Processing Orders via Order Integration

Owned by Daniel Weisbaum
Last updated: Aug 26, 2022 by J Cobb (Unlicensed)
2 min read







Description

Pre-checkout integration to ensure confirmation is automatically offered to buyers at the time of checkout on inventory. 



Please find our documentation you can start to build against today: https://app.swaggerhub.com/apis-docs/Tevo/order-integration/1.0.0#/Inventory%20Holds/holdInventory

To achieve order integration on the Ticket Evolution marketplace, we expect that there will be support for three endpoints on the inventory management system/automation provider. More specifically:

  • A hold call to confirm the availability of the inventory being purchased. A successful response will put the inventory on hold in the system of record.

  • A hold release call to release inventory in case there is an issue on our side. A successful response will release the hold for that inventory.

  • An invoice or purchase call to ensure the inventory is sold out from the POS system. A successful response will sell out the inventory in the system of record as TEvo as the buyer.



What we Expect

  • Integration will be done against a RESTful API.

  • All responses will be in a JSON formatted response body.

  • All response times will return on average within 5 seconds.

  • Automators will provide documentation which will include but not be limited to response codes for each endpoint with details on what each code means.

  • Automator will provide an API Key that we will use when making calls to the endpoints

Hold Requests

  • TEvo will do all validations on our end prior to making the hold request.

  • The hold request will include the following attributes:

    • Remote ID provided by the supplier when the inventory was provided to TEvo

    • Quantity of tickets being purchased

    • Global ID - which will be used to sync hold, hold release and invoice calls.

  • A successful response will represent that the tickets have been put on hold and are available to TEvo for purchase.

Hold Release

  • TEvo will release the hold on the inventory if there was an issue creating the final order on our side. 

  • The hold release call will include the following attributes:

    • Global ID - This will allow the automator to link the hold release call to the initial hold call.

Invoice/Purchase

  • Upon successful hold, TEvo will make an Invoice/Purchase call shortly afterwards.

  • The Invoice call will include the following attributes:

    • TEvo Order ID

    • Global ID - This will allow the automator to link the invoice create call to the initial hold call.

  • Any errors returned via the Invoice/Purchase call will be the responsibility of the seller to resolve as these tickets have been confirmed to put on hold and have been committed to the buyer.