GLOBAL_PAYMENT_WEBHOOK 端点发送一个已签名的 HTTP POST 请求。负载描述了跨境支付的两端——入金端（来源国家/币种）和出金端（目标国家/币种）——以及当前订单状态。请验证 signature 请求头，并以 {"callbackStatus": "SUCCESS"} 响应以确认接收。
请求头
订单状态码
其他全球支付状态不会推送。
负载字段
string
推送此事件的 Webhook 端点 ID。
string
对于此事件类型，始终为
GLOBAL_PAYMENT_WEBHOOK。string
全球支付订单的唯一标识符。
string
您提供的客户端订单标识符。如果您未提供，则省略此字段。
string
您的 VelaFi 账户（用户）ID。
string
来源国家名称（例如
Mexico）。string
处理来源端支付的入金商户 ID。未设置时省略。
string
向付款方收取的法币（例如
MXN）。string
以来源币种向付款方收取的金额。
string
入金端收取的费用。未设置时省略。
string
目标国家名称（例如
Hong Kong）。string
处理目标端支付的出金商户 ID。未设置时省略。
string
交付给收款人的法币（例如
USD）。string
以目标币种交付给收款人的金额。
string
出金端收取的费用。未设置时省略。
string
入金币种与出金币种之间的实际汇率。
string
当前订单状态码。请参阅上方的状态表。
string
订单创建时的 Unix 时间戳（毫秒）。
string
订单最后更新时的 Unix 时间戳（毫秒）。
string
本次推送尝试签名时的 Unix 时间戳（毫秒）。
负载示例
Incoming POST body
必需的响应
返回 HTTP 状态200 及以下 JSON 响应体以确认接收：
Your response
此 Webhook 仅针对上面列出的状态触发。如果在尝试推送时订单已进入后续状态，某个状态可能会被跳过。同一事件可能会多次送达，因此请结合
orderId 和 orderStatus 进行去重。请参阅推送与重试。