Webhook

Webhookを使用するとAPIもしくはダッシュボード上で取引がされる毎に、自動的にOmiseサーバーから指定されたURLへHTTP通信で通知が送られる仕組みを指します。通知内容は、取引に関するペイロードのデータを含むイベントオブジェクトで選択したURLに送信されます。送信先URLは何回でも変更が可能で、テストモードとライブモードでURLを使い分ける事も出来ます。全てのイベントデータは、ダッシュボード内の”イベント”で確認を行うか、APIから直接取得する仕組みになっています。

OmiseのWebhookでは、有効なSSL証明書のあるHTTPSのURLがご利用いただけます。www.letsencrypt.orgから無料のSSL証明書を取得できます。SSL testよりWebhook URLを検証可能です。

イベントのリスト

課金に関するイベント

Event Name Trigger
charge.create 課金が作成された
charge.update 課金が更新された
charge.capture 課金が実売上化された (マニュアルキャプチャー設定の場合)
charge.reverse 課金が取消された (マニュアルキャプチャー設定の場合)
charge.complete 課金が完了した (3Dセキュア利用時)

顧客に関するイベント

Event Name Trigger
customer.create 顧客が作成された
customer.update 顧客が更新された
customer.destroy 顧客が削除された
customer.update.card 顧客がカード情報を更新した

クレジットカードに関するイベント

Event Name Trigger
card.update カードが更新された
card.destroy カードが削除された

チャージバック(dispute)に関するイベント

Event Name Trigger
dispute.create チャージバックの要請を開始した時
dispute.update チャージバックが更新された
dispute.close チャージバック要請の結果が出た

レシピエント(振込先口座)に関するイベント

Event Name Trigger
recipient.create レシピエントが作成された
recipient.update レシピエントが更新された
recipient.destroy レシピエントが削除された
recipient.activate レシピエントが有効化された
recipient.deactivate レシピエントが無効化された
recipient.verify レシピエントが承認された

返金に関するイベント

Event Name Trigger
refund.create 返金が作成された

振込に関するイベント

Event Name Trigger
transfer.create 振込が作成された
transfer.update 振込が更新された
transfer.destroy 振込が削除された
transfer.send 振込リクエストを送信された
transfer.pay 振込が完了した