1. Support Hub
  2. TripBuilder
  3. IBE - Internet Booking Engine

IBE with Marketplace Supply & Online Payment

Get started with the TripBuilder consumer IBE in combination with marketplace supply and online payment. This article walks you through the most important steps.

  1. Overview
  2. Details Explained
  3. Getting Started
    1. Checklist - Agreements & Terms
    2. Checklist - Payyo Configuration
    3. Checklist - IBE Configuration


Nezasa's TripBuilder IBE with marketplace supply provides an all-in-one solution to sell personalized itineraries over your own website to consumers. The graphic below shows the key components and actors in the setup:

TripBuilder IBE - How It Works

This article focuses purely on the setup with Payyo as payment provider. This is the default and recommended setup for consumer bookings when sourcing from Nezasa's marketplace. 

Alternative payment providers (Datatrans, Adyen) are supported as well, however they come with additional fees. And in case the marketplace supply is used, with additional contractual conditions.

An another alternative is the reservation request checkout which doesn't use any online payment. The consumer plans the itinerary on your website and instead of triggering a live booking (and thus online payment), the consumer triggers a reservation request. The payment from the consumer has to be handled outside of TripBuilder in this case. Read more


Details Explained

This chapter explains some core concepts of the setup. 

Payyo KYC

In order to use the consumer IBE with online payment it is required to pass the KYC process of Payyo, our payment partner, as well as to agree to the general payment terms.

Payyo Payment Fees

The fees for the online payment are charged by Payyo directly to the tour operator (via the Payyo merchant account of the tour operator).

Nezasa Booking Fees

The booking fees as defined in your Nezasa product plan is invoiced separately and not integrated into the calculations done by the system during a booking.

Consumer Payment

While TripBuilder helps collecting the money from the consumer, the tour operator remains fully responsible overall that the money is paid. Nezasa is in no way liable for outstanding payments by the consumer to the tour operator. Any component sourced and booked from the Nezasa marketplace by the tour operator (directly or by a customer of the tour operator) is to be paid in full to Nezasa in case of late cancellations or no cancellation.

Down Payment

The minimal down payment can be configured by you as tour operator. However, if the itinerary contains components from the marketplace, the system switches to a dynamic down payment calculation that might be higher than your defined percentage. The amount, in this case, depends on what components were added to the itinerary and what payment and cancellation conditions the supplier of that component is offering on the marketplace. Non-refundable components and components of suppliers asking for immediate payments are to be covered by the down payment.

Rest Payment

The rest payment is automatically handled. The system will send a payment link to the consumer 60 days before the trip starts. If not paid, a new reminder is sent 45, 35 and then 30 days before the trip starts. The last two payment reminder is also sent to the tour operator.

(The feature is currently being refined, the reminder schedule might change.)

Money Distribution

Automated Payment Split between Tour Operator and Nezasa

The system automatically splits the amount paid by the consumer between the tour operator and Nezasa. The Nezasa share is defined as the sum of the net prices of all components sourced from the marketplace. The split logic first covers the Nezasa share. Once the Nezasa share is covered, the remaining amount is directly forwarded to the Payyo merchant of the tour operator.


Getting Started

The onboarding process documented in form of checklists. The Nezasa support will guide you through the steps, of course.

Checklist - Agreements & Terms

This three, contractual steps are required to get started.

Step 1

Product Plan

Subscribe to the product plan “Standard” or higher. 

Step 2

Order the Consumer IBE & Accept Service Terms

Please trigger the consumer IBE setup process with Nezasa support and accept the Nezasa service conditions for consumer bookings.

Step 3

Online Payment Terms

Nezasa partnered with Payyo. Together, we provide a seamless setup without the need for you to find your own payment provider or acquirer.

What you have to do:

  1. Apply for the KYC with Payyo and get approved.
  2. Sign the payment condition agreement between you, Payyo, and Nezasa.

Hint: step 3 is initialized by Nezasa for you. You don't need to reach out to Payyo.


    Checklist - Payyo Configuration

    Not required. The setup is all pre-defined and done by Payyo based on the information provided during the KYC process. 

    For Payyo specific questions, please refer to Payyo’s knowledge base and support.

    Checklist - IBE Configuration

    This checklist goes through configuration options available for your IBE.

    Step 1

    Base Setup by Nezasa

    Get confirmation that Nezasa has enabled the consumer IBE for you.

    Step 2

    White-label Domain

    By default, the IBE runs on a dedicated domain. While Nezasa provides such a subdomain (*.tripbuilder.app), it is highly recommended to use a subdomain of your primary domain because of the “third-party cookie policy” of modern browsers. 

    Example: your main domain is “www.company.com” and you choose to use “ibe.company.com” for the consumer IBE of Nezasa.

    Read more

    Step 3

    Embed IBE into Your Website

    Set up a path and page on your website where the IBE will be integrated.

    Read more

      Step 4

      Configure your IBE

      There are plenty of configuration options available. Here the most important ones:

      • Terms & Conditions
        Configure the IBE checkout such that the user has to accept the terms. This may also involve topics like EU-GDPR or EU-PRRL checks.

      • Cancellation Policy
        As a tour operator, you’ll enforce package cancellation policies which need to be defined and applied. You can either pack them into your terms & condition, or use the systems “cancellation policy” feature. 

      • Payment Terms
        Define what down payment you’ll ask from consumers. Remember: if a booking contains marketplace components, the system might apply a higher down payment. 

      • Markups
        Define for different product categories what markup you put on top of the net price. Read more

      Step 5


      It is essential to test all your settings and maybe even do a test booking. Here are some important remarks when it comes to testing:

      1. Test as "consumer"
        The final tests should take place in the same way as a real customer of yours would use the website. This is absolutely crucial! Doing the tests directly on TripBuilder portal while being logged in with your admin user might lead to different results as your user has special permissions which leads to more features being available or more information being shown.

      2. Test Booking
        Perform a real booking with an actual credit card. When doing so, do not use marketplace supply because it will trigger bookings in supplier systems. Use ad-hoc components instead and make sure the value of the itinerary is small. 
        Thanks to this booking test, you'll also be able to test the refund feature in the Payyo backend UI.