Errors

Our API uses conventional HTTP response codes to indicate success or failure:

Authentication ErrorsCopied!

  • 401: Invalid authentication (bad token or credentials)

  • 403: Not authorized to access the resource

Request ErrorsCopied!

  • 400: Bad request - missing required fields or invalid format

  • 404: Resource not found

Server ErrorsCopied!

  • 500: Internal server error - contact support if persists

Error responses include a message field with a human-readable explanation.

{
  "error": {
    "message": "Invalid payer external ID provided",
    "code": "400"
  }
}