コンテンツへスキップ
ArionPay

ナレッジベース · 4分で読めます

Webhook署名の検証

注文を処理する前に、すべてのWebhookでArionPay-Signatureヘッダーを確認します。

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です。

注文を処理する前に

  1. 生のリクエスト本文から署名を計算し、定数時間で比較します。
  2. 古いタイムスタンプは拒否します(目安は5分より古いもの)。
  3. イベントIDを使い、同じ配信が繰り返されても注文を二重に発送しないようにします。
  4. data.invoice.id(請求書の作成時に保存したもの)で注文を探し、amountFiatとcurrencyを確認します。
  5. 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'));
}