Error handling

​

Client errors

• 400 Bad request - Returned when the request passed authentication and authorization checks, but the request did not have the data it expected. In most situations, this is because of missing request properties, or incorrect values for properties.
• 401 Unauthorized - Returned when the bearer token was not valid and could not be used to authorize the API call. In this case please check the List 4XX errors API to inspect the cause of the issue.
• 403 Forbidden - Returned when the bearer token is valid but the authenticating client does not have permission to access or manipulate the resource. This may be due to insufficient scopes in the JWT, a restricted API key used to sign the JWT, or a resource being locked.
• 404 Not found - The resource could not be found. In a small number of cases, the resource may indeed exist, but due to permissions it is not accessible to the authenticated client and returning a 403 would provide information that should not be available to the caller.
• 405 Method not allowed - The HTTP method used was not recognized for the path of the request.
• 409 Duplicate record - A record already exists that matches one of the unique constrain for this resource. Check the API documentation for the call made to check what fields have a unique constraint.
• 429 Too many requests - The request exceeded a rate limit. Wait for the number of seconds in the Retry-After header, if present, before you retry.

{
  "type": "error", 
  "code": "bad_request",
  "status": 400,
  "message": "Request failed validation",
  "details": [
    {
      "type": "type_error.uuid",
      "pointer": "/payment_method/buyer_id",
      "message": "value is not a valid uuid",
      "location": "body"
    }
  ]
}

{
    "type": "error",
    "code": "unauthorized",
    "status": 401,
    "message": "No valid API authentication found",
    "details": []
}

{
    "type": "error",
    "code": "forbidden",
    "status": 403,
    "message": "Invalid credentials",
    "details": []
}

{
    "type": "error",
    "code": "not_found",
    "status": 404,
    "message": "The resource could not be found",
    "details": []
}

{
    "type": "error",
    "code": "method_not_allowed",
    "status": 405,
    "message": "Method Not Allowed",
    "details": []
}

{
    "type": "error",
    "code": "duplicate_record",
    "status": 409,
    "message": "Duplicate record",
    "details": []
}

{
    "type": "error",
    "code": "too_many_requests",
    "status": 429,
    "message": "Too many requests",
    "details": []
}

​

No active payment service

• No connection supports the payment method for the transaction’s currency and country.
• The connection doesn’t support the transaction’s intent. For example, a payment method that only supports direct capture needs intent set to capture.
• The matched Flow rule leaves no connection to route the transaction to.

​

Server errors

{
    "type": "error",
    "code": "server_error",
    "status": 500,
    "message": "Request could not be processed",
    "details": []
}

{
    "type": "error",
    "code": "bad_gateway",
    "status": 502,
    "message": "Request could not be processed",
    "details": []
}

{
    "type": "error",
    "code": "gateway_timeout",
    "status": 504,
    "message": "Request could not be processed",
    "details": []
}