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.