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

    请求路径

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

    参数列表

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

    返回值

    名称类型长度必填描述
    orderIdString32是商户唯一订单号,可用于查询交易结果
    orderNoString32是PalmPay平台订单号
    merchantIdString32是商户号
    currencyString10是货币代码(GHS、TZS、KES、PKR)
    amountLong-是交易金额(最小单位计量)
    orderStatusInteger20是订单状态(见订单状态)
    remarkString200否备注信息
    errorMsgString200否错误信息
    createdTimeLong-是订单创建时间
    completedTimeLong-否订单完成时间
    productTypeString200否用户支付时的真实产品类型,如pay_wallet、bank_transfer、mmo
    payerBankNameString200否虚拟账户的银行(只有productType为bank_transfer时才返回)
    payerAccountNameString200否虚拟账户的名字(只有productType为bank_transfer时才返回)
    payerVirtualAccNoString200否虚拟账户号(只有productType为bank_transfer时才返回)

    错误码

    参见此文

    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: GH' \
    --header 'Authorization: Bearer 10241024' \
    --header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
    --header 'Content-Type: application/json' \
    --data '{
        "requestTime": 1662171389940,
        "version": "V1.1",
        "nonceStr": "IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y",
        "orderId": "1558616686273",
        "orderNo": "242019052313044587518762420"
    }'

    response

    {
        "respCode": "00000000",
        "respMsg": "success",
        "data": {
            "orderId": "1558616686273",
            "orderNo": "242019052313044587518762420",
            "merchantId": "CH1913953825",
            "currency": "GHS",
            "amount": 900000,
            "orderStatus": 2,
            "remark": "test",
            "createdTime": 1708927047000,
            "completedTime": 1708927065000
        }
    }