Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

イベントWebhook

Webhookを設定して、Access Worldpayからステータスの更新を受け取ります。

Webhookとは何ですか?

Access Worldpay Webhookは、リクエストのステータスに関するリアルタイムの情報を提供します。Webhookを設定すると、リクエストでステータスが変更されたときに自動的に更新を受け取ることができます。

Worldpayでのボーディング

実装マネージャーに連絡して、Webhook URLを追加し、要件に基づいてイベントを有効または無効にします。

注記:Webhookの宛先(URL)は、暗号化された接続(https)を使用する必要があり、信頼できる認証局によって署名された証明書も必要です。

Webhookの受信

ネットワークアクセス

Webhookは、次のIPアドレスとHTTPSポート443のセットから発信されます。Webアプリケーションファイアウォール(WAF)で、次のアドレスのWebhookを受信できることを確認してください。IPのフルセットは、環境ごとにホワイトリストに登録しなければなりません。

検証中

受信したWebhookがWorldpayからのものであり、改ざんされていないことを確認するために、次のいずれかの確認を実行することを強くお勧めします。

イベントの確認

HTTP(S)応答コード200で応答して、イベントを受信したことを確認します。

警告:確認応答しないと、キュー内の後続のイベントの遅延(または損失)が発生する可能性があります。

  • 200イベント確認応答が10秒以内に受信されない場合、確認が受信されるまでイベントを再試行します。
  • 再試行間隔は試行回数に基づいて増加し、時間間隔はイベントごとに15分から2時間に増加します。
  • 再試行メカニズムは、確認応答(200)が受信された、またはイベントの送信を1週間試みた後のいずれかの後に各イベントの再送信を停止します。

サポートされているイベント

支払イベント


Payoutsイベント

  • 基本的な支払の一括支払には、sentForRefund支払イベントが使用されます。
  • 支払errorイベントは、支払と一括支払に関連するイベントの両方で共有されます。

Fast Accessの一括支払には、次のイベントが用意されています。


Webhookの値

キー説明
eventIdイベントの一意の識別子。
eventTimestampイベントの日付。
eventDetailsイベント情報を含むオブジェクト。
classificationイベントカテゴリー。一括支払または支払のいずれかになります。
transactionReference支払で指定した取引参照。
typeイベントステータス。例えば、cancelledまたはsentForAuthorization
date最初に支払を送信した日付。
reference部分的な決済または部分的な払い戻しのために提供した一意の参照。
refund.onlineRefundAuthorizationオンライン払い戻しのための発行体からの認証コード。

注記:すべての購入返品がオンライン承認のために提出されることを保証するために、VisaおよびMastercardの義務の一部として返される追加情報。2022年4月まで、すべての地域で段階的に導入されます。

refund.refusal.codeオンライン払い戻し承認の拒否コード。
refund.refusal.descriptionオンライン払い戻し承認の拒否の説明。
octReference調整とレポートに使用される単一メッセージOCTのVisa取引ID。sentForRefundまたはrefused支払イベントで返すことができます。

注記:2021年4月中旬からご利用いただけます

amount値とcurrencyCodeを含むオブジェクト。
value承認、一部払い戻し、または全額または一部決済額。指数を含む整数です。指数が2の場合、e.g.250は次の通りです 2.50.
currencyCode通貨コード
_links現在未使用