Enable Remember Me
Beta

Last updated: October 6, 2025

Information

Remember Me is available globally, with some exclusions. To enable Remember Me, contact your account manager or request support.

The Remember Me feature enables customers to save their card details during checkout. The next time the customer shops at any merchant that has Remember Me enabled, we display their saved card details.

This means you can provide a faster checkout experience even if the customer did not save their details directly with you.

Remember Me supports both customer-initiated transactions (CITs) and merchant-initiated transactions (MITs).

If you use Remember Me to store your customer payment details in the following scenarios, you automatically receive the payment instrument ID in the payment response:

CITs performed with your existing saved card-on-file system.
For more information, see the store_payment_details field reference.
MITs that your process with Flow. For example, if the payment_type is recurring, installment, or unscheduled.
For more information, see the payment_type field reference.

When a customer chooses to save their card details during checkout we save and link their following details:

Email address
Payment details
Phone number

The next time the customer shops with a merchant that enabled Remember Me:

Checkout.com uses the email address the customer provided to detect if they have previously saved their details.
We send them a one-time code to securely verify their identity and authenticate their session.
If successful, we display their saved card details to provide a faster checkout experience.

Customers can manage their saved details and view their purchase history on their personal dashboard.

Information

Remember Me's authentication does not replace any additional payment authentication required by the issuer, scheme, or merchant. For example, 3D Secure authentication.

Information

To test your Remember Me integration in the sandbox environment, request your one-time password (OTP) to be sent via email when prompted.

To enable Remember Me in your production environment, contact your account manager or request support.

For new customers, you must provide the customer.email to display the option to sign up for Remember Me on the checkout screen. You can:

Provide the customer.email field when you Request a Payment Session. Recommended if you already collect the customer email in your payment journey.
Collect the customer email using Flow. Recommended if you do not collect the customer email in your payment journey.

To provide a better experience for returning customers, we recommend that you also request the customer's phone number during sign up. You can use the customer.email or customer.phone they provide when they return to display the option to retrieve their saved payment details.

Information

Providing a placeholder email for returning customers in the request can lead to issues with customer retrieval. If your process relies on placeholder emails, contact your account manager or request support.

post

https://api.checkout.com/payment-sessions


1{
2 "amount": 1000,
3 "currency": "GBP",
4 "reference": "ORD-123A",
5 "billing": {
6   "address": {
7     "country": "GB"
8   }
9 },
10 "customer": {
11   "name": "Jia Tsang",
12   "email": "[email protected]",
13   "phone": {
14     "country_code": "+44",
15     "number": "7700900000"
16   }
17 },
18 "success_url": "https://example.com/payments/success",
19 "failure_url": "https://example.com/payments/failure"
20}


1{
2 "id": "ps_2Un6I6lRpIAiIEwQIyxWVnV9CqQ",
3 "payment_session_secret": "pss_9823241e-2cec-4c98-b23d-7b29ow4e2e34",
4 "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzJVbjZJNmxScElBaUlFd1FJeXhXVm5WOUNxUSIsImFtb3VudCI6MTAwMCwibG9jYWxlIjoiZW4tR0IiLCJjdXJyZW5jeSI6IkdCUCIsInBheW1lbnRfbWV0aG9kcyI6W3sidHlwZSI6ImNhcmQiLCJjYXJkX3NjaGVtZXMiOlsiVmlzYSIsIk1hc3RlcmNhcmQiLCJBbWV4Il19XSwicmlzayI6eyJlbmFibGVkIjp0cnVlfSwiX2xpbmtzIjp7InNlbGYiOnsiaHJlZiI6Imh0dHBzOi8vYXBpLnNhbmRib3guY2hlY2tvdXQuY29tL3BheW1lbnQtc2Vzc2lvbnMvcHNfMlVuNkk2bFJwSUFpSUV3UUl5eFdWblY5Q3FRIn19fQ==",
5 "_links": {
6   "self": {
7     "href": "https://api.sandbox.checkout.com/payment-sessions/ps_2Un6I6lRpIAiIEwQIyxWVnV9CqQ"
8   }
9 }
10}

When Initializing Flow for mobile, and rendering a card component, provide the rememberMeConfiguration options:


1val rememberMeConfiguration = RememberMeConfiguration(
2    data = RememberMeConfiguration.Data(
3        email = "[email protected]",
4        phone = Phone(countryCode = "44", number = "7700900000")
5    ),
6    showPayButton = true
7)
8
9val componentOption = ComponentOption(
10    showPayButton = true,
11    rememberMeConfiguration = rememberMeConfiguration
12)
13
14val cardComponent = checkoutComponentsSDK.create(
15    PaymentMethodName.Card,
16    componentOption
17)

For new customers, you must provide the customer.email to display the option to sign up for Remember Me on the checkout screen. You can:

Provide the customer.email field when you Request a Payment Session. Recommended if you already collect the customer email in your payment journey.
Collect the customer email using Flow. Recommended if you do not collect the customer email in your payment journey.

Information

post

https://api.checkout.com/payment-sessions


1{
2 "amount": 1000,
3 "currency": "GBP",
4 "reference": "ORD-123A",
5 "billing": {
6   "address": {
7     "country": "GB"
8   }
9 },
10 "customer": {
11   "name": "Jia Tsang",
12   "email": "[email protected]",
13   "phone": {
14     "country_code": "+44",
15     "number": "7700900000"
16   }
17 },
18 "success_url": "https://example.com/payments/success",
19 "failure_url": "https://example.com/payments/failure"
20}


1{
2 "id": "ps_2Un6I6lRpIAiIEwQIyxWVnV9CqQ",
3 "payment_session_secret": "pss_9823241e-2cec-4c98-b23d-7b29ow4e2e34",
4 "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzJVbjZJNmxScElBaUlFd1FJeXhXVm5WOUNxUSIsImFtb3VudCI6MTAwMCwibG9jYWxlIjoiZW4tR0IiLCJjdXJyZW5jeSI6IkdCUCIsInBheW1lbnRfbWV0aG9kcyI6W3sidHlwZSI6ImNhcmQiLCJjYXJkX3NjaGVtZXMiOlsiVmlzYSIsIk1hc3RlcmNhcmQiLCJBbWV4Il19XSwicmlzayI6eyJlbmFibGVkIjp0cnVlfSwiX2xpbmtzIjp7InNlbGYiOnsiaHJlZiI6Imh0dHBzOi8vYXBpLnNhbmRib3guY2hlY2tvdXQuY29tL3BheW1lbnQtc2Vzc2lvbnMvcHNfMlVuNkk2bFJwSUFpSUV3UUl5eFdWblY5Q3FRIn19fQ==",
5 "_links": {
6   "self": {
7     "href": "https://api.sandbox.checkout.com/payment-sessions/ps_2Un6I6lRpIAiIEwQIyxWVnV9CqQ"
8   }
9 }
10}

When Initializing Flow for mobile, and rendering a card component, provide the rememberMeConfiguration options:


1let rememberMeConfiguration: CheckoutComponents.RememberMeConfiguration = {
2  let data = CheckoutComponents.RememberMeConfiguration.Data(
3    email: "[email protected]",
4    phone: CheckoutComponents.Phone(countryCode: "44", number: "7700900000")
5  )
6  return .init(data: data, showPayButton: true)
7}()
8
9try checkoutComponentsSDK.create(
10  .card(
11    ...
12    rememberMeConfiguration: rememberMeConfiguration
13    ...
14  )
15)

Enable Remember Me
Beta

Information

Customer experience

Information

Add Remember Me to your integration

Information

Information

Request example

Response example

Information

Request example

Response example