Skip to main content

OMNIA Card: Reseller Connection

Connect OMNIA Card to Ventrata to scan Rome and Vatican passes at your entrance, with each pass recorded as a booking and redeemed with Opera Romana Pellegrinaggi.

OMNIA Card logo powered by Opera Romana Pellegrinaggi icon Opera Romana Pellegrinaggi

 

OMNIA Card is the Rome and Vatican multi-attraction pass issued by Opera Romana Pellegrinaggi, sold in 24-hour, 72-hour and digital Smart formats. Each pass bundles Vatican Museums and Sistine Chapel entry with the Colosseum, Borghese Gallery, open-bus sightseeing and public transport. For operators, it brings pilgrims and culture-first visitors planning Rome itineraries well ahead of arrival, prepaid entries to the city's major sites from a single purchase.

 

Connecting OMNIA Card to Ventrata lets you scan OMNIA Card passes at your entrance. Ventrata checks each pass with Opera Romana Pellegrinaggi, records it as a booking in Ventrata and redeems it.

 

To learn more about partnering with OMNIA Card, visit omniavaticanrome.org.

 

Primary website

Tags

Multi-Attraction Pass · Cultural & Museum Tickets

Destination markets

🇻🇦 Vatican City · 🇮🇹 Italy

Source markets

🌎 Global

Connection features

Product Mapping · Redemption Sync · Pass Walkup Scanning Sync

Developed by

