Cancel a pending charge
POST/v1/charges/:chargeId/cancel
Cancels only charges in the pending state. A 202 means the result is not yet
authoritative. There is no background reconciliation: replay the same payload with the
same Idempotency-Key to continue safely. Before the durable PSP-dispatch fence, provider
absence keeps the intent pending; after that fence, lookup absence confirms cancellation
without repeating the DELETE.
Request
Responses
- 200
- 202
- 401
- 403
- 404
- 409
- 422
- 429
- 502
Cancellation confirmed authoritatively.
Pending result; replay the same payload with the same Idempotency-Key.
Authentication failed
Insufficient permission
Resource not found
Idempotency or state conflict
Validation error
Request limit exceeded
External integration failed
Did this page unblock the next step?
Feedback stays inside the docs flow and should never include customer or card data.