The “Remember Me” feature in Ivy’s Checkout enables returning users to skip bank selection and data entry when paying with the same bank again. This improves returning user experience and boosts conversion rates.

First Time Flow

Recurring Flow

Customer Recognition

Ivy will recognize returning users wherever possible. However, you can guarantee that your returning users will get the smoothest checkout experience possible by either:
  1. Passing the same customer email each time you Create a Checkout Session:
Make sure to pass the email address in the customer.email field, not in the prefill section. This ensures proper customer recognition for the Remember Me feature.
POST /api/checkout/session/create
{
  "price": {
    "totalNet": 100,
    "vat": 19,
    "total": 119,
    "currency": "EUR"
  },
  "referenceId": "my-unique-checkout-reference-id",
  "successCallbackUrl": "https://my-website.com/success",
  "errorCallbackUrl": "https://my-website.com/try-again",
  "...": "...",
  "customer": {
    "email": "[email protected]"
  }
}
  1. Creating a customer upfront, storing the Ivy customer id in your backend and passing it during each Checkout Session creation:
POST /api/customer/create
{
  "email": "[email protected]"
}

// Response
{
"id": "2efc91d2-6680-4285-ba16-a49bd18fd711", // <- Use this ID during Checkout creation
"merchantId": "<your merchantId>",
"email": "[email protected]"
}
POST /api/checkout/session/create
{
  "price": {
    "totalNet": 100,
    "vat": 19,
    "total": 119,
    "currency": "EUR"
  },
  "referenceId": "my-unique-checkout-reference-id",
  "successCallbackUrl": "https://my-website.com/success",
  "errorCallbackUrl": "https://my-website.com/try-again",
  "...": "...",
  "customer": {
    "id": "2efc91d2-6680-4285-ba16-a49bd18fd711" // <- ID from customer creation
  }
}