付款单笔查询

接口信息

• 路径: /api/v1/txn/query
• 方法: POST
• Content-Type: application/json

业务说明

• 用于查询单笔付款交易的详细状态
• 可通过requestId或payoutId查询
• 在付款后通过此接口确认交易状态

请求参数

Headers

请求头

参数名	值	必填	说明
Content-Type	application/json	是	请求体类型

Request Body

主要参数

参数名	类型	说明	必填
merchantNo	string	请求发起方的商户号。	M
onBehalfOf	string	请求实际对应的商户号，仅在代其他商户发起请求时填写。	N
requestId	string(32)	业务流水号	C-若payoutId为空，则必填
payoutId	integer(32)	付款流水ID	C-若requestId为空，则必填
sign	string	签名	N

请求示例

Request

{
  "merchantNo": "800225",
  "requestId": "REQ20240101123456789012345678901",
  "payoutId": 1808783413957234688,
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

响应结果

响应头 Headers

参数名	值	必填	说明
content-type	application/json;charset=UTF-8	否	响应体类型

响应参数

响应字段

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
└─merchantNo	string	商户号
└─onBehalfOf	string	请求实际对应的商户号；非代发起场景可能为空
└─requestId	string	业务流水号
└─payoutId	integer	付款流水ID
└─status	string	Status枚举值
└─settleCurrency	string	结算币种
└─settleSumAmount	number	结算单汇总金额
└─serviceFee	number	手续费
└─convRate	number	转换汇率
└─payoutStatusReason	string	付款状态原因

响应示例

Response

{
    "respCode": "20000",
    "respMsg": null,
    "data": {
        "merchantNo": "801040",
        "onBehalfOf": null,
        "requestId": "DM20250888804123",
        "payoutId": "1954374604177408000",
        "status": "P",
        "settleCurrency": "USD",
        "settleSumAmount": 8.939382,
        "serviceFee": -2.089382,
        "convRate": 277.564623,
        "payoutStatusReason": null
    }
}