跳至正文

支付团队工具

Pix Webhook Inspector

粘贴 Pix 事件,在影响业务之前发现结构、幂等性和安全问题。

浏览器在本地分析载荷,不会将其发送给 AZPay。

Webhook 载荷

前一次通知(A,可选)
准备就绪。

诊断结果

粘贴 JSON 开始分析。

检查项目

endToEndId 标识单笔 Pix,txid 用于关联账单。请向支付服务商确认收款,再记账一次。 Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

快速检查有助于构建可靠的 Webhook 接收端。签名仍须在服务器上验证。

幂等性

检查稳定标识符,帮助避免重复处理同一笔付款。

付款状态

帮助明确 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 重发。稳定标识符可识别已处理事件,避免重复扣款、入账或发货。

准备好接入支付了吗?

了解如何将 AZPay Checkout 融入您的支付流程。

了解 Checkout