Skip to main content

How to Automatically Log In Customers on the Web Checkout (Headless Login)

Automatically log in customers on the Web Checkout if they logged in on your website.

Updated over 2 months ago

This guide demonstrates how to configure the Web Checkout to automatically log in customers who have already logged in on your website, without requiring them to re-enter their membership details.

This is especially useful if you’re using a membership program and want to provide a personalised experience across both environments.

📒 NOTE

This feature only works for logins using the Membership reference method.

Member Login - Membership Reference


What is Headless Login

Headless login refers to the process of authenticating a customer without manual input by modifying the data-config attribute or <script> tag for the checkout button.

This works by pre-filling the member’s credentials directly into the checkout configuration, enabling automatic login.


Update Data-Config

To enable the headless login, add the below piece of code in the data-config attribute of your checkout script. See the Implementation Guide for more information.

{
"productID": "<PRODUCT_ID>",
"apiKey":"<YOUR_API_TOKEN>",
"features": {
"membership": {
"reference": "<MEMBER_REFERENCE>",
"verification": "<MEMBER_VERIFICATION>"
}
}
}

📒 NOTE

Replace the reference and verification values with actual membership values in double quotes (" "), where

  • reference - the ticket reference found in the booking detail of the membership booking

  • verification - the last name of the member, found in the customer details of the membership booking

Membership Booking - Ticket Reference & Last Name

Adding the authentication credentials to the data-config enables headless login on all products in the checkout. To limit this feature to specific products, specify the product ID in the data-config attribute.

You can add the membership reference and member verification inside the membership feature to your script or button configuration.

<script src="https://cdn.checkout.ventrata.com/v3/production/ventrata-checkout.min.js" type="module" data-config='{"productID": "<PRODUCT_ID>", "apiKey":"<YOUR_API_TOKEN>", "features": { "membership": {"reference": "<MEMBER_REFERENCE>", "verification": "<MEMBER_VERIFICATION>" } } }'></script>


Headless Login Flow

Once a customer logs in on your website, the system securely passes their membership reference and verification code into the web checkout configuration.

When a customer accesses the checkout, they are automatically logged in - no manual input required.

When the customer accesses the checkout page:

  • The Web Checkout detects their membership credentials in the config

  • It automatically authenticates them in the background

  • Their membership data (like benefits and personal info,) is instantly available — no additional login required

📗 TIP

Learn how membership login is stored.

Did this answer your question?