Skip to main content
Our API uses standard HTTP status codes to indicate the success or failure of a request. When an error occurs, the response will include an error code and message. Your integration should handle these gracefully, with retry logic where appropriate, and surface clear messages to users when action is required.
Status CodeMessageHow to Resolve
400Bad RequestCheck your request payload and parameters for missing or invalid fields.
401UnauthorizedEnsure you are using the correct API key.
403ForbiddenYour API key does not have permission. Confirm access rights or contact support.
404Not FoundVerify the endpoint URL and resource ID.
409ConflictThe resource is in an invalid state (e.g., duplicate request). Retry if safe.
422Unprocessable EntityInput validation failed. Check field formats and required attributes.
429Too Many RequestsYou have exceeded the rate limit. Implement retries with exponential backoff.
500Internal Server ErrorTemporary server issue. Retry the request or contact support if persistent.
503Service UnavailableAPI is temporarily unavailable. Retry with backoff.
Specific Error Cases
  • A 404 error can occur if an order confirmation request is submitted before the order reaches awaiting_confirmation. Adding a short delay or polling until the order is ready will help prevent this error.
  • When creating a checkout intent, the buyer.country field is case sensitive. The expected input is uppercase.
⌘I