• 简体中文
  • 批量查询入金订单

    请求路径

    /api/v2/virtual/order/pageList

    参数列表

    名称类型长度必填描述
    accountNoString10否虚拟账号的号码或商户主账户的号码,不填则代表获取商户主账户及所有虚拟账号下的入金订单
    startTimeLong13是入金订单创建的开始时间(时间戳)
    endTimeLong13是入金订单创建的结束时间(时间戳),时间范围最大30天
    pageIndexInteger11否分页当前页,不填则默认第一页
    pageSizeInteger3否每页条数,默认50,最大500

    返回值

    名称类型长度必填描述
    respCodeInteger8是返回码,详见 错误代码
    respMsgString200是返回信息
    totalCountInteger11是总条数
    pageSizeInteger3是每页条数
    pageIndexInteger11是分页当前页
    listarray   
         
         
    orderNoString64是PalmPay平台订单号
    orderStatusInteger3是Virtual Account订单状态 ● 状态枚举见 Virtual Account订单状态
    createdTimeLong13是订单创建时间
    updateTimeLong13是订单修改时间
    currencyString3是订单货币(虚拟号服务目前只包含NGN ● 货币代码字典见 货币字典
    orderAmountLong19是订单金额即外部转账的发起金额,精确到分
    referenceString512否付款方备注
    payerAccountNoString64是付款方账户号码
    payerAccountNameString200是付款方账户名称
    payerBankNameString64是付款方银行
    virtualAccountNoString64否虚拟账号的号码(只有向虚拟账号入金才会返回,向商户主账户入金不会返回)
    virtualAccountNameString200否虚拟账号的名称(只有向虚拟账号入金才会返回,向商户主账户入金不会返回)
         
    accountReferenceString120否虚拟账户备注字段
    sessionIdString128否渠道响应参数,注:大部分非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
    }