Normalized response values

📘
failure_reason and network_advice_code are normalized fields managed by Spreedly that is sent in the API response. The values presented have been normalized across all supported gateways in Composer. See the associated gateway and network error code mapping below.

"gateway_response": {
              "outcome_data": {
                "failure_reason": "do_not_honor",
                "network_advice_code": "stop_recurring_payment"
            },         
  							"raw_payment_outcome_data": {
                  "processor_decline_code": "GENERAL_DECLINE",
                  "processorInformation.merchantAdvice.code": "21"
            }
        },

failure_reason

group_name	spreedly_field_name	spreedly_value	error_type	description	Adyen: refusalReason	Authorize.net: errors.error.errorCode	Braintree: processor-response-code	Checkout V2: response_code	Cybersource Rest: errorInformation.reason	PayPal Commerce Platform (PPCP): details.issue	Stripe PI: decline_code	Worldpay: iso8583_return_code_code
outcome_data	failure_reason	incorrect_address	hard	Address verification failed	AVS Declined	27, 217	2059	20107, 20193, 50491	AVS_FAILED	SHIPPING_ADDRESS_INVALID, BILLING_ADDRESS_INVALID, INVALID_PICKUP_ADDRESS, MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED, MISSING_PICKUP_ADDRESS	incorrect_zip	N7
		contact_bank	hard	Hard errors originating from the issuing bank		3, 170, 171, 172, 173, 174	2044, 2041, 2043, 2020	20001, 20002, 20046, 200A4, 200A5, 200A6	CONTACT_PROCESSOR	PAYMENT_SOURCE_INFO_CANNOT_BE_VERIFIED, PAYMENT_SOURCE_CANNOT_BE_USED	call_issuer, do_not_try_again, no_action_taken	60, 70, 01
		expired_card	hard	Card expiry information is incorrect	Expired Card	8, 201, 317, E00018	2004	20054, 30033	EXPIRED_CARD	CARD_EXPIRED	expired_card, invalid_expiry_month, invalid_expiry_year	54, 101
		processor_declined	soft	Card was declined by issuing bank but can retry	Transaction blocked by Adyen to prevent excessive retry fees	19, 20, 21, 22, 23, 25, 26, 41, 44, 45, 48, 57, 58, 59, 60, 61, 62, 63, 66, E00053, E00136	2038	20004, 20104, 20182, 50001, 50002, 50005, 50020, 50021, 50022, 50023, 50025, 50030, 50070, 50100, 50150, 50180, 50240, 50260, 50399, 50401, 50402, 50403, 50404, 50406, 50407, 50408, 50409, 50410, 50441, 50451, 50452, 50453, 50454, 50471, 50481, 50492, 50494, 50499, 50501, 50513, 50531, 50599	PROCESSOR_DECLINED	INSTRUMENT_DECLINED, PAYMENT_SOURCE_DECLINED_BY_PROCESSOR	processing_error
		insufficient_funds	soft	Not enough funds to cover transaction amount	Not enough balance		2001	20051, 50003, 50280	INSUFFICIENT_FUND		insufficient_funds	51, 116
		lost_stolen_card	hard	Card has been reported lost or stolen		4	2012, 2013, 2047, 2053	30004, 30007, 30035, 30037, 30041, 30043	STOLEN_LOST_CARD		pickup_card, stolen_card, restricted_card, lost_card	41, 43, 04, 07, 200
		issuer_unavailable	hard	Submitted card number does not correlate to an existing card-issuing bank or that there is a connectivity error with the issuer.	Issuer Unavailable		2009	20091, 20096, 30015, 30016	ISSUER_UNAVAILABLE		issuer_not_available	15, 91, 912
		incorrect_cvv	hard	Card verification value failed validation	CVC Declined	44, 165, 312	2060, 2010	20082, 20087, 20124, 200N7	CVN_NOT_MATCH, INVALID_CVN, CV_FAILED		incorrect_cvc, invalid_cvc	82, N7
		card_limit_exceeded	soft	Credit limit or activity limit exceeded	Withdrawal amount exceeded, Withdrawal count exceeded		2002, 2003	20061, 20065, 30021, 30022, 50101, 50102, 50103, 50104, 50105, 50106, 50514, 50515, 50517, 200P1, 200P9	EXCEEDS_CREDIT_LIMIT	MAX_VALUE_EXCEEDED, TRANSACTION_LIMIT_EXCEEDED, TRANSACTION_RECEIVING_LIMIT_EXCEEDED, MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED	card_velocity_exceeded, withdrawal_count_limit_exceeded	61, 65
		fraud_suspected	hard	Fraud suspected or security violation	Acquirer Fraud, FRAUD, FRAUD-CANCELLED, Issuer Suspected Fraud	128, 130, 131, 132, 141, E00054, E00056, E00057, E00096, E00104, E00116, E00118	2085, 2014, 2077, 2021	20059, 20063, 20105, 20183, 30034, 40101, 40201, 40202, 40203, 40204, 40205	BLACKLISTED_CUSTOMER, SUSPENDED_ACCOUNT, DECISION_PROFILE_REJECT, SCORE_EXCEEDS_THRESHOLD, DECISION_PROFILE_REVIEW, CUSTOMER_WATCHLIST_MATCH, ADDRESS_COUNTRY_WATCHLIST_MATCH, EMAIL_COUNTRY_WATCHLIST_MATCH, IP_COUNTRY_WATCHLIST_MATCH	COMPLIANCE_VIOLATION, TRANSACTION_BLOCKED_BY_PAYEE, PAYEE_BLOCKED_TRANSACTION	merchant_blacklist, fraudulent, security_violation	59, 83, 59, 63
		invalid_account	hard	Submitted card number is invalid or account does not exist	Invalid Card Number, No checking account available on Card, No savings account available on Card	6, 7, 10, 37, 200, E00081, E00124	2005, 2007, 2075	20014, 20101, 50405	INVALID_ACCOUNT	INVALID_ACCOUNT_STATUS, INVALID_PAYER_ID, PAYEE_ACCOUNT_INVALID	invalid_account, invalid_number, incorrect_number	14, 111, 78
		do_not_honor	soft	The customer's bank is unwilling to accept the transaction	Declined Non Generic	2, 261	2000, 2046, 2105, 2106	20005, 20012, 20179	GENERAL_DECLINE		generic_decline, do_not_honor, reenter_transaction, try_again_later	79, 05
		cardholder_authentication_required	soft	The customer's bank declined the transaction because a 3D Secure authentication was not successfully completed	Authentication required, 3DS Authentication Error	117, 118, E00007, E00008	2099	20151, 20152, 20153, 20154, 20155, 20159	PENDING_AUTHENTICATION, CONSUMER_AUTHENTICATION_REQUIRED, CONSUMER_AUTHENTICATION_FAILED	CONSENT_NEEDED	authentication_required	1A
		closed_card	hard	Account is closed	Blocked Card		2108	20108, 30046, 50466		CARD_CLOSED, PAYEE_ACCOUNT_LOCKED_OR_CLOSED	new_account_information_available	46
		transaction_not_allowed	hard	Transaction was denied, refer to the gateway for more details	Transaction Not Permitted	48, 50, 56, 67, 87, E00128	2074, 2015, 2019, 2018, 2076, 2070, 2107	20057, 20093, 20103, 30017, 30018, 30019		PERMISSION_DENIED, PERMISSION_DENIED_FOR_DONATION_ITEMS	card_not_supported, not_permitted, revocation_of_all_authorizations, revocation_of_authorization, service_not_allowed, stop_payment_order, transaction_not_allowed	57, 12, 93
		invalid_merchant_configuration	soft	Invalid merchant configuration, refer to the gateway for more details		43, 87, 185, 227, E00122, E00010	2026, 2068	20003, 20157, 50200				77, 76, 03
		restricted_card	soft	Issuer or Cardholder has put a restriction on the card.	Restricted Card		2057	20062, 30036		PAYER_ACCOUNT_RESTRICTED	restricted_card	62
		amount_not_supported	soft	The authorized amount is set to zero, is unreadable, or exceeds the allowable amount	Invalid Amount	5, 47, 49, E00031	2048	20013, 30020, 50511, 50512		AMOUNT_MISMATCH, PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH, CANNOT_BE_NEGATIVE, CANNOT_BE_ZERO_OR_NEGATIVE	invalid_amount
		currency_not_supported	soft		Not supported	39, 225, 226, 227, 228, 231, 232, 233, 240		20106		CURRENCY_NOT_SUPPORTED, MULTI_CURRENCY_ORDER	currency_not_supported
		duplicate_transaction	soft	The gateway flagged the transaction as a duplicate		11, 222, 318, E00012, E00039	2016, 2069			PUI_DUPLICATE_ORDER, DUPLICATE_INVOICE_ID	duplicate_transaction

