• 简体中文
  • 单笔查询入金订单

    请求路径

    /api/v2/virtual/order/detail

    参数列表

    名称类型长度必填描述
    orderNoString32是PalmPay平台订单号

    返回值

    名称类型长度必填描述
    orderNoString32是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/detail' \
    --header 'Accept: application/json, text/plain, */*' \
    --header 'countryCode: NG' \
    --header 'Authorization:  Bearer L231127063379321376521' \
    --header 'Signature: fM36uxQ23rLN3T4d+BDTFUqMMlSSU1P8TOelzyAr4NL3FZLBL7DcZZpXjPEZKz6pRGmigfcxUaQSmtvimkL/h6Yqz7NI1Smp+384zs0urrOT77Fa70E6Mj/TZvaBZD6ngwgbuMHzbavcvu/34gfpv3kpTXbF1QGtCbpX/W7w6QkVcP+a0bN19L5x5Hrh0IrN73DQP8c+aP0EnxJXkxblj5XegVEUf9hxK1f3UkGkHTG551pQCp2/pnunUyvU53dDcM9hn6qBUUFOHpX2VLBu30u27UfbOdBI75eG/RrhBS5pUbG3a4OH9RlUc9FmwcjayX67Gt9AkX+xuRdB9LO9tg==' \
    --header 'Content-Type: application/json' \
    --data '{
        "requestTime":1702979519927,
        "version":"V2.0",
        "nonceStr":"WHk1genAzP8NAfujRsMdZaKC0ygBpOfH",
        "orderNo":"MI1735541179325538304"
    }'

    response

    {
        "respCode": "00000000",
        "respMsg": "success",
        "data": {
            "orderNo": "MI1735541179325538304",
            "orderStatus": 1,
            "createdTime": 1702620236604,
            "updateTime": 1702620236604,
            "currency": "NGN",
            "orderAmount": 30000,
            "reference": "agent",
            "payerAccountNo": "12341991",
            "payerAccountName": "abigaile jack",
            "payerBankName": "ACCESS BANK NIGERIA",
            "virtualAccountNo": "6683582280",
            "virtualAccountName": "asd test",
            "accountReference": "accountReference example",
            "sessonId": "090400010202502110345301100221"
        },
        "status": true
    }