STABLE_COIN_PAYMENT_WEBHOOK 端点发送一个已签名的 HTTP POST 请求。这是 VelaFi 发送的唯一一种稳定币支付事件。被拒绝、已取消、已退款或因金额或网络不匹配而被标记的订单不会触发 Webhook。推送内容包括完整的订单详情、区块链交易数据以及涉及的链上地址。您的端点应验证 signature 请求头，并返回 HTTP 200 和 {"callbackStatus": "SUCCESS"} 以确认接收。如果您的端点未在超时时间内响应，VelaFi 将重试投递。
请求头
推送字段
string
投递此事件的 Webhook 端点 ID。
string
对于此事件类型，始终为
STABLE_COIN_PAYMENT_WEBHOOK。string
唯一的支付订单 ID。
string
与该支付订单关联的用户 ID。
string
拥有该支付订单的商户 ID。
string
生成该订单的支付链接 ID。
string
目标钱包 ID。
string
目标钱包的可读名称。
string
您作为商户为该订单提供的参考编号。
string
支付所用的稳定币币种（例如
USDT、USDC）。string
网络代码（例如
USDT-POL、USDT-BEP20）。string
可读的网络名称（例如
Polygon (POS)、Binance Smart Chain (BEP20)）。string
付款方存入的总金额。
string
从存入金额中扣除的交易手续费。
string
扣除手续费后的实收净额（
depositAmount - feeAmount）。string
投递时的订单状态。由于此 Webhook 在订单确认时发送，该值通常为
CONFIRMED。string
链上发送方钱包地址。
string
链上接收方钱包地址。
string
链上结算的区块链交易哈希。
string
与该订单关联的支付链接 URL。
string
订单创建时的 Unix 时间戳（毫秒）。
string
订单未支付时将被取消的 Unix 时间戳（毫秒）。创建订单时会将其设置为
createTime 之后 30 分钟，因此已确认的订单也包含此字段。string
开始处理时的 Unix 时间戳（毫秒）。
string
链上交易确认时的 Unix 时间戳（毫秒）。
string
本次投递尝试签名时的 Unix 时间戳（毫秒）。
推送示例
Incoming POST body
必需的响应
请返回以下 JSON 响应体，HTTP 状态码为200：
Your response
所有值均以 JSON 字符串形式发送。时间戳为 Unix 毫秒，未设置的时间戳将以字符串
"null" 发送。txHash 唯一标识链上结算——如果您的合规流程有此要求，可使用它在区块链上独立验证交易的最终性。