How it Works
There are three ways to give resellers access to your web checkout:
Adding a referrer ID to the code (data-config attribute)
When a reseller's referrer value is added, Ventrata can track every sale they make. This referrer value is stored behind the scenes in the Request Header, under the field called Octo-Referrer, and linked to the reseller in the Ventrata dashboard.
📗 TIP
A request header is metadata sent from a user's browser to the server when making a request (such as loading a webpage or submitting a form).
1. Add referrer to Button Code
1. Add referrer to Button Code
This method requires access to the data-config attribute. Use this method when you are embedding booking buttons on your own website.
See the Implementation Guide for more information.
How to Implement
In your Ventrata dashboard, go to Resellers > Resellers.
Resellers
Select the reseller you want to give access to.
On the Reseller detail, copy the value in the 'Web referrers' field.
📒 NOTE
If it is empty, add a unique referrer value.
Reseller Detail - Web Referrers
In your website code, update the button's
data-configattribute to include the reseller's referrer value:<button type="button" data-config='{"productID":"[YOUR_APIKEY]", "referrer": "[REFERRER_VALUE]"}' ventrata-checkout > Book Now </button>
📒 NOTEYou can also include the referrer value the
<script>tag if needed.
Once this is set, Ventrata tracks all bookings made through that button and links them to the reseller.
2. Assign Reseller in the Dashboard
2. Assign Reseller in the Dashboard
Use this method to assign a reseller to the checkout directly from the Ventrata dashboard - no code required.
How to Set up
In your Ventrata dashboard, go to Web Checkouts > Checkouts.
Select the checkout you want to update.
Web Checkouts
Scroll down or search for 'Resellers' in the checkout form.
Reseller
📒 NOTE
Make sure the reseller has a web referrer value. If not, see Add referrer to Button Code above.
Select the reseller you want to add.
Press the Update Checkout button.
Update Checkout
3. Dynamically Insert a Referrer Value
3. Dynamically Insert a Referrer Value
If your reseller does not have a website, you can give them a direct link to your web checkout that includes their referrer ID. Just add the referrer= or r= value to the end of the link, like this:
📗 TIP
Dynamic insertion refers to the method of automatically applying a reseller's referrer ID into the checkout by including it in the URL, instead of manually coding it into the website.
Ventrata automatically detects the reseller when someone uses this link, then:
stores the referrer value in the Session Storage
📗 TIP
A session is a temporary storage mechanism that holds user-related data while they navigate a website. Once the user closes the browser tab or quits the browser, the session storage is cleared.
It includes the referrer value info in the booking request as part of the "Octo-Referrer" field in the Request header
and it links any resulting bookings to the correct reseller.
Why Use Referrers
✅ Commission Tracking for Resellers & Affiliates
automatically track which partner generated a booking
use this data to calculate commission
✅ Performance Tracking Across Campaigns
use different referrer values to track which marketing channels or partners drive bookings
compare performance by campaign, partner or geography
✅ Enable Third-Party Agents Without Full Access
allow resellers who do not have their own websites to use your web checkout
no tech setup needed