Ventrata (using Opera Romana Pellegrinaggi's API)

 

This reseller connection lets you accept OMNIA Card passes at your entrance without entering bookings by hand. Features of this connection include:

  • Product Mapping – you map each OMNIA Card product to your Ventrata product, option and unit.

  • Redemption Sync – passes you scan are redeemed with Opera Romana Pellegrinaggi.

  • Pass Walkup Scanning Sync – OMNIA Card holders can be scanned at your entrance without a booking in Ventrata.

 

Creating the OMNIA Card Connection

🔐 Required Role Permissions: See Connections, Modify Connections

Before you begin:

  • You must have a commercial agreement with Opera Romana Pellegrinaggi to accept OMNIA Card. To inquire about partnering with them, contact them via omniavaticanrome.org.

  • You must have OMNIA Card created as a Reseller in Ventrata.

  • You must have your Opera Romana Pellegrinaggi credentials: the ORP username, password and operator ID they give you.

 

  1. In Ventrata Dashboard, go to Connections → Connections, click + New Connection, and select OMNIA Card from the list of partners.

  2. Select OMNIA Card Reseller from the list of your resellers (must be created before creating a connection).

  3. Enter the ORP username, password and operator ID from Opera Romana Pellegrinaggi.

  4. (Optional) You can also set the connection Name of your choosing, which may be helpful if you plan to have multiple OMNIA Card connections and would like to differentiate between them more easily in the future.

  5. Create the connection. Ventrata checks the username and password with Opera Romana Pellegrinaggi, and shows an error if they're wrong.

 

Mapping OMNIA Card Products

OMNIA Card products appear on the connection the first time a pass for them is scanned. Map each one to a Ventrata product, option and unit:

  1. Scan a OMNIA Card pass. If its product isn't mapped yet, you'll see "... is not mapped in ..." and the product is added to the connection.

  2. In Ventrata Dashboard, open the OMNIA Card connection.

  3. For the new OMNIA Card product, select the matching Ventrata product, option and unit, and save.

  4. Scan the pass again.

 

📗 TIP

Scan a test pass for each OMNIA Card product you accept before your first visitors arrive, so every product is mapped in advance.

 

Managing the OMNIA Card Connection

  • Scan passes wherever you redeem Ventrata tickets. Ventrata looks up the pass number with Opera Romana Pellegrinaggi, creates an open-dated booking with one ticket for each redeemable pass, and redeems it with Opera Romana Pellegrinaggi.

  • Update the mapping when Opera Romana Pellegrinaggi changes its products.

  • Replace the credentials if Opera Romana Pellegrinaggi issues new ones.

 

Connection Features Detailed

This section is for anyone who wants to know exactly how the OMNIA Card connection works. Here Ventrata calls Opera Romana Pellegrinaggi's API to look up and redeem each pass you scan.

 

In short: visitors buy an OMNIA Card pass from Opera Romana Pellegrinaggi. When they arrive, you scan it, and Ventrata creates the booking and redeems the pass with Opera Romana Pellegrinaggi.

 

Product Mapping

✅

You map each OMNIA Card product to a Ventrata product, option and unit on the connection.

This works as follows:

  • The first time a pass for a new product is scanned, Ventrata adds that product to the connection as a row to map.

  • Each row is mapped to one Ventrata product, option and unit.

Content Sync

❌

OMNIA Card doesn't read your product content from Ventrata.

OMNIA Card uses the content set up on its own side.

Availability Sync

❌

OMNIA Card doesn't check your availability.

Bookings from OMNIA Card are open-dated and created only when a voucher or pass is scanned, so they don't use your availability ahead of time.

Pricing Sync

❌

OMNIA Card doesn't read your prices.

OMNIA Card sets its own prices. Settle the amounts for each redemption with OMNIA Card under your agreement.

Promotions Sync

❌

Your Ventrata promotions don't apply on OMNIA Card.

Set up any promotions with OMNIA Card directly.

Bookings Sync

❌

OMNIA Card doesn't send bookings to Ventrata in advance.

A booking is created in Ventrata only when you scan the voucher or pass at your entrance.

Pickups/Dropoff Sync

❌

Not part of this connection.

Arrange any pickups with the customer directly.

Custom Questions Sync

❌

Not part of this connection.

Ask the customer for any extra details at your entrance.

Extras Sync

❌

Not part of this connection.

Sell extras separately, for example on arrival.

Redemption Sync

✅

When you scan, Ventrata redeems the voucher or pass with OMNIA Card.

This works as follows:

  • Ventrata looks up the pass with Opera Romana Pellegrinaggi. Only passes with the status redeemable can be used.

  • Ventrata redeems the pass with Opera Romana Pellegrinaggi and saves the booking in Ventrata.

  • If the pass is already recorded in Ventrata, the existing booking is used instead of creating a new one.

Pass Walkup Scanning Sync

✅

Customers with a OMNIA Card voucher or pass can be scanned at your entrance without a booking in Ventrata.

This works as follows:

  • Scan the OMNIA Card pass wherever you redeem Ventrata tickets.

  • Ventrata creates an open-dated booking for the mapped product, option and unit, with one ticket for each pass.

Gift Card Sync

❌

Ventrata gift cards can't be sold or redeemed through OMNIA Card.

Gift cards bought in Ventrata can't be used on OMNIA Card.

✅ supported · ❌ not supported

 

Good to know: limits and details of the OMNIA Card connection

  • Redeemable passes only: a pass that's already used, expired or otherwise not redeemable is rejected with "Invalid card status".

  • Open-dated bookings: pass bookings aren't tied to a date or time slot.

  • Mapping on first scan: new products appear on the connection only after a pass for them is scanned.

 

FAQs

I see "... is not mapped in ..." when I scan a pass.

The OMNIA Card product on the pass isn't mapped yet. Open the connection, map it to a Ventrata product, option and unit, and scan again.

I see "Invalid card status" when I scan a pass.

Opera Romana Pellegrinaggi reports that the pass can't be redeemed, for example because it's already been used. Check the pass with the visitor or with Opera Romana Pellegrinaggi.

I get an error on the username or password when I save the connection.

Opera Romana Pellegrinaggi didn't accept the credentials. Check the ORP username, password and operator ID with Opera Romana Pellegrinaggi. If the issue persists, contact our Technical Support.

 

 

Partner Information

OMNIA Card

 

Ventrata Partner ID: c94c94b5-4e06-48b6-a1c4-350b0dfc0cd8

Did this answer your question?