#批量查询入金订单
#请求路径
/api/v2/virtual/order/pageList#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| accountNo | String | 10 | 否 | 虚拟账号的号码或商户主账户的号码,不填则代表获取商户主账户及所有虚拟账号下的入金订单 |
| startTime | Long | 13 | 是 | 入金订单创建的开始时间(时间戳) |
| endTime | Long | 13 | 是 | 入金订单创建的结束时间(时间戳),时间范围最大30天 |
| pageIndex | Integer | 11 | 否 | 分页当前页,不填则默认第一页 |
| pageSize | Integer | 3 | 否 | 每页条数,默认50,最大500 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| respCode | Integer | 8 | 是 | 返回码,详见 错误代码 |
| respMsg | String | 200 | 是 | 返回信息 |
| totalCount | Integer | 11 | 是 | 总条数 |
| pageSize | Integer | 3 | 是 | 每页条数 |
| pageIndex | Integer | 11 | 是 | 分页当前页 |
| list | array | |||
| orderNo | String | 64 | 是 | PalmPay平台订单号 |
| orderStatus | Integer | 3 | 是 | Virtual Account订单状态 ● 状态枚举见 Virtual Account订单状态 |
| createdTime | Long | 13 | 是 | 订单创建时间 |
| updateTime | Long | 13 | 是 | 订单修改时间 |
| currency | String | 3 | 是 | 订单货币(虚拟号服务目前只包含NGN ● 货币代码字典见 货币字典 |
| orderAmount | Long | 19 | 是 | 订单金额即外部转账的发起金额,精确到分 |
| reference | String | 512 | 否 | 付款方备注 |
| payerAccountNo | String | 64 | 是 | 付款方账户号码 |
| payerAccountName | String | 200 | 是 | 付款方账户名称 |
| payerBankName | String | 64 | 是 | 付款方银行 |
| virtualAccountNo | String | 64 | 否 | 虚拟账号的号码(只有向虚拟账号入金才会返回,向商户主账户入金不会返回) |
| virtualAccountName | String | 200 | 否 | 虚拟账号的名称(只有向虚拟账号入金才会返回,向商户主账户入金不会返回) |
| accountReference | String | 120 | 否 | 虚拟账户备注字段 |
| sessionId | String | 128 | 否 | 渠道响应参数,注:大部分非NIBSS通道不返回sessionId,此类订单若有问题需提供订单号找PalmPay和银行确认用户实际到账情况 |
#错误码
#Postman请求示例
#request
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/virtual/order/pageList' \
--header 'Authorization: Bearer L231127063379321376521' \
--header 'countryCode: NG' \
--header 'Signature: TwguXAzSzkqozysv6ZbhBuu7fCXxtzf6veWDKRw3h/w99/6RB2rwGeO4h2sF8OUQYmJdXOxRp/XuG61aVRZdvvUItAp0vzMR6CmLHhfnePbyrmQ8YzMVJ5x1B0d8Hg0OrngJbb65e0SjceSGLHxfvRJBR3yIjbGygkAIaimDP6FlvYkL45DHZ3dVE4jIGx6PI9SCoU4lVeFQ8LTzclv3DtsLV11Pxdov5werRX35J5SiwFmtTkp9q4NpRpOiK9zhUmnr1FsP8SnGIqsJvKFXqJ3Pt4+djF5cpVGyT5KabNhXOIzvlcaGjK28AEQGVYPDM3kfWwehY0f7NLLPsatW4Q==' \
--header 'content-type: application/json;charset=UTF-8' \
--data '{
"requestTime":1705478935310,
"pageIndex":1,
"accountNo":"6683582280",
"pageSize":50,
"startTime":1702478935364,
"endTime":1705478935364,
"version":"V2.0",
"nonceStr":"QzV0CvC36JXPEJzWqXsgb6koddda1f1W"
}'#response
{
"data": {
"pageIndex": 1,
"pageSize": 50,
"totalCount": 4,
"list": [{
"orderNo": "MI1747467913272733696",
"payerAccountNo": "",
"orderStatus": 1,
"payerBankName": "ACCESS BANK NIGERIA",
"updateTime": 1705463801971,
"virtualAccountName": "asd test",
"reference": "NIbss",
"orderAmount": 12300,
"createdTime": 1705463791565,
"currency": "NGN",
"payerAccountName": "abigaile jack",
"virtualAccountNo": "6683582280",
"accountReference": "accountReference example",
"sessonId": "090400010202502110345301100221"
}, {
"orderNo": "031voa5e30800",
"payerAccountNo": "12347067",
"orderStatus": 1,
"payerBankName": "PalmPay",
"updateTime": 1703561872033,
"virtualAccountName": "test_1(vbs)",
"orderAmount": 10000,
"createdTime": 1703561868390,
"currency": "NGN",
"payerAccountName": "zhang san tecv",
"virtualAccountNo": "6683582280",
"accountReference": "accountReference example",
"sessonId": "090400010202502110345301100221"
}, {
"orderNo": "031vmvpr2a600",
"payerAccountNo": "12347067",
"orderStatus": 1,
"payerBankName": "PalmPay",
"updateTime": 1703496503900,
"virtualAccountName": "test_1(vbs)",
"orderAmount": 20000,
"createdTime": 1703496500411,
"currency": "NGN",
"payerAccountName": "zhang san tecv",
"virtualAccountNo": "6683582280",
"accountReference": "accountReference example",
"sessonId": "090400010202502110345301100221"
}, {
"orderNo": "031vmvm62a600",
"payerAccountNo": "12347067",
"orderStatus": 1,
"payerBankName": "PalmPay",
"updateTime": 1703496375309,
"virtualAccountName": "test_1(vbs)",
"orderAmount": 20000,
"createdTime": 1703496371697,
"currency": "NGN",
"payerAccountName": "zhang san tecv",
"virtualAccountNo": "6683582280",
"accountReference": "accountReference example",
"sessonId": "090400010202502110345301100221"
}],
"notEmpty": true,
"empty": false
},
"respMsg": "success",
"respCode": "00000000",
"status": true
}