Errors

{
  "error": {
    "code": "bad_request",
    "message": "quote_id is required"
  }
}

​

HTTP statuses

​

Handling recommendations

• Show actionable validation errors to your operators or support team.
• Retry network failures with the same Idempotency-Key only when the business intent and request body are unchanged.
• Do not retry authentication errors until credentials have been fixed.
• Store error responses with your internal payment record for reconciliation and support.