Private preview

Gift card decline codes Private preview

Learn about gift card decline codes and how to resolve them when a charge or operation fails.

Private preview

Request access to the Gift card private preview by contacting your Account Executive or by sending an email to with the following information:

Use case for in-person and/or online gift card acceptance
Terminal device and integration type
Gift card provider
Country/countries where gift cards will be accepted
Estimated annual gift card transaction volume

Gift cards use a subset of the Stripe decline codes. Our decline codes expand on issuer decline codes by going into more detail about the specific reason for the decline.

Decline codes

Decline code	Description

`card_already_activated`	The card has already been activated. Retries won’t succeed.
`currency_not_supported`	The payment provider doesn’t support this currency. Retries won’t succeed.
`do_not_honor`	The card was declined for an unknown reason. The customer needs to contact their card issuer for more information.
`expired_card`	The card registered with the payment provider has expired. Retry attempts might succeed after the customer takes action to resolve the issue with their account.
`fraudulent`	The payment was declined because the partner suspects that it’s fraudulent. Don’t report more detailed information to your customer. Instead, present it as a `partner_generic_decline`.
`incorrect_number`	The card number is incorrect. The customer needs to try again using the correct card number.
`insufficient_funds`	The customer needs to use an alternative payment method.
`invalid_account`	The card, or account the card is connected to, is invalid. The customer needs to contact their card issuer to check that the card is working correctly.
`invalid_amount`	The payment provider doesn’t allow the amount. Retries won’t succeed.
`invalid_pin`	The PIN entered is incorrect. The customer needs to try again using the correct PIN.
`invalid_track_data`	The card data is invalid. The customer needs to contact their card issuer to check that the card is working correctly.
`lost_card`	The payment was declined because the card is reported lost. Don’t report the specific reason for the decline to the customer. Instead, present it as a `partner_generic_decline`.
`lost_or_stolen_card`	The payment was declined because the card is reported lost or stolen. Don’t report the specific reason for the decline to the customer. Instead, present it as a `partner_generic_decline`.
`online_or_offline_pin_required`	The card was declined because it requires a PIN. If the card reader supports Online PIN, prompt the customer for a PIN without creating a new transaction. If the card reader doesn’t support Online PIN, the customer needs to insert their card and enter a PIN.
`partner_action_not_supported`	The payment provider doesn’t support this action. Retries won’t succeed.
`partner_generic_decline`	The payment provider has declined the payment.
`pin_try_exceeded`	The allowable number of PIN tries was exceeded. The customer must use another card or method of payment.
`processing_error`	The payment provider encountered a processing error.
`stolen_card`	The payment was declined because the card is reported stolen. Don’t report more detailed information to your customer. Instead, present it as a `partner_generic_decline`.
`try_again_later`	The card was declined for an unknown reason. The customer can try again later.