Gateway error code mapping

The following error codes are returned by each of the gateways supported by Recover, which Spreedly has designated as recoverable.

Note the category designation as well; softmeans a failure that will be reattempted, while outage indicates a gateway specific outage response which will be retried.

When in outage_only Mode, Spreedly will retry High Level Spreedly Outage codes and Gateway Specific Outage codes.

When in standard Mode, Spreedly will Retry High Level Spreedly Outage responses, Gateway Specific Outage responses and Soft responses.

The Response Element for each gateway indicates the specific element of the response the service evaluates for a Recovery attempt. When using custom mode, this is the element you must use for evaluation.

📘

It is important to note that any failure on the 2nd gateway will be retried regardless of mode or error response, providing there is a 3rd gateway to be retried on.

High Level Spreedly Outage Codes

Response Element - error_code

Error CodeCategory
circuit_breaker_openHigh Level Outage
retryable_communication_exceptionHigh Level Outage

These high level error codes are considered retryable; they are related to errors in communication with the target gateway where we are certain that there is no chance a transaction could have occurred.

For example, if a request to a gateway returns a timeout error, we can't be certain that the transaction wasn't attempted/successful on the gateway, so we would not retry. But, if a gateway's circuit breaker was opened due to consistent timeouts, we would know that the request never made it to the gateway, and thus we could safely retry on another gateway.

Adyen

Response Element - message

MessageCategory
Acquirer Error | 96 : System errorGateway Specific Outage
Acquirer Error | 96 : System malfunctionGateway Specific Outage
Issuer UnavailableGateway Specific Outage
Issuer Unavailable | 91 : Issuer or switch is inoperativeGateway Specific Outage
Issuer Unavailable | 91 : Issuer unavailable or switch inoperativeGateway Specific Outage
Issuer Unavailable | 96 : System malfunctionGateway Specific Outage
The payment gateway is currently unavailableGateway Specific Outage
Unable to communicate with the payment system.Gateway Specific Outage
3D Not AuthenticatedSoft
Acquirer ErrorSoft
Authentication requiredSoft
Authentication required | 1A : Authentication RequiredSoft
Authentication required | 65 : Authentication requiredSoft
Authentication required | 65 : Authentication requiredSoft
Billing address problem (Country XK invalid)Soft
Configuration Problem mpiImplementationSoft
Could not find an acquirer account for the provided currency (CRC).Soft
Could not find an acquirer account for the provided currency (MXN).Soft
Could not find an acquirer account for the provided currency (USD).Soft
Could not find an acquirer account for the provided txvariant (amex), currency (EUR), and action (AUTH).Soft
Could not find an acquirer account for the provided txvariant (amex), currency (SEK), and action (AUTH).Soft
Could not find an acquirer account for the provided txvariant (hipercard), currency (BRL), and action (AUTH).Soft
Declined Non GenericSoft
Declined Non Generic | 03 : Invalid merchantSoft
Expired Card | 82 : PolicySoft
Expired Card | SG : No account on file — absoluteSoft
FRAUD-CANCELLED | 00 : Approved or completed successfullySoft
FRAUD-CANCELLED | 85 : No reason to decline a request for account number verification, address verification, CVV2 verification, or a credit voucher or merchandise returnSoft
Invalid AmountSoft
Invalid Amount | 13 : Invalid amountSoft
Invalid Merchant AccountSoft
Issuer Unavailable | 91 : Issuer unavailable or switch inoperativeSoft
Not allowedSoft
Not supportedSoft
Not supported | 05 : Do not honorSoft
Not supported | 12 : Invalid transactionSoft
Not supported | 40 : Requested function not supportedSoft
Not supported | 42 : Invalid accountSoft
Payment details are not supported for this country/ MCC combinationSoft
Pin tries exceeded | 75 : Allowable number of PIN tries exceededSoft
RefusedSoft
Refused | 03 : Invalid merchant or terminalSoft
Refused | 05 : Do not honorSoft
Refused | 05 : Generic / Contact the card centerSoft
Refused | 06 : ErrorSoft
Refused | 100 : DenySoft
Refused | 100 : Do not honor (general denial)Soft
Refused | 82 : PolicySoft
Refused | D : Declined (30 : System malfunction)Soft
Refused | D : Declined (O8 : Reserved)Soft
Refused | SG : No account on file — absoluteSoft
Required field 'billingAddress.stateOrProvince' is not provided.Soft
Required field 'billingAddress.street' is not provided.Soft
Restricted Card | 104 : Restricted cardSoft
Revocation Of AuthSoft
Transaction Not PermittedSoft
Unable To ProcessSoft

