Library
List of Errors
We encountered an issue processing your transaction, possibly due to a problem with the customer’s card or a temporary issue at their bank. Please advise the customer to retry the transaction. If the decline continues, kindly request a different card or payment method.

Recommended Customer Message

There may be an issue with your card or a temporary problem at your card-issuing bank. Please try the transaction again. If the decline persists, please use a different card or payment method.

Description

The payment failed because the transaction is invalid. This error occurs when the transaction type is not supported, the card issuer is unavailable, the card has restrictions, or there are issues with the transaction parameters.

Recommended Customer Message

Your payment could not be processed. Please verify your payment details and try again, or use a different payment method.

Root Cause

  • Invalid or unsupported transaction type: The transaction attempted is not supported by the payment gateway or the card network.
  • Card issuer temporarily unavailable: The bank's systems may be experiencing downtime or unable to authorize the transaction at the moment.
  • Card issues or restrictions: The customer's card may be blocked, expired, or not authorized for the attempted transaction type (e.g., international transactions).

Troubleshooting and Solutions

  • Advise the customer to contact their bank for clarification and to ensure their card is properly configured for the type of purchase.
  • Suggest using an alternative payment method if the issue persists.
  • Ensure that all required transaction parameters are correctly provided in the API or payment request.
  • If the problem continues, contact the payment gateway support team to investigate any potential configuration or compatibility issues.