Use saved payment methodsBeta
Allow returning customers to reuse saved payment methods during checkout.
Private preview
The Custom Checkout integration is in private preview. To request access, click here.
Note
Custom Checkout support for saved payment methods only includes cards. It doesn’t support other saved payment methods, such as bank accounts.
Identify your Customer
Each saved payment method is linked to a Customer object. Before creating the Checkout Session, authenticate your customer, and pass the corresponding Customer ID to the Checkout Session.
Render payment methods
Use the savedPaymentMethods array on the front end to render the customer’s available payment methods.
Note
The savedPaymentMethods
array includes only the payment methods that have allow_redisplay set to always
. Follow the steps to collecting consent from your customer, which ensures that allow_
is properly set.
Confirm with a saved payment method
When your customer has selected a saved payment method and is ready to complete checkout, call confirm, passing in the paymentMethod ID.