#查询订单
#请求接口路径
[POST] /api/v2/bill-payment/order/query#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| sceneCode | String | - | 是 | 业务场景码【详见 场景码】 |
| outOrderNo | String | 64 | 是 | 商户订单号 |
| orderNo | String | 64 | 是 | Palmpay 平台订单号(商户订单号和平台订单号不能同时为空) |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| outOrderNo | String | 64 | 是 | 商户订单号 |
| orderNo | String | 32 | 是 | PalmPay 平台订单号 |
| billerId | String | 32 | 是 | 运营商 ID |
| itemId | String | 32 | 是 | 套餐 ID |
| orderStatus | Integer | 20 | 是 | 订单状态【详见 订单状态】 |
| amount | Long | - | 是 | 订单总金额(单位为分) |
| sceneCode | String | - | 是 | 业务场景码 |
| currencySymbol | String | 5 | 是 | 货币符号 |
| currency | String | 5 | 是 | 货币类型 |
| payerEmail | String | 50 | 是 | 付款方邮箱 |
| payerMobileNo | String | 50 | 是 | 关联的系统会员手机 |
| payerAccountId | String | 50 | 是 | 付款人账户 id |
| payerAccountType | Integer | 50 | 是 | 付款方账户类型 |
| payTime | Long | - | 是 | 支付时间 |
| completedTime | Long | - | 是 | 订单完成时间 |
| merchantNo | String | 32 | 是 | 商户号 |
| errorMsg | String | 32 | 是 | 返回信息 |
#Postman 请求示例
#request
curl 请求
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/bill-payment/order/query' \
--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",
"orderNo":"y521ug58000",
}'#response
{
"respCode": "00000000",
"respMsg": "success",
"data": {
"orderNo": "y521ug58000",
"outOrderNo": "tC27wjQmRnbapFAwynhatCxWkXwN7rpG",
"billerId": "MTN",
"itemId": "s105113874659400",
"orderStatus": 1,
"amount": null,
"currencySymbol": "₦",
"currency": "NGN",
"payerEmail": "caojiangling07@foxmail.com",
"payerMobileNo": null,
"payerAccountId": "fb567314d91e455c97119ee06bb",
"payerAccountType": 4,
"payTime": 1713927263000,
"completedTime": 1713927280000,
"merchantNo": "12311240914311",
"errorMsg": null,
"notifyUrl": "https://xxx/notify"
}
}#公共错误码
#业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| SBP.INVALID_PARAMETER | 参数无效 | 检查请求参数,修改后重新发起请求 |
| SBP.INVALID_SCENE_CODE | 场景码无效 | 检查场景码,修改后重新发起请求 |
| SBP.TRADE_NOT_EXIST | 订单不存在 | 检查传入的交易号是否正确,修改后重新发起请求 |