Resume a Parked Renewal
Starts a fresh on-session attempt with the saved card for a subscription renewal that is waiting on the customer to authenticate; the bank’s step then arrives in next_action on the following status reads. Only the payment’s own customer may call it — with the payment’s client_secret or their own session — and it is a no-op for any payment that is not a parked renewal.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Path Parameters
The unique identifier of the payment.
Response
Resume requested
When the card authorization must be captured, as an ISO 8601 timestamp. null when this payment was not authorized for later capture.
"2026-01-01T12:00:00.000Z"
The payment this status describes, prefixed pay_.
"pay_xxxxxxxxxxxxxx"
Details of the most recent failed attempt, or null when the payment has not failed.
What the buyer must do next while status is requires_action, otherwise null. type picks the shape and each variant carries only its own data, so switching on type gives you exactly that step's payload.
- Redirect
- Display instructions
- Await confirmation
Always payment_status.
"payment_status"
Present while status is processing on a settlement rail, otherwise null.
Where to send the buyer once the payment reaches a resting state, or null to leave them where they are. Editable until they return — see the return_url operation.
"https://shinetime.example/checkout/done"
How far the payment has got. requires_confirmation — nothing attempted yet, or the last attempt failed and can be retried. requires_action — the buyer has a step outstanding; see next_action. requires_capture — the card authorization is holding funds and must be captured. confirming — the buyer has done their part and the processor is deciding. processing — the money is moving; see processing_details. succeeded — collected. canceled — voided or written off.
requires_confirmation, requires_action, requires_capture, confirming, processing, succeeded, canceled "succeeded"

