Settings
API Version
Product Catalog
Library
Configure SDK
Home
Business Entities
Customers
Subscriptions
In App Purchases - Legacy
Omnichannel
Invoices and Credit Notes
Estimates
Orders
Product Catalog
Entitlements
Usage Based Billing
Hosted Pages
Payments
Currencies
Events
Simulation Tools
List of Errors
gateway
gateway.payment_method.not_supported
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.
Root Cause
- Country or regional restrictions: The selected payment method is not supported in the customer’s country or region.
- Merchant category code (MCC) 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.
- Ask the customer to 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.