Checkout
POST /v2/b2b/checkout/kiosk
Headers:
Content-Type: application/json
x-acme-api-key: valid API Key
x-acme-request-uuid: a unique identifier to help prevent duplicate transactions (optional)
Body:
A Checkout Input JSON Object with shopping cart
Response:
A WillCall Order Detail object describing the order, order items, and tickets arranged by event
Checkout JSON Objects
Checkout Input JSON Object
Field | Description | Notes |
---|---|---|
contactFirstName | First name of the customer. | optional |
contactLastName | Last name of the customer. | optional |
Email address of the customer. | ||
phoneNumber | Phone number of the customer. | |
zipCode | Zip code of the customer. | optional |
billingFirstName | First name of the customer. | optional |
billingLastName | Last name of the customer. | optional |
billingEmail | Email address of the customer. | |
billingPhoneNumber | Phone number of the customer. | |
expressTransactionID | transaction token from Tripos | required |
notes | Notes about the order | optional |
shoppingCart | The shopping cart object with the items to be purchased. | required |
shoppingCart.reservationId | The ID of a reservation with the desired events and tickets. On checkout, this will be automatically deleted | optional |
shoppingCart.items | A list of items in the shopping cart | required |
shoppingCart.items[x].itemId | A unique id for this item. | Read Only |
shoppingCart.items[x].eventId | Event id of the item. | required |
shoppingCart.items[x].ticketingTypeId | Type of ticket. | required |
shoppingCart.items[x].eventName | The name of the event. | optional |
shoppingCart.items[x].quantity | The number of these items in the shopping cart. | Required |
shoppingCart.items[x].unitPrice | The price for each item in the shopping cart. | Read Only |
shoppingCart.items[x].amount | The total amount (quantity X unit price) | Read Only |
shoppingCart.items[x].itemType | The type of item, one of Event, Inventory, ComboEvent, ComboInventory | required |
shoppingCart.items[x].inventoryId | If this item is not an event then this is the inventory id of the item. | required for inventory |
shoppingCart.items[x].inventoryName | Name of the item, if it's not an event. | optional |
shoppingCart.comboItems | A list of combo items in the cart. | optional |
shoppingCart.comboItems[x].itemId | The inventory item id, if this is an inventory item. | optional |
shoppingCart.comboItems[x].comboTemplateId | The combo template id associated with this combo item. | optional |
shoppingCart.comboItems[x].comboTemplateName | the name of the combo template. | optional |
shoppingCart.comboItems[x].comboTemplateType | Either fixedPrice or Discount depending on the type combo template. | optional |
shoppingCart.comboItems[x].tickets | The list of tickets for this combo item. | optional |
shoppingCart.comboItems[x].tickets[y].eventTemplateId | The event template associated with this ticket. | optional |
shoppingCart.comboItems[x].tickets[y].ticketTypeId | The id for the type of ticket. | optional |
shoppingCart.comboItems[x].tickets[y].name | The name on the ticket. | optional |
shoppingCart.comboItems[x].tickets[y].description | A description of what the ticket is for. | optional |
shoppingCart.comboItems[x].tickets[y].price | The retail price of the ticket. | optional |
shoppingCart.comboItems[x].tickets[y].discountedPrice | The price after discounts for resellers are applied to the retail price. | optional |
shoppingCart.comboItems[x].tickets[y].quantity | The number of tickets. | optional |
shoppingCart.comboItems[x].tickets[y].subTotal | The subtotal of the retail price of the tickets for the purchased quantity | optional |
shoppingCart.comboItems[x].tickets[y].discountedSubTotal | The subtotal of the discounted price of the tickets for the purchased quantity | optional |
shoppingCart.comboItems[x].events | A list of events in the shopping cart. | optional |
shoppingCart.comboItems[x].events[y].eventTemplateId | The id of the event template for this event. | optional |
shoppingCart.comboItems[x].events[y].eventId | The id of the event. | optional |
shoppingCart.comboItems[x].events[y].eventName | The name of the event. | optional |
shoppingCart.comboItems[x].events[y].eventStartTime | The start time of the event. | optional |
shoppingCart.comboItems[x].addOns | The list of add ons in this combo item. | optional |
shoppingCart.comboItems[x].addOns[y].addOnId | The id of the add-on . | optional |
shoppingCart.comboItems[x].addOns[y].name | The name of the add on. | optional |
shoppingCart.comboItems[x].addOns[y].quantity | The number of items of this add on in the shopping cart. | optional |
shoppingCart.comboItems[x].addOns[y].unitPrice | The price of these items. | optional |
shoppingCart.comboItems[x].addOns[y].priceSplit | Either 'each' or 'total'. If each then the price will be quantity * unitPrice, if total the price will be unitPrice. | optional |
expDate | expiration date in a mmyy format (no separators) | required for cc manual entry without a card reader |
chargeAmount | the charge amount if paying less than the total | required for cc manual entry without a card reader ONLY if paying less than the total |
uuid | a unique identifier to help prevent duplicate transactions (does not have to be a uuid per se) | required |
terminalId | a valid kiosk terminal id | required |
paymentMethods | A list of payment types. "paymentMethods": ["CreditCard"] In practice, there will only be credit card. The options are "Cash" or "CreditCard" | required |
reservationId | The ID of a reservation with the desired events and tickets. On checkout, this will be automatically deleted | optional |
Note: The following is included in the response
- ccLastFourDigits: Last four digits of the credit card