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.
In Ventrata Dashboard, go to Connections → Connections, click + New Connection, and select OMNIA Card from the list of partners.
Select OMNIA Card Reseller from the list of your resellers (must be created before creating a connection).
Enter the ORP username, password and operator ID from Opera Romana Pellegrinaggi.
(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.
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:
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.
In Ventrata Dashboard, open the OMNIA Card connection.
For the new OMNIA Card product, select the matching Ventrata product, option and unit, and save.
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:
|
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:
|
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:
|
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
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.
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.
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.
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.
📚 More about Ventrata connections
Partner Information
OMNIA Card
Ventrata Partner ID: c94c94b5-4e06-48b6-a1c4-350b0dfc0cd8

