Error codes

Payment

HTTP 201

StatusReasonMessageAction
AUTHORIZEDTransaction approved
PARTIAL_AUTHORIZEDPartial amount approved
AUTHORIZED_PENDING_REVIEWAVS_FAILEDApproved; failed AVSReview
AUTHORIZED_PENDING_REVIEWCONTACT_PROCESSORApproved; contact bankObtain auth code
DECLINEDEXPIRED_CARDCard expiredUpdate payment method
DECLINEDINSUFFICIENT_FUNDInsufficient fundsUse different payment
AUTHORIZED_RISK_DECLINEDSCORE_EXCEEDS_THRESHOLDDeclined by fraud rulesRetry
PENDING_AUTHENTICATIONAUTHENTICATION_REQUIREDAuthentication requiredAuthenticate & retry


HTTP 400

StatusReasonMessageAction
INVALID_REQUESTMISSING_FIELDMissing required fieldsCorrect and resend
INVALID_REQUESTINVALID_DATAInvalid data providedCorrect and resend
INVALID_REQUESTDUPLICATE_REQUESTDuplicate requestUse unique reference
INVALID_REQUESTCARD_TYPE_NOT_ACCEPTEDCard type not acceptedContact bank
INVALID_REQUESTPROCESSOR_UNAVAILABLEProcessor failureRetry later
INVALID_REQUESTINVALID_AMOUNTAmount mismatchCorrect and resend
INVALID_REQUESTINVALID_CARD_TYPEInvalid card type/mismatchCorrect and resend


HTTP 502

StatusReasonMessageAction
SERVER_ERRORSYSTEM_ERRORSystem failureCheck SDK docs
SERVER_ERRORSERVER_TIMEOUTServer timeoutReview in EBC
SERVER_ERRORSERVICE_TIMEOUTService timeoutReview in EBC
SERVER_ERRORINVALID_OR_MISSING_CONFIGConfig errorContact support

Capture

HTTP 201

StatusReasonMessageAction
PENDINGSuccessful transaction
INVALID_REQUESTINVALID_MERCHANT_CONFIGURATIONConfiguration errorContact support
SERVER_ERRORPROCESSOR_TIMEOUTProcessor timeoutReview in EBC


HTTP 400

StatusReasonMessageAction
INVALID_REQUESTMISSING_FIELDMissing fieldsResend with correct fields
INVALID_REQUESTINVALID_DATAInvalid dataResend with correct data
INVALID_REQUESTDUPLICATE_REQUESTDuplicate requestUse unique reference
INVALID_REQUESTEXCEEDS_AUTH_AMOUNTExceeds authorized amountNew auth & capture
INVALID_REQUESTAUTH_ALREADY_REVERSEDAuthorization already reversedNo action
INVALID_REQUESTTRANSACTION_ALREADY_SETTLEDTransaction already settledNo action
INVALID_REQUESTINVALID_AMOUNTAmount mismatchCorrect & resend
INVALID_REQUESTINVALID_PAYMENT_IDInvalid request IDNo action
INVALID_REQUESTMISSING_AUTHNo matching authorizationRequest new auth
INVALID_REQUESTTRANSACTION_ALREADY_REVERSED_OR_SETTLEDAlready reversed/settledNo action

HTTP 502

StatusReasonMessageAction
SERVER_ERRORSYSTEM_ERRORSystem failureHandle retries
SERVER_ERRORSERVER_TIMEOUTServer timeoutReview in EBC
SERVER_ERRORSERVICE_TIMEOUTService timeoutReview in EBC
SERVER_ERRORINVALID_OR_MISSING_CONFIGConfig errorContact support

Reversal

HTTP 201

StatusReasonMessageAction
REVERSEDSuccessful transaction
SERVER_ERRORPROCESSOR_TIMEOUTProcessor timeoutReview in EBC

HTTP 400

StatusReasonMessageAction
INVALID_REQUESTMISSING_FIELDMissing fieldsResend with correct fields
INVALID_REQUESTINVALID_DATAInvalid dataResend with correct data
INVALID_REQUESTDUPLICATE_REQUESTDuplicate requestUse unique reference
INVALID_REQUESTPROCESSOR_UNAVAILABLEProcessor failureRetry later
INVALID_REQUESTAUTH_ALREADY_REVERSEDAuthorization already reversedNo action
INVALID_REQUESTTRANSACTION_ALREADY_SETTLEDAlready settledNo action
INVALID_REQUESTINVALID_AMOUNTAmount mismatchCorrect & resend
INVALID_REQUESTINVALID_PAYMENT_IDInvalid request IDNo action
INVALID_REQUESTMISSING_AUTHNo matching authorizationRequest new auth
INVALID_REQUESTTRANSACTION_ALREADY_REVERSED_OR_SETTLEDAlready reversed/settledNo action

