웹훅 이벤트 카탈로그
이 페이지는 Wink에서 구독할 수 있는 모든 웹훅 이벤트를 나열합니다. 설정 방법은 Webhook Integration Guide 또는 Webhooks 관리 페이지를 참조하세요.
구독 방법
섹션 제목: “구독 방법”- 포털에서 Applications > Webhooks로 이동합니다.
- 웹훅을 생성하고 수신할 이벤트를 선택하세요 — 또는 모든 이벤트를 수신하려면 목록을 비워두세요.
- 이벤트가 발생할 때마다 Wink가 서명된 HTTP POST를 귀하의 엔드포인트로 전송합니다. 봉투, 헤더, 서명 검증 및 재시도에 대해서는 Webhook Integration을 참조하세요.
모든 이벤트 유형
섹션 제목: “모든 이벤트 유형”이 표는 빌드 시 플랫폼의 이벤트 카탈로그에서 생성되므로 항상 API와 일치합니다.
전달된 것으로 표시된 이벤트 유형은 Webhooks API의 참조 페이지에 링크되어 있으며,
정확한 JSON 본문(WebhookEnvelope과 이벤트별 object), Wink-* 헤더 및
재시도 정책을 문서화합니다. 전달되지 않는 이벤트 유형은 내부적으로 존재하지만(결제, 원장, 채널 관리자
동기화 등) 현재 웹훅 구독자에게 전송되지 않습니다.
수신자는 이벤트를 받는 대상을 나타냅니다: SUPPLIER (호텔), AFFILIATE (호텔에 활성 판매 채널이 있는 리셀러), AGENT (예약을 한 여행사) 또는 SELF (이벤트 대상 관리 주체). 모든 수신자는 동일한 페이로드 형식을 받으며, 역할별 세부 정보는
페이로드의 links.self URL 뒤에 있습니다.
account.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
account.details.updated | The account's details changed. | 전달되지 않음 | — |
account.managers.update | The account's manager list changed. | ✓ 전달됨 | SELF |
account.task.complete | An onboarding task was completed. | 전달되지 않음 | — |
account.task.create | An onboarding task was created for the account. | 전달되지 않음 | — |
account.task.remove | An onboarding task was removed. | 전달되지 않음 | — |
account.task.tax_id.complete | The tax-id onboarding task was completed. | 전달되지 않음 | — |
account.task.update | An onboarding task was updated. | 전달되지 않음 | — |
account.under_review | The account was placed under review. | 전달되지 않음 | — |
activity.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
activity.created | An activity was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
activity.deleted | An activity was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
activity.updated | An activity was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
add_on.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
add_on.created | An add-on was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
add_on.deleted | An add-on was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
add_on.updated | An add-on was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
booking.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
booking.cancelled | A booking was cancelled. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.create | A booking was created (confirmed). | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.failed | A booking attempt failed. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.funds.available | Funds for a booking became available for payout. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.funds.ledgered | Funds for a booking were added to the ledger. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.initialize.complete | A booking initialisation completed. | 전달되지 않음 | — |
booking.initialize.request | A booking initialisation (checkout) was requested. | 전달되지 않음 | — |
booking.payout.complete | A payout for a booking completed. | 전달되지 않음 | — |
booking.payout.create | A payout for a booking was created. | 전달되지 않음 | — |
booking.processing | A booking is being processed. | 전달되지 않음 | — |
booking.refund.error | A booking was refunded because of a processing error. | 전달되지 않음 | — |
booking.refund.full | A booking was fully refunded. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.refund.partial | A booking was partially refunded. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.refund.request | A refund was requested for a booking. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.review.created | A guest submitted a review for a booking. | ✓ 전달됨 | SUPPLIER |
booking.review.responded | The hotel responded to a guest review. | ✓ 전달됨 | AFFILIATE, AGENT, SUPPLIER |
booking.sync.failed | A booking-to-channel-manager synchronisation failed. | 전달되지 않음 | — |
booking.sync.run | A booking-to-channel-manager synchronisation run started. | 전달되지 않음 | — |
channel-manager.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
channel-manager.update | A channel manager pushed an update. | 전달되지 않음 | — |
channel-manager.update.availability | A channel manager pushed an availability update. | 전달되지 않음 | — |
channel-manager.update.rate | A channel manager pushed a rate update. | 전달되지 않음 | — |
email.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
email.correspondence | An email correspondence was recorded. | 전달되지 않음 | — |
internal.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
internal.payment.failed | A payment failed (internal). | 전달되지 않음 | — |
internal.payment.processing | A payment is processing (internal). | 전달되지 않음 | — |
internal.payment.succeeded | A payment succeeded (internal). | 전달되지 않음 | — |
ledger.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
ledger.entry.create | A ledger entry was created. | 전달되지 않음 | — |
managing_entity.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
managing_entity.account_representative.updated | The account representative changed. | 전달되지 않음 | — |
managing_entity.agent.email.notification | An email notification was sent to the account's agent. | 전달되지 않음 | — |
managing_entity.agent.updated | The account's travel-agent details changed. | 전달되지 않음 | — |
managing_entity.city.updated | The account's address or city changed. | ✓ 전달됨 | SELF |
managing_entity.created | A managing entity (account) was created. | ✓ 전달됨 | SELF |
managing_entity.deleted | The account was deleted. | ✓ 전달됨 | SELF |
managing_entity.information.updated | The account's general information changed. | ✓ 전달됨 | SELF |
managing_entity.logo.updated | The account's logo changed. | ✓ 전달됨 | SELF |
managing_entity.managed_by.updated | The entity managing this account on its behalf changed. | ✓ 전달됨 | SELF |
managing_entity.manager.accepted | An invited manager accepted the invitation. | 전달되지 않음 | — |
managing_entity.manager.added | A manager was added to the account. | ✓ 전달됨 | SELF |
managing_entity.manager.email.notification | An email notification was sent to an account manager. | 전달되지 않음 | — |
managing_entity.manager.invited | A manager was invited to the account. | ✓ 전달됨 | SELF |
managing_entity.manager.owner.set | The account owner was set. | ✓ 전달됨 | SELF |
managing_entity.manager.rejected | An invited manager rejected the invitation. | 전달되지 않음 | — |
managing_entity.manager.removed | A manager was removed from the account. | ✓ 전달됨 | SELF |
managing_entity.name.updated | The account's display name changed. | 전달되지 않음 | — |
managing_entity.place_id.updated | The account's Google Place ID changed. | ✓ 전달됨 | SELF |
managing_entity.profile_picture.updated | The account's profile picture changed. | ✓ 전달됨 | SELF |
managing_entity.status.updated | The account's platform status changed (e.g. approved, suspended). | ✓ 전달됨 | SELF |
managing_entity.subscription.changed | The account's platform subscription changed. | 전달되지 않음 | — |
managing_entity.subscription.invoice.changed | The status of a subscription invoice changed. | ✓ 전달됨 | SELF |
managing_entity.subscription.provisioned | A platform subscription was provisioned for the account. | ✓ 전달됨 | SELF |
managing_entity.unique_id.updated | The account's short unique id changed. | ✓ 전달됨 | SELF |
managing_entity.url_name.updated | The account's URL name (slug) changed. | ✓ 전달됨 | SELF |
master_rate.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
master_rate.created | A master rate was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
master_rate.deleted | A master rate was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
master_rate.updated | A master rate was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
meeting_room.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
meeting_room.created | A meeting room was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
meeting_room.deleted | A meeting room was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
meeting_room.updated | A meeting room was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
payee.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
payee.create | A payee was created. | 전달되지 않음 | — |
payee.create.failure | Creating a payee failed. | 전달되지 않음 | — |
payee.update | A payee was updated. | 전달되지 않음 | — |
payee.update.failure | Updating a payee failed. | 전달되지 않음 | — |
perk.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
perk.deleted | A perk was deleted. | 전달되지 않음 | — |
perk.updated | A perk was updated. | 전달되지 않음 | — |
property.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
property.address.updated | A property's address changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.created | A property (hotel) was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.deleted | A property was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.geolocation.updated | A property's geolocation changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.name.updated | A property's name changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.policy.created | A property policy was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.policy.updated | A property policy changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.profile.updated | A property's profile changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.registered | A property completed registration. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.services.updated | A property's services/amenities changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.status.updated | A property's platform status changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
property.updated | A property was updated. | 전달되지 않음 | — |
property.welcome_text.updated | A property's welcome text changed. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
rate_modifier.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
rate_modifier.updated | A rate modifier was updated. | 전달되지 않음 | — |
rate_plan.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
rate_plan.created | A rate plan was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
rate_plan.deleted | A rate plan was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
rate_plan.updated | A rate plan was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
restaurant.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
restaurant.created | A restaurant was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
restaurant.deleted | A restaurant was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
restaurant.updated | A restaurant was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
room_type.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
room_type.created | A room type was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
room_type.deleted | A room type was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
room_type.updated | A room type was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
sales_channel.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
sales_channel.created | A sales-channel relationship (supplier ↔ reseller) was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
sales_channel.deleted | A sales-channel relationship was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
sales_channel.updated | A sales-channel relationship was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
spa.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
spa.created | A spa was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
spa.deleted | A spa was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
spa.updated | A spa was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
special_rate.*
| 이벤트 | 설명 | 전달됨 | 수신자 |
|---|---|---|---|
special_rate.created | A promotion (special rate) was created. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
special_rate.deleted | A promotion was deleted. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
special_rate.updated | A promotion was updated. | ✓ 전달됨 | AFFILIATE, SUPPLIER |
추가 자료
섹션 제목: “추가 자료”- Webhook Integration Guide — 설정 단계 및 모범 사례.
- Webhooks — 웹훅 구독 관리.
- Applications — API 자격 증명 관리.
- Build on Wink — 개발자를 위한 플랫폼 개요.