API Partner Order Integration

Overview

Order Integration ensures buyers know immediately whether their tickets are secured by placing a hold on the ticket group directly in the inventory source POS. When the hold call is successful the order will be automatically created and confirmed, if a hold call fails, no order is created and a clear error message is returned.

Inventory Flows

Not all inventory is currently order integrated. You have two options when retrieving listings:

All Inventory: Include both integrated and non-integrated listings
Order Integrated Only: Filter listings where automated=true

Checkout Timing

For order integrated inventory, checkout includes an additional hold step:

The hold call may add up to 30 seconds to the checkout process.
Ensure your checkout flow does not timeout before the hold request completes.

Hold Call Outcomes

Successful Hold → The order is automatically created and accepted.
Unsuccessful Hold → No order is created. This prevents the customer from experiencing a post-purchase rejection.

Request	Response

Request

Response

Example of a request /v9/listings/4965382382

{
  "automated": true,
  "available_quantity": 2,
  "discounted": false,
  "eticket": false,
  "featured": null,
  "format": "TM_Mobile",
  "id": 4965382382,
  "in_hand": true,
  "in_hand_on": null,
  "instant_delivery": false,
  "owned": false,
  "public_notes": "TMX Smartphone Entry  XFER.",
  "quantity": 2,
  "retail_price": 60,
  "retail_price_inclusive": 60,
  "row": "15",
  "section": "211",
  "service_fee": 0,
  "signature": ,
  "splits": [
    1,
    2,
  ],
  "tevo_section_name": "mezzanine center 211",
  "type": "event",
  "view_type": null,
  "wheelchair": false,
  "wholesale_price": 40,
  "face_value": null,
  "seller_cost": nul
}