Booking fees

A booking fee is a calculated additional cost added on to ticket purchases. Vista implicitly calculates these but ticketing interfaces must be aware of how they work and present them appropriately to the patron.

• Booking fees can be calculated as either:
  • Fixed fee per ticket (e.g., $1 per ticket).
  • Percentage fee per ticket (e.g., 10% of ticket price per ticket).
• A maximum booking fee per order can be configured (e.g., $1 per ticket up to a maximum of $5).
• Booking fees can vary by showtime, client, and booking mode.
• Booking fees are not accrued on food & beverage purchases.

Booking fees for an order

Booking fees are calculated whenever tickets are set against an order using the SetShowtime endpoint. The order includes a booking.totalBookingFee property that represents the total booking fee the patron is required to pay.

Each ticket within the order also has a bookingFee property that represents the booking fee for the individual ticket (or null if the ticket does not incur a booking fee).

{
  "order": {
    "id": "baeb04fc3faf45879f6546cfba84afad",
    "type": "Standard",
    "status": "InProgress",
    "totalPrice": {
      "valueIncludingTax": 25.16,
      "valueExcludingTax": 20.96,
      "tax": 4.2
    },
    "booking": {
      "mode": "Paid",
      "totalBookingFee": {
        "valueIncludingTax": 5.66,
        "valueExcludingTax": 4.72,
        "tax": 0.94
      }
    },
    "showtimes": [
      {
        "showtimeId": "0000000003-5301",
        "tickets": [
          {
            "ticketTypeId": "0000000003-0022",
            "price": {
              "valueIncludingTax": 19.5,
              "valueExcludingTax": 16.24,
              "tax": 3.26
            },
            "bookingFee": {
              "id": "92603",
              "amount": {
                "valueIncludingTax": 5.66,
                "valueExcludingTax": 4.72,
                "tax": 0.94
              }
            }
          }
        ]
      }
    ]
  }
}

Booking fees for ticket pricing

Booking fees are also returned by the GetTicketPricesForShowtime endpoint on a per-ticket price basis. This is essential for clients that wish to display the booking fee value during ticket selection, before the tickets have been ordered.

{
  "ticketPrices": [
    {
      "ticketTypeId": "0000000003-0022",
      "price": {
        "valueIncludingTax": 19.5,
        "valueExcludingTax": 16.24,
        "tax": 3.26
      },
      "isDefault": true,
      "bookingFee": {
        "valueIncludingTax": 1.0,
        "valueExcludingTax": 0.86,
        "tax": 0.14
      }
    }
  ]
}

While for the most common use-case, presenting a per-ticket fee is valid, certain booking fee configurations make this data unusable:

• Booking fees based on a percentage rather than a fixed-amount per ticket.
• Booking fees configured with minimum or maximum value per order that may mean only certain tickets incur fees.

For scenarios where these booking fee configurations are being used the client will be responsible to handle this custom logic specifically.