# ticket.order.refunded

HTML: https://www.app2email.com/docs/api/webhooks/ticket.order.refunded · Index: https://www.app2email.com/docs/api/llms.txt

Tickets of an order were refunded or cancelled: by staff, the API, a cancelled date, or a full refund made at the payment provider. Not sent for a late payment that was returned before any ticket existed. page_url is empty in events: read the order with GET /tickets/orders/{id}.

Group: Tickets-and-Pay. Header `X-App2email-Event: ticket.order.refunded`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.order` | object | yes | The order after the change, with its tickets. |
| `data.order.id` | integer |  | The order's id. |
| `data.order.reference` | string |  |  |
| `data.order.status` | string |  | pending: a checkout that is not finished. expired: it was never paid or confirmed. confirmed: the tickets were issued.; one of: `pending`, `confirmed`, `partly_refunded`, `refunded`, `cancelled`, `expired` |
| `data.order.kind` | string |  | online: paid by card. free: a free order. comp: complimentary. outside: paid outside app2email.; one of: `online`, `free`, `comp`, `outside` |
| `data.order.channel` | string |  | Where it was made.; one of: `web`, `whatsapp`, `staff`, `door`, `api` |
| `data.order.source` | string |  | The src label of the link the buyer came through. |
| `data.order.event` | object |  |  |
| `data.order.event.id` | integer |  |  |
| `data.order.event.name` | string |  |  |
| `data.order.event.slug` | string |  |  |
| `data.order.date` | object |  | The date that was bought. |
| `data.order.date.id` | integer |  |  |
| `data.order.date.start` | string |  |  |
| `data.order.date.start_local` | string |  |  |
| `data.order.date.label` | string |  |  |
| `data.order.buyer` | object |  |  |
| `data.order.buyer.name` | string |  |  |
| `data.order.buyer.contact` | string |  | The WhatsApp number in digits, or a business-scoped user id. Empty when unknown; erased-... after an erase. |
| `data.order.buyer.email` | string |  |  |
| `data.order.buyer.no_whatsapp` | boolean |  | The buyer said they do not use WhatsApp. |
| `data.order.currency` | string |  |  |
| `data.order.total` | number |  | What the buyer pays, in currency. |
| `data.order.total_label` | string |  |  |
| `data.order.tickets_total` | number |  | The sum of the ticket prices. |
| `data.order.order_fee` | number |  |  |
| `data.order.donation` | number |  |  |
| `data.order.discount` | number |  | Information: already taken off tickets_total. |
| `data.order.fees` | number |  | Information: the booking fees inside total. |
| `data.order.tax` | number |  | Information: the tax inside total. |
| `data.order.refunded` | number |  |  |
| `data.order.refunded_label` | string |  | Empty while nothing was refunded. |
| `data.order.ticket_count` | integer |  | Tickets of role ticket. |
| `data.order.people_count` | integer |  | The people they admit. |
| `data.order.addon_count` | integer |  |  |
| `data.order.promo_code` | string |  |  |
| `data.order.payment` | object |  |  |
| `data.order.payment.id` | integer |  | The online payment: the id of GET /payments/{id}. null for free, complimentary and outside orders. |
| `data.order.payment.method` | string |  | stripe, paypal, cash, bank, card_machine, other, or empty. |
| `data.order.payment.note` | string |  | The note of a sale paid outside. |
| `data.order.comp_reason` | string |  | kind comp: guest, artist, press, sponsor, staff, prize or other. |
| `data.order.staff_note` | string |  | The business's internal note. |
| `data.order.created_by` | string |  | customer, a person of the business, or API key <name>. |
| `data.order.attention` | string |  | Not empty: the order needs a look. dispute: the buyer's bank opened a card dispute and the tickets are blocked.; one of: ``, `refund_failed`, `refund_outside`, `refund_mismatch`, `paid_twice`, `dispute` |
| `data.order.close_reason` | string |  | Why it ended without tickets: unpaid, buyer_cancelled, staff_cancelled, late_payment, date_cancelled, event_cancelled or erased. |
| `data.order.refund_request` | object |  | A refund the buyer asked for. null when there is none. |
| `data.order.refund_request.status` | string |  | one of: `open`, `refunded`, `declined` |
| `data.order.refund_request.reason` | string |  |  |
| `data.order.refund_request.at` | string |  |  |
| `data.order.answers` | object |  | The answers given for the order: question id -> value.; any keys |
| `data.order.marketing_optin` | boolean |  |  |
| `data.order.erased` | boolean |  | The buyer's details were erased on request. |
| `data.order.page_url` | string |  | The ticket page of this order. Anyone who has the link can open the tickets: treat it like a password and give it only to the buyer. Empty in webhook events and for an erased order. |
| `data.order.expires` | string |  | pending: until when it can be paid or confirmed. |
| `data.order.confirmed` | string |  | When the tickets were issued. |
| `data.order.cancelled` | string |  |  |
| `data.order.refunded_at` | string |  |  |
| `data.order.created` | string |  |  |
| `data.order.updated` | string |  |  |
| `data.order.tickets` | object[] |  | Every ticket of the order, any status. In GET /tickets/orders only with tickets=true. |
| `data.order.tickets.id` | integer |  | The ticket's id. |
| `data.order.tickets.order_id` | integer |  |  |
| `data.order.tickets.order_reference` | string |  |  |
| `data.order.tickets.event_id` | integer |  |  |
| `data.order.tickets.date_id` | integer |  | The date the ticket is for. |
| `data.order.tickets.type_id` | integer |  |  |
| `data.order.tickets.type_name` | string |  | The ticket type's name as it was sold. |
| `data.order.tickets.role` | string |  | one of: `ticket`, `addon` |
| `data.order.tickets.seq` | integer |  | 1..n inside the order. |
| `data.order.tickets.status` | string |  | valid and blocked tickets hold a place; refunded, cancelled and transferred (passed on) are final.; one of: `valid`, `blocked`, `refunded`, `cancelled`, `transferred` |
| `data.order.tickets.holder_name` | string |  |  |
| `data.order.tickets.answers` | object |  | The answers given for this ticket: question id -> value.; any keys |
| `data.order.tickets.seat` | object |  | null without a seat. |
| `data.order.tickets.seat.key` | string |  | The key of the seat in the seat plan. |
| `data.order.tickets.seat.label` | string |  |  |
| `data.order.tickets.seat.section` | string |  |  |
| `data.order.tickets.seat.row` | string |  |  |
| `data.order.tickets.seat.seat` | string |  |  |
| `data.order.tickets.seat.table` | string |  |  |
| `data.order.tickets.admits` | integer |  |  |
| `data.order.tickets.check_in` | object |  | The check-in state of a ticket. |
| `data.order.tickets.check_in.people` | integer |  | People admitted so far (0 to admits). Above 0 = checked in. |
| `data.order.tickets.check_in.inside` | integer |  | People inside now, for events that count people leaving. |
| `data.order.tickets.check_in.entries` | integer |  | Accepted scans on the way in. |
| `data.order.tickets.check_in.first_at` | string |  |  |
| `data.order.tickets.check_in.last_at` | string |  |  |
| `data.order.tickets.check_in.last_out_at` | string |  |  |
| `data.order.tickets.check_in.gate` | string |  | The id of the entrance of the last scan. |
| `data.order.tickets.currency` | string |  |  |
| `data.order.tickets.price` | number |  | What was paid for this ticket, all in: what a refund of it returns. |
| `data.order.tickets.price_label` | string |  |  |
| `data.order.tickets.face` | number |  | The all-in list price before a discount. |
| `data.order.tickets.refunded` | number |  |  |
| `data.order.tickets.refunded_at` | string |  |  |
| `data.order.tickets.block_reason` | string |  | Why staff blocked it. A disputed payment reads Payment disputed. |
| `data.order.tickets.passed_on` | boolean |  | true: the ticket was made when a holder passed a ticket on. |
| `data.order.tickets.replaces_id` | integer |  | The ticket this one replaced. 0 = none. |
| `data.order.tickets.replaced_by_id` | integer |  | The ticket that replaced this one. 0 = none. |
| `data.order.tickets.page_url` | string |  | The ticket page of this ticket. Anyone who has the link can open the ticket: treat it like a password and give it only to the buyer. Empty in webhook events, for an erased order and for a ticket that is no longer valid. |
| `data.order.tickets.created` | string |  |  |
| `data.order.tickets.updated` | string |  |  |
| `data.order.tickets.buyer` | object |  | Only in the rows of GET /tickets/issued: who bought it. |
| `data.order.tickets.buyer.name` | string |  |  |
| `data.order.tickets.buyer.contact` | string |  |  |
| `data.order.tickets.buyer.email` | string |  |  |
| `data.refund` | object | yes |  |
| `data.refund.amount` | number |  | What went back by this change, in the order's currency. |
| `data.refund.amount_label` | string |  |  |
| `data.refund.ticket_ids` | integer[] |  | The tickets that stopped being valid. |
| `data.refund.money` | string |  | How the money went back. none: the tickets were cancelled without a refund.; one of: `provider`, `recorded`, `outside`, `none` |
| `data.refund.full` | boolean |  | No valid ticket is left on the order. |
| `data.refund.by` | string |  | Who did it. |
| `data.refund.reason` | string |  |  |
| `data.timestamp` | string | yes |  |

## Samples

### staff refund

```json
{
  "id": "evt_Tkt3k9m2Lw8Rt5Yp1Zs02",
  "type": "ticket.order.refunded",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "order": {
      "id": 8812,
      "reference": "TK-7H3KQ9",
      "status": "partly_refunded",
      "kind": "online",
      "channel": "web",
      "source": "",
      "event": {
        "id": 12,
        "name": "Summer Quiz",
        "slug": "summer-quiz"
      },
      "date": {
        "id": 31,
        "start": "2026-12-12T08:30:00.000Z",
        "start_local": "2026-12-12T19:30",
        "label": ""
      },
      "buyer": {
        "name": "John Smith",
        "contact": "61412345678",
        "email": "",
        "no_whatsapp": false
      },
      "currency": "AUD",
      "total": 24,
      "total_label": "A$24.00",
      "tickets_total": 24,
      "order_fee": 0,
      "donation": 0,
      "discount": 0,
      "fees": 0,
      "tax": 0,
      "refunded": 12,
      "refunded_label": "A$12.00",
      "ticket_count": 2,
      "people_count": 2,
      "addon_count": 0,
      "promo_code": "",
      "payment": {
        "id": 15,
        "method": "stripe",
        "note": ""
      },
      "comp_reason": "",
      "staff_note": "",
      "created_by": "customer",
      "attention": "",
      "close_reason": "",
      "refund_request": null,
      "answers": {},
      "marketing_optin": false,
      "erased": false,
      "page_url": "",
      "expires": null,
      "confirmed": "2026-11-06T01:00:00.000Z",
      "cancelled": null,
      "refunded_at": "2026-11-06T01:00:00.000Z",
      "created": "2026-11-06T01:00:00.000Z",
      "updated": "2026-11-06T01:00:00.000Z",
      "tickets": [
        {
          "id": 501,
          "order_id": 8812,
          "order_reference": "TK-7H3KQ9",
          "event_id": 12,
          "date_id": 31,
          "type_id": 44,
          "type_name": "Adult",
          "role": "ticket",
          "seq": 1,
          "status": "valid",
          "holder_name": "John Smith",
          "answers": {},
          "seat": null,
          "admits": 1,
          "check_in": {
            "people": 0,
            "inside": 0,
            "entries": 0,
            "first_at": null,
            "last_at": null,
            "last_out_at": null,
            "gate": ""
          },
          "currency": "AUD",
          "price": 12,
          "price_label": "A$12.00",
          "face": 12,
          "refunded": 0,
          "refunded_at": null,
          "block_reason": "",
          "passed_on": false,
          "replaces_id": 0,
          "replaced_by_id": 0,
          "page_url": "",
          "created": "2026-11-06T01:00:00.000Z",
          "updated": "2026-11-06T01:00:00.000Z"
        },
        {
          "id": 502,
          "order_id": 8812,
          "order_reference": "TK-7H3KQ9",
          "event_id": 12,
          "date_id": 31,
          "type_id": 44,
          "type_name": "Adult",
          "role": "ticket",
          "seq": 2,
          "status": "refunded",
          "holder_name": "John Smith",
          "answers": {},
          "seat": null,
          "admits": 1,
          "check_in": {
            "people": 0,
            "inside": 0,
            "entries": 0,
            "first_at": null,
            "last_at": null,
            "last_out_at": null,
            "gate": ""
          },
          "currency": "AUD",
          "price": 12,
          "price_label": "A$12.00",
          "face": 12,
          "refunded": 12,
          "refunded_at": "2026-11-06T01:00:00.000Z",
          "block_reason": "",
          "passed_on": false,
          "replaces_id": 0,
          "replaced_by_id": 0,
          "page_url": "",
          "created": "2026-11-06T01:00:00.000Z",
          "updated": "2026-11-06T01:00:00.000Z"
        }
      ]
    },
    "refund": {
      "amount": 12,
      "amount_label": "A$12.00",
      "ticket_ids": [
        502
      ],
      "money": "provider",
      "full": false,
      "by": "Jane Doe jane@example.com",
      "reason": "cannot come"
    },
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

## Caused by

- [Cancel an event and refund or void its tickets](https://www.app2email.com/docs/api/tickets-and-pay/cancel-ticket-event.md): `POST /v1/{number}/tickets/events/{id}/cancel`
- [Cancel one date and refund or void its tickets](https://www.app2email.com/docs/api/tickets-and-pay/cancel-ticket-date.md): `POST /v1/{number}/tickets/dates/{date_id}/cancel`
- [Refund an order or some of its tickets](https://www.app2email.com/docs/api/tickets-and-pay/refund-ticket-order.md): `POST /v1/{number}/tickets/orders/{id}/refund`
- [Void one ticket without a refund](https://www.app2email.com/docs/api/tickets-and-pay/void-ticket.md): `POST /v1/{number}/tickets/issued/{id}/void`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=ticket.order.refunded