Authorize.net

Response Element - message

MessageCategory
A valid amount is requiredGateway Specific Outage
ACH transactions are not accepted by this merchantGateway Specific Outage
An error occurred during processing. Please try againGateway Specific Outage
An error occurred during processing. Call Merchant Service ProviderGateway Specific Outage
Bill To Address is requiredGateway Specific Outage
Bill To City is requiredGateway Specific Outage
Bill To Country is requiredGateway Specific Outage
Bill To First Name is requiredGateway Specific Outage
Bill To State/Province is requiredGateway Specific Outage
Bill To Zip/Postal Code is requiredGateway Specific Outage
Description is requiredGateway Specific Outage
Email is requiredGateway Specific Outage
Line item 1 is invalidGateway Specific Outage
Line item 2 is invalidGateway Specific Outage
Line item 3 is invalidGateway Specific Outage
Line item 4 is invalidGateway Specific Outage
Line item 5 is invalidGateway Specific Outage
Line item 6 is invalidGateway Specific Outage
Line item 7 is invalidGateway Specific Outage
Line item 8 is invalidGateway Specific Outage
Phone is requiredGateway Specific Outage
Ship To First Name is requiredGateway Specific Outage
System unavailable.Gateway Specific Outage
The ABA code is invalidGateway Specific Outage
The configuration with processor is invalid. Call Merchant Service Provider.Gateway Specific Outage
The Elavon bank number or terminal ID is incorrect. Call Merchant Service ProviderGateway Specific Outage
The FDC Merchant ID or Terminal ID is incorrect. Call Merchant Service ProviderGateway Specific Outage
The Global Payment System identification numbers are incorrect. Call Merchant Service ProviderGateway Specific Outage
The merchant does not accept this type of credit cardGateway Specific Outage
The request field(s) are either invalid or missingGateway Specific Outage
The supplied currency code is either invalid, not supported, not allowed for this merchant or doesn't have an exchange rateGateway Specific Outage
The VITAL identification numbers are incorrect. Call Merchant Service ProviderGateway Specific Outage
There is one or more missing or invalid required fieldsGateway Specific Outage
This processor does not support this method of submitting payment dataGateway Specific Outage
Transactions of this market type cannot be processed on this systemGateway Specific Outage
AVS data is invalid or AVS is not allowed for this card type.Soft
Street address does not match, but 5-digit postal code matches.Soft
Street address does not match, but 9-digit postal code matches.Soft
Street address matches, but postal code does not match.Soft
This transaction cannot be accepted at this timeSoft
This transaction cannot be processed.Soft
This transaction has been declined.Soft

Braintree

Response Element - error_code

Error CodeCategory
3000Gateway Specific Outage
2000Soft
2002Soft
2003Soft
2009Soft
2026Soft
2038Soft
2046Soft
2048Soft
2057Soft
2099Soft

CheckoutV2

Response Element - error_code

Error CodeCategory
20022Gateway Specific Outage
20068Gateway Specific Outage
20068Gateway Specific Outage
20096Gateway Specific Outage
20001Soft
20001Soft
20002Soft
20003Soft
20005Soft
20006Soft
20009Soft
20010Soft
20012Soft
20013Soft
20014Soft
20017Soft
20018Soft
20019Soft
20019Soft
20020Soft
20021Soft
20023Soft
20024Soft
20025Soft
20025Soft
20026Soft
20027Soft
20028Soft
20029Soft
20030Soft
20031Soft
20032Soft
20033Soft
20038Soft
20039Soft
20040Soft
20042Soft
20044Soft
20046Soft
20051Soft
20052Soft
20053Soft
20054Soft
20055Soft
20055Soft
20056Soft
20057Soft
20057Soft
20058Soft
20059Soft
20060Soft
20061Soft
20062Soft
20063Soft
20064Soft
20065Soft
20066Soft
20067Soft
20075Soft
20078Soft
20082Soft
20082Soft
20082Soft
20083Soft
20084Soft
20085Soft
20086Soft
20086Soft
20087Soft
20088Soft
20089Soft
20090Soft
20091Soft
20092Soft
20093Soft
20094Soft
20095Soft
20097Soft
20098Soft
20099Soft
2006PSoft
200N0Soft
200N7Soft
200O5Soft
200P1Soft
200P9Soft
200R1Soft
200R3Soft
200S4Soft
200T2Soft
200T3Soft
200T5Soft
20100Soft
20101Soft
20102Soft
20103Soft
20104Soft
20105Soft
20106Soft
20107Soft
20108Soft
20109Soft
20109Soft
20109Soft
20110Soft
20111Soft
20112Soft
20113Soft
20114Soft
20115Soft
20116Soft
20117Soft
20118Soft
20119Soft
20120Soft
20121Soft
20122Soft
20123Soft
20124Soft
20150Soft
20151Soft
20152Soft
20153Soft
20154Soft
20155Soft
20156Soft
20157Soft
20158Soft
20179Soft
20182Soft
20183Soft
20193Soft

