Manual Insertion
You can apply promotions manually by:
using public promotions
letting customers enter promo codes during checkout
For more details on these methods, refer to the linked articles in each bullet point.
Dynamic Insertion
Dynamic insertion means applying a promo code automatically, without manual customer input. This saves customers time and ensures the discount is always applied.
When a promo code is applied, it gets included in the data sent to Ventrata, ensuring customers see the correct discount when booking.
This article focuses on two methods in particular:
1. Updating the Data-Config (Script Configuration)
1. Updating the Data-Config (Script Configuration)
This method requires access to the data-config attribute. This is useful if you are embedding a booking button on your website and want to apply a promo code without showing a promo code field to customers.
See the Implementation Guide for more information.
How to Implement
Modify the checkout button's settings (
data-configattribute) to include thepromoCodevalue:<button type="button"
data-config='{
"productID":"[YOUR_APIKEY]",
"promoCode": "[PROMO_CODE]"
}'
ventrata-checkout>
Book Now </button>
📒 NOTEYou can put the
promoCodevalue inside the checkout script or directly in the checkout button's code.You can find promo codes in the promotions section of your Ventrata dashboard.
Promotions - Promotion Codes
Once the
promoCodevalue is extracted from thedata-config, it is included in the payload for availability and calendar requests. This means that when a customer clicks the button, Ventrata reads the promo code and applies the discount automatically.
2. Apply Promo Code from the URL
2. Apply Promo Code from the URL
Another simple way to apply a promo code is by including it in the URL. This is helpful for email campaigns, social media posts, or affiliate links.
You can do this by adding the promoCode= or p= value to the end of the link.
How to Implement
Share a URL that includes the promocode value:
Ventrata will automatically detect the FREE promo code and apply it at checkout.
There are two ways the system remembers this code:
1. Session Storage (Temporary Memory)
Keeps the promo code active as long as the browser tab is open.
If the customer refreshes or navigates between pages, the promo code still works.
The promo code disappears if the customer closes the browser.
2. Direct Query from the URL
When a customer clicks on the promo code link, Ventrata reads the promo code directly from the URL, stores and applies the discount in:
Session Storage
Payload for availability and calendar requests
Why Use Dynamic Insertion
✅ Improved Conversion Rates
removes the need for manual promo code entry
customers are less likely to abandon checkout
✅ Promotion Campaigns
run targeted campaigns with preloaded promo codes that link directly to discounted checkouts
✅ Better Tracking
tracking which campaign or source generated the booking becomes easier
✅ Control Over Promotions
ideal for limited-time offers or partner-specific deals, where you gain more control over which customers see and use specific promotions