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