Go City is the world's largest multi-attraction pass company, selling passes for more than 1,500 attractions, tours and activities in 25+ destinations across four continents. For operators, it brings prepaid pass holders from all major source markets who visit outside peak times and try attractions new to them, around 12 million attraction visits a year.
Connecting Go City to Ventrata lets you scan, validate and redeem Go City passes at your entrance, on Ventrata-powered turnstiles, kiosks, point-of-sale terminals, the mobile app or the Ventrata Dashboard, without a separate Go City app.
To learn more about Go City, visit gocity.com.
📒 NOTE
Looking to resell Go City passes instead? See Go City: Operator Backend.
🏆 Go City Platinum Preferred Connectivity Partner 2026. Ventrata was named Go City's first Platinum partner in the program's first year, for supporting the full feature set: real-time capacity holds, dual validation, and dynamic redemption. Ventrata was also the first system to upgrade to Go City's latest Direct Connect API.
Primary website | |
Tags | Multi-Attraction Pass |
Connection type | Pass redemption: you scan Go City passes at your entrance |
Connection features | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Developed by | Ventrata (using Go City Direct Connect API & Ventrata's OCTO API) |
This connection lets you:
Scan, validate and redeem Go City passes from walk-up visitors on your Ventrata-powered turnstiles, kiosks, point of sale, mobile app or dashboard, with no separate Go City app and no manual data entry (Go City 'Direct Connect').
Let pass holders pre-book a date and time in the Go City app or reservation portal, using your live Ventrata availability (Go City 'Go Reserve').
Record every Go City visit as a booking in Ventrata, with the pass number as the reseller reference.
Report each redemption back to Go City automatically, together with the net rate Go City owes you.
How It Works
You scan a barcode or QR code at the entrance, or enter it under + New Order → Redeem Voucher Code, and it doesn't match an existing Ventrata booking or ticket.
Ventrata checks the format. A Go City pass number has 12 digits, starts with 6 or 7, and its 9th digit is 1 (adult), 2 (child) or 4 (VIP). Dashes are stripped. Anything else is not treated as a Go City pass.
Ventrata looks up the pass with Go City in real time. Lookups are cached for 5 minutes.
For each valid offer on the pass, Ventrata creates an open-dated booking for the mapped product, option and unit. The reseller reference is /. One pass can carry several offers, so one scan can create several bookings.
If an offer isn't mapped yet, the scan fails until you map it.
Ventrata reports the visit to Go City: at scan time by default, or when the ticket is redeemed or marked no-show if you defer redemption.
📒 NOTE
12-digit pass number starting with 6 or 7; the 9th digit is 1 (adult), 2 (child) or 4 (VIP). Dashes are stripped. Codes that don't match are silently ignored, not treated as Go City.
Pre-Booked Visits
Go City 'Go Reserve'. Pass holders pick a date and time in the Go City app or reservation portal. Go City reads your live availability with Ventrata's OCTO Availability Check and books with OCTO Booking Reservation and Booking Confirmation. Pass holders can reschedule or cancel (OCTO Booking Update and Booking Cancellation), and Go City cancels these bookings automatically when a pass becomes invalid. To turn it on, copy the API key shown on your Go City connection page (above the listings table) and securely share it with Go City's implementation team ([email protected]) asking to enable Go Reserve.
Creating the Go City Connection
🔐 Required Role Permissions: See Connections, Modify Connections
Before you begin:
You're a Go City attraction partner and your products already exist in Go City's system.
You use Ventrata-powered hardware (turnstile, ticket kiosk, point of sale / terminal), the Ventrata mobile app or the dashboard at your entrance.
You've created Go City as a Reseller in Ventrata with correct retail and wholesale/commission pricing.
The Go City reseller uses the 'Bill to my account' settlement method.
You must already be a Go City attraction partner with your products set up in Go City's system. If you don't work with Go City yet, contact their Americas team. [email protected] Https://gocity.com/en/work-with-us
EMEA team. [email protected]
APAC team. [email protected]
Get credentials and test passes from Go City
Email [email protected] and ask for production Direct Connect API credentials and a production test pass of each type (adult, child, familiarization) for each product.
Keep the username, password and test passes Go City sends you.
Create the Go City connection
In your Ventrata dashboard, go to Connections → Connections, click + New Connection and select Go City.
Select the Go City Reseller and enter the Go City username and password.
Tick 'Redeem only on Redemption/No-show' (recommended).
Optionally allow or disallow destinations or products, and give the connection a name.
Tick 'Test' only while testing.
Click Create Connection. Ventrata checks the credentials when you save.
Turn on Go Reserve (optional)
Copy the API key shown on your Go City connection page, above the listings table.
Securely share it with Go City's implementation team ([email protected]) and ask them to enable Go Reserve.
The connection form has these options:
Reseller | The connection uses this reseller's configuration (pricing, allowed and disallowed products) and records all bookings on its behalf. |
Go City username | Basic-auth user for the Go City partner API. A 'uat:' prefix points the connection at Go City staging. |
Go City password | Basic-auth password for the Go City partner API. |
Redeem only on Redemption/No-show | Ticked (recommended): Ventrata sends the redemption to Go City when the booking is actually redeemed or marked no-show. Unticked: it's sent when the booking is created. |
Allowed / disallowed destinations and products | Limits what this connection can book, on top of the reseller settings. Useful if you run several Go City connections, for example one per destination. |
Connection name | Lets you tell connections apart, for example 'Go City Paris' and 'Go City Sydney'. |
Test | Forces all Go City bookings into test mode and lets only test-mode equipment scan them. Untick before going live. |
Pass types | Which pass types you accept: ALL_INCLUSIVE, EXPLORER, SINGLE_SELL. All ticked by default. |
Pass variants | Which variants you accept: STANDARD, DEFAULT, PLUS, X_FROM_Y, HIGHLIGHTS, ESSENTIALS, SPOTLIGHT, MINI, SINGLE_SELL, CUSTOM. All ticked by default. |
Pass brands | Which brands you accept: GO_CITY, BIG_BUS, GREAT, EMPIRE_STATE_BUILDING, ONE_WORLD_OBSERVATORY, TOP_OF_THE_ROCK, EDGE, AIRBNB. All ticked by default. |
📗 TIP
Prefix the username with 'uat:' to point the connection at Go City's staging environment. Separately, the 'Test' checkbox forces all Go City bookings into test mode and lets only test-mode equipment scan them; untick it before you receive visitors.
Mapping Products
When you save the connection, Ventrata loads Go City's offer list (the attractions it sells) and creates one row per offer and customer type (ADULT, CHILD, VIP). Offers Go City no longer returns are removed on save. New offers seen on a scanned pass add a row on the fly.
Scan each Go City test pass on Ventrata-powered hardware or the mobile app, or enter its pass number under + New Order → Redeem Voucher Code. You'll get a 'not mapped' error, and the Go City listing appears in your connection.
Go to Connections → Connections and open your Go City connection.
Click a listing row (unmapped rows are red), select the Ventrata product, option and unit, and click Update Mapping.
📒 NOTE
Every row needs a product, option and unit.
📒 NOTE
Unmapped rows are highlighted in red.
📒 NOTE
Until a row is mapped, scans of that offer fail with ' is not mapped in <connection>'.
Redemption
Immediately: Ventrata posts the visit to Go City at scan time, when the booking is created.
On redemption or no-show: With 'Redeem only on Redemption/No-show' ticked (recommended), Ventrata sends the redemption when the booking is redeemed or marked no-show.
What's sent to Go City: A visit to Go City's /partner-api/v1/visit with passNumber, offerId and netRate.
Connection Features Detailed
This section is for anyone who wants the detail. Click a row to see how each feature works.
Product Mapping | ✅ |
You map each Go City pass listing to a Ventrata product in the Ventrata Dashboard. When you save the connection, Ventrata loads Go City's offer list (the attractions it sells) and creates one row per offer and customer type (ADULT, CHILD, VIP). Offers Go City no longer returns are removed on save. New offers seen on a scanned pass add a row on the fly. Every row needs a product, option and unit. Unmapped rows are highlighted in red. Until a row is mapped, scans of that offer fail with ' is not mapped in <connection>'. |
Content Sync | ❌ |
Product content isn't synced. Go City sells its own pass. Your products and their content stay in Ventrata. |
Availability Sync | ✅ |
Go Reserve: Go City pulls your live time slots with Ventrata's OCTO Availability Check when a pass holder makes a reservation. Go Reserve: Go City pulls your live time slots with Ventrata's OCTO Availability Check when a pass holder makes a reservation. |
Pricing Sync | ✅ |
Prices are shared with Go City. The booking uses your Ventrata unit price (voucher settlement). On redemption, Ventrata sends Go City a netRate equal to the ticket's wholesale price minus direct balance, so your wholesale/net price in Ventrata is what Go City is told it owes you. Set Go City's retail and wholesale/commission prices correctly on the reseller. |
Promotions Sync | ❌ |
Promotions don't apply to Go City passes. Your Ventrata promotions don't apply to bookings made by scanning a pass. |
Bookings Sync | ✅ |
Bookings are created in Ventrata when a pass is scanned. Walk-up bookings are created only at scan time. Visitors can enter with either the Go City pass or a Ventrata-issued barcode, since both belong to the same booking. Go Reserve bookings are made ahead by Go City through Ventrata's OCTO API. Ventrata makes no cancel or amend calls to Go City. For Go Reserve, pass holders reschedule or cancel through Go City (OCTO Booking Update and Booking Cancellation), and Go City cancels bookings whose pass becomes invalid. |
Pickups/Dropoff Sync | ❌ |
Not part of this connection. Pass redemptions don't carry pickups. |
Custom Questions Sync | ❌ |
Not part of this connection. Booking questions aren't asked or sent for pass redemptions. |
Extras Sync | ❌ |
Not part of this connection. Extras can't be added to a pass redemption. |
Redemption Sync | ✅ |
Redemptions are sent to Go City. Ventrata posts the visit to Go City at scan time, when the booking is created. With 'Redeem only on Redemption/No-show' ticked (recommended), Ventrata sends the redemption when the booking is redeemed or marked no-show. A visit to Go City's /partner-api/v1/visit with passNumber, offerId and netRate. |
Pass Walkup Scanning Sync | ✅ |
You scan Go City passes at your entrance. You scan a barcode or QR code at the entrance, or enter it under + New Order → Redeem Voucher Code, and it doesn't match an existing Ventrata booking or ticket. Ventrata checks the format. A Go City pass number has 12 digits, starts with 6 or 7, and its 9th digit is 1 (adult), 2 (child) or 4 (VIP). Dashes are stripped. Anything else is not treated as a Go City pass. Ventrata looks up the pass with Go City in real time. Lookups are cached for 5 minutes. |
Gift Card Sync | ❌ |
Not part of this connection. Go City passes aren't Ventrata gift cards. |
✅ supported · ❌ not supported
Good to know: limits of this connection
Good to know: limits of this connection
Customer types are limited to ADULT, CHILD and VIP.
Wrong credentials give no descriptive error; the username and password fields are just marked invalid.
If a pass lookup hits an HTTP error or timeout, the pass is silently treated as not found.
Barcodes that don't match the Go City format are silently ignored.
You need Ventrata-powered hardware, the mobile app or the dashboard at your entrance.
The Go City reseller must use the 'Bill to my account' settlement method.
No pickups, extras or booking questions; customer, answer and transport validation are skipped for these orders.
Troubleshooting
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
The Go City offer on this pass isn't mapped to a Ventrata product yet. Open the Go City connection, click the red row and map it to a product, option and unit.
"Pass not mapped in Ventrata connection"
"Pass not mapped in Ventrata connection"
Map the listing that appeared after the scan.
"Redemption not allowed"
"Redemption not allowed"
"Go City's own message (INVALID offer messages or FAILURE errorDescription)"
"Go City's own message (INVALID offer messages or FAILURE errorDescription)"
Go City rejected the pass or offer; Ventrata shows Go City's text to staff as is.
FAQs
Can visitors enter with the Go City pass or do they need a Ventrata ticket?
Can visitors enter with the Go City pass or do they need a Ventrata ticket?
Either. The Go City pass and any Ventrata-issued barcode belong to the same booking.
Can I run more than one Go City connection?
Can I run more than one Go City connection?
Yes. Use allowed and disallowed destinations or products to split them, for example by destination, and name each connection.
Can pass holders book a time in advance?
Can pass holders book a time in advance?
Yes, with Go Reserve. Securely share the API key from your connection page with Go City's implementation team ([email protected]) to turn it on.
What does Go City get told it owes me?
What does Go City get told it owes me?
Ventrata sends a net rate equal to the ticket's wholesale price minus direct balance, so check your wholesale prices on the Go City reseller.
Useful Resources
📚 More about Ventrata connections
Partner Information
Go City Limited
6 Dryden Street, London, WC2E 9NH
United Kingdom
Ventrata Partner ID: b880f9df-612d-4f95-9611-f64b2137b936