付款批量查询

接口信息

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

业务说明

• 这是使用付款API的前置步骤,必须先成功添加收款人才能进行付款
• 添加成功后会返回beneficiaryId(收款人ID),该ID将用于后续的付款操作
• 建议提前添加常用的收款人,避免临时添加延误付款

请求参数

Headers

请求头

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

Request Body

主要参数

参数名	类型	说明	必填
merchantNo	string	商户号	M
requestId	string(32)	业务流水号	C
payoutId	integer(32)	付款流水ID	C
payoutStatus	string	付款状态/Status枚举值	C
payoutStartTime	string	付款时间-开始	C
payoutEndTime	string	付款时间-结束	C
createTimeStartTime	string	创建时间-开始	M
createTimeEndTime	string	创建时间-结束	M
payoutMethod	string	付款方式	C
size	integer	每页条数	M
current	integer	当前页码	M
sign	string	签名	M

请求示例

Request

{
  "merchantNo": 801129,
  "createTimeStartTime": "2025-09-01 12:00:00",
  "createTimeEndTime": "2025-09-10 12:00:00",
  "size": 10,
  "current": 1,
  "sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f84228ad4"
}

响应结果

响应头 Headers

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

响应参数

响应字段

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
└─records	array	交易记录列表
└─total	integer	总记录数
└─size	integer	每页大小
└─current	integer	当前页码

响应示例

Response

{
    "respCode": "20000",
    "respMsg": null,
    "data": {
        "respCode": "20000",
        "respMsg": "Success",
        "data": {
            "records": [
                {
                    "payoutId": "1965301538608513024",
                    "paymentMethod": "3",
                    "payoutType": "BIZ",
                    "settleCurrency": "USD",
                    "settleSumAmount": 6.060606,
                    "serviceFee": -1.060606,
                    "otherFee": 0.000000,
                    "frozenAmount": 0.000000,
                    "settleAmount": 5.000000,
                    "payoutCurrency": "USD",
                    "payoutAmount": 5.000000,
                    "convRate": 1.000000,
                    "merchantNo": "801129",
                    "payeeId": "1964954268462354432",
                    "payeeName": "PocketPaypalBankTransfer",
                    "payeeBankName": null,
                    "payeeBankAddress": null,
                    "payeeAccount": "null",
                    "payeeAccountCountry": "US",
                    "payeeAccountName": "PocketPaypalBankTransfer",
                    "payeeAccountSwiftCode": null,
                    "payeeAccountLocalCode": null,
                    "payeeCountry": "US",
                    "payeeAddress": null,
                    "mobileNumber": null,
                    "payoutStatus": "S",
                    "payoutTips": null,
                    "payoutRemark": null,
                    "payoutTime": "2025-09-09 14:30:06",
                    "distributeStatus": "S",
                    "distributePs": "jiaoyiRemark",
                    "transactionPurpose": "4",
                    "remark": null,
                    "createTime": "2025-09-09 14:29:35",
                    "updateTime": "2025-09-09 14:29:36",
                    "payoutMethod": "E_WALLET",
                    "firstName": null,
                    "lastName": null,
                    "companyName": "PocketPaypalBankTransfer",
                    "requestId": null,
                    "payoutStatusReason": null,
                    "payerDetail": null
                },
                {
                    "payoutId": "1965297178272989184",
                    "paymentMethod": "3",
                    "payoutType": "BIZ",
                    "settleCurrency": "USD",
                    "settleSumAmount": 3.000000,
                    "serviceFee": -1.030000,
                    "otherFee": 0.000000,
                    "frozenAmount": 0.000000,
                    "settleAmount": 1.970000,
                    "payoutCurrency": "USD",
                    "payoutAmount": 1.970000,
                    "convRate": 1.000000,
                    "merchantNo": "801129",
                    "payeeId": "1964954268462354432",
                    "payeeName": "PocketPaypalBankTransfer",
                    "payeeBankName": null,
                    "payeeBankAddress": null,
                    "payeeAccount": "null",
                    "payeeAccountCountry": "US",
                    "payeeAccountName": "PocketPaypalBankTransfer",
                    "payeeAccountSwiftCode": null,
                    "payeeAccountLocalCode": null,
                    "payeeCountry": "US",
                    "payeeAddress": null,
                    "mobileNumber": null,
                    "payoutStatus": "S",
                    "payoutTips": null,
                    "payoutRemark": null,
                    "payoutTime": "2025-09-09 14:14:04",
                    "distributeStatus": "S",
                    "distributePs": "betaTest",
                    "transactionPurpose": "0",
                    "remark": null,
                    "createTime": "2025-09-09 14:12:15",
                    "updateTime": "2025-09-09 14:12:18",
                    "payoutMethod": "E_WALLET",
                    "firstName": null,
                    "lastName": null,
                    "companyName": "PocketPaypalBankTransfer",
                    "requestId": null,
                    "payoutStatusReason": null,
                    "payerDetail": null
                }
            ],
            "total": 2,
            "size": 10,
            "current": 1,
            "orders": [
                {
                    "column": "create_time",
                    "asc": false
                }
            ],
            "hitCount": false,
            "searchCount": true,
            "pages": 1
        }
    }
}

分页说明

• size: 每页显示的记录数
• current: 当前页码
• total: 总记录数