查询兑吧订单状态
优质
小牛编辑
134浏览
2023-12-01
订单查询接口
接口说明
兑吧订单提供查询功能，以便开发者在不确定订单状态的情况下，通过主动查询来确认订单状态。
请求地址
https://activity.m.duiba.com.cn/status/orderStatus
输入参数
| 参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
|---|---|---|---|---|
| appKey | yes | string | 255 | 接口appKey，应用的唯一标识码 |
| timestamp | yes | long | 20 | 1970-01-01开始的时间戳，毫秒。 |
| orderNum | yes | string | 255 | 兑吧订单号 |
| bizId | no | string | 255 | 开发者的订单号(该字段后续将废弃，开发者不要使用该字段查询) |
| sign | yes | string | 255 | MD5签名，参见【签名规则】 |
响应参数
| 参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
|---|---|---|---|---|
| success | yes | boolean | 查询的结果，查询成功返回true，失败返回false | |
| status | no | string | 20 | success为true的时候返回，分为：create 创建订单后的初始状态、process 处理中、success 兑换成功、fail 兑换失败 |
| subStatus | no | string | 20 | 订单子状态，success为true的时候返回，分为：create 创建订单后的初始状态、process 处理中、waitAudit 待审核、waitSend 待发货、success 兑换成功、fail 兑换失败 |
| errorMessage | no | string | 255 | success为false的时候返回，返回失败的原因 |
注意：
1.针对处理中（process）的商品订单子状态，通过子状态订单字段进行区分，其中包含了实物商品的待发货（waitSend）、待审核（waitAudit）、直冲类和虚拟商品类型的处理中（process）状态。
2.接口查询仅支持普通兑换商品订单状态查询。
响应示例：
{
success:true,
status:"process",
subStatus:"waitAudit"
}
或者:
{
success:false,
errorMessage:”签名验证失败"
}
代码示例
java
/*
* 生成订单查询请求地址
* orderNum 和 bizId 二选一，不填的项目请使用空字符串
*/
CreditTool tool=new CreditTool("appKey", "appSecret");
String url=tool.buildCreditOrderStatusRequest(orderNum,bizId);
//将此url请求发出，并解析响应的json字符串，获取订单状态
//具体输入输出参数见HTTP接口说明
php
/*
* 生成订单查询请求地址
* orderNum 和 bizId 二选一，不填的项目请使用空字符串
*/
function buildCreditOrderStatusRequest($appKey,$appSecret,$orderNum,$bizId){
$url="http://www.duiba.com.cn/status/orderStatus?";
$timestamp=time()*1000 . "";
$array=array("orderNum"=>$orderNum,"bizId"=>$bizId,"appKey"=>$appKey,"appSecret"=>$appSecret,"timestamp"=>$timestamp);
$sign=sign($array);
$url=$url . "orderNum=" . $orderNum . "&bizId=" . $bizId . "&appKey=" . $appKey . "×tamp=" . $timestamp . "&sign=" . $sign ;
return $url;
}
$url=buildCreditOrderStatusRequest($appKey,$appSecret,$orderNum,$bizId);
//将此url请求发出，并解析响应的json字符串，获取订单状态
//具体输入输出参数见HTTP接口说明
.net
/*
* 生成订单查询请求地址
* orderNum 和 bizId 二选一，不填的项目请使用空字符串
* 在生成地址之前请准备好appKey和appSecret
*/
string url="http://activity.m.duiba.com.cn/status/orderStatus";
Hashtable hshTable = new Hashtable();
hshTable.Add("orderNum",orderNum);
hshTable.Add("bizId",bizId);
url = duiba.BuildUrlWithSign(url, hshTable, appKey, appSecret);