易企通1.0
  1. 进件系统
易企通1.0
  • 易生接口联调指南
  • 资料下载
    • 技术资料
      • 易生MIS-POS技术方案
  • 接口能力
    • 进件系统
      • 报文数据元说明
      • 商管系统联调说明
      • 参数字典说明
      • 9进件类接口
        • 9.1 图片上传
        • 9.2 商户信息录入
        • 9.3 商户信息补件
        • 9.4 商户异步通知回调
        • 9.5 商户审核结果查询
        • 9.6 商户信息查询
        • 9.7 商户信息变更
        • 9.8 新增终端
        • 9.9 终端变更
        • 9.10 结算账户变更
        • 9.11 商户功能变更
        • 9.12 参数查询
        • 9.13 查询授权码
        • 9.14 机具序列号入库接口
        • 9.15 商户签约申请接口
        • 9.16 易生侧签约电子协议下载
        • 9.17 商户电子协议号变更
        • 9.18 终端授权码重置接口
        • 9.19 终端注销
        • 9.20 商户注销
        • 9.21 终端序列号TUSN校验
        • 9.22 终端序列号查询终端信息
        • 9.23 银联入驻结果查询
        • 9.24 微信支付宝重新入驻
        • 9.25 更新银联报备服务商
        • 9.26 更新代理商编号(特定使用)
        • 9.27 商户、终端操作通知
        • 9.28 终端码牌、小白盒绑定解绑
      • 10分账绑定类接口
        • 个人分账方入网
        • 企业分账方入网
        • 分账方信息更新
      • 11限额类接口
        • 11.1 查询限额
        • 11.2 新增限额
        • 11.3 变更限额
      • 12营销类接口
        • 12.1 活动报名新增接口
        • 12.2 活动报名终止接口
        • 12.3 活动报名查询接口(该接口不可用)
      • 13支付宝配置类接口
        • 支付宝实名认证
          • 13.1.1 图片上传接口
          • 13.1.2 商家认证申请单提交
          • 13.1.3 商家认证申请单状态
          • 13.1.4 商家认证状态
          • 13.1.5 商家认证申请单撤销
      • 14微信配置类接口
        • 14.6 微信活动报名
          • 微信图片上传接口
          • 微信活动报名申请
          • 微信活动报名进度查询
          • 微信活动报名重新申请
        • 14.7 微信实名认证
          • 提交申请单
          • 撤销申请单
          • 查询审核状态
          • 查询开户意愿确认状态
          • 微信/支付宝实名认证结果查询
          • 微信图片上传接口
        • 14.1 微信APPID配置
        • 14.2 微信授权目录配置
        • 14.4 微信商户简称及客服号码修改
        • 14.5 微信商户信息查询
        • 14.3 微信配置查询
    • 易企通1.0
      • 加签验签说明
      • 敏感信息加密
      • 标准类API
        • 附录-应答码说明
        • 附录-交易类型码
        • 担保
          • 担保申请
          • 担保确认
          • 担保查询
          • 担保撤销
        • 清算
          • 商户余额查询
          • 秒到交易查询(老-防腐层)
          • D1和T1交易结算查询
        • 标准-付款码支付
        • 标准-主扫支付
        • 标准-jsapi支付
        • 银联云闪付app支付
        • 标准-交易单笔查询
        • 标准-交易关闭
        • 云闪付授权
        • 银联JS-获取用户标识
        • 标准-交易支付成功通知
      • 用不到的接口
        • 定时任务-交易中间状态的定时查询
        • wxAppId可由前端传过来的-微信jsapi支付(目前用不着)
        • 获取微信openid
        • 获取请求附加数据(商户未接过,目前暂时用不上)
    • 云易收(云收银)
      • 云易收联调说明
      • 云易收-附录-码
      • H5预下单-标准
      • H5预下单-行业
      • 小程序预下单-标准
      • 小程序预下单-行业
      • 订单查询接口
      • 云闪付授权
      • 云闪付获取用户标识
      • 分期交易查询
      • 分期交易退货
      • 交易回调通知
    • 电子协议
      • 电子协议联调说明
      • 电子协议-附录-码
      • 个人开户3001
      • 企业开户3002
      • 发送验证码3101
      • 创建合同3201
      • 签署合同3206
      • 合同查询3210
      • 合同下载
      • 获取签名密钥
    • 分账、退款
      • 添加个人收款方
      • 添加企业收款方
      • 请求分账
      • 分账撤销
      • 分账结果查询
      • 分账关系绑定
      • 分账关系查询
      • 实时退款
      • 退款查询
      • 急速退款-账户代扣 (暂不可用)
      • 分账接收方变更
    • 网支中台
      • 银联无跳转快捷(全渠道)
        • 商户侧开通
          • 标准版-发送开通短信验证码
          • Token版-发送开通短信验证码
          • Token版-后台开通
          • 标准版-后台开通
        • 银联侧开通
          • Token版-前台页面开通(二期实现)
          • 标准版-前台页面开通
        • 发送短信验证码
        • 开通查询
        • 支付(短信验证)
        • 支付(无短信验证)
      • 订单系统
        • 交易信息查询
        • 订单创建
        • 订单关闭
        • 订单拉取-暂时没对外调试
    • 易生鉴权
      • 银行卡信息鉴权
      • 通讯运营商信息鉴权
      • 公安信息鉴权
      • 风险信息鉴权
      • 短信鉴权
      • 鉴权结果查询
      • 未命名接口
    • 微收单-不对接
      • resultcode应答码说明
      • getSign
      • 付款码支付
      • 主扫支付
      • JSAPI支付
      • 交易查询
      • 支付通知接口
      • 秒到交易查询
      • 银联行业码用户标识接口
      • 银联行业码支付
      • 交易退款
    • 易生代付
      • 代付交易请求
      • 代付查询交易请求
      • 批量代付交易请求(暂时未对外开放)
      • 批量代付结果查询请求(暂时未对外开放)
      • 代付额度查询
      • 手续费报送
      • 异步通知
      • 代付额度调整明细查询
    • 银行卡接口规范
      • 易生MIS-POS技术方案
      • 智能POS三方调用
      • 易生银行卡受理终端应用规范
      • 银行卡接口文档
  1. 进件系统

