Payments
Cancel a scheduled retry
Cancels an upcoming retry, if there is one scheduled
Cancellation requests are processed asynchronously. You can use workflows to be notified if the cancellation is successful.
post/payments/{id}/cancellations
Request
- Base URLhttps://{prefix}.api.sandbox.checkout.com
- Auth
- OAuth 2Client credentialsToken URLstringScopesgateway, gateway:payment-cancellations
- or API key in header Authorization
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
idstring required
The unique payment identifier.
Headers
Cko-Idempotency-Keystring
An optional idempotency key for safely retrying payment requests
Request body
Example request
{
"reference": "ORD-5023-4E89"
}Response
Cancellation accepted
Example response
{
"action_id": "act_y3oqhf46pyzuxjbcn2giaqnb44",
"reference": "ORD-5023-4E89"
}Changes
No recorded changes to this operation across all 1 revision of this API.