Webhook署名の検証
送信する内容
各Webhookは、次のヘッダーを付けて、ストアのWebhook URLにJSONでPOSTされます:
ArionPay-Event:invoice.pending、invoice.partial、invoice.paid、invoice.expired、invoice.needs_reviewのいずれか。ArionPay-Event-Id:一意のID。保存しておき、重複したものは無視してください。ArionPay-Signature:t=<timestamp>,v1=<hex>。v1は、ストアのWebhookシークレットで署名した<timestamp>.<raw body>のHMAC-SHA256です。
注文を処理する前に
- 生のリクエスト本文から署名を計算し、定数時間で比較します。
- 古いタイムスタンプは拒否します(目安は5分より古いもの)。
- イベントIDを使い、同じ配信が繰り返されても注文を二重に発送しないようにします。
data.invoice.id(請求書の作成時に保存したもの)で注文を探し、amountFiatとcurrencyを確認します。- 10秒以内に2xxステータスで応答してください。それ以外の応答、リダイレクト、タイムアウトの場合は、約3日間再送されます。
テスト請求書からのWebhookには、テストの印(livemode: false)が付きます。本番環境ではlivemode: trueの場合のみ処理してください。Webhookシークレット(whsec_…)はAPIシークレットとは別のものです。Webhooksページの「Replace secret」で取得します。
// Node.js
const crypto = require('crypto');
// rawBody: the request body exactly as received (a string), before any JSON parsing
function verifyArionPayWebhook(rawBody, header, secret, toleranceSec = 300) {
const parts = Object.fromEntries(header.split(',').map((p) => p.trim().split('=')));
const ts = parts.t || '';
const given = parts.v1 || '';
if (!/^\d+$/.test(ts) || Math.abs(Date.now() / 1000 - Number(ts)) > toleranceSec) return false;
if (!/^[0-9a-f]{64}$/.test(given)) return false;
const expected = crypto
.createHmac('sha256', secret)
.update(`${ts}.${rawBody}`)
.digest();
return crypto.timingSafeEqual(expected, Buffer.from(given, 'hex'));
}