This documentation helps you successfully integrate Sovendus Voucher Network and/or Checkout Benefits into your shop using JavaScript on the order success page.
🎯 What You'll Achieve
💰 Increase Revenue: Offer customers exclusive vouchers and cashback rewards
🔄 Boost Retention: Keep customers engaged with personalized offers
📈 Track Performance: Monitor voucher redemptions and customer engagement
🎁 Enhance Experience: Provide value-added services at checkout
📋 Integration Checklist
Obtain Sovendus Identifiers
Contact your account manager to receive your unique traffic source and medium numbers.
Prepare Order Success Page
Identify where to place the Sovendus container in your thank you page.
Implement HTML Markup
Add the container div to your order success page.
JavaScript Integration
Replace placeholder values with your actual order data and add the script to your order success page.
Test Integration
Verify your implementation by placing a test order and using our integration testing app to validate data transmission. Send screenshots to your account manager for final verification.
Your personal banner and/or offer list will be created by Sovendus and made available on our servers.
Need Help?
If you have any questions or encounter issues during the process, please reach out to your Sovendus account manager for assistance.
🛠️ Implementation Guide
Step 1: HTML Container
Add this HTML markup to your order success/thank you page where you want the Sovendus content to appear:
<!-- Sovendus Container --><divid="sovendus-container-1"><!-- the integration loads the content into this div element --></div>
Container Placement
The position of this container doesn't affect the placement of the Sovendus sticky banner and overlay vartiants if you're using one.
When is the container required?
The container is only required when one of the following is true for you:
you are using an inline/embedded version of our banner or product list
you are using a SPA (single page app - e.g. react, angular, vue, etc.) as the existence of this container will trigger the sovendus overlay removal process
If you are not using an inline/embedded version and not using a SPA, you can safely ignore this container.
Step 2: Replace Placeholder Variables
Before implementing the JavaScript code, obtain these values from your Sovendus account manager:
Variable
Description
Example
TRAFFIC_SOURCE_NUMBER
Your unique traffic source identifier
1234567
TRAFFIC_MEDIUM_NUMBER
Your unique traffic medium identifier
123
Step 3: JavaScript Integration
Add this script right after the container div above, or if not possible, at the end of the <body> section of your order success/thank you page:
<!--sovendus code begin --><scripttype="text/javascript">window.sovIframes=window.sovIframes||[];
Step 4: Customize Consumer Data
Replace the placeholder values with actual data from your order form or user database.
Parameter Documentation
For detailed information on all parameters, examples, and requirements, visit: Parameter Documentation
Step 5: Test the Integration
After implementing the code, follow these comprehensive testing steps:
Testing Requirements
Complete testing is essential to ensure proper data transmission and banner display. Your account manager needs verification screenshots before going live.
🧪 Testing Process
Place a Test Order
Complete a real transaction on your website
Use realistic order data (products, quantities, pricing)
Include customer information in the checkout process
Verify Banner Display
Check your order success/thank you page immediately after checkout
Look for the Sovendus banner, overlay, or embedded content
Check that consumer data and order information match your test order
Test Multiple Scenarios
With coupon codes: Test orders using discount codes
Without coupon codes: Test standard orders
With consent given: Test when users accept marketing/personalized consent
Without consent: Test when users decline or haven't provided consent
Document and Share Results
Take screenshots of the banner display on your success page
🇨🇭 Switzerland Requirements
For Switzerland, additional landing page integration is required on your home page:
Option 1: JavaScript Implementation
// Add to your home/landing pagevar script =document.createElement("script");script.type="text/javascript";script.async=true;script.src=
Option 2: HTML Implementation
<!-- Add to your home/landing page HTML --><scriptasync="true"src="https://api.sovendus.com/js/landing.js"></script>
🔒 User Consent Integration
Privacy Compliance
While Sovendus works without cookies and processes data only to improve user experience, you may want to pass personal data only with explicit user consent.
Method 1: Split Integration
Use consent attributes on script tags:
<!-- Container (always load) --><divid="sovendus-container-1"><!-- the integration loads the content into this div element --></div><!-- Marketing consent required --><scripttype="text/javascript"my-consent-solution-attribute=
Method 2: Consent Variable
Use consent state functions:
<divid="sovendus-container-1"><!-- the integration loads the content into this div element --></div><scripttype="text/javascript"my-consent-solution-attribute="Sovendus">
