RamboPay 知识库
付款 Webhook 幂等处理与安全验签最佳实践
面向开发者说明如何避免重复发货、假回调和金额不一致。
为什么要幂等
同一个付款成功事件可能因为网络重试被发送多次。如果商家系统没有幂等控制，就可能重复发货或重复开通服务。
验签步骤
读取原始请求体，使用 Webhook Secret 和时间戳计算 HMAC SHA-256，比较签名后再处理业务。
核对金额
处理成功事件前，应核对 payment_id、merchant_order_id、amount、currency 和订单状态。
记录事件
保存 event_id、签名、处理结果和响应时间，方便后续审计和排查。
常见问题
RamboPay 会删除真实订单信息吗？
不会。真实订单明细应由商家保存在自己的系统里，RamboPay 的价值是帮助商家控制支付通道看到的标准化付款摘要。
这是否等于规避支付通道风控？
不是。平台只支持合法交易的商业隐私保护，不支持违法交易、违禁商品、虚假描述或伪装交易。