# 2 代收对账单

# request URL

  • /api/v1/record/paymentList

# 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 选填, 如果参数completeDate已经填写 string 1-50 2022-01-01 交易完成日期
page 必填 int - - 页码
status 选填 选填 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
-- paymentMethod String QR Code 代收类型
-- paymentChannel String GCASH_STATIC_VA 代收渠道码
-- amount Double 100.1 代收金额(这里和商户后台下载对账文件一致,为本地货币金额. 例如: 100.1p => 100.1p)
-- fee Double 10.1 代收手续费(这里和商户后台下载对账文件一致,为本地货币金额. 例如: 10.1p => 10.1p)
-- name String 999100000198 用户名
-- mobile String 09123456789 用户手机
-- status String COMPLETE 支付状态: PENDING、COMPLETE、FAILED
-- appName String XXXXXX 应用名称
-- 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": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "transactionId": "C1175679364396181358", 
        "paymentMethod": "QR Code", 
        "paymentChannel": "QRPH_DYNAMIC_QR",
        "amount": 100.0, 
        "fee": 20.0,
        "name": "xxxx xxxx",
        "mobile": null,
        "status": "PENDING", 
        "appName": "paycools",
        "createTime": "2023-03-21 10:06:36", 
        "completeTime": null 
      },
      {
        "merchantOrderId": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "transactionId": "C1175679364504324838",
        "paymentMethod": "Bank Transfer",
        "paymentChannel": "INSTA_TRANSFER_ACC",
        "amount": 100.0,
        "fee": 20.0,
        "name": "xxxx xxxx",
        "mobile": "09123456789",
        "status": "COMPLETE",
        "appName": "paycools",
        "createTime": "2023-03-21 10:08:24",
        "completeTime": "2023-03-21 10:08:24"
      },
      {
        "merchantOrderId": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "transactionId": "C1175679364555430931",
        "paymentMethod": "Bill Payment",
        "paymentChannel": "GCASH_STATIC_VA",
        "amount": 200.0,
        "fee": 20.0,
        "name": "xxxx xxxx",
        "mobile": "09123456789",
        "status": "COMPLETE",
        "appName": "PayCools",
        "createTime": "2023-03-21 10:09:15",
        "completeTime": "2023-03-21 10:09:15"
      },
      {
        "merchantOrderId": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "transactionId": "C1175679364577251000",
        "paymentMethod": "Web Payment",
        "paymentChannel": "GCASH_URL",
        "amount": 100.0,
        "fee": 20.0,
        "name": "xxxx xxxx",
        "mobile": "09123456789",
        "status": "FAILED",
        "appName": "paycools",
        "createTime": "2023-03-21 10:09:37",
        "completeTime": "2023-03-21 10:53:29"
      }
    ],
    "page": 1
  }
}
# failed response example. code see reference
{
  "code": 1002,
  "message": "merchant white ip forbidden"
}