商户进件

1、修订记录

2、业务说明

（1）接口说明

扫码服务商使用该接口提交商家（子商户）资料，帮助商家入驻成为银盛支付商户。 流程指引请看 扫码服务商-子商户进件时序图

3、请求地址

4、请求参数说明

4.1、 公共请求参数

4.2、业务请求参数

data加密前的json数据明文字符串

注意：下方分类只是对字段进行名义上的归类，以帮助理解参数意思，无实际意义

5.响应参数说明

银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。

请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。

5.1、公共响应参数

5.2、业务响应参数

data(JSON数据)

6.示例

```java public static String addScanMerc() throws Exception { /* 1、外层公有请求参数赋值 / Map params = new HashMap(); params.put("ver", "1.0");//固定值1.0 params.put("msgCode", "Merchant");//接口代码，详见文档 params.put("method", "addScanMerchant");;//接口方法，详见文档 params.put("src","ORG20210927162704");// 由银盛生成的接入机构号，请联系银盛客户经理获取 params.put("signType", "RSA");//固定值RSA params.put("charset", Constants.CHARSET_UTF_8);//固定值UTF-8

    /** 2、业务参数data赋值: 业务参数说明详细见接口文档 */
    /** -----------组装业务参数开始 设置为null相当于map里面没有put这个参数,只是做参数的参考,具体按自己业务设置对应字段的值-------------*/
    Map<String,Object> dataparams = new HashMap<>();
    dataparams.put("userShortName","张三科技");//商户简称 （商户模式为3时不用填）
    dataparams.put("userType","0");//商户模式 0-个体商户;1-企业商户;3:小微商户，商户模式不同，上传的图片不同。详见上传图片接口
    dataparams.put("coOperatorNo","801551099990303");//代理商编号
    dataparams.put("certType","00");//证件类型 身份证 00（只支持00）
    dataparams.put("actualManager","张三");//实际控制人
    dataparams.put("mccCd","5533");//扫码报备所需商户类型 详情见附录7.2
    dataparams.put("contactsPhone","12111111111");//联系人电话
    dataparams.put("contactsEmail","10xxxxxxxx@qq.com");//联系人邮箱
    dataparams.put("contactsName","张三");//联系人姓名
    dataparams.put("contactsAddr","广东省深圳市龙华区");//联系人通讯地址

    //法人信息
    dataparams.put("legalPersonName","张三");//法人姓名
    dataparams.put("legalPersonId","430626199301215716");//法人身份证号码
    dataparams.put("legalPersonIdSdate","20201010");//法人身份证开始日期
    dataparams.put("legalPersonIdEdate","20990505");//法人身份证到期日期
    dataparams.put("legalPersonPhone","12111111111");//法人电话
    dataparams.put("crpProfession","10");//法人职业
    dataparams.put("crpNationality","中国");//法人国籍 选填（不填的话默认选择中国）
    dataparams.put("crpGender","0");//法人性别
    dataparams.put("crpAddr","广东省深圳市龙华区");//法人地址

    //营业资质信息
    dataparams.put("businessLicence","张三科技");//营业执照全称
    dataparams.put("businessLicenceNo","5466xxxxxxxxxA");//营业执照号码
    dataparams.put("businessLicenceSdate","20200101");//营业执照开始日期
    dataparams.put("businessLicenceEdate","20990105");//营业执照结束日期
    dataparams.put("registeredAddress","中国广东深圳");//注册地址 （商户模式为3时不用填）

    //结算信息
    dataparams.put("balanceAccType","11");//结算卡类型 11：对私借记卡（ 结算卡正面照、结算卡反面照图片必传）21：对公账户（ 有账户号面照片，开户许可证）23：对公存折（ 只须有账户号面照片，开户许可证）24：单位结算卡（ 结算卡正面照、 结算卡反面照图片必传）
    dataparams.put("balanceAccCardno","62175123456789119");//结算卡号
    dataparams.put("balanceAccName","张三");//结算户名
    dataparams.put("bankMobile","15526201167");//银行预留手机号
    dataparams.put("bankType","1041000");//开户行行别编号，规范详见附录 7.3
    dataparams.put("bankName","中国银行");//开户行行别名称，规范详见附录 7.3
    dataparams.put("openAccBanktype","104100005145");//开户行编号（支行），规范详见附录 7.3
    dataparams.put("openAccBankname","中国银行股份有限公司北京复兴门支行");//开户行名称（支行），规范详见附录 7.3
    dataparams.put("openAccProvince","广东省");//开户行省（如湖北省） 规范详见附录 7.8
    dataparams.put("openAccCity","长沙市");//开户行市（如武汉市） 规范详见附录 7.8
    dataparams.put("openAccArea","6412");//开户行区，规范详见附录 7.8
    dataparams.put("lowestStlAmt","1");//结算起始金额 单位元
    dataparams.put("codeLegalPersonAcc","1");//是否法人结算 0: 非法人结算 , 1: 法人结算
    dataparams.put("unincorporatedName","张三");//非法人姓名
    dataparams.put("unincorporatedId","430626199301215716");//非法人身份证号码

    //门店信息
    dataparams.put("mercUpId","826440357229AV8");//总店商户号    商户级别为分店时必填
    dataparams.put("mercLvl","2");//商户级别 1 总店 2 分店（默认传总店、分店暂不支持）
    dataparams.put("businessAddress","广东省深圳市xxxx大厦xx层");//营业地址
    dataparams.put("mercProv","广东省");//商户归属省（如湖北省）规范详见附录 7.8
    dataparams.put("mercCity","长沙市");//商户归属市（如武汉市）规范详见附录 7.8
    dataparams.put("mercArea","龙华区");//商户归属区 规范详见附录 7.8

    //支付业务信息
    dataparams.put("openScan","0");//是否开通POS扫码业务0:不开通，1:开通
    dataparams.put("openPosp","0");//是否开通刷卡业务0:不开通，1:开通
    dataparams.put("openBusRadio","00");//到账方式 00:T+1到账 01:D+1到账 只能二选一
    dataparams.put("fastPay","1");//是否开通D0
    dataparams.put("codeAdvanceOpen","1");//是否开通扫码D0垫资费 0：不开通，1：开通

    //todo pos扫码费率信息-----openScan为1时才需要设置以下参数
    dataparams.put("wechatSignRate","22");//微信签约费率(最低:0.01%)
    dataparams.put("wechatSignMin","1");//微信签约费率封底(单位:分)
    dataparams.put("alipaySignRate","22");//支付宝签约费率(最低:0.01%)
    dataparams.put("alipaySignMin","1");//支付宝签约费率封底(单位:分)
    dataparams.put("creditRate1","55");//银联一档（>1000）：贷记卡费率
    dataparams.put("creditMin1","10");//银联一档（>1000）：贷记卡封底.（单位：分）
    dataparams.put("debitRate1","55");//银联一档（>1000）：借记卡费率
    dataparams.put("debitMax1","10000");//银联一档（>1000）：借记卡封顶（单位：分）
    dataparams.put("debitMin1","10");//银联一档（>1000）：借记卡封底（单位：分）
    dataparams.put("creditRate2","55");//银联二档（<=1000）：贷记卡费率
    dataparams.put("creditMin2","10");//银联二档（<=1000）：贷记卡封底（单位：分）
    dataparams.put("debitRate2","55");//银联二档（<=1000）：借记卡费率
    dataparams.put("debitMin2","10");//银联二档（<=1000）：借记卡封底（单位：分
    dataparams.put("debitMax2","10000");//银联二档（<=1000）：借记卡封顶（单位：分）

    //todo T+1到账费率信息-----开通了刷卡业务（openPosp为1）并且刷卡到账方式（openBusRadio）为00时，才需要设置以下参数
    dataparams.put("t111Rate",null);//T+1到账-借记卡费率
    dataparams.put("t111RateTop",null);//T+1到账-借记卡费率封顶（单位：分）
    dataparams.put("t111SignRateMin",null);//T+1到账-借记卡费率封底（单位：分）
    dataparams.put("t112Rate",null);//T+1到账-贷记卡费率
    dataparams.put("t112SignRateMin",null);//T+1到账-贷记卡费率封底（单位：分）

    //todo D+1到账费率信息-----开通了刷卡业务（openPosp为1）并且刷卡到账方式（openBusRadio）为01时，才需要设置以下参数
    dataparams.put("t11Rate","0.01");//D+1到账-借记卡费率
    dataparams.put("t11RateTop","100");//D+1到账-借记卡费率封顶（单位：分）
    dataparams.put("t11SignRateMin","1");//D+1到账-借记卡费率封底（单位：分）
    dataparams.put("t12Rate","0.01");//D+1到账-贷记卡费率
    dataparams.put("t12SignRateMin","1");//D+1到账-贷记卡费率封底（单位：分）
    dataparams.put("tAdvanceType","百分比");//D+1到账-垫资费类型（百分比、元）
    dataparams.put("tAdvanceFee","10");//D+1到账-垫资费
    dataparams.put("tAdvanceMin","10");//D+1到账-垫资费封底（单位：分）

    //todo 刷卡D0到账费率信息-----开通了刷卡D0到账（fastPay）为1时，才需要设置以下参数
    dataparams.put("d011Rate","0.01");//D0到账-借记卡费率
    dataparams.put("d011RateTop","100");//D0到账-借记卡费率封顶（单位：分）
    dataparams.put("d011RateBottom","10");//D0到账-借记卡费率最低（单位：分）
    dataparams.put("d012Rate","0.01");//D0到账-贷记卡费率
    dataparams.put("d012RateBottom","10");//D0到账-贷记卡费率最低（单位：分）
    dataparams.put("d0AdvanceJsignType","百分比");//D0到账-借记卡签约费率垫资费类型(百分比；元)
    dataparams.put("d0AdvanceJsignFee","10");//D0到账-借记卡签约费率垫资费
    dataparams.put("d0AdvanceJsignMin","1");//D0到账-借记卡签约费率垫资费封底(单位:分)
    dataparams.put("d0AdvanceJsignMax","100");//D0到账-借记卡签约费率垫资费封顶(单位:分)
    dataparams.put("d0AdvanceDsignType","百分比");//D0到账-贷记卡签约费率垫资费类型(百分比；元)
    dataparams.put("d0AdvanceDsignFee","10");//D0到账-贷记卡签约费率垫资费
    dataparams.put("d0AdvanceDsignMin","1");//D0到账-贷记卡签约费率垫资费封底(单位:分)
    dataparams.put("d0AdvanceDsignMax","100");//D0到账-贷记卡签约费率垫资费封顶(单位:分)

    //todo 扫码D0到账费率信息-----开通了扫码D0到账（codeAdvanceOpen）为1时，才需要设置以下参数
    dataparams.put("codeAdvanceRate","0.03");//垫资费费率 取值区间：0.01-99.99（开通扫码D0垫资费的话则必填）
    dataparams.put("codeAdvanceMin","1");//垫资费费率最低值（单位：分）取值区间：1-999900（开通扫码D0垫资费的话则必填）

    //其他
    dataparams.put("remark","调用商户进件接口，身份/结算卡信息随便填写的，需要自己修改为自己的数据进行测试");//备注
    dataparams.put("expandingManager","王五");//拓展经理姓名
    /** 3、业务参数加密: 业务参数说明详细见接口文档 */
    //加密密钥aeskey: 加密密钥证书入网申请后发放
    String aesKey = "A81F41DE7406CC1566579A751D93CA7A";
    String addMercData = JSONObject.toJSONString(dataparams);
    String creData = DesUtil.encryptExtraData(aesKey, "UTF-8", addMercData);
    params.put("data", creData);

    /** 4、根据请求参数生成签名 */
    //客户端私钥证书路径: 证书在入网流程中自己申请的
    String privateKeyFilePath = "D:/data/yulong_666.pfx";
    //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
    String privateKeyPassword = "123456";
    String sign = YsfSignUtil.sign(params, privateKeyFilePath, privateKeyPassword);
    params.put("signValue", sign);
    //因为请求流水号(reqFlowId)不参与签名，在签名之后补充reqFlowId,请自己生成有意义的请求流水号
    params.put("reqFlowId", String.valueOf(System.currentTimeMillis()));

    /** 5、发送请求*/
    //扫码服务商“商户进件”修改地址，具体以文档为准
    String reqUrl = "https://appdev.ysepay.com/saas/org/addScanMerchant";
    String result = HttpClientUtil.sendPostJson(reqUrl,JSONObject.toJSONString(params));

    /** 6、结果验签 */
    JSONObject jsonObject = JSONObject.parseObject(result);
    // 获取签名串
    String sinaValue = jsonObject.getString("signValue");
    // 获取返回的业务参数（json数据）
    String respData = jsonObject.getString("data");
    Map<String, String> dataMap = null;
    if(!StringUtil.isEmpty(respData)){
        dataMap = JSONObject.parseObject(respData,Map.class);
    }
    //银盛公钥证书路径: 证书入网申请后发放
    String ysPublicKeyFilePath = "D:/data/businessgate.cer";
    //校验返回的业务参数是否与签名串匹配
    boolean flag = YsfSignUtil.rsaCheckContent(dataMap,sinaValue,ysPublicKeyFilePath);
    if(!flag){
        throw new Exception("check sign error");
    }
    return result;
}

```{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}