订单审核接口

使用场景

通过订单审核接口,开发者可以在自己的后台中审核兑吧的待审核订单。如果开发者自己已经有一套审核的系统,可以使用该接口对接。

  1. 如果这个订单需要审核,兑吧会在扣积分接口请求中带上waitAudit参数,开发者自行在自己的系统生成待审核记录。
  2. 开发者在自己系统操作审核的时候,调用审核接口,把审核通过的订单:passOrderNums ,审核拒绝的订单rejectOrderNums传递给兑吧。

接口地址

https://activity.m.duiba.com.cn/audit/apiAudit?

接口说明

很多涉及金钱的兑换项,出于安全的考虑,需要通过审核通过后才能进行兑换。

默认所有需要扣除开发者资金的兑换都需要审核,开发者也可以在后台 基础配置—>预算控制 处进行配置,放宽限度。比如5元以下的兑换免审核,等等。

当一笔订单需要审核时,兑吧向开发者发起扣除用户积分的请求中,会附带该订单是否需要审核的参数 waitAudit,开发者可以根据此参数做自己的处理,也可以忽略。

如果开发者需要在自己的系统中进行审核,除了做普通的订单创建和积分扣除行为之外,还可以根据此参数生成待审核清单。

注意:需要审核的订单,扣积分接口返回成功,只表示扣除积分成功,不表示审核通过,兑吧不会进行后续的兑换行为,而是会等待开发者的审核结果。)

输入参数

参数 是否必须 参数类型 限制长度 参数说明
appKey yes string 255 接口appKey,应用的唯一标识
passOrderNums no string 255 审核通过的订单id串(兑吧订单号,用逗号分隔,如果不存在,填值为:"")
rejectOrderNums no string 255 审核不通过的订单id串(兑吧订单号,用逗号分隔,如果不存在,填值为:"")
timestamp yes long 20 1970-01-01开始的时间戳,毫秒。
sign yes string 255 MD5签名,参见【签名规则

请求示例

https://activity.m.duiba.com.cn/audit/apiAudit?"+"appKey="+appKey+"&passOrderNums="+passOrderNums+"&rejectOrderNums=“+"rejectOrderNums+"&sign="+sign+"&timestamp="+timestamp

响应参数

参数 是否必须 参数类型 限制长度 参数说明
success yes boolean 批量审核是否响应成功(true不代表审核成功)
details no string 255 返回各个订单的订单号和审核结果,具体格式参考示例
errorMessage no string 255 返回失败的原因

响应示例

请求成功:
{
    "success":true,
    "details": {
        "201412221432438470023531":{
            "message":"",
            "success":true
        },
        "201412221432438470023532":{
            "message":"订单不存在",
            "success":false
        }
    }
请求失败:
{"success":false,"errorMessage":"出错原因"}

代码示例

java

CreditTool tool=new CreditTool("appKey", "appSecret");

CreditAuditParams params=new CreditAuditParams();
params.setPassOrderNums(Arrays.asList("1","2"));//此处的订单号为兑吧的订单号,而非开发者的订单号
params.setRejectOrderNums(Arrays.asList("3","4"));//此处的订单号为兑吧的订单号,而非开发者的订单号
String url=tool.buildCreditAuditRequest(params);

//使用httpclient 发送 url请求
//验证响应结果为JSON格式的 {success:true}

php

/*
*  兑换订单审核请求
*  有些兑换请求可能需要进行审核,开发者可以通过此API接口来进行批量审核,也可以通过兑吧后台界面来进行审核处理
*  此处的订单号为兑吧的订单号,而非开发者的订单号
*/
function buildCreditAuditRequest($appKey,$appSecret,$passOrderNums,$rejectOrderNums){
    $url="https://activity.m.duiba.com.cn/audit/apiAudit?";
    $array=array("appKey"=>$appKey,"appSecret"=>$appSecret);
    if($passOrderNums !=null && !empty($passOrderNums)){
        $string=null;
        while(list($key,$val)=each($passOrderNums)){
            if($string == null){
                $string=$val;
            }else{
                $string= $string . "," . $val;
            }
        }
        $array["passOrderNums"]=$string;
    }
    if($rejectOrderNums !=null && !empty($rejectOrderNums)){
        $string=null;
        while(list($key,$val)=each($rejectOrderNums)){
            if($string == null){
                $string=$val;
            }else{
                $string= $string . "," . $val;
            }
        }
        $array["rejectOrderNums"]=$string;
    }
    $sign = sign($array);
    $url=$url . "appKey=".$appKey."&passOrderNums=".$array["passOrderNums"]."&rejectOrderNums=".$array["rejectOrderNums"]."&sign=".$sign;
    return $url;
}

.net

/*
*  兑换订单审核请求
*  有些兑换请求可能需要进行审核,开发者可以通过此API接口来进行批量审核,也可以通过兑吧后台界面来进行审核处理
*  此处的订单号为兑吧的订单号,而非开发者的订单号
*/
string url="http://activity.m.duiba.com.cn/audit/apiAudit";

string[] passOrderNums = {"1","2"};//通过审核的兑吧的订单号
string[] rejectOrderNums = {"3","4"};//拒绝审核的兑吧的订单号

Hashtable hshTable = new Hashtable();

if(passOrderNums != null && passOrderNums.Length != 0){
    string pass = passOrderNums.Join(",",passOrderNums);
    hshTable.Add("passOrderNums",pass);
}

if(rejectOrderNums !=null && rejectOrderNums.Length != 0){
    string reject = rejectOrderNums.Join(",",rejectOrderNums);
    hshTable.Add("rejectOrderNums",reject);
}
//兑吧惯例,产生URL之前请准备好appKey和appSecret
url = duiba.BuildUrlWithSign(url, hshTable, appKey, appSecret);

results matching ""

    No results matching ""