有关端点配置、签名验证、重试以及投递故障排查，请参阅 Webhooks 指南。
两类 webhook
法币入金可以发送两类互补的 webhook：
请使用
onramp.payment-order.* 跟踪订单创建和付款状态。请将 onramp.* 作为对账和资产结算的权威交易信号。当 transactionId 有值时，支付订单负载中的该字段会将订单关联到对应的 ONRAMP 交易。
交易事件包括 onramp.processing、onramp.success、onramp.failed 和 onramp.cancelled。其 data.paymentOrder 关联字段标识发起该交易的订单。有关权威负载和处理指南，请参阅法币入金交易 webhooks。
支付订单事件
onramp.payment-order.created
在 Blockradar 通过所选服务商成功创建支付订单后发送。负载中包含您的客户完成法币转账所需的付款说明。
onramp.payment-order.paid
在 Blockradar 确认已收到法币付款且支付订单已成功结算时发送。如有，transactionId 标识相关的 Blockradar 交易。
onramp.payment-order.failed
在支付订单无法完成时发送。如果您需要最新的服务商响应和失败详情，请使用其 id 获取该支付订单。
onramp.payment-order.cancelled
在支付订单于成功结算前被取消时发送。触发原因可能是取消请求成功，也可能是服务商的状态更新。
负载
所有支付订单 webhook 请求均使用以下结构：data 结构。当前阶段尚不可用的字段可能为 null。尤其是在 onramp.payment-order.created 事件中，transactionId、amountFiatReceived 和 amountSettled 可能尚未填充。
处理事件
- 事件被接受后，请尽快返回成功的
2xx响应。 - 使用
data.id作为支付订单标识符，并确保处理具有幂等性。 - 不要假设事件只会到达一次或按特定顺序到达。
- 在您的系统中更新订单时，请同时使用
event和data.status。 - 将
onramp.payment-order.paid视为成功的终态事件。 - 将
onramp.success视为对应法币入金交易的成功终态事件。