Webhook 事件目录
本页列出了您可以在 Wink 上订阅的所有 webhook 事件。有关设置说明，请参阅Webhook 集成指南或Webhook 管理页面。
- 在您的门户中导航至 应用 > Webhooks。
- 创建一个 webhook 并选择您想接收的事件 — 或留空以接收所有事件。
- 每当事件发生时，Wink 会向您的端点发送带签名的 HTTP POST。有关信封、头信息、签名验证和重试，请参阅Webhook 集成。
所有事件类型
Section titled “所有事件类型”此表格由平台事件目录在构建时生成，因此始终与 API 保持一致。
标记为已发送的事件类型链接到其在Webhooks API中的参考页面，
该页面记录了精确的 JSON 正文（WebhookEnvelope，包含事件特定的 object）、Wink-* 头信息和重试策略。
未发送的事件类型存在于内部（支付、账本、渠道管理同步等），但当前不会发送给 webhook 订阅者。
接收者 表示谁会收到事件：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 集成指南 — 设置步骤和最佳实践。
- Webhooks — 管理您的 webhook 订阅。
- 应用 — 管理 API 凭证。
- 在 Wink 上构建 — 面向开发者的平台概览。