Conekta

Response Element - message

MessageCategory
Hubo un error del lado del sistema y los ingenieros de Conekta han sido notificados.Gateway Specific Outage
Unable to communicate with the payment system.Gateway Specific Outage
Tu método de pago ha sido rechazado, intenta con otro método.Soft
Falta el correo del comprador.Soft
Esta transacción no está permitida para esta tarjeta.Soft
La tarjeta ingresada ha sido declinada. Por favor intenta mas tarde.Soft
Hubo un problema de procesamiento. Intente de nuevo.Soft
El cargo no existe o no es apto para esta operación.Soft
El comercio es inválido. Contacte a soporte.Soft
La tarjeta no está soportada.Soft
La ruta de tu petición no ha sido encontrada.Soft
El mínimo para pagos de tarjeta es de 3 pesos.Soft
The company cannot process because the risk amount limit is reaching.Soft
translation missing: es.pt_multiplexer_client.response.declined.settlement_error_purchaserSoft
Falta el teléfono en el campo "details".Soft
En este momento solamente procesamos pesos Mexicanos o Dólares Americanos.Soft
Falta el nombre del comprador.Soft
El máximo para pagos de tarjeta es de 6000 pesos.Soft

CyberSource

Response Element - error_code

Error CodeCategory
101Soft
102Soft
150Soft
151Soft
203Soft
233Soft
234Soft
236Soft
251Soft
481Soft
520Soft

CyberSource REST

Response Element - message

MessageCategory
Error - The request was received but there was a server timeout. This error does not include timeouts between the client and the server.Gateway Specific Outage
Error - General system failure.Gateway Specific Outage
Request failed due to unknown system error.Gateway Specific Outage
Serious error saving payment informationGateway Specific Outage
An unexpected error occurred.Gateway Specific Outage
INVLD MER IDGateway Specific Outage
Internal server ErrorGateway Specific Outage
Declined - The request is missing one or more fieldsSoft
Decline - General decline of the card. No other information provided by the issuing bank.Soft
Declined - One or more fields in the request contains invalid dataSoft
Soft Decline - The authorization request was approved by the issuing bank but declined by CyberSource because it did not pass the Address Verification Service (AVS) check.Soft
Decline - Issuing bank unavailable.Soft

DLocal

Response Element - error_code

CodeCategory
3001Gateway Specific Outage
3002Gateway Specific Outage
3003Gateway Specific Outage
4000Gateway Specific Outage
5000Gateway Specific Outage
5001Gateway Specific Outage
5002Gateway Specific Outage
5003Gateway Specific Outage
5004Gateway Specific Outage
5005Gateway Specific Outage
5006Gateway Specific Outage
5007Gateway Specific Outage
5008Gateway Specific Outage
5009Gateway Specific Outage
5010Gateway Specific Outage
5013Gateway Specific Outage
5013Gateway Specific Outage
5016Gateway Specific Outage
5017Gateway Specific Outage
5021Gateway Specific Outage
6000Gateway Specific Outage
7000Gateway Specific Outage
5010Gateway Specific Outage
321Gateway Specific Outage
327Gateway Specific Outage
300Soft
301Soft
304Soft
306Soft
309Soft
315Soft
316Soft
318Soft
319Soft
323Soft
324Soft
325Soft
326Soft
340Soft

NMI

Response Element - message

