TANITARDevelopers
WebhooksEvent catalogevent

event.ticket.order-changed

Version 1 of the event.ticket.order-changed webhook event.

The event.ticket.order-changed event.

Event typeevent.ticket.order-changed
Schema version1
Routing keyevent.event.ticket.order-changed.v1
Produced byevent-management-service
Schemaurn:defendr:contract:event:ticket-order-changed:1

data fields

FieldTypeRequiredDescription
eventIdstringyes
orderIdstringyes
playerIdstringyes
reservation"held", "released", "consumed"yes
payment"pending", "succeeded", "failed", "reversal-pending", "reversed"yes
fulfillment"pending", "issued", "unfulfillable"yes
revisionintegeryes
paymentRecoveryRequiredbooleanyes

Some fields are required only in particular states. The JSON Schema below is authoritative.

Example delivery

Signed with the example secret whsec_placeholder_example_webhooks_signing_secret, so you can check your verifier against it. See Verifying signatures.

POST /your/webhook/endpoint HTTP/1.1
content-type: application/json
webhook-id: whd_00000000-0000-4000-8000-000000000011
webhook-timestamp: 1800000000
webhook-signature: v1,pFYXdFwXZaE9oHfKeF7+Ml4nkdEL5jnmaFMXzr+x3jY=
tanitar-event-type: event.ticket.order-changed
tanitar-schema-version: 1
tanitar-delivery-attempt: 1

{"messageId":"evt_00000000-0000-4000-8000-000000000011","kind":"event","type":"event.ticket.order-changed","schemaVersion":1,"occurredAt":"2027-01-15T10:00:00.000Z","producer":"event-management-service","accountId":"acc_11111111-1111-4111-8111-111111111111","correlationId":"corr_00000000-0000-4000-8000-000000000011","data":{"eventId":"event_example","orderId":"ticket_order_aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","playerId":"player_example","reservation":"held","payment":"pending","fulfillment":"pending","revision":1,"paymentRecoveryRequired":false}}

The same body, formatted:

{
  "messageId": "evt_00000000-0000-4000-8000-000000000011",
  "kind": "event",
  "type": "event.ticket.order-changed",
  "schemaVersion": 1,
  "occurredAt": "2027-01-15T10:00:00.000Z",
  "producer": "event-management-service",
  "accountId": "acc_11111111-1111-4111-8111-111111111111",
  "correlationId": "corr_00000000-0000-4000-8000-000000000011",
  "data": {
    "eventId": "event_example",
    "orderId": "ticket_order_aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "playerId": "player_example",
    "reservation": "held",
    "payment": "pending",
    "fulfillment": "pending",
    "revision": 1,
    "paymentRecoveryRequired": false
  }
}

JSON Schema

urn:defendr:contract:event:ticket-order-changed:1
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:defendr:contract:event:ticket-order-changed:1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "eventId",
    "orderId",
    "playerId",
    "reservation",
    "payment",
    "fulfillment",
    "revision",
    "paymentRecoveryRequired"
  ],
  "properties": {
    "eventId": {
      "type": "string",
      "minLength": 1
    },
    "orderId": {
      "type": "string",
      "minLength": 1
    },
    "playerId": {
      "type": "string",
      "minLength": 1
    },
    "reservation": {
      "enum": [
        "held",
        "released",
        "consumed"
      ]
    },
    "payment": {
      "enum": [
        "pending",
        "succeeded",
        "failed",
        "reversal-pending",
        "reversed"
      ]
    },
    "fulfillment": {
      "enum": [
        "pending",
        "issued",
        "unfulfillable"
      ]
    },
    "revision": {
      "type": "integer",
      "minimum": 1
    },
    "paymentRecoveryRequired": {
      "type": "boolean"
    }
  }
}

On this page