Library
List of Errors
The payment method could not be processed due to country or MCC restrictions, or because the card failed screening checks (e.g., prepaid card not supported). Please review the gateway configuration to ensure the payment method is properly configured for the country and transaction type.

Recommended Customer Message

The selected payment method is not supported for your country or the type of transaction. Please use a different payment method or contact customer support for assistance.

Description

The payment failed because the payment method is not supported in the customer's region or for the transaction type. This error occurs due to country or regional restrictions, merchant category restrictions, unsupported card types, or gateway configuration limitations.

Recommended Customer Message

Your selected payment method is not supported in your region. Please use a different payment method to complete your transaction.

Root Cause

  • Country or regional restrictions: The selected payment method is not supported in the customer's country or region.
  • Merchant category restrictions: The payment method is restricted based on the type of business or transaction category.
  • Unsupported card type: The selected payment method involves a card type that is not accepted (e.g., prepaid or gift cards).
  • Gateway configuration limitations: The payment gateway settings do not allow the selected payment method for the specified country or transaction type.

Troubleshooting and Solutions

  • Ask the customer to try using a different payment method supported in their country or region.
  • Verify that the payment gateway configuration supports the selected payment method for the target country and transaction type.
  • Review and update the gateway settings to allow the required payment methods if applicable.
  • Inform the customer about the supported payment methods available for their region at checkout.
  • Contact the payment gateway provider if the issue persists despite correct configuration.