Set payment methods per-subscription
Learn how to specify which payment methods are allowed for a subscription.
The subscription payment_
parameter lets you set specific payment methods on individual subscriptions. This allows more flexibility than a single default_
or less granular customer settings.
To enable payment methods, you first need to activate them in your account settings.
In some situations, there might be restrictions that prevent payment methods from being used for a subscription. For instance, a payment method might only operate in one currency, or have limitations on the amount that can be paid. Stripe doesn’t automatically select a payment method when these limitations prevent it from being used.
Manually select payment methods ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can override the payment methods that can be used to pay a subscription by changing its payment settings.
If you configured a default payment method on either the Customer or the Subscription, be sure to include it in the list of payment_
. Otherwise, that method will not be used and payment could fail.
Payment method priority ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
By default, customers can pay a subscription’s generated invoice with any of the enabled payment methods in your invoice template settings. This takes precedence over the older default_
customer setting.
If set, a subscription’s payment_
takes priority over default invoice settings, but only for that specific subscription. Payment method types are passed onto the subscription’s setup intent and invoices.
You can further specify a subscription’s default_
, or the older default_
, to prioritize which payment method is attempted.
Payment method errors ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Payment method errors can prevent a subscription from being created. This can happen when:
- You manually select a payment method but a restriction, such as supported currencies, prevents it from being used.
- A payment method isn’t activated for your account
Errors can also occur at time of payment, and Stripe can’t finalize the invoice. See invoicing payment method errors for details.
Payment method options ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Some payment methods have additional options that you can set to customize the payment experience. See the payment method options documentation for details.