本文へ移動

決済チーム向けツール

Pix Webhook Inspector

Pix イベントを貼り付けて、運用に影響する前に構造、冪等性、セキュリティの問題を確認できます。

解析はブラウザー内で行われ、データが AZPay に送信されることはありません。

Webhook ペイロード

前回の通知(A、任意)
解析できます。

診断結果

JSON を貼り付けて解析を開始します。

チェック項目

endToEndId は送金を識別し、txid があれば請求と紐付きます。決済事業者で入金を確認し、一度だけ計上してください。 Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

簡易診断は信頼できる受信処理の実装に役立ちます。署名はサーバー側で検証してください。

冪等性

固定の識別子を探し、同じ決済の二重処理を防ぐ手がかりを示します。

決済ステータス

pending、confirmed、failed、refunded などの状態遷移を明確にします。

セキュリティ

例を共有する前に、トークン、パスワード、カード情報の可能性を示します。

どの技術スタックでも安全な受信処理を

副作用のある処理の前にイベント ID を記録し、速やかに応答して非同期で処理します。

for (const pix of payload.pix) {
  await db.transaction(async tx => {
    if (await tx.insertReceiptIfAbsent(pix.endToEndId)) {
      await tx.enqueueReconciliation(pix);
    }
    for (const refund of pix.devolucoes ?? []) {
      await tx.reconcileRefundOnce(refund.rtrId, refund.status);
    }
  });
}
return response(200);

よくある質問

ペイロードはサーバーに送信されますか?

いいえ。基本解析はブラウザー内で行います。実際のトークン、鍵、個人情報、カード情報は貼り付けないでください。

Webhook の署名を検証できますか?

連携用の秘密鍵とアルゴリズムが必要です。このツールは構造や安全上の問題を示します。暗号学的な検証はバックエンドで行ってください。

決済で冪等性が重要なのはなぜですか?

タイムアウトや通信障害で Webhook が再送されることがあります。固定の ID で処理済みイベントを識別し、二重請求、二重計上、二重配送を防げます。

決済を導入しますか?

AZPay Checkout を決済フローに組み込む方法をご覧ください。

Checkout を見る