付款结果通知(Payout Callback)
付款状态发生变化后,Velora 会向创建付款时提交的 notifyUrl 发送异步通知。
通知说明
- 方法:
POST - 地址:商户提交的
notifyUrl - Content-Type:
application/json - 验签:参考 接入准备,使用原始请求体进行校验
通知示例
json
{
"data": {
"amount": {
"value": "200.00",
"currency": "RUB"
},
"status": "Success",
"createdAt": "2026-08-14T07:53:54+00:00",
"updatedAt": "2026-08-14T07:54:02+00:00",
"payoutId": "payout_20260814075354206395313",
"channelOrderId": "20260814075354PD5630484505007955A05",
"merchantOrderId": "PAYOUT_1786694004469_G61WUS"
},
"result": {
"msg": "Payout successfully",
"code": "S0000"
}
}通知字段
| 字段名 | 类型 | 长度 / 限制 | 必返 | 说明 |
|---|---|---|---|---|
data | object | — | 是 | 付款订单和通道处理信息 |
result | object | — | 是 | 本次付款处理结果 |
data 对象
| 字段名 | 类型 | 长度 / 限制 | 必返 | 示例值 | 说明 |
|---|---|---|---|---|---|
amount | object | — | 否 | — | 付款金额 |
status | string | 枚举 | 是 | Success | 付款状态 |
createdAt | string | ISO 8601 | 否 | 2026-08-14T07:53:54+00:00 | 付款订单创建时间 |
updatedAt | string | ISO 8601 | 否 | 2026-08-14T07:54:02+00:00 | 付款订单更新时间 |
payoutId | string | ≤ 64 字符 | 是 | payout_20260814075354206395313 | Velora 平台付款单号 |
channelOrderId | string | ≤ 64 字符 | 否 | 20260814075354PD5630484505007955A05 | PSP 通道订单号 |
merchantOrderId | string | ≤ 64 字符 | 是 | PAYOUT_1786694004469_G61WUS | 商户付款订单号 |
data.amount 对象
| 字段名 | 类型 | 长度 / 限制 | 必返 | 示例值 | 说明 |
|---|---|---|---|---|---|
value | string | 数值字符串 | 是(随 amount 出现) | 200.00 | 付款金额 |
currency | string | 3 字符,ISO-4217 | 是(随 amount 出现) | RUB | 三位币种代码 |
result 对象
| 字段名 | 类型 | 长度 / 限制 | 必返 | 示例值 | 说明 |
|---|---|---|---|---|---|
msg | string | ≤ 255 字符 | 是 | Payout successfully | 付款结果说明 |
code | string | ≤ 32 字符 | 是 | S0000 | 付款结果码 |
应答示例
商户成功验签并处理通知后,应返回 HTTP 200:
json
{
"code": "SUCCESS"
}