Appearance
订单查询 - 平台订单号
通过该接口查询订单处理状态
接口说明
- 下单接口提交后可通过该接口查询订单状态
- 建议优先对接回调通知数据返回
接口地址
/openapi/queryByOrderNo
请求参数
参数名称 | 字段类型 | 是否必填 | 最大长度 | 示例值(加密前) | 描述 |
---|---|---|---|---|---|
app_key | string | 是 | 32 | 64a6285f23c5a | 应用app Key |
order_no | string | 是 | 64 | 20909458523684864 | 平台订单号 |
timestamp | int | 是 | 12 | 1689736728 | 请求时间戳 |
sign | string | 是 | 32 | 参见样例 | 签名,参见签名规则 |
请求数据样例
json
{
"app_key": "64b9eb7c20b89",
"customer_order_no": "1689906148",
"timestamp": 1689907061,
"sign": "8a29bfab3f950052a8851acc80767da3"
}
返回参数说明
参数名称 | 字段类型 | 是否必填 | 最大长度 | 示例值(加密前) | 描述 |
---|---|---|---|---|---|
order_no | string | 是 | 32 | 18642666082271232 | 平台订单号 |
customer_order_no | string | 是 | 64 | 1689736728 | 外部订单号 |
card_no | string | 否 | 32 | 9070247051131562875 | 卡号 |
card_secret | string | 是 | 32 | 123456 | 卡密 |
cookie_type | int | 是 | 4 | 1 | CK类型:1PC、2M站、3api |
card_face | int | 否 | 4 | 50 | 卡面值 |
card_balance | int | 是 | 8 | 50 | 卡余额 |
card_end_date | string | 是 | 32 | 2026-07-17 | 过期时间 |
status | string | 是 | 32 | success | 订单状态(success:成功,processing:处理中,failed:失败,cancel:已取消) |
error_code | string | 否 | 32 | 90001 | 仅失败情况下需要根据该字段进行处理,参见错误码定义 |
error_msg | string | 否 | 255 | 卡密错误 | 过期时间 |
订单处理成功结果返回
json
{
"code": 0,
"data": {
"order_no": "18642666082271232",
"customer_order_no": "1689908817",
"cookie_type": 1,
"product_code": "JDE",
"card_no": "JDV11540037803000087",
"card_secret": "FC4465CF370E0ED9",
"card_face": 50,
"card_balance": "50.00",
"card_end_date": "2026-07-17",
"created_at": "2023-07-21 11:06:56",
"finished_at": "2023-07-21 11:07:41",
"error_code": "",
"error_msg": "",
"status": "success"
},
"message": "查询成功"
}
订单处理失败结果返回
json
{
"code": 0,
"data": {
"order_no": "18631473976311808",
"customer_order_no": "1689906148",
"cookie_type": 1,
"product_code": "JDE",
"card_no": "",
"card_secret": "3792859B221BCC1F",
"card_face": "",
"card_balance": "",
"card_end_date": "",
"created_at": "2023-07-21 10:22:28",
"finished_at": "2023-07-21 10:22:58",
"error_code": "90001",
"error_msg": "卡密错误",
"status": "failed"
},
"message": "查询成功"
}