Stripe Checkout offers Link – a one-click payment option to let customers securely save and reuse their payment information. However, if you need to save a payment method to charge it off-session or you prefer to manage saved payment methods yourself, you will need to save the payment method to a Customer. Allow_redisplay is a parameter on the PaymentMethod object to help you model whether you've received consent from the customer to prefill saved card information on return purchases.
Whether and how a payment method is saved will depend on the mode that you use in Checkout.
allow_redisplay: limited
and will not be prefilled on return purchases. Alternatively, you can let customers choose whether to save their card information for return purchases by using saved_payment_method_options.payment_method_save. Using this parameter will show an additional tickbox on the Checkout page that the customer can check to optionally save their payment information. Cards saved when the tickbox is ticked will be saved with allow_redisplay: always
and will be prefilled for returning customers. allow_redisplay: limited
and will not be prefilled for return purchases. You can use saved_payment_method_options.payment_method_save to let customers save their payment method and prefill it on return purchases. allow_redisplay: always
and will be prefilled when passing in a Customer object into a Checkout Session. This default behaviour is to make it simpler for you to comply with card network rules and data protection regulations. If you need to change the default behaviour enabled by these modes, you can use the following methods:
allow_redisplay
value on the payment method: You can use the PaymentMethod API to change the allow_redisplay value that is set on the payment method. allow_redisplay
value set through Checkout: You can use payment_method_data.allow_redisplay to override the allow_redisplay value that is set for payment methods saved through Checkout. allow_redisplay: always
. You can use saved_payment_method_options.allow_redisplay_filters to determine whether to also show payment methods with allow_redisplay: limited
or unspecified
.Global privacy laws are complicated and nuanced. We recommend talking to your legal and privacy team before implementing setup_future_usage or overriding Checkout’s default behaviours for saving and redisplaying payment methods as it may implicate your privacy compliance framework. As an example, the European Data Protection Board has issued guidance regarding saving payment details. Learn how to configure Checkout to collect consent and save payment methods for future use here.
If you created a Stripe account before 18 April, payment methods previously saved through Checkout have been backfilled with the appropriate allow_redisplay
value.
From 1 May 2024, Checkout no longer displays saved cards with allow_redisplay: limited
or unspecified
to returning customers. If you have any questions about this change please contact support.
Upcoming improvements to saved payment methods on Checkout