Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Explore the Contact Details Element


Explore the Contact Details Element

Create a single email input for both email collection and Link authentication by adding the Contact Details Element (previously known as 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 Contact Details Element as part of your checkout page

Add the Contact Details Element

Put the Contact Details 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 Contact Details 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 Contact Details Element optionally prefilling a customer's email address.
const contactDetailsElement = elements.create("contactDetails", {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',

contactDetailsElement 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

Last verified 2026-09-24

Is this helpful?