Skip to main content
Refunds a successful order, in full or in part, back to the payment instrument it came from.

​
Endpoint

​
Authentication

Authenticate with your secret key in the api-key header.

​
Request body

Plain JSON — this endpoint is not encrypted.
Omit amount to refund the order in full. Supply it for a partial refund — it cannot exceed the amount originally charged.

​
Request example

​
Response

Returns the standard envelope with the created refund record.
The provider has not published a success response body for this endpoint. Confirm the exact shape against your sandbox account before depending on individual fields, and read refunds back with List refunds.

​
Rules

  • The order must have reached a successful final status. A pending order cannot be refunded — there is nothing to return yet.
  • Refunds go back to the original payment instrument. You cannot redirect one elsewhere.
  • Settlement takes time, typically several working days for a card.
Refunding is not the same as cancelling. If a customer abandons a payment, do nothing — the order simply never settles. Only refund money that actually arrived.
Guard against double refunds on your side. Record that you have issued a refund against a reference before you call this endpoint, so a retry after a timeout doesn’t send a second one.

​
Common errors

​
Next steps

List refunds

Read back the refunds you’ve issued.

List chargebacks

Refunds forced by the customer’s bank.