payment_method_not_availablehighAffects MRR

Stripe payment_method_not_available Error — Causes, Fix & MRR Impact

The Stripe payment_method_not_available error occurs when the selected payment method is not available for this transaction (e.g. currency or country), causing the charge to fail and MRR risk for SaaS businesses processing subscription payments.

What this means

The chosen payment method cannot be used for this payment (e.g. currency or region). The customer should select another payment method that is available.

Why it happens

Currency not supported by method

The payment method (e.g. certain cards or local methods) does not support the charge currency.

Country or region restriction

The method is not available for the customer's country or your business's region.

Context not supported

The method cannot be used for this type of charge (e.g. recurring, one-time, invoice).

Method no longer valid

The payment method was removed, expired, or is no longer supported by Stripe for this context.

MRR Impact

Unavailable method causes failed charges; offering alternative methods and checking availability upfront protects MRR.

Offering available payment methods and clear switching protects MRR.

Avg. recovery rate: Good when you surface other available methods and make switching easy.

Urgency: within 24h

How to fix it

  1. 1

    Check method availability before charge

    When creating a PaymentIntent or Subscription, ensure the payment method is valid for the currency and context. Use Stripe's documentation or API to filter payment methods by capability.

  2. 2

    Show clear message

    Tell the customer this payment method is not available for this payment and ask them to choose another (e.g. different card, ACH, SEPA). List or link to available methods.

  3. 3

    Offer alternative payment methods

    Provide a way to add or select another payment method (e.g. card, bank debits) that is supported for their country and currency.

  4. 4

    Do not retry same method

    Do not retry with the same payment method; it will keep failing. Only retry after the customer has selected an available method.

  5. 5

    Filter methods in UI

    In your payment method selector, only show methods that are available for the current currency and country to reduce this error.

Detect payment_method_not_available automatically

Track payment_method_not_available; use to add or promote payment methods for affected regions.

Monitor your Stripe health free →

FAQ

What does Stripe payment_method_not_available mean?
payment_method_not_available means the payment method (e.g. card, bank) is not available for this request (e.g. not supported for this currency, country, or context). For SaaS, prompt the customer to choose a different payment method or add one that is available for their region and currency.
Should I retry payment_method_not_available?
Retrying with the same payment method usually will not help. The method is not available for this use case. Offer another payment method (e.g. different card, ACH, SEPA) that is supported for the customer's country and currency.
How do I prevent this error?
When collecting payment methods, only show or suggest methods that are available for the customer's country and currency. Use Stripe's capabilities and method availability APIs to filter options.
Does this affect MRR?
Yes. If the customer cannot pay with their chosen method, they may churn. Offering multiple methods and checking availability upfront protects MRR.

Related errors

currency_not_supported

The Stripe currency_not_supported error occurs when the card does not support the currency in which the charge was made, causing the decline and MRR risk for SaaS businesses processing subscription payments.

Affects MRRcard_not_supported

The Stripe card_not_supported error occurs when the card does not support the type of purchase (e.g. recurring or international), causing the charge to be declined and MRR risk for SaaS businesses processing subscription payments.

Affects MRRaccount_closed

The Stripe account_closed error occurs when the customer's account (e.g. bank or card account) is closed, causing the payment method to be invalid and MRR risk for SaaS businesses processing subscription payments.

Affects MRR