#查询订单结果
#请求路径
/api/v2/payment/merchant/order/queryStatus#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderId | String | 32 | 否 | 商户唯一订单号,可用于查询交易结果,与PalmPay平台订单号,二者至少传一个 |
| orderNo | String | 32 | 否 | PalmPay平台订单号,可用于查询交易结果,与商户唯一订单号,二者至少传一个 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderId | String | 32 | 是 | 商户唯一订单号,可用于查询交易结果 |
| orderNo | String | 32 | 是 | PalmPay平台订单号 |
| merchantId | String | 32 | 是 | 商户号 |
| currency | String | 10 | 是 | 货币代码(NGN、GHS、TZS、KES、ZAR) |
| amount | Long | - | 是 | 交易金额(最小单位计量) |
| orderStatus | Integer | 20 | 是 | 订单状态(见订单状态) |
| remark | String | 200 | 否 | 备注信息 |
| errorMsg | String | 200 | 否 | 错误信息 |
| payMethod | String | - | 否 | 该场景固定为"bank_transfer" |
| productType | String | 200 | 否 | 用户支付时的真实产品类型,如pay_wallet、bank_transfer、mmo |
| payerBankName | String | 200 | 否 | 虚拟账户的银行(只有productType为bank_transfer时才返回) |
| payerAccountName | String | 200 | 否 | 虚拟账户的名字(只有productType为bank_transfer时才返回) |
| payerVirtualAccNo | String | 200 | 否 | 虚拟账户号(只有productType为bank_transfer时才返回) |
| payerAccountType | Integer | 20 | 否 | 账户类型(pay with bank transfer使用-1) |
| payerAccountId | String | 200 | 否 | 虚拟账户 ID(当-1时返回) |
| payerVirtualAccNo | String | 200 | 否 | 虚拟账户号(当-1时返回) |
| orderExpireMilliSec | Long | - | 是 | 订单剩余过期时间(与虚拟账户剩余有效时间相同) |
| createdTime | Long | - | 是 | 订单创建时间 |
| completedTime | Long | - | 否 | 订单完成时间 |
| payer | String | - | 否 | JSON string格式,详见:付款人信息(Payer)(白名单商户返回此域,如需请联系BD申请) |
| sessionId | String | 128 | 否 | 渠道响应参数,注:大部分非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"
}
}