下单回调接口

简介

业务介绍

合作方通过直充接口下单，当下单成功后可以回调合作方接口，保持我方与合作方两侧信息一致，避免出现直充下单失败我方却异步开通成功的情况。合作方需要保证回调接口幂等。

接口定义

URL

由合作方提供

请求方式

参数	说明
Method	POST
Content-Type	application/x-www-form-urlencoded

请求参数

变量名	名称	是否必须	说明
partnerNo	合作方编码	是	合作方的唯一标识
sign	签名串	是	MD5签名，签名方法见附录
orderNo	订单号	是	合作方的订单号
status	订单状态	是	1-下单成功已完成权益充值
startTime	权益开始时间	否	该订单会员开始时间，格式：yyyy-MM-dd HH:mm:ss
deadline	权益结束时间	否	该订单会员结束时间，格式：yyyy-MM-dd HH:mm:ss
orderTime	合作方下单时间	是	合作方调用直充接口下单的时间，格式：yyyy-MM-dd HH:mm:ss
orderFinishTime	订单完成时间	是	合作方调用直充接口下单实际开通权益的时间，格式：yyyy-MM-dd HH:mm:ss

返回参数

字段名	类型	说明
code	String	返回码，A00000请求成功，Q00301参数错误，Q00332系统错误
msg	String	返回码说明

返回示例

{
    "code": "A00000",
    "msg": "成功"
}

附录

MD5加密描述

采用MD5计算签名，pubkey由爱奇艺提供，具体计算方法如下：
1、 假设共有三个参数 a=3、b=2、c=1；
2、 按参数名的字母正序排列，再用“&”连接后得到串A，即为“a=3&b=2&c=1”；
3、 将pubkey拼接到串A后面，假设pubkey为“qwer”，则拼接后为“a=3&b=2&c=1qwer”；
4、 计算拼接串的MD5即为最终签名值，注意使用UTF-8编码计算,MD5后的签名最后都转成小写。
举例：
参数：a=3、b=2、c=1；
pubkey：qwer
最终签名串：f80118ff523f25eda67cb799bdc9c52d

JAVA版本示例代码如下：

public class Test{
/**
 * MD5签名测试类
 *
 */
    private static final char[] DIGITS = {'0', '1', '2', '3', '4', '5', '6',
        '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
    public static void main(String[] args) {
        TreeMap<String, Object> paramMap = new TreeMap<>();
        paramMap.put("a", "3");
        paramMap.put("b", "2");
        paramMap.put("c", "1");
        String md5key = "qwer";
        String targetParam = Joiner.on("&").withKeyValueSeparator("=")
        .useForNull("").join(paramMap);
        // MD5签名工具类,可以自己实现, MD5实现参照
        String targetSign = EncodeUtils.MD5(targetParam + md5key, "UTF-8");
        System.out.println("targetSign: " + targetSign);
    }
}

加密工具类

MD5加密

import com.google.common.base.Joiner;
import org.apache.commons.lang.StringUtils;
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class EncodeUtils{

    public static String MD5(String text, String charset) {

        MessageDigest msgDigest = null;
        try {
            msgDigest = MessageDigest.getInstance("MD5");
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException("System doesn't support MD5 algorithm.");
        }
        try {
            msgDigest.update(text.getBytes(charset));    //注意改接口是按照指定编码形式签名
        } catch (UnsupportedEncodingException e) {
            throw new IllegalStateException("System doesn't support your  EncodingException.");
        }
        byte[] bytes = msgDigest.digest();
        String md5Str = new String(encodeHex(bytes));
        return md5Str;
    }

    public static char[] encodeHex(byte[] data) {

        int l = data.length;
        char[] out = new char[l << 1];
        // two characters form the hex value.
        for (int i = 0, j = 0; i < l; i++) {
            out[j++] = DIGITS[(0xF0 & data[i]) >>> 4];
            out[j++] = DIGITS[0x0F & data[i]];
        }
        return out;
    }
}

常见问题

回调未成功如何处理

我方会进行重试，间隔（回调时间点）如下：
{ "5s", "10s", "1m", "5m", "10m", "30m", "1h", "2h", "12h" }
即回调最晚时间是在12h后，如果下单后12h仍未回调，请联系我方人工处理。