Inntopia Commerce is a one-cart booking engine for mountain and resort destinations, letting a guest book lodging, lift tickets, activities, dining and spa from separate underlying systems in a single transaction. Based in Stowe, Vermont and part of Outside Inc., Inntopia serves ski resorts, golf and beach properties, waterparks and destination organisations, mostly in North America. It is one of two Inntopia connections; the other is Inntopia Marketing Cloud.

Connecting Inntopia Commerce to Ventrata lets a resort or destination running Inntopia Commerce sell your Ventrata products in their booking engine, alongside their lodging and other travel inventory.

To learn more about Inntopia Commerce, visit corp.inntopia.com/commerce.

Primary website	corp.inntopia.com/commerce
Tags	Custom Checkout
Developed by	Inntopia (using Ventrata's OCTO API)

This app connection links your Ventrata account with Inntopia Commerce so resorts can sell your activities and attractions in the same purchase as a stay. Features of this connection include:

Syncs your content, availability and pricing – into the Inntopia cart.
Sells alongside lodging – and other inventory in a single guest transaction.
Sends bookings to Ventrata – new bookings, modifications and cancellations.
Delivers tickets – vouchers or tickets are issued from Ventrata to the guest through Inntopia.

‼️ IMPORTANT

This is a checkout-mode connection, not a reseller connection. The guest completes the entire purchase inside Inntopia's cart. Ventrata remains the source of truth for availability, pricing and offers, and the payment is taken by Inntopia's managed payment gateway and posted to Ventrata as an external payment. Because of this, the setup differs from a standard reseller connection.

‼️ IMPORTANT

Required role permissions go beyond the standard ones: See Checkouts, Modify Checkouts, See Connections, Modify Connections.

‼️ IMPORTANT

Inntopia Commerce will process your guests' personal data. Review your privacy policy and terms before connecting.

Creating the Inntopia Commerce Connection

🔐 Required Role Permissions: See Connections, Modify Connections, See Connection Key

Before you begin:

You must have a commercial agreement in place with Inntopia to use their solutions. To get started, contact them at [email protected].
You must decide how payment is handled. Inntopia Commerce normally settles bookings using the external gateway method: the card is charged on the Inntopia side and the transaction is recorded against the booking in Ventrata as external gateway.

In Ventrata Dashboard, go to Connections → Connections, click + New Connection, and select Inntopia Commerce from the list of partners.
Create a new Checkout dedicated to this API connection. Do not integrate this Checkout into your own website. Inntopia loads it inside their cart to capture product, option, availability and unit selections.
Unless you have separately agreed to process the payment through your own Ventrata gateway, confirm the Checkout uses the External Gateway card payment method.
On the list of allowed hosts for that Checkout, add every domain from which Inntopia will load the widget. Requests from any domain not listed return HOSTNAME_NOT_ALLOWED, so before testing ask your Inntopia contact for their full list of staging and production domains.
When creating the connection, select Inntopia Commerce from the list of partners, then select the Checkout you created.
Optional: allow/disallow products or destinations on the connection to expose only the inventory covered by your agreement.
(Optional) You can also set the connection Name of your choosing, which may be helpful if you plan to have multiple Inntopia Commerce connections and would like to differentiate between them more easily in the future.
Press the Create Octo Connection button.

📗 TIP

If needed, you can also allow or disallow products or destinations on the connection level to limit what Inntopia Commerce can access.

Sharing Access with Inntopia Commerce

Securely share the OCTO API key shown on the connection you've created with your Inntopia contact to complete the setup.

Your Ventrata configuration is complete. You can revoke access at any time by deactivating the connection.

Managing the Inntopia Commerce Connection

Revoke access by deactivating the connection.
Allow or disallow products: limit which destinations, products and options Inntopia Commerce can access. See how to allow or disallow products.
Rename the connection to tell several Inntopia Commerce connections apart.

How payment and the Checkout work

The guest completes the entire purchase inside Inntopia's cart. Ventrata remains the source of truth for availability, pricing and offers. Payment is taken by Inntopia's managed payment gateway and posted to Ventrata as an external payment, recorded against the booking as external gateway.

The dedicated Checkout is loaded by Inntopia inside their cart to capture product, option, availability and unit selections. It must not be integrated into your own website.

Connection Features Detailed

This section is for anyone who wants to know exactly how the Inntopia Commerce connection works: what Inntopia Commerce does with your Ventrata data, and which Ventrata OCTO API calls it makes.

Reads products	✅	Inntopia Commerce reads the products enabled on the connection. This works as follows: Get Product (`GET /products/{productId}`) – Inntopia Commerce re-reads a single product to pick up changes. Typically with Inntopia Commerce: it does this throughout the day.
Checks availability	✅	Inntopia Commerce checks availability for the products enabled on the connection. This works as follows: Availability Check (`POST /availability`) – Inntopia Commerce sends a product, an option and dates, and Ventrata answers with each bookable day or time slot and its status. Typically with Inntopia Commerce: it does this throughout the day.
Syncs content, availability and pricing	✅	Your products, availability and pricing go into Inntopia's cart. Content, availability, pricing and offers come from Ventrata. Ventrata stays the source of truth. This works as follows: `octo/pricing` capability – Inntopia Commerce asks for prices by adding it to the `Octo-Capabilities` header of its requests. Without it, Ventrata sends availability with no prices. Typically with Inntopia Commerce: it does this throughout the day. What this means for you: Resorts sell what you have actually got.
Receives bookings	✅	New bookings, modifications and cancellations from Inntopia reach Ventrata. The guest buys inside Inntopia's cart. Changes and cancellations are sent to Ventrata. This works as follows: Get Booking (`GET /bookings/{uuid}`) – Inntopia Commerce reads a single booking to pick up its latest details and status. Get Order (`GET /orders/{id}`) – Inntopia Commerce reads the order that a booking belongs to. Typically with Inntopia Commerce: it does this from time to time. What this means for you: Orders show up as normal bookings.
Creates and changes bookings	✅	Inntopia Commerce creates or changes bookings in Ventrata. This works as follows: Booking Reservation (`POST /bookings`) – Inntopia Commerce holds places for a booking. Booking Confirmation (`POST /bookings/{uuid}/confirm`) – Inntopia Commerce confirms the booking, and Ventrata returns your booking reference and tickets. Booking Update (`PATCH /bookings/{uuid}`) – Inntopia Commerce changes a booking. Booking Cancellation (`POST /bookings/{uuid}/cancel`) – Inntopia Commerce cancels a booking. Ventrata accepts this only before the cancellation cutoff.
Issues tickets	✅	Vouchers or tickets are issued from Ventrata to the guest via Inntopia. Ticket issuance flows through Ventrata.
Takes payment on the Inntopia side	✅	Inntopia's managed payment gateway charges the guest. The payment is posted to Ventrata as an external payment, recorded as external gateway. What this means for you: You do not process this payment through Ventrata unless separately agreed.

✅ supported

FAQs

Inntopia Commerce is not listed when I create a new connection.

This integration is enabled per account. Contact [email protected] to request access.

No products are displayed on the connection page.

Check which destinations, products and options are allowed or disallowed on the connection. If that does not fix it, check your products and options are made available for sale on the Direct API source. If it still persists, contact our support team.

I see HOSTNAME_NOT_ALLOWED when the Inntopia widget loads.

The domain loading the widget is not on the allowed hosts list for the Checkout. Collect every staging and production domain from your Inntopia contact and have them added.

The guest was charged but no booking appears in Ventrata.

The order was not confirmed against Ventrata after payment was taken on the Inntopia side. Ask your Inntopia contact for the x-request-id of the confirm request so we can trace it, and contact our support team.

Useful Resources

📚 More about Ventrata connections

Partner Information

Sterling Valley Systems, Inc.

PO Box 309, Stowe, VT 05672, United States

corp.inntopia.com/commerce

Ventrata Partner ID: 46209491-a755-4039-9370-8c92c0cdbafc