HTTP 502

StatusReasonMessageAction
SERVER_ERRORSYSTEM_ERRORSystem failureHandle retries
SERVER_ERRORSERVER_TIMEOUTServer timeoutReview in EBC
SERVER_ERRORSERVICE_TIMEOUTService timeoutReview in EBC
SERVER_ERRORINVALID_OR_MISSING_CONFIGConfig errorContact support

Refund

HTTP 201

StatusReasonMessageAction
PENDINGSuccessful transaction
INVALID_REQUESTINVALID_MERCHANT_CONFIGURATIONConfiguration errorContact support
SERVER_ERRORPROCESSOR_TIMEOUTProcessor timeoutReview in EBC

HTTP 400

StatusReasonMessageAction
INVALID_REQUESTMISSING_FIELDMissing fieldsResend with correct fields
INVALID_REQUESTINVALID_DATAInvalid dataResend with correct data
INVALID_REQUESTDUPLICATE_REQUESTDuplicate requestUse unique reference
INVALID_REQUESTINVALID_CARDInvalid account numberUse different payment
INVALID_REQUESTINVALID_AMOUNTAmount mismatchCorrect & resend
INVALID_REQUESTCAPTURE_ALREADY_VOIDEDCredit for voided captureNo action
INVALID_REQUESTACCOUNT_NOT_ALLOWED_CREDITStand-alone credits not allowedUse follow-on credit

HTTP 502

StatusReasonMessageAction
SERVER_ERRORSYSTEM_ERRORSystem failureHandle retries
SERVER_ERRORSERVER_TIMEOUTServer timeoutReview in EBC
SERVER_ERRORSERVICE_TIMEOUTService timeoutReview in EBC
SERVER_ERRORINVALID_OR_MISSING_CONFIGConfig errorContact support



Void

HTTP 201

StatusReasonMessageAction
VOIDEDSuccessful transaction
INVALID_REQUESTINVALID_MERCHANT_CONFIGURATIONConfiguration errorContact support
SERVER_ERRORPROCESSOR_TIMEOUTProcessor timeoutReview in EBC

HTTP 400

StatusReasonMessageAction
INVALID_REQUESTMISSING_FIELDMissing fieldsResend with correct fields
INVALID_REQUESTINVALID_DATAInvalid dataResend with correct data
INVALID_REQUESTDUPLICATE_REQUESTDuplicate requestUse unique reference
INVALID_REQUESTINVALID_AMOUNTAmount mismatchCorrect & resend
INVALID_REQUESTNOT_VOIDABLENot voidableNo action

HTTP 502

StatusReasonMessageAction
SERVER_ERRORSYSTEM_ERRORSystem failureHandle retries
SERVER_ERRORSERVER_TIMEOUTServer timeoutReview in EBC
SERVER_ERRORSERVICE_TIMEOUTService timeoutReview in EBC
SERVER_ERRORINVALID_OR_MISSING_CONFIGConfig errorContact support

Validation Response

NameReasonScopeDefault Message
INVALID_MERCHANTAUTHENTICATION_FAILURERequest/AuthMerchant authentication failed.
INVALID_TRANSACTIONINVALID_REQUESTRequestInvalid transaction/request.
INVALID_AMOUNTINVALID_FIELDFieldInvalid amount.
INVALID_CARDINVALID_FIELDFieldInvalid card or reference ID.
FORMAT_ERRORINVALID_FIELDFieldRequest format error.
FIELD_TOO_SHORTFIELD_TOO_SHORTFieldField value is too short.
FIELD_TOO_LONGFIELD_TOO_LONGFieldField value is too long.
MISSING_REQUIRED_FIELDMISSING_FIELDFieldRequired field is missing.
EXPIRED_CARDVALUE_EXPIREDFieldValue has expired.
ISSUER_INOPERATIVEDECLINEDSystemIssuer unavailable / declined.
ROUTING_ERRORSYSTEM_ERRORSystemRouting / network error.
DUPLICATE_TRANSMISSIONINVALID_REQUESTRequestDuplicate request detected.
RECONCILE_ERRORSYSTEM_ERRORSystemReconciliation error.
SYSTEM_MALFUNCTIONSYSTEM_ERRORSystemSystem malfunction.