订单审核接口

订单审核接口

使用场景

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

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

接口地址

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

接口说明

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

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

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

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

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

输入参数

请求示例

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

响应参数

响应示例

请求成功：
{
    "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);