订单查询接口

接口说明

兑吧订单提供查询功能，以便开发者在不确定订单状态的情况下，通过主动查询来确认订单状态。

请求地址

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 兑换失败（如需其他状态请参考注意点3）
errorMessage	no	string	255	success为false的时候返回，返回失败的原因

注意：

1.针对处理中（process）的商品订单子状态，通过子状态订单字段进行区分，其中包含了实物商品的待发货（waitSend）、待审核（waitAudit）、直冲类和虚拟商品类型的处理中（process）状态。

2.接口查询仅支持普通兑换商品订单状态查询。

3.subStatus新增如下类型，当status是process处理中时新增：waitPay 待付款，waitReceive 待收货，received 已收货；当status为fail时新增:error 异常，cancel 已取消，timeOut 已失效（若需添加上述状态，请联系兑吧技术支持）

响应示例：

{
  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 . "&timestamp=" . $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);

查询兑吧订单状态