• 简体中文
  • 查询订单结果

    请求路径

    /api/v2/payment/merchant/order/queryStatus

    参数列表

    名称类型长度必填描述
    orderIdString32否商户唯一订单号,可用于查询交易结果,与PalmPay平台订单号,二者至少传一个
    orderNoString32否PalmPay平台订单号,可用于查询交易结果,与商户唯一订单号,二者至少传一个

    返回值

    名称类型长度必填描述
    orderIdString32是商户唯一订单号,可用于查询交易结果
    orderNoString32是PalmPay平台订单号
    merchantIdString32是商户号
    currencyString10是货币代码(NGN、GHS、TZS、KES、ZAR)
    amountLong-是交易金额(最小单位计量)
    orderStatusInteger20是订单状态(见订单状态)
    remarkString200否备注信息
    errorMsgString200否错误信息
    payMethodString-否该场景固定为"bank_transfer"
    productTypeString200否用户支付时的真实产品类型,如pay_wallet、bank_transfer、mmo
    payerBankNameString200否虚拟账户的银行(只有productType为bank_transfer时才返回)
    payerAccountNameString200否虚拟账户的名字(只有productType为bank_transfer时才返回)
    payerVirtualAccNoString200否虚拟账户号(只有productType为bank_transfer时才返回)
    payerAccountTypeInteger20否账户类型(pay with bank transfer使用-1)
    payerAccountIdString200否虚拟账户 ID(当-1时返回)
    payerVirtualAccNoString200否虚拟账户号(当-1时返回)
    orderExpireMilliSecLong-是订单剩余过期时间(与虚拟账户剩余有效时间相同)
    createdTimeLong-是订单创建时间
    completedTimeLong-否订单完成时间
    payerString-否JSON string格式,详见:付款人信息(Payer)(白名单商户返回此域,如需请联系BD申请)
    sessionIdString128否渠道响应参数,注:大部分非NIBSS通道不返回sessionId,此类订单若有问题需提供订单号找PalmPay和银行确认用户实际到账情况

    错误码

    参见此文

    Postman示例

    request

    curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/payment/merchant/order/queryStatus' \
    --header 'Accept: application/json, text/plain, */*' \
    --header 'CountryCode: NG' \
    --header 'Authorization: Bearer 10241024' \
    --header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
    --header 'Content-Type: application/json' \
    --data '{
        "requestTime": 1662171389940,
        "version": "V1.1",
        "nonceStr": "IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y",
        "orderId": "1558616686273",
        "orderNo": "24243423523432425444"
    }'

    response

    {
        "respCode": "00000000",
        "respMsg": "success",
        "data": {
            "orderId": "1558616686273",
            "orderNo": "242019052313044587518762420",
            "merchantId": "CH1913953825",
            "mobile": "023408186666666",
            "currency": "NGN",
            "amount": 900000,
            "orderStatus": 2,
            "remark": "测试测试",
            "payMethod": "bank_transfer",
            "payerAccountType": -1,
            "payerAccountId": "VA123123112312421",
            "payerVirtualAccNo": "8792003113",
            "orderExpireMilliSec": 3600000,
            "createdTime": 1708927047000,
            "completedTime": 1708927065000,
            "payer": {
              "accountNo": "1390451991",
              "accountName": "abigaile jack",
              "bankCode": "000014",
              "bankName": "ACCESS BANK NIGERIA"
            },
            "sessionId": "0904052510170933002001344448"
        }
    }