Overview

Exceptions occur when an API operation fails to process a request payload. In such scenarios, error codes and its corresponding HTTP status codes help troubleshoot the possible failure reason. For example, in a scenario where a user provides invalid inputs such as card number, CVV or expiry date.

The sample error response given below shows the HTTP response body structure that is returned in case of errors:

HTTP Response Body:
{
  "errorCode": "ER007",
  "errorType": "INVALID_ARGUMENT_ERROR",
  "errorMessage": "Invalid argument error occurred. Check additionalInfo for more details.",
  "traceId": "adb0213f-63aa-48f4-9dda-d033fa1c6641",
  "additionalInfo": {
     "amount": "may not be null",
     "requestId": "may not be null"
  }
}
HTTP Status Code: 400

Default Error Codes

Note: To support better error handling, we iteratively keep on improving and adding more error codes to this list. Please expect to receive new unseen error codes in API responses. In such cases we recommend you to revisit this section and add handling for new codes as well.

The following table lists the possible error codes and its descriptions that are generated by the payment API services: