Skip to main content
Expian Operator Connection

How to connect your products in Ventrata to operator using Expian ticketing system to resell their products

Dominic Martinkevic avatar
Written by Dominic Martinkevic
Updated over 3 months ago

Expian, formerly known as Ticknovate, is a ticketing system designed for tourist attractions, travel, and transportation businesses.

This operator connection (also referred to as backend) allows you to connect with other operators using Expian as their ticketing system to resell their products through Ventrata more efficiently and automatically. The capabilities of this connection include:

  • Syncing availability and pricing from your operator's Expian system.

  • Posting bookings, updates, and cancellations from Ventrata to Expian.

  • Receiving vouchers/tickets from your operator's Expian system and issuing them to your customers.


Configuring Operator Backend

Before You Begin:

  1. Contact your operator using Expian and request the "OCTO API Key" and "OCTO Endpoint" for you to resell their products through Ventrata. Expian users have the ability to generate the API key for resellers within their Expian admin. Expian's OCTO Endpoint is typically unique for each operator and follows the format: octo.api.<operator>.expian.io. This endpoint is provided to each operator by Expian when their system is configured. Operators may contact their Expian Customer Success Manager for assistance with obtaining this information.

  2. In the Ventrata Dashboard, navigate to Products → Operators, and select the Expian-powered operator for which you would like to set up the connection.

  3. In the Backend Partner section, choose Expian from the list of available connections and enter the OCTO API Key provided to you by your operator. Unless otherwise instructed by the operator, leave the OCTO Endpoint field with the default pre-filled value.

    In the Backend Partner field, select Expian from the list of connections available and enter OCTO API Key you were provided by your Operator.

  4. Click Update Operator to save the configuration.


Mapping Products

Once the operator has been configured with its backend, you can proceed to Product Mapping—the process of connecting your Ventrata products and options with the corresponding products and options from the operator's Expian system:

  1. In the Ventrata Dashboard, navigate to Products → Products and select the product you would like to map to the operator's Expian system.

  2. Edit the product and ensure the Operator is set to the correct operator to which this product belongs, where you have already configured the backend.

  3. Check Backend Connected for this product to use the API connection (backend). To pull availability from Expian, ensure Backend Availability is checked; to pull pricing, check Backend Pricing. If you do not check Backend Availability and/or Backend Pricing, the product will use the availability and/or pricing configured in Ventrata but will still post bookings to Expian. Click Update Product to save.

    Check Backend Connected for this product to use the API connection (backend). To pull availability from Expian, ensure Backend Availability is checked; to pull pricing, check Backend Pricing. If you do not check Backend Availability and/or Backend Pricing, the product will use the availability and/or pricing configured in Ventrata but will still post bookings to Expian. Click Update Product to save.

  4. The product page will now display a Mappings tab. Navigate to this tab and map your Ventrata product, option(s), and units by selecting the corresponding products, options, and units from the dropdown lists as received from Expian. Ensure that no fields are left empty (unmapped), and click Save Changes.

    The product page will now display a Mappings tab. Navigate to this tab and map your Ventrata product, option(s), and units by selecting the corresponding products, options, and units from the dropdown lists as received from Expian. Ensure that no fields are left empty (unmapped), and click Save Changes.


Supported Capabilities (Detailed)

Availability

When Backend Availability is enabled Ventrata will pull availability from Expian.

This works as follows:

  • Availability Check. When a user interacts with the availability calendar in Ventrata (e.g., selects units and clicks through the dates in the dashboard, web checkout, terminal, etc.), Ventrata will make a live request to Expian to retrieve availability for the given dates. This is usually done in 7-day ranges or for a specific day.

  • The calendar may display cached (non-live) data from the previous time it was requested before the user interacts with the calendar.

Pricing

When Backend Pricing is enabled Ventrata will pull both retail and net (wholesale) pricing from Expian.

This works as follows:

  • Availability Check (Pricing Capability). When a user interacts with the availability calendar in Ventrata (e.g., selects units and clicks through the dates in the dashboard, web checkout, terminal, etc.), Ventrata will make a live request to Expian to retrieve availability along with the pricing for the given dates. This is usually done in 7-day ranges or for a specific day. Pricing will shown to the user and cached / stored in Ventrata as API generated fares.

  • Net (wholesale) pricing returned via the API from Expian will be recorded as cost pricing, regardless of your cost percentage settings on the operator, when using Backend Pricing.

Booking

Bookings, booking changes and cancellation made in Ventrata for the Backend Connected product will be automatically sent to Expian.

This work as follows:

  • Booking Reservation. When a product is added to the cart in Ventrata, a request will be made to reserve the availability.

  • Booking Confirmation. After the payment step, a request to confirm the booking will be made, along with any customer contact information sent at this point. The voucher/ticket provided by Expian will be ingested as a voucher/ticket in Ventrata (except for PDF_FILE, which Ventrata currently does not support).

  • Booking Update. When a booking is changed, an API request to update the booking will be made to Expian.

  • Booking Cancellation. When a booking is cancelled, an API request to cancel the booking will be made to Expian.

Redemption

Booking status from Expian (for example if booking is Redeemed) is not currently communicated back to Ventrata after booking is confirmed.

Pickups

Pickups are not currently supported.

Promotions

Promotions are not currently supported.

Extras

Extras are not currently supported.


Troubleshooting

Issue

Possible Solutions

Error when updating operator to save backend configuration.

Likely OCTO API Key or OCTO Endpoint are incorrect. Double-check these details with your operator. If issue persists, contact us for support.

No Backend Connected checkbox in product settings.

Likely operator selected for the product doesn't have backend configured, check backend configuration and try again. If issue persists, contact us for support.

The product/option/unit I want to map is not on the dropdown.

Dropdown list is pulled from Expian based on products/options/units operator made available to you. Double-check these details with your operator. If issue persists, contact us for support.


Partner Information

Expian Ltd
Spaces, Mappin House, 4 Winsley St,
London W1W 8HF, United Kingdom

UK CRN 12698240

Partner ID af1db775-3f88-4d78-8b91-b7d69c5a252b

Did this answer your question?