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 checkbox on the Checkout page that the customer can check to optionally save their payment information. Cards saved when the checkbox is checked 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 behavior is to make it simpler for you to comply with card network rules and data protection regulations. If you need to change the default behavior 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 with your legal and privacy team prior to implementing setup_future_usage or overriding Checkout’s default behaviors 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 April 18, payment methods previously saved through Checkout have been backfilled with the appropriate allow_redisplay
value.
Starting May 1, 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