Check out our usual error messages and what they mean
HTTPS status code | Error code |
---|---|
400 | NOT_FOUND |
403 | XXX_NOT_ALLOWED |
404 | NO_SUCH_XXX |
404 | NOT_FOUND |
409 | CONFLICT |
413 | REQUEST_TOO_LARGE |
422 | UNPROCESSABLE_ENTITY |
422 | INVALID_ADDRESS |
429 | TOO_MANY_REQUESTS |
500 | INTERNAL_SERVER_ERROR |
500 | UNEXPECTED_ERROR |
502/503/504 | TEMPORARILY_UNAVAILABLE |
Error message | Description | Handling error |
---|---|---|
| This is an invalid request. | Refer to the OpenAPI documentation to check validation rules. |
CAPTURE_NOT_ALLOWED
error is only present as response to capture
request.
There are multiple reasons for this error to occur depending on these the customer may not get the products and the merchant won't get settled for the order. The customer might have to place the same order again.
Error message | Description | Error handling |
---|---|---|
| The order might be cancelled or expired, or the captured amount might be higher than the remaining authorized amount. |
CANCEL_NOT_ALLOWED
error is only present as response to cancel
request.
Error message | Description |
---|---|
| Once an order is captured, it can not be cancelled anymore. For more information, see our Escalation and retry policy. |
NOT_ALLOWED error could be present in the following requests:
release_authorization
extend_authorization_time
update_authorization
update_order_customer_details
update_merchant_references
Depending on the operation this error can affect the customer communication, shipping details or authorization expire time.
Error message | Description | Error handling |
---|---|---|
| The capture amount must always be higher than the authorized amount. | See our Escalation and retry policy. |
REFUND_NOT_ALLOWED error is only present as response to refund
request.
If the order has already been cancelled or fully refunded, the failed refund call doesn't have any impact on the customer. In cases where the attempted refunded amount is greater than the captured amount, the whole refund might fail, and customer's money be left with the merchant.
Error message | Description | Error handling |
---|---|---|
| An order or value can only be refunded if it has been previously captured or partially captured. | See our Escalation and retry policy. |
NO_SUCH_ORDER
error is only present as response to capture
request.
Error message | Description | Handling error |
---|---|---|
| The requested resource (order, capture, or refund) could not be found. Check if their IDs are correct. | Check if their IDs are correct. |
Error message | Description | Handling error |
---|---|---|
| The requested resource (order, capture, or refund) could not be found. | Check if their IDs are correct. |
Error message | Description | Handling error |
---|---|---|
| The requested resource (order, capture, or refund) could not be found. | Check if their IDs are correct. |
Error message | Description | Handling error |
---|---|---|
| This request conflicts with the current state of the target resource. | See our Escalation and retry policy. |
Error message | Description | Handling error |
---|---|---|
| This request is too large. | Refer to the OpenAPI documentationto see if the request is valid. |
Error message | Description | Handling error |
---|---|---|
| The service is unable to process this request. | Refer to the OpenAPI documentation to see if the request is valid. |
Error message | Description | Handling error |
---|---|---|
| The service is unable to process this request. | Refer to the OpenAPI documentation to see if the request is valid. |
Error message | Description | Handling error |
---|---|---|
| We received too many requests in a given amount of time (rate limiting). | For more information, see the Rate limit guide. |
Error message | Description | Handling error |
---|---|---|
| An unexpected server error occurred. | For more information, see our Escalation and retry policy. |
Error message | Description | Handling error |
---|---|---|
| The service is temporarily unavailable. | For more information, see our Escalation and retry policy. |