付款批量查询
接口信息
- 路径:
/api/v1/txn/queryList - 方法: POST
- Content-Type: application/json
业务说明
- 支持按单个或批量付款流水 ID、业务流水号查询交易，并返回分页结果。
- 至少提供一个交易标识条件，或一组完整的创建时间/付款时间范围。
- 所有已提供的查询条件取交集，仅返回商户有权限查看且满足全部条件的交易。
请求参数
Headers
请求头
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| Content-Type | application/json | 是 | 请求体类型 |
Request Body
主要参数
| 参数名 | 类型 | 说明 | 必填 |
|---|---|---|---|
| merchantNo | string | 请求发起方的商户号。 | M |
| onBehalfOf | string | 请求实际对应的商户号，仅在代其他商户发起请求时填写。 | N |
| requestId | string(64) | 单个业务流水号；空字符串视为未提供 | C |
| payoutId | integer(int64) | 单个付款流水 ID | C |
| payoutIds | string(6400) | 付款流水 ID 数组的 JSON 字符串，例如 "[\"1965301538608513024\",\"1965301538608513025\"]"；原始数组最多 100 项 | C |
| requestIds | string(6400) | 业务流水号数组的 JSON 字符串，例如 "[\"ORDER-001\",\"ORDER-002\"]"；原始数组最多 100 项，每项最长 64 字符 | C |
| payoutStatus | string | 付款状态/Status枚举值 | C |
| payoutStartTime | string | 付款时间-开始 | C |
| payoutEndTime | string | 付款时间-结束 | C |
| createTimeStartTime | string | 创建时间-开始，与结束时间成对提供 | C |
| createTimeEndTime | string | 创建时间-结束，与开始时间成对提供 | C |
| payoutMethod | string | 付款方式 | C |
| size | integer | 每页条数，1～100；省略或为 null 时默认 10 | N |
| current | integer | 当前页码，至少为 1；省略或为 null 时默认 1 | N |
| sign | string | 签名 | M |
请求示例
json
{
"merchantNo": 801129,
"createTimeStartTime": "2025-09-01 12:00:00",
"createTimeEndTime": "2025-09-10 12:00:00",
"size": 10,
"current": 1,
"sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f84228ad4"
}json
{
"merchantNo": "801129",
"payoutIds": "[\"1965301538608513024\",\"1965301538608513025\"]",
"size": 100,
"current": 1,
"sign": "<按本次请求计算的签名>"
}json
{
"merchantNo": "801129",
"requestIds": "[\"ORDER-001\",\"ORDER-002\"]",
"size": 10,
"current": 1,
"sign": "<按本次请求计算的签名>"
}响应结果
响应头 Headers
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | 是 | 响应体类型 |
响应参数
响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| respCode | string | 响应码 |
| respMsg | string | 响应信息 |
| data | object | 响应数据 |
| └─data | object | 分页数据 |
| └─records | array | 当前页交易记录列表 |
| └─payoutId | integer | 付款流水 ID |
| └─settleCurrency | string | 结算币种 |
| └─settleSumAmount | number | 实际结算总金额，实际结算总金额=结算金额+手续费 |
| └─serviceFee | number | 手续费 |
| └─settleAmount | number | 结算金额 |
| └─payoutCurrency | string | 付款币种 |
| └─payoutAmount | number | 付款金额 |
| └─convRate | number | 转换汇率 |
| └─merchantNo | string | 商户号 |
| └─onBehalfOf | string | 请求实际对应的商户号；非代发起场景可能为空 |
| └─payeeName | string | 收款方名称 |
| └─payoutStatus | string | 付款状态/Status枚举值 |
| └─payoutTime | string | 付款时间 |
| └─distributePs | string | 交易附言 |
| └─transactionPurpose | string | 交易用途 |
| └─payoutMethod | string | 付款方式 |
| └─createTime | string | 创建时间 |
| └─updateTime | string | 更新时间 |
| └─requestId | string | 业务流水号 |
| └─payoutStatusReason | string | 付款状态原因 |
| └─total | integer | 总记录数 |
| └─size | integer | 每页大小 |
| └─current | integer | 当前页码 |
| └─pages | integer | 总页数 |
响应示例
json
{
"respCode": "20000",
"respMsg": null,
"data": {
"data": {
"records": [
{
"payoutId": "2100862326273609728",
"settleCurrency": "USD",
"settleSumAmount": 17.170000,
"serviceFee": -5.170000,
"settleAmount": 12.000000,
"payoutCurrency": "USD",
"payoutAmount": 12.000000,
"convRate": 1.000000,
"merchantNo": "800527",
"onBehalfOf": null,
"payeeName": "yuyu liu",
"payoutStatus": "S",
"payoutTime": "2026-09-18 17:10:09",
"distributePs": "REFERENCE BANK",
"transactionPurpose": "5",
"payoutMethod": "BANK_TRANSFER",
"createTime": "2026-09-18 16:19:45",
"updateTime": "2026-09-18 17:10:09",
"requestId": "DM2026081200010",
"payoutStatusReason": ""
},
{
"payoutId": "2100771357805121536",
"settleCurrency": "USD",
"settleSumAmount": 11.120000,
"serviceFee": -5.110000,
"settleAmount": 6.010000,
"payoutCurrency": "USD",
"payoutAmount": 6.010000,
"convRate": 1.000000,
"merchantNo": "800527",
"onBehalfOf": null,
"payeeName": "dante te",
"payoutStatus": "S",
"payoutTime": "2026-09-18 10:25:02",
"distributePs": "REFERENCE PAYPAL",
"transactionPurpose": "0",
"payoutMethod": "E_WALLET",
"createTime": "2026-09-18 10:18:16",
"updateTime": "2026-09-18 10:25:02",
"requestId": null,
"payoutStatusReason": ""
},
{
"payoutId": "2083068542462853120",
"settleCurrency": "USD",
"settleSumAmount": 12.230000,
"serviceFee": -5.120000,
"settleAmount": 7.110000,
"payoutCurrency": "HKD",
"payoutAmount": 54.580000,
"convRate": 7.675822,
"merchantNo": "800527",
"onBehalfOf": null,
"payeeName": "test swift company",
"payoutStatus": "S",
"payoutTime": "2026-07-31 13:55:18",
"distributePs": "REFERENCE SWIFT",
"transactionPurpose": "0",
"payoutMethod": "SWIFT",
"createTime": "2026-07-31 13:53:36",
"updateTime": "2026-07-31 13:55:18",
"requestId": null,
"payoutStatusReason": ""
}
],
"total": 3,
"size": 10,
"current": 1,
"pages": 1
}
}
}分页说明
- size: 每页显示的记录数
- current: 当前页码
- total: 总记录数