MessageCategory
Time Out - VoidedGateway Specific Outage
TIMEOUT-RETRYGateway Specific Outage
General errorGateway Specific Outage
General system errorGateway Specific Outage
Issuer UnavailableGateway Specific Outage
Processor Temporarily UnavailableGateway Specific Outage
Response TimeoutGateway Specific Outage
Transaction timed outGateway Specific Outage
Issuer or switch is unavailableGateway Specific Outage
System malfunctionGateway Specific Outage
Processing Network UnavailableGateway Specific Outage
Connection errorGateway Specific Outage
Invalid transaction, Retry in 3 daysSoft
Issuer DeclinedSoft
Do Not HonorSoft
DECLINEDSoft
DeclinedSoft
Issuer Declined, Retry in 3 daysSoft
DeclineSoft
Invalid transactionSoft
Processor Error 555Soft
Invalid merchant IDSoft
CALL 18003372255Soft
AVS REJECTEDSoft
51 - DECLINEDSoft
SECURITY DENIAL - 683Soft
Authentication FailedSoft
POLICY DENIAL - 682Soft
DECLINE RETRY LATERSoft
Error Processing Transaction. Please contact customer service.Soft
Blocked, first usedSoft
Terminal not programmed for serviceSoft
Processor Error 206Soft
Transaction not allowedSoft
Processor Error 149Soft
REJECTED CONTACT CUST SERVSoft
Your request has been declined - the issuing bank has returned an unknown response. Contact the card holder's credit card company for further investigation.Soft
Processor Error 229Soft
Processor Error 218Soft
Decline - Re-try TransactionSoft
Transaction DeclinedSoft
Security violationSoft
INV TRAN TYPESoft
CALL ISSUING BANKSoft
Declined - Contact card issuerSoft
Invalid Payment TypeSoft
Canadian domestic debit not supportedSoft
57 - TRANSACTION NOT ALLOWEDSoft
Transaction received but declinedSoft
Processor Error 148Soft
Bad Bin or Host DisconnectSoft
Service Not AllowedSoft
Authorization DeclinedSoft
Call Voice CenterSoft
Call IssuerSoft
DECLINE TRY LATERSoft
Invalid MerchantSoft
The card was declined.Soft
A format error occurredSoft
Resubmit TransactionSoft
Invalid amountSoft
Transaction failed because of payment processing failure.: 754 - Authorization declined. Try a different card or contact your bank for assistanceSoft
Violation, cannot completeSoft
Re-enter transactionSoft
Terminal inactiveSoft
TRAN NOT ALLOWEDSoft
Card Type Verification ErrorSoft
Transaction failed because of payment processing failure.: 611 - Authorization declined. Try a different card or contact your bank for assistanceSoft
INVALID DATASoft
Transaction failed because of payment processing failure.: 596 - This transaction is not authorized due to restrictions by your bank. Please use a different card or contact your bank for assistanceSoft
CVV REQUIREDSoft
63 - TRANSACTION NOT ALLOWEDSoft
Invalid bankcard merchant numberSoft
INVALID AMOUNTSoft
Retry transactionSoft
Transaction not permittedSoft
DECLINED:CLOSEDSoft
Transaction failed because of payment processing failure.: 303 - This transaction has been declined. Please check card details and try again, or contact your bank for assistanceSoft
Unknown ErrorSoft
Cashback Not AppSoft
INVALID TRANSACTIONSoft
Transaction Void UnsuccessfulSoft
INVALID MRCH #Soft
Invalid merchant configurationSoft
Transaction failed because of payment processing failure.: 530 - This transaction has been declined. Please check card details and try again, or contact your bank for assistanceSoft
AVS REQUIREDSoft
Processor Error 317Soft
Transaction failed because of payment processing failure.: 613 - Authorization declined. Try a different card or contact your bank for assistanceSoft
Cannot authorizeSoft
The bank has requested that you process the transaction manually by calling the cardholder's credit card company.Soft
Invalid merchantSoft
Processor Error CAN NOT ACCEPTSoft
An error occurred while processing the card.Soft
SERV NOT ALLOWEDSoft
Crypto failureSoft
Please RetrySoft
The external processing gateway has reported a limit has been exceeded.Soft
Transaction failed because of payment processing failure.: 606Soft
Invalid requestSoft
Invalid Transaction or Other Dollar AmountSoft
Retry TransactionSoft
Cardholder's bank does not allow this type of purchaseSoft
The bank has requested that you retry the transaction.Soft
The settlement you are attempting to refund has not been batched yet. There are no settled funds available to refund.Soft

Orbital

Response Element - message