商管系统联调说明

一、通信方式

商管系统接口调用统一使用HTTP方式通信。

二、协议规则

💡

2.1 报文格式

代理商与易生间的报文采用key/value的表单方式通过HTTP Post提交。
报文后续可能会新增字段,服务商应对新增的字段不敏感,若服务商不关心该字段,可直 接丢弃。

💡

2.2 字符编码

统一采用 UTF-8 格式编码:单个中文字符长度为两个字节、英文或数字字符为一个字节。

📌

2.3 报文签名与验签

  1. 代理商对应的秘钥由易生生成,和机构号(clientCode)一起下发;
  2. 对于报文的签名处理机制如下:
    首先,对报文出现的签名域(MAC)之外的所有数据元按照key(忽略大小写)的ascii顺序排序,并 以&作为连接符拼接成待签名串(即key1=value1&key2=value2…),最后将渠道密钥(和机构号会一起下发)拼接在报文待签名字符串最后(key=md5)。然后对待签名串使用MD5做签名操作(签名字符串都是大写)。
  3. 对于报文的验签处理机制:
    首先,对报文出现的签名域(MAC)之外的所有数据元按照key的ascii顺序排序,并 以&作为连接符拼接成待签名串(即key1=value1&key2=value2…),最后将代理商的私钥拼接在报文待签名字符串最后(key=md5)。然后对待签名串使用MD5加密与报文中的签名信息做比较,验证报文的一致性;
  4. 签名代码
鉴权签名

/**

  • 鉴权签名
    /
    public static String getSign(String key, Map<String, String> map, String encode) {
    ArrayList list = new ArrayList();
    for (Map.Entry<String, String>entry : map.entrySet()) {
    if (StringUtils.isNotBlank(entry.getValue())) {//空值不参与加密
    list.add(entry.getKey() + "=" + entry.getValue() + "&");// key=value+
    }
    }
    int size = list.size();
    String[] arrayToSort = list.toArray(new String[size]);
    Arrays.sort(arrayToSort, String.CASE_INSENSITIVE_ORDER);
    StringBuilder sb = new StringBuilder();
    for (int i = 0; i < size; i++) {
    sb.append(arrayToSort[i]);
    }
    String result = sb.toString();
    result += "key=" + key;
    try {
    logger.info("md5之前:\n"+result);
    result = MD5Util.crypt(result, encode);
    logger.info(result);
    } catch (Exception e) {
    e.printStackTrace();
    }
    return result;
    }
    /
    *
  • Encodes a string 2 MD5
  • @param str String to encode
  • @return Encoded String
  • @throws NoSuchAlgorithmException
  • @throws UnsupportedEncodingException
    */
    public static String crypt(String str, String encode) throws NoSuchAlgorithmException, UnsupportedEncodingException {
    if (str == null || str.length() == 0) {
    throw new IllegalArgumentException("String to encript cannot be null or zero length");
    }
    StringBuffer hexString = new StringBuffer();
    MessageDigest md = MessageDigest.getInstance("MD5");
    md.update(str.getBytes(encode));
    byte[] hash = md.digest();
    for (int i = 0; i < hash.length; i++) {
    if ((0xff & hash[i]) < 0x10) {
    hexString.append("0" + Integer.toHexString((0xFF & hash[i])));
    } else {
    hexString.append(Integer.toHexString(0xFF & hash[i]));
    }
    }
    return hexString.toString().toUpperCase();
    }
修改于 2025-05-20 08:15:27
上一页
报文数据元说明
下一页
参数字典说明
Built with