Skip to main content

How to Provide a Checkout Widget to Resellers

Let resellers sell your products using your web checkout, while maintaining control over reseller permissions and tracking.

How it Works

There are three ways to give resellers access to your web checkout:

  1. Adding a referrer ID to the code (data-config attribute)

  2. Assigning resellers in the Ventrata dashboard

  3. Dynamically inserting a referrer value in the URL

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

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

  1. In your Ventrata dashboard, go to Resellers > Resellers.

    Resellers

  2. Select the reseller you want to give access to.

  3. 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

  4. In your website code, update the button's data-config attribute to include the reseller's referrer value:

    <button type="button" data-config='{"productID":"[YOUR_APIKEY]", "referrer": "[REFERRER_VALUE]"}' ventrata-checkout > Book Now </button>

    ​


    📒 NOTE

    You 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

Use this method to assign a reseller to the checkout directly from the Ventrata dashboard - no code required.

How to Set up

  1. In your Ventrata dashboard, go to Web Checkouts > Checkouts.

  2. Select the checkout you want to update.
    ​

    Web Checkouts

  3. Scroll down or search for 'Resellers' in the checkout form.
    ​

    Reseller in Web Checkout settings

    Reseller

    📒 NOTE

    Make sure the reseller has a web referrer value. If not, see Add referrer to Button Code above.
    ​

  4. Select the reseller you want to add.

  5. Press the Update Checkout button.
    ​

    Update Web Checkout

    Update Checkout

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:

https://your-address.com/?referrer=ventrataReseller

📗 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.

Link Agent to Reseller Sales

Record sales made by individual reseller agents using the 'Code' field in the agent detail.

Create Agent Code

  1. In the Ventrata dashboard, go to Resellers > Resellers.

    Resellers - Resellers

  2. Select an existing reseller.

  3. On the reseller detail page, go to the Agents tab.

    Agents

  4. Select an existing agent or create a new one.

  5. Enter a code for the agent. This value is used to identify the agent in bookings.

    Code

    📗 TIP

    You can use a combination of alphanumeric characters. Use either uppercase or lowercase letters only (do not mix both), as codes are case-sensitive.

  6. Press the Update Agent button.

    Update Agent

1. Add referrer to Button Code

Update your website button to include the reseller's referrer value and agent code, separated by a colon (:).

<button type="button" data-config='{"productID":"[YOUR_APIKEY]", "referrer": "[REFERRER_VALUE]:[AGENT_CODE]"}' ventrata-checkout > Book Now </button>

📒 NOTE

  • The value before the colon (:) is the reseller referrer

  • The value after the colon (:) is the agent code

You can also include the referrer value in the <script> tag if needed.

Once configured, Ventrata tracks bookings and links them to the reseller and the associated agent.

2. Assign Reseller in the Dashboard

Once the reseller is assigned to the web checkout and agent code is set up, no additional configuration is required.

3. Dynamically Insert a Referrer Value

Add the agent code after the reseller referrer in the URL, separated by a colon (:)

https://your-address.com/?referrer=ventrataReseller:agentcode123

📒 NOTE

  • The value before the colon (:) is the reseller referrer

  • The value after the colon (:) is the agent code

Ventrata automatically detects both and links the booking accordingly.

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

Related Articles
How to Create Resellers
How to Use Direct Reseller Sale
How to Redeem a Reseller Voucher
How to Create Web Checkouts
How to Redeem a Reseller Gift Voucher
Did this answer your question?