概要
Payment Options Gatewayは、取引イベントが発生すると、加盟店が設定したwebhook_url にWebhook通知を送信します。
これらの通知には、取引ステータス、決済情報、加盟店情報、ゲートウェイレスポンスコードが含まれ、加盟店は決済結果を確認し、システムを適切に更新できます。
Webhook通知は、購入、売上確定、返金など、対応するさまざまな決済方法や取引タイプに対して送信される場合があります。
主なポイント
Webhook通知
- Webhook通知は、決済リクエストで設定された
webhook_urlに送信されます。 successフィールドは、通知された取引イベントが成功したかどうかを示します。gateway_responseオブジェクトには、ゲートウェイのレスポンスコード、タイプ、メッセージが含まれます。payment_detailsオブジェクトには決済関連情報が含まれ、その内容は決済方法によって異なる場合があります。merchant_detailsおよびtransaction_detailsオブジェクトには、加盟店および取引の識別情報が含まれます。
- 決済開始時のレスポンスは、必ずしも取引の完了を意味しません。
- 加盟店は決済記録を更新する前に、Webhook通知を検証し、取引ステータスを確認する必要があります。
- Webhookのフィールドおよび値は、決済方法、取引タイプ、処理結果によって異なる場合があります。
Webhookレスポンスサンプル
以下は、PayNowを使用した決済成功時のWebhook通知の一例です。レスポンス構造や決済方法固有のフィールドは、取引タイプや決済方法によって異なる場合があります。レスポンス属性
上記の例は、開発環境におけるPayNow決済成功時のWebhook通知を示しています。Webhookのフィールドおよび値は、決済方法、取引タイプ、処理結果によって異なる場合があります。加盟店は注文を確定する前に、受信したWebhook通知を検証し、取引ステータスを確認するとともに、重複通知を安全に処理する必要があります。