# 3 代付对账单
# request URL
/api/v1/record/payoutList
# request method
- POST
# request params
parameter name | Is it mandatory | type of data | length | example | description |
---|---|---|---|---|---|
appId | 必填 | string | - | - | 应用APPID |
createDate | 选填, 如果参数completeDate已经填写 | string | 1-50 | 2022-01-01 | 交易创建日期 |
completeDate | 选填, 如果参数createDate已经填写 | string | 1-50 | 2022-01-01 | 交易完成日期 |
page | 必填 | int | - | - | 页码 |
status | 选填 | string | 1-100 | - | 支付状态码: PENDING、 COMPLETE、 FAILED |
timestamp | 必填 | string | 1-50 | 1679335338000 | 时间戳-2分钟有效期 |
sign | 必填 | string | - | 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 | 签名 |
# response params
parameter name | type of data | example | description |
---|---|---|---|
code | int | 1000 | 状态码 参考列表 |
message | String | success | 状态码信息 |
data | Object | - | 返回具体信息 |
- records | List | - | 对账单数据列表 |
-- merchantOrderId | String | LT000000216 | 商户订单ID |
-- transactionId | String | C1175679364396181358 | PayCools交易ID |
-- amount | Double | 100.1 | 代付金额(这里和商户后台下载对账文件一致,为本地货币金额. 例如: 100.1p => 100.1p) |
-- fee | Double | 10.1 | 代付手续费(这里和商户后台下载对账文件一致,为本地货币金额. 例如: 10.1p => 10.1p) |
-- remittingBank | String | Union Bank | 出款行 |
-- remittingAccount | String | 915****5678 | 出款账号 |
-- recipientName | String | xxxx****xxxx | 收款人 |
-- recipientAccount | String | 091****6789 | 收款账号 |
-- receivingChannel | String | GCASH | 代付渠道 |
-- status | String | COMPLETE | 代付状态:PENDING、COMPLETE、FAILED |
-- createTime | String | 2023-03-21 10:06:36 | 交易创建时间 |
-- completeTime | String | 2023-03-21 10:06:36 | 交易完成时间 |
# successful response example
{
"code": 1000,
"message": "success",
"data": {
"records": [
{
"merchantOrderId": "xxxxxxxxxxxxxxxxxx",
"transactionId": "xxxxxxxxxxxxxxxxxx",
"amount": 100.0,
"fee": 15.0,
"remittingBank": "Union Bank Of The Philippines",
"remittingAccount": "091****5678",
"recipientName": "xxx***xxx",
"recipientAccount": "915****6789",
"appName": "paycools",
"status": "PENDING",
"receivingChannel": "GCASH",
"createTime": "2023-03-20 17:54:28",
"completeTime": null
},
{
"merchantOrderId": "xxxxxxxxxxxxxxxxxx",
"transactionId": "xxxxxxxxxxxxxxxxxx",
"amount": 100.0,
"fee": 15.0,
"remittingBank": "Union Bank Of The Philippines",
"remittingAccount": "915****5678",
"recipientName": "xxx***xxx",
"recipientAccount": "091****6789",
"appName": "paycools",
"status": "FAILED",
"receivingChannel": "GCASH",
"createTime": "2023-03-20 20:18:57",
"completeTime": "2023-03-20 20:19:25"
},
{
"merchantOrderId": "xxxxxxxxxxxxxxxxxx",
"transactionId": "xxxxxxxxxxxxxxxxxx",
"amount": 100.0,
"fee": 15.0,
"remittingBank": "Union Bank Of The Philippines",
"remittingAccount": "915****5678",
"recipientName": "xxx***xxx",
"recipientAccount": "091****6789",
"appName": "paycools",
"status": "COMPLETE",
"receivingChannel": "GCASH",
"createTime": "2023-03-20 20:21:10",
"completeTime": "2023-03-20 20:21:21"
}
],
"page": 1
}
}
# failed response example. code see reference
{
"code": 1002,
"message": "merchant white ip forbidden"
}