添加端点
仪表盘 → Webhooks → 添加您的 HTTPS 网址并选择事件(建议从payment.confirmed 开始)。您将获得一个签名密钥(whsec_…)。
Payload
验证签名
在信任任何数据之前,务必先验证:事件
wallet.* 和 bridge.* 的 payload 包含 walletId/bridgeTransferId、
chain/route、amount,以及相关的交易哈希——结构与
Wallets 和 Bridge 的 API 响应一致。
争议
当客户在您的结账页面报告发送的资金未能自动确认时(金额不符、地址错误,或 延迟发送),系统会创建一个争议。这在客户一侧是自助式的(他们会立即收到matchedWallet / amountCovered / lateByMinutes 的结果),
payment.dispute_opened 会给您同样详细的信息,以便在自动检查无法解决问题
时人工跟进——例如,即便金额略有不足,您也可以自行决定为订单放行。
投递与重试
- 请在 10 秒内响应
2xx;其他任何情况都视为失败。 - 我们会以退避策略最多重试 3 次;投递记录和状态码均可在仪表盘中查看。
- 处理程序必须幂等——请以
paymentIntentId作为去重键。