Check the command
Before creating a refund, verify:- The payment belongs to the same merchant and environment
- The amount does not exceed the refundable balance
- The command has an idempotency key
- The key includes
refunds:write
2xx accepts or creates the resource, but settlement may remain pending. Process refund.created, refund.updated, refund.succeeded, and refund.failed.
Reuse the same Idempotency-Key after a timeout. Do not create another key until you know the prior command’s outcome.