コンテンツにスキップ

Webhookイベントカタログ

このページでは、Winkで購読可能なすべてのWebhookイベントを一覧表示しています。設定手順については、Webhook統合ガイドまたはWebhook管理ページをご覧ください。

  1. ポータルのApplications > Webhooksに移動します。
  2. Webhookを作成し、受信したいイベントを選択します。
  3. イベントが発生するたびにWinkがHTTP POSTをエンドポイントに送信します。

完全な設定手順とベストプラクティスについては、Webhook統合をご覧ください。


TripPayアカウントのライフサイクルおよび設定に関連するイベント。

イベントキー説明
アカウント作成account.create新しいアカウントが作成されました。
アカウント審査中account.under_reviewアカウントが審査待ちです。
アカウント更新account.updatedアカウントの詳細が変更されました。
アカウントステータス更新account.status.updatedアカウントのステータスが変更されました(例:承認、停止)。
アカウント住所更新account.address.updatedアカウントの住所が変更されました。
アカウント詳細更新account.details.updatedアカウントの詳細フィールドが変更されました。
アカウント情報更新account.information.update一般的なアカウント情報が更新されました。
アカウントマネージャー更新account.managers.updateアカウントマネージャーのリストが変更されました。
プロフィール画像更新account.profile_picture.updatedアカウントのプロフィール画像が変更されました。
エージェント更新account.agent.updatedアカウントのエージェント情報が変更されました。
URL名更新account.url-name.updateアカウントのバニティURLが変更されました。
ユニークID更新account.unique-id.updateアカウントのユニーク識別子が変更されました。
イベントキー説明
タスク作成account.task.create新しいタスクがアカウントに追加されました。
タスク更新account.task.updateアカウントのタスクが変更されました。
タスク削除account.task.removeアカウントのタスクが削除されました。
タスク完了account.task.completeアカウントのタスクが完了しました。
税IDタスク完了account.task.tax_id.complete税ID確認タスクが完了しました。
イベントキー説明
アクワイアラー作成account.acquirer.created新しいアクワイアラーがアカウントに追加されました。
アクワイアラー更新account.acquirer.updatedアカウントのアクワイアラーが変更されました。
アクワイアラー削除account.acquirer.removedアカウントからアクワイアラーが削除されました。

支払先(支払い受取人)管理に関連するイベント。

イベントキー説明
支払先作成payee.create新しい支払先が正常に作成されました。
支払先作成失敗payee.create.failure支払先の作成に失敗しました。
支払先更新payee.update支払先が更新されました。
支払先更新失敗payee.update.failure支払先の更新に失敗しました。

TripPayを通じた予約契約のライフサイクルを追跡するイベント。

イベントキー説明
初期化リクエストbooking.contract.initialize.request予約契約の初期化がリクエストされました。
初期化完了booking.contract.initialize.complete予約契約の初期化が完了しました。
契約作成booking.contract.created新しい予約契約が作成されました。
契約処理中booking.contract.processing予約契約の支払いが処理中です。
契約失敗booking.contract.failed予約契約の支払いが失敗しました。
契約キャンセルbooking.contract.cancelled予約契約がキャンセルされました。
部分返金booking.contract.refund.partial契約に対して部分返金が行われました。
全額返金booking.contract.refund.full契約に対して全額返金が行われました。
返金リクエストbooking.contract.refund.request返金リクエストが送信されました。
返金エラーbooking.contract.refund.error返金処理中にエラーが発生しました。
支払い作成booking.contract.payout.create契約に対する支払いが作成されました。
支払い完了booking.contract.payout.complete支払いが正常に完了しました。

内部支払い処理イベント。

イベントキー説明
支払い成功internal.payment.succeeded支払いが正常に処理されました。
支払い処理中internal.payment.processing支払いが現在処理中です。
支払い失敗internal.payment.failed支払い処理に失敗しました。

Winkの予約ライフサイクルに関するイベント。

イベントキー説明
予約作成booking.create新しい予約が作成されました。
予約キャンセルbooking.cancelled予約がキャンセルされました。

チャンネルマネージャーイベント

Section titled “チャンネルマネージャーイベント”

チャンネルマネージャーの料金および空室状況の更新に関連するイベント。

イベントキー説明
料金更新channel-manager.update.rateチャンネルマネージャーが料金の更新をプッシュしました。
空室状況更新channel-manager.update.availabilityチャンネルマネージャーが空室状況の更新をプッシュしました。
一般更新channel-manager.update一般的なチャンネルマネージャーの更新。

財務元帳のエントリに関連するイベント。

イベントキー説明
元帳エントリ作成ledger.entry.create新しい元帳エントリが記録されました。

管理エンティティ(物件、アフィリエイト、会社)およびその管理に関するイベント。

イベントキー説明
サブスクリプション提供managing_entity.subscription.provisioned新しいサブスクリプションが提供されました。
サブスクリプション変更managing_entity.subscription.changedサブスクリプションプランが変更されました。
サブスクリプション請求書変更managing_entity.subscription.invoice.changedサブスクリプション請求書が更新されました。
イベントキー説明
ステータス更新managing_entity.status.updatedエンティティのステータスが変更されました。
エンティティ削除managing_entity.deleted管理エンティティが削除されました。
エージェント更新managing_entity.agent.updatedエンティティのエージェントが変更されました。
エージェントメール通知managing_entity.agent.email.notificationエージェントにメール通知が送信されました。
マネージャーメール通知managing_entity.manager.email.notificationマネージャーにメール通知が送信されました。

マネージャーのライフサイクル

Section titled “マネージャーのライフサイクル”
イベントキー説明
マネージャー追加managing_entity.manager.added新しいマネージャーが追加されました。
マネージャー招待managing_entity.manager.invitedマネージャー招待が送信されました。
マネージャー削除managing_entity.manager.removedマネージャーが削除されました。
マネージャー承認managing_entity.manager.acceptedマネージャー招待が承認されました。
マネージャー拒否managing_entity.manager.rejectedマネージャー招待が拒否されました。
オーナー設定managing_entity.manager.owner.setエンティティの所有権が移転されました。
イベントキー説明
情報更新managing_entity.information.updatedエンティティ情報が更新されました。
住所更新managing_entity.city.updatedエンティティの住所/市区町村が変更されました。
アカウント担当者更新managing_entity.account_representative.updatedアカウント担当者が変更されました。
プロフィール画像更新managing_entity.profile_picture.updatedエンティティのプロフィール画像が更新されました。
ロゴ更新managing_entity.logo.updatedエンティティのロゴが更新されました。
URL名更新managing_entity.url_name.updatedエンティティのバニティURLが変更されました。
ユニークID更新managing_entity.unique_id.updatedエンティティのユニーク識別子が変更されました。
名前更新managing_entity.name.updatedエンティティ名が変更されました。

カテゴリ件数
アカウントイベント20
支払先イベント4
予約契約イベント12
支払いイベント3
予約イベント2
チャンネルマネージャーイベント3
元帳イベント1
管理エンティティイベント19
合計64