跳转到主要内容
对于通过 API 创建、并指定了目标网络和钱包地址的入金(BUY)订单,VelaFi 可以在订单完成后将购买的加密货币提现到该地址。提现成功后,VelaFi 会向您的 ON_RAMP_WITHDRAW_WEBHOOK 端点发送一个已签名的 HTTP POST 请求。请验证 signature 请求头,并以 {"callbackStatus": "SUCCESS"} 响应以确认接收。
自动提现到目标地址的功能由 VelaFi 按账户开通,并非每个订单都会自动提现。未自动提现的订单不会触发此 Webhook。如果您订阅了 CRYPTO_WITHDRAW_WEBHOOK,自动提现也会触发该事件。

请求头

负载字段

string
该事件所排队推送的 Webhook ID。
string
对于此事件类型,始终为 ON_RAMP_WITHDRAW_WEBHOOK。
string
入金订单的 ID。
string
您的 VelaFi 账户(用户)ID。
string
您提供的客户端订单标识符。如果您未提供,则省略此字段。
string
提现所用的网络,与订单上设置的一致。
string
目标钱包地址,与订单上设置的一致。
string
订单的加密货币,例如 USDT。
string
订单的加密货币数量(与 ORDER_WEBHOOK 中的 cryptoAmount 值相同)。
string
提现的链上交易哈希。不可用时省略。
string
始终为 succeeded。提现失败不会触发此 Webhook。
string
本次推送尝试签名时的 Unix 时间戳(毫秒)。

负载示例

Incoming POST body

必需的响应

返回 HTTP 2xx 状态(例如 200)及以下 JSON 响应体以确认接收:
Your response
同一事件可能会多次送达,因此请按 orderId 进行去重。请参阅推送与重试。