付款查询（Query Payout）

用于主动查询付款订单的当前状态，可用于订单轮询、对账或订单补偿。

请求说明

• 方法：POST
• 路径：/api/v1/payout/orderQuery
• Content-Type：application/json
• 鉴权：参考 接入准备

请求字段

参数名	类型	必填	说明
payoutId	string	否	Velora 平台付款单号，即创建付款返回的 payoutId
merchantOrderId	string	否	创建付款时传入的商户订单号，长度 ≤ 64 字符

payoutId 与 merchantOrderId 二选一即可发起查询。

请求示例

使用平台付款单号查询：

{
  "payoutId": "payout_20260814075354206395313"
}

或使用商户订单号查询：

{
  "merchantOrderId": "PAYOUT_1786694004469_G61WUS"
}

响应字段

响应体与付款结果通知一致：result 表示付款处理结果，data 表示付款订单数据。

result 对象

字段名	类型	长度 / 限制	必返	示例值	说明
code	string	≤ 32 字符	是	S0000	付款结果码
msg	string	≤ 255 字符	是	Payout successfully	付款结果说明

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	三位币种代码

响应示例

{
  "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"
  }
}

相关链接

• 创建付款：发起付款
• 付款结果通知：异步通知与验签