MessageCategory
No Answer / Unable to sendGateway Specific Outage
Unable to communicate with the payment system.Gateway Specific Outage
Call Voice CenterSoft
Do Not HonorSoft
Processor DeclineSoft
Invalid Transaction TypeSoft
RestraintSoft
Error validating card/account number rangeSoft
Other ErrorSoft
Invalid Amex CIDSoft
No AccountSoft
Invalid AmountSoft
Over Freq LimitSoft
Invalid Institution CodeSoft
Issuer UnavailableSoft
Revocation of AuthSoft
AUTH DECLINED 09001Soft
Error. The Orbital Gateway has received a badly formatted message. Field [AVS NAME] exceeded max length of [30]Soft
AUTH DECLINED 99001Soft
*REQUEST DENIED* 99019Soft
AUTH DECLINED 01001Soft
Bad AmountSoft
Token UnavailableSoft
Invalid MCC SentSoft

PayPal Commerce Platform

Response Element - error_code

MessageCategory
AUTHENTICATION_FAILUREGateway Specific Outage
CARD_BILLING_ADDRESS_COUNTRY_NOT_SUPPORTEDGateway Specific Outage
CARD_TYPE_NOT_SUPPORTEDGateway Specific Outage
CURRENCY_MISMATCHGateway Specific Outage
DECIMAL_PRECISIONGateway Specific Outage
DECIMALS_NOT_SUPPORTEDGateway Specific Outage
INTERNAL_SERVER_ERRORGateway Specific Outage
INVALID_ARRAY_LENGTHGateway Specific Outage
INVALID_COUNTRY_CODEGateway Specific Outage
INVALID_CURRENCY_CODEGateway Specific Outage
INVALID_FX_RATE_IDGateway Specific Outage
INVALID_INVOICE_IDGateway Specific Outage
INVALID_PARAMETER_SYNTAXGateway Specific Outage
INVALID_PARAMETER_VALUEGateway Specific Outage
INVALID_STRING_LENGTHGateway Specific Outage
INVALID_STRING_MAX_LENGTHGateway Specific Outage
MALFORMED_REQUEST_JSONGateway Specific Outage
MISSING_REQUIRED_PARAMETERGateway Specific Outage
MULTI_CURRENCY_CODEGateway Specific Outage
NOT_AUTHORIZEDGateway Specific Outage
PAYEE_ACCOUNT_INVALIDGateway Specific Outage
PERMISSION_DENIEDGateway Specific Outage
PLATFORM_FEES_NOT_SUPPORTEDGateway Specific Outage
RATE_LIMIT_REACHEDGateway Specific Outage
SHIPPING_ADDRESS_INVALIDGateway Specific Outage
CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPESoft
CURRENCY_NOT_SUPPORTED_FOR_COUNTRYSoft
INSTRUMENT_DECLINEDSoft
SHIPPING_ADDRESS_NOT_ALLOWED_BY_RESIDENCE_COUNTRYSoft
TRANSACTION_REFUSEDSoft

Stripe & Stripe PI

Stripe and StripePI are a bit more complex than the other gateways in that there is a Gateway Specific Field decline_code that is returned in responses which can be used to determine if the error code card_declined might be retryable or not.

So here we break out which codes are 'basic' and can be retried without further consideration, and those that need to be present in the decline_code GSF only when the error code is card_declined.

Generic Error Codes

Response Element - error_code

Error CodeCategory
authentication_requiredSoft
processing_errorSoft
card_decline_rate_limit_exceededSoft
amount_too_smallSoft
email_invalidSoft
charge_expired_for_captureSoft

decline_code Error Codes

Remember, these codes appear in the GSF decline_code and are considered for Recover only when the response.error_code is card_declined:

Decline CodeCategory
card_not_supportedSoft
do_not_honorSoft
generic_declineSoft
invalid_accountSoft
transaction_not_allowedSoft

Worldpay

Response Element -error_code

MessageCategory
Issuer unavailable or switch inoperative (STIP not applicable or available for this transaction)Gateway Specific Outage
Time outGateway Specific Outage
REFUSEDSoft
Do not honourSoft
Insufficient fundsSoft
Capture cardSoft
Policy reasonsSoft
Authentication requestedSoft
Gateway errorSoft
Invalid merchant or service providerSoft
Payment Method DISCOVER-SSL is unknown; The Payment Method is not available.Soft
Payment Method AMEX-SSL is unknown; The Payment Method is not available.Soft
Format errorSoft
Payment Method VISA_COMMERCIAL_CREDIT-SSL is unknown; The Payment Method is not available.Soft
Payment Method ECMC_COMMERCIAL_CREDIT-SSL is unknown; The Payment Method is not available.Soft
Payment Method DINERS-SSL is unknown; The Payment Method is not available.Soft
Unable to authoriseSoft
Transaction amount exceeds Maximum Transaction Amount set up for this merchant.Soft