network_advice_code

group_name	spreedly_field_name	spreedly_value	Adyen: additionalData.merchantAdviceCode	Braintree: merchant-advice-code	Checkout V2: processing.partner_merchant_advice_code	Cybersource Rest: processorInformation.merchantAdvice.code	Worldpay: mac
outcome_data	network_advice_code	new_account_information_available	01 : New account information available	01	01 : Updated or additional information required	01, 3	01
		cannot_approve_at_this_time_try_again_later	02 : Cannot approve at this time, try again later	02	02 : Try again later	02, 2	02
		do_not_try_again	03 : Do not try again	03	21 : Do not try again	03, 1	03
		token_not_supported	04 : Token requirements not fulfilled for this token type	04	04 : Token requirements not fulfilled for this token type	04	04
		stop_recurring_payment	21 : Payment Cancellation ; Revocation Of Auth	21	03 : One of:account closed; suspected fraud; recurring agreement canceled	21	21
		merchant_not_enrolled		22		22	22
		retry_after_1_hour	24 : Retry after 1 hour	24	24 : Retry after one hour	24	24
		retry_after_24_hours	25 : Retry after 24 hours	25	25 : Retry after 24 hours	25	25
		retry_after_2_days	26 : Retry after 2 days	26	26 : Retry after two days	26	26
		retry_after_4_days	27 : Retry after 4 days	27	27 : Retry after four days	27	27
		retry_after_6_days	28 : Retry after 6 days	28	28 : Retry after six days	28	28
		retry_after_8_days	29 : Retry after 8 days	29	29 : Retry after eight days	29	29
		retry_after_10_days	30 : Retry after 10 days	30	30 : Retry after 10 days	30	30
		non_reloadable_prepaid_card	40 : Consumer non-reloadable prepaid card	40	40 : Non-reloadable prepaid card	40	40
		single_use_virtual_card_number	41 : Consumer single-use virtual card number	41	41 : Single-use virtual card number	41	41
		refused_due_to_sanctions	42 : Score Exceeds Applicable Threshold Value	42	42 : Sanction score exceeds applicable threshold value	42	42

📘failure_reason and network_advice_code are normalized fields managed by Spreedly that is sent in the API response. The values presented have been normalized across all supported gateways in Composer. See the associated gateway and network error code mapping below.

failure_reason

network_advice_code

📘
failure_reason and network_advice_code are normalized fields managed by Spreedly that is sent in the API response. The values presented have been normalized across all supported gateways in Composer. See the associated gateway and network error code mapping below.