Library
List of Errors
This response generally indicates that there is a problem with the submitted card. Please advise the customer to use an alternative payment method.

Recommended Customer Message

There was an issue processing your card. Please try a different payment method or contact your card issuer for help.

Description

The payment failed because the card is not supported for setup or verification transactions. This error occurs when the card is not eligible for setup transactions, has restrictions from the issuer, is invalid or inactive, or the gateway does not support the card type for setup.

Recommended Customer Message

Your card could not be set up for payments. Please try a different card or payment method.

Root Cause

  • Unsupported card for setup: The card provided is not eligible for setup or verification transactions required by the payment gateway.
  • Card restrictions: The card issuer has blocked or restricted the card from being used for setup or tokenization purposes.
  • Invalid card status: The card is inactive, expired, or otherwise invalid for new setups.
  • Gateway limitations: The gateway does not support the card type for setup or zero-amount authorization transactions.

Troubleshooting and Solutions

  • Ask the customer to try using a different, supported payment method.
  • Verify that the card is active, valid, and eligible for setup or tokenization.
  • Review the gateway documentation to confirm supported card types for setup transactions.
  • Contact the payment gateway support team if the issue persists despite using a valid card.
  • Clearly inform customers during setup about acceptable card types and any limitations.