Errors

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "request body is required"
  }
}

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "message": "payment was declined",
    "type": "card_error",
    "decline_code": "insufficient_funds",
    "decline_type": "authorization",
    "retryable": true
  }
}

​

Status code map

​

Client behavior

• Retry network failures and retryable 5xx operations with the same idempotency key only when the operation-specific documentation says that a retry is safe.
• A 502 with code GATEWAY_ERROR from confirming a payment intent (including create with confirmation) or creating a refund means no money moved. The same idempotency key only replays that response, so use a new key to try again. From capture or cancel, retrieve the payment intent before retrying: the outcome there is not yet guaranteed. A 502 without an Ionic error body comes from the network edge: retry it with the same key.
• Do not retry validation errors without changing the request.
• Do not retry payment declines blindly.
• Include X-Request-ID when contacting support.