Errors

Errors return a 4xx or 5xx status with a consistent JSON body so you can branch on error.code programmatically.

Error format

{
  "error": {
    "code": "insufficient_funds",
    "message": "The customer's account has insufficient funds."
  }
}

Common status codes

• 400 — malformed request
• 401 — invalid or missing API key
• 402 — payment failed (see error.code)
• 429 — rate limited
• 5xx — something went wrong on our end