1.1 payParams参数列表

1.1.1 payParams中的notifyUrl接口规则

例：业务 notifyUrl 传入 https://xxx.com/abc , 回调请求地址为 https://xxx.com/abc?msgId=123&msgContent=通知JSON字符消息体

notifyUrl 可以自己补充参数， 如 https://xxx.com/abc?axv=1 ，回调会自适应请求地址 https://xxx.com/abc?axv=1&msgId=123&msgContent=支付中心返回的JSON串

注意事项：

1. notifyUrl通知方式为GET请求
2. 支付中心调用接入方接口会回传两个参数msgId和msgContent
3. msgContent 存储的JSON字段，未来有可能会新增新的一级字段，且参与签名，验签或解析时应当考虑兼容新增字段。
4. 接入方需要校验 sign 以确保回调信息是来自支付中心的合法回调。签名校验方式如发起支付时的签名方式。
5. 重试策略为 1, 10, 20, 60, 60, 180, 360, 600, 600, 3600, 7200, 7200, 代表回调未得到业务方成功响应后延迟重试时间（秒）

Java解析示例

JSONObject jsonObject = JSONObject.parseObject(msgContent);
Map<string,string> map = new HashMap<>();
for(string key : jsonObject.keySet()){
  map.put(key, jsonObject.get(key).toString());
}

支付中心返回的支付结果msgContent JSON串参数说明如下

支付结果msgContent示例

{
  "customerId": 1,
  "serviceType": 0,
  "txId": 30271458087***,
  "orderId": "928123***",
  "feeType": "CNY",
  "payStatus": "SUCCESS",
  "payChannel": "bp",
  "payChannelName": "B币",
  "payChannelId": 99,
  "payAmount": 9,
  "payMsgContent": "{\"payCounponAmount\":0,\"payBpAmount\":9}",
  "payAccountId": "27515323",
  "deviceType": 2,
  "orderPayTime": "2018-09-07 17:39:37",
  "timestamp": "1536313177258",
  "traceId": "3027145809363013632",
  "extData": "{}",
  "signType": "MD5",
  "sign": "5e32095c9a3f49a8001a90a5c162461b",
  "expiredTime": 0
}

接入方的notifyUrl接口需返回是否处理完成，给支付中心返回一个字符串，值如下

• SUCCESS 表示成功
• FAIL 表示失败 支付平台会立即重试
• REPUBLISH 支付平台稍后重试

支付中心明确收到指定返回后，才认为通知成功，否则会重试，业务方需保证该回调接口的幂等性，注意返回值是大写字符串。

1.1.2 payParams中sign签名生成规则如下

1. 将payParams中参数按照字典排列后连接token（token由支付中心未接入方分配）如：k1=v1&k2=v2&……&token=xxx
2. 进行md5加密后全部小写 sign生成如下：

sign = md5(k1=v1&k2=v2&……&token=xxx).toLowerCase()

【生成签名示例 Java 代码】
public class RestSignUtils {
/**
 * 对实体类进行签名
 * @param o
 * @param token
 */
    public static string sign(Object o, string token) {
      BaseVO baseVO = new BaseVO();
      JsonElement jsonElement  = new JsonParser().parse(o);
      try {
        Map<string, string> paramMap = new HashMap<>();
        JsonObject jsonObject = jsonElement.getAsJsonObject();
        Iterator<Map.Entry<string, JsonElement>> iterator = jsonObject.entrySet().iterator();
        while (iterator.hasNext()) {
          Map.Entry<string, JsonElement> entry = iterator.next();
          if (entry.getValue().isJsonPrimitive()) {
            paramMap.put(entry.getKey(), entry.getValue().getAsString());
          } else {
            paramMap.put(entry.getKey(), entry.getValue().toString());
          }
        }
        return getSign(paramMap, token);
      } catch (Exception e) {
        BiliLog.error("sign failed. error [{}]", e.getMessage());
        throw new RuntimeException("签名计算错误");
      }
    }
    public static string  getSign(Map<string, string> paramterMap, string payToken) {
      List<Map.Entry<string, string>> paramsList = new ArrayList<>(paramterMap.entrySet());
      try {
        Collections.sort(paramsList, new Comparator<Map.Entry<string, string>>() {
          @Override
          public int compare(Map.Entry<string, string> o1, Map.Entry<string, string> o2) {
            return o1.getKey().compareTo(o2.getKey());
          }
        });
        List<string> params = new ArrayList<>();
        for (Map.Entry<string, string> singleOne: paramsList) {
          params.add(string.format("%s=%s", singleOne.getKey(), singleOne.getValue()));
        }
        params.add("token=" + payToken);
        string orignalSign = StringUtils.join(params, "&");
        return Md5Utils.GetMD5Code(orignalSign).toLowerCase();
      } catch (Exception e) {
        BiliLog.warn("parameter sort failed. {}", e.getMessage());
      }
      return null;
    }
}