Error Codes

Card Acceptance List of Error Codes

The Card Acceptance API uses conventional HTTP response codes to indicate the success or failure of an API request. In general:

  • codes in the 2xx range indicate success
  • codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a header is missing, etc.
  • codes in the 5xx range indicate server/system errors

As our API can raise errors for many reasons, such as a failed charge, invalid parameters, authentication errors. We recommend writing code that gracefully handles all possible error codes.

All the errors include an error code and a short human-readable message that briefly explains the error reported (you can use it internally but don't share it with your clients/users).

Error responses

Error responses are a combination of the HTTP response code, the service code, and the case code.

Error response = HTTP response code + service code + case code

Service Codes

Below is a list with all the service codes:

Service codeService
01Card Registration
03Get Card
04Unbinding
54Payment Charge
55Get Payment Status
57Payment Void
58Payment Refund

Case Codes

Below is a list of all Internal possible HTTP response codes and case codes, along with additional information about them:

HTTP CodeService CodeCase CodeResponse Description
200XX01APPROVED
200XX02APPROVED_AUTO
200XX06BALANCE_AVAILABLE
200XX31SUBMITTED
200XX00BASIC_VERIFICATION_SUCCESSFUL
200XX01EXTERNAL_VERIFICATION_SUCCESSFUL
200XX02SCHEME_TOKENIZATION_SUCCESSFUL
201XX05AUTHENTICATION_IN_PROGRESS
201XX29PENDING
202XX03APPROVED_PENDING_SETTLEMENT
202XX18DEFERRED_TRANSACTION_RECEIVED
202XX30REFERRED
204XX07NO_VERIFICATION_PERFORMED
206XX28PARTIALLY_APPROVED
400XX21EXPIRED_CARD
400XX23INVALID_CSC
400XX04EXTERNAL_VERIFICATION_DECLINED_EXPIRED_CARD
400XX05EXTERNAL_VERIFICATION_DECLINED_INVALID_CSC
401XX04AUTHENTICATION_FAILED
401XX15DECLINED_INVALID_PIN
401XX17DECLINED_PIN_REQUIRED
401XX03EXTERNAL_VERIFICATION_DECLINED_AUTHENTICATION_REQUIRED
401XX10SCHEME_TOKENIZATION_SUCCESSFUL_ADDITIONAL_AUTHENTICATION_REQUIRED
402XX10DECLINED
402XX11DECLINED_AVS
402XX12DECLINED_AVS_CSC
402XX13DECLINED_CSC
402XX16DECLINED_PAYMENT_PLAN
402XX22INSUFFICIENT_FUNDS
402XX27NO_BALANCE
402XX02EXTERNAL_VERIFICATION_DECLINED
402XX08SCHEME_TOKENIZATION_DECLINED
403XX08BLOCKED
403XX14DECLINED_DO_NOT_CONTACT
403XX01EXTERNAL_VERIFICATION_BLOCKED
409XX19DUPLICATE_BATCH
423XX24LOCK_FAILURE
424XX07BALANCE_UNKNOWN
428XX25NOT_ENROLLED_3D_SECURE
429XX20EXCEEDED_RETRY_LIMIT
499XX09CANCELLED
500XX32SYSTEM_ERROR
500XX35UNSPECIFIED_FAILURE
500XX00GENERAL_ERROR
501XX26NOT_SUPPORTED
501XX01INTERNAL_SERVER_ERROR
502XX00ABORTED
502XX00ACQUIRER_SYSTEM_ERROR
502XX06EXTERNAL_VERIFICATION_PROCESSING_ERROR
502XX09SCHEME_TOKENIZATION_ERROR
504XX33TIMED_OUT
520XX34UNKNOWN