githubEdit

FAQs

What's the difference between a voucher and a ticket?

Under each product in the mapping section, we provide a deliveryMethods key. This is an array containing one or both of the following values:

  • VOUCHER: A single barcode/ticket for the whole booking, regardless of how many tickets were bought.

  • TICKET: An individual barcode/ticket per person (unit).

Once a booking is confirmed:

  • booking.voucher is provided if deliveryMethods contains VOUCHER.

  • booking.units[].ticket is provided if deliveryMethods contains TICKET.

  • If a method is not available, its value is null.

If both are provided, you can use either format based on your user experience and guest preference.

All Ventrata-operated products support both delivery methods, but some attractions require a separate barcode per person. In these situations, you will have only TICKET and not VOUCHER. Make sure to check deliveryMethods for each product.

Do vouchers/tickets always come with both PDF and QR code? If so, which should I use?

Yes. Ventrata always offers both PDF and QR code delivery formats for vouchers and tickets. If possible, support both: show the QR code in your interface and provide the PDF as a download option. The PDF includes full redemption details.

What is the difference between booking.supplierReference and barcode?

For each booking (and unit/ticket), we provide a QR code value and a supplier reference. In some cases, the barcode is very long and contains enough data to allow it to be verified offline. You should NOT print the QR code value in plain text. Instead, print the supplier reference below the QR code, which is always compact and human-readable.

Last updated