Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
    Overview
    Instant Bank Payments
    At a glance
    Link with Checkout
    Link with Web Elements
      Explore the Link Authentication Element
      Link in the Express Checkout Element
      Link in the Payment Element
      Link in the Payment Request Button
      Link in the Card Element
    Link with Mobile Elements
    Link with Invoicing
    Integration guides
    Link payment integrations
    Build a custom checkout page that includes Link
    Set up future payments using Elements and Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsFaster checkout with LinkLink with Web Elements

Explore the Link Authentication Element

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

Copy page

Pre-collected email addresses

If you already have customer email addresses, pass them directly to the Payment Element instead.

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

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.

See also

  • Stripe Web Elements
  • Payment Element
  • Address Element
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc
Related Guides
Build a custom checkout page that includes Link
Products Used
Link
Payments
Elements