Order Ticket Fulfilment Webhooks

If an order requires fulfilment the broker can upload their tickets within Tixstock. An order fulfilment webhook is sent to the reseller containing the base64 encoded PDF and the order details it relates to each time a broker uploads their ticket.

The order eTicket Fulfilment Webhook and Order Mobile Fulfilment Webhook payload are the same with the exception of the webhook type. As such, we would recommend using the same endpoint for both types of webhook.

The Order eTicket Fulfilment webhook type is order.eticket_fulfilment and is used for ETicket orders. Conversely, the Order Mobile Fulfilment webhook type is set to order.mobile_ticket_fulfilment and represents Mobile Ticket orders.

Resellers are required to return an order status in their endpoints response this will ensure the order status remain in sync for both systems.

The resellers order statuses can be set up via the Tixstock Reseller Admin Area.

Post Data

Parameter	Description
order_id*	The resellers ID for the order. Type: String
id*	The resellers ID for the listing the order relates to. Type: String
general_admission*	The General Admission (GA) status of the listing. Type: Boolean
row*	The row that the ticket is assigned to. If the listing is set to GA, `NULL` will be sent. Type: String
seat*	The seat that the eTicket is assigned to. Type: String
file*	Base64 encoded string of eTicket PDF file. Type: String
proof_file_url	An Array of valid proof urls for mobile ticket fulfillment. Can be blank array in case of non mobile ticket type fulfillment. Type: Array

GA Example Request

{ 
    "data": { 
        "order_id": "3434341233", 
        "id": "15454542", 
        "general_admission": 1, 
        "row": null, 
        "seat": null, 
        "file": "base64 PDF file...",
        "proof_file_url": [
            "url 1",
            "url 2"
            ...
        ]
    }, 
    "meta": {
        "type": "order.eticket_fulfilment" 
    } 
}

None GA Example Request

{ 
    "data": { 
        "order_id": "3434341233", 
        "id": "15454542", 
        "general_admission": 0, 
        "row": "V", 
        "seat": "100", 
        "file": "base64 PDF file...",
        "proof_file_url": [
            "url 1",
            "url 2"
            ...
        ]
    }, 
    "meta": {
        "type": "order.mobile_ticket_fulfilment" 
    } 
}

Resellers JSON Response

It is required that resellers provide a valid JSON response back from the webhook request.

Success Response

{ 
    "external_id": "3434341233", 
    "order_status": "Delivered", 
    "message": "Listing has been fulfilled for the order.", 
    "success": true 
}

Error Response

{ 
    "external_id": "3434341233", 
    "order_status": "Accepted", 
    "message": "Listing failed to be fulfilled for the order.", 
    "success": false 
}