Skip to main content

Errors and reliability

Status handling​

  • 401 Unauthorized: missing/invalid credential.
  • 403 Forbidden: credential valid but scope insufficient.
  • 429 Too Many Requests: rate limit hit; obey Retry-After.

Reliability practices​

  • Always send Idempotency-Key for write requests.
  • Use server-side status polling for quote/checkout lifecycle.
  • Treat webhook-confirmed payment state as source of truth.