订单查询接口

接口说明

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

请求地址

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 . "&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);

results matching ""

    No results matching ""