Skip to main content

添加端点

仪表盘 → Webhooks → 添加您的 HTTPS 网址并选择事件(建议从 payment.confirmed 开始)。您将获得一个签名密钥(whsec_…)。

Payload

验证签名

在信任任何数据之前,务必先验证:

事件

wallet.*bridge.* 的 payload 包含 walletId/bridgeTransferIdchain/routeamount,以及相关的交易哈希——结构与 WalletsBridge 的 API 响应一致。

争议

当客户在您的结账页面报告发送的资金未能自动确认时(金额不符、地址错误,或 延迟发送),系统会创建一个争议。这在客户一侧是自助式的(他们会立即收到 matchedWallet / amountCovered / lateByMinutes 的结果), payment.dispute_opened 会给您同样详细的信息,以便在自动检查无法解决问题 时人工跟进——例如,即便金额略有不足,您也可以自行决定为订单放行。

投递与重试

  • 请在 10 秒内响应 2xx;其他任何情况都视为失败。
  • 我们会以退避策略最多重试 3 次;投递记录和状态码均可在仪表盘中查看。
  • 处理程序必须幂等——请以 paymentIntentId 作为去重键。