#查询代付交易结果
#请求路径
/api/v2/merchant/payment/queryPayStatus#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderId | String | 32 | 否 | 商户唯一订单号,可用于查询交易结果,与PalmPay平台订单号,二者至少传一个 |
| orderNo | String | 32 | 否 | PalmPay平台订单号,可用于查询交易结果,与商户唯一订单号,二者至少传一个 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| currency | String | 10 | 是 | 货币代码(NGN、GHS、TZS、KES、ZAR) |
| amount | Long | 20 | 否 | 订单金额(最小单位计量) 只有当 orderStatus=2 时才会有值 |
| fee | fee | 20 | 否 | 手续费总额(最小单位计量) 只有当 orderStatus=1 or 2 时才会有值 fee:{ fee: 0, vat: 0} |
| orderNo | String | 32 | 否 | PalmPay返回的订单号 |
| orderId | String | 32 | 否 | 商户原始订单号 |
| orderStatus | Integer | 20 | 是 | 订单状态(见订单状态) |
| sessionId | String | 128 | 否 | 渠道响应参数,注:大部分非NIBSS通道不返回sessionId,此类订单若有问题需提供订单号找PalmPay和银行确认用户实际到账情况 |
| message | String | 20 | 否 | 订单状态描述信息 |
| errorMsg | String | 200 | 否 | 错误信息 |
| createdTime | Long | - | 是 | 订单创建时间 |
| completedTime | Long | - | 否 | 订单完成时间 |
#错误码
#Postman请求示例
#request
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/merchant/payment/queryPayStatus' \
--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":"e7c3784d5e2242fc00afe89ac1234",
"orderNo":"41220723093001"
}'#response
{
"respCode": "00000000",
"respMsg": "success",
"data": {
"currency": "NGN",
"amount": 50000,
"fee": {
"fee": 402
},
"orderNo": "41220723093001",
"orderId": "e7c3784d5e2242fc00afe89ac1234",
"orderStatus": 2,
"sessionId": "100033240509135230000500932911",
"message": "success",
"createdTime": 1708927047000,
"completedTime": 1708927065000
}
}