ticketaco
BUSINESS

웹훅 이벤트

티켓타코에서 제공하는 웹훅 이벤트 목록입니다. 웹훅 연동 방법 및 재전송 정책은 웹훅 연결하기 가이드를 참고해주세요.

웹훅 헤더

티켓타코 웹훅은 다음과 같은 헤더가 있습니다.

ticketaco-webhook-delivery-id: 550e8400-e29b-41d4-a716-446655440000
ticketaco-webhook-delivery-retry-count: 0

ticketaco-webhook-delivery-id
웹훅 이벤트 전송 건의 고유 식별자입니다. 재전송 시에도 동일한 값이 유지됩니다.

ticketaco-webhook-delivery-retry-count
웹훅이 재전송된 횟수입니다. 웹훅 재전송 정책을 확인하세요.

order.completed

예매가 완료되면 전송됩니다. 추첨·승인 티켓은 참가신청 후 선정되어 결제까지 완료되면 전송됩니다.
예매 단위로 전송됩니다. 한 번에 3장을 예매해도 이벤트는 1건 전송됩니다.

이벤트 본문

{
  "type": "order.completed",
  "test": true,
  "createdAt": "2025-04-07T14:30:00.000Z",
  "data": {
    "orderNumber": "P0000000001",
    "eventId": "a1b2c3d4",
    "name": "FEConf 2025",
    "quantity": 2,
    "totalAmount": 40000,
    "tickets": [
      {
        "orderTicketNumber": "T0000000001"
        // ...
      }
    ],
    "status": "PAID"
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

data object
상태가 변경된 Order 객체입니다.

ticket.checked_in

참가자가 체크인하면 전송됩니다.

이벤트 본문

{
  "type": "ticket.checked_in",
  "test": true,
  "createdAt": "2025-04-07T14:25:00.000Z",
  "data": {
    "orderTicketNumber": "T0000000001",
    "orderNumber": "P0000000001",
    "ticketTypeName": "일반 참가권",
    "purchaser": {
      "name": "김티켓"
      // ...
    },
    "status": "USED"
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

data object
상태가 변경된 Ticket 객체입니다.

ticket.canceled

티켓을 취소하면 전송됩니다.
티켓 단위로 전송됩니다. 예를 들어, 한 번에 예매한 3장 중 1장을 부분 취소하면 이벤트가 1건 전송되고, 3장 모두 취소하면 3건이 전송됩니다.

이벤트 본문

{
  "type": "ticket.canceled",
  "test": true,
  "createdAt": "2025-04-08T10:00:00.000Z",
  "data": {
    "orderTicketNumber": "T0000000001",
    "orderNumber": "P0000000001",
    "ticketTypeName": "일반 참가권",
    "purchaser": {
      "name": "김티켓"
      // ...
    },
    "status": "CANCELED"
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

data object
상태가 변경된 Ticket 객체입니다.

ticket.updated

양도가 완료되어 소유자가 변경되거나 참가자 정보(이름, 연락처 등)가 변경되면 전송됩니다.
취소나 체크인 같은 상태 변화는 포함되지 않습니다.

이벤트 본문

{
  "type": "ticket.updated",
  "test": true,
  "createdAt": "2025-04-08T15:00:00.000Z",
  "reason": "transferred",
  "data": {
    "orderTicketNumber": "T0000000001",
    "orderNumber": "P0000000001",
    "ticketTypeName": "일반 참가권",
    "purchaser": {
      "name": "김티켓"
      // ...
    }
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

reason string
티켓이 변경된 사유입니다.

  • transferred: 양도가 완료되어 소유자가 변경된 경우입니다.
  • attendee_info_updated: 참가자 정보(이름, 연락처 등)가 변경된 경우입니다.

data object
상태가 변경된 Ticket 객체입니다.

entry.created

추첨·승인 방식의 티켓에서 참가신청이 완료되면 전송됩니다.

이벤트 본문

{
  "type": "entry.created",
  "test": true,
  "createdAt": "2025-04-05T09:00:00.000Z",
  "data": {
    "entryNumber": "E0000000001",
    "eventId": "a1b2c3d4",
    "name": "FEConf 2025",
    "ticketTypeName": "추첨 참가권",
    "status": "PENDING"
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

data object
상태가 변경된 Entry 객체입니다.

entry.canceled

추첨·승인 방식의 티켓에서 참가신청을 취소하면 전송됩니다.

이벤트 본문

{
  "type": "entry.canceled",
  "test": true,
  "createdAt": "2025-04-06T11:00:00.000Z",
  "data": {
    "entryNumber": "E0000000001",
    "eventId": "a1b2c3d4",
    "name": "FEConf 2025",
    "ticketTypeName": "추첨 참가권",
    "status": "CANCELED"
    // ...
  }
}

type string
웹훅 이벤트 타입입니다.

test nullable boolean
테스트 전송 여부입니다. 라이브 웹훅에는 포함되지 않습니다.

createdAt string
웹훅이 생성된 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

data object
상태가 변경된 Entry 객체입니다.