These are the failure messages of payment:
error_code is the code returned by the card processor, passed through as-is. It can hold several codes separated by , (for example issuer_declined, insufficient_funds), and can be a code that isn't in this table; in that case error_message is Generic reason - user should contact their bank. Branch on status: failed, and treat error_code as informational.
| error_code | error_message | description |
|---|---|---|
genericgeneric_declinetransaction_not_allowedrule | Generic reason - user should contact their bank | We're sorry, the card was declined. Please try again or use another card. |
authentication_failedpayment_intent_authentication_failure | Authentication failed | We're sorry, the payment was declined because authentication failed. Please try again |
insufficient_funds | Insufficient funds | We're sorry, the card was declined due to insufficient funds. Please try again. |
issuer_declinedcontact_card_issuerdo_not_honor | User's bank declined the payment | We're sorry, your bank has declined this payment. Please contact your bank to unblock this payment or try a different card. |
timeouttry_again_later | Failed connection - user should try again | We're sorry, something went wrong and we weren't able to process your payment. Please try again or contact us for support at [email protected]. |
invalid_card | Invalid card details | We're sorry, the card number is invalid. Please try again. |
expired_card | Expired card | We're sorry, this card is expired. Please try another card. |
tabby_rejected | Tabby rejected | Sorry, Tabby is unable to approve this purchase. Please use an alternative payment method for your order. |
retry_limit_exceeded | Too many failed attempts | We're sorry, there's a limit to the number of payment attempts per day. Please try again tomorrow or contact us for support at [email protected]. |
duplicate_payment | Duplicate payment | We're sorry, the card was declined because there was a similar payment charged recently. Please try a different card or contact your bank to unblock this payment. |
invalid_bin | Card issued by a non-supported bank | We're sorry, this card is issued by a bank which is not supported. Please try again with a different card. |
invalid_expiry | Invalid expiry | We're sorry, the card expiry date is invalid. Please try again. |
incorrect_verification_code | Incorrect CVC/CVV | We're sorry, the card was declined because the CVC/CVV number is incorrect. Please try again. |
cvv2_failureinvalid_amex_cvv | Incorrect CVV | We're sorry, the card was declined because the CVV number is incorrect. Please try again. |
tabby_minimum | Below Tabby minimum amount | The minimum payment amount to use Tabby is AED 10. Please try an alternative payment method. |
not_supported_card | Card not supported | This card is not supported. Please use a different card. |
subscriptions_card_not_supported | Card not supported for subscriptions | This card is not supported. Please use a different card. |
authentication_expired | User didn't complete authentication | The payment was declined because authentication wasn't completed successfully. Please try again. |
risk_blocked_transactionrisk_recaptcha_blocked_transaction | High-risk payment | We're sorry, the card was declined. Please try again or use another card. |
avs_mismatch | Billing address mismatch | The billing address is incorrect. Please try again. |
currency_not_allowed_for_link | Currency not supported | This currency is not supported for this payment. |
risk_blocked_transactionrisk_recaptcha_blocked_transaction | High-risk payment | We're sorry, the card was declined. Please try again or use another card. |
avs_mismatch | Billing address mismatch | The billing address is incorrect. Please try again. |
currency_not_allowed_for_link | Currency not supported | This currency is not supported for this payment. |