Explore the Link Authentication Element

Create a single email input for both email collection and Link authentication.

Create a single email input for both email collection and Link authentication by adding the Link Authentication Element to your Elements integration. If your customer doesn’t have a Link account, and they select one of its supported payment methods (credit card, debit card, or US bank), they’re given the option of signing up.

Alternatively, if your customer already has a Link account, it authenticates them with a one-time-password, then automatically fills their payment details in the Payment Element.

Use the Link Authentication Element as part of your checkout page

Add the Link Authentication Element

Put the Link Authentication Element at the beginning of the checkout page, followed by the Address Element (optional), then the Payment Element. The following code creates an instance of the Link Authentication Element and mounts it to the DOM:

checkout.js
// Enable the skeleton loader UI for the optimal loading experience.
const loader = 'auto';

// Create an elements group from the Stripe instance passing in the clientSecret and enabling the loader UI.
const elements = stripe.elements({clientSecret, loader});

// Create an instance of the Link Authentication Element optionally prefilling a customer's email address.
const linkAuthenticationElement = elements.create("linkAuthentication", {defaultValues: {email: "foo@bar.com"}});

// Passing in defaultValues is optional, but useful if you want to prefill customer information to simplify the customer experience.
const paymentElement = elements.create('payment', {
  defaultValues: {
    billingDetails: {
      name: 'John Doe',
      phone: '888-888-8888',

linkAuthenticationElement renders an email address input. When Link matches a customer email with an existing Link account, it sends the customer a secure, one-time code to their phone to authenticate. If the customer successfully authenticates, Stripe displays their Link-saved addresses and payment methods automatically so they can use them. You also need to register your domain.

Explore the Link Authentication Element

Create a single email input for both email collection and Link authentication.

Add the Link Authentication Element

See also