微信实名认证开户意愿申请

1.修订记录

2.接口说明

（1）场景说明

1、微信实名认证开户意愿申请

（2）接口说明

1、微信实名认证接口（开户意愿申请单）-V3.0版本

3.请求地址

4.请求参数说明

4.1 公共请求参数

4.2 业务请求参数

参数名biz_content,值为一个json格式对象，下面列表描述json对象的值

4.3 受益人信息 BeneficiaryInfoRequest

4.4 金融许可证 FinanceInstitutionRequest

4.5 法人身份信息 IdentificationInfoRequest

4.6 联系人信息 MerContactInfoRequest

4.7 经营许可证信息 SpecialOperationRequest

5.响应参数说明

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

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

5.1 公共响应参数

5.2 业务响应参数

若以上资料报备系统若已存在的情况下，业务请求方仍通过接口上送至银盛报备系统的情况下，若符合提交申请单要求，银盛报备系统更新本地资料并提交申请单。

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

6.样例

6.1 SDK调用示例

• 银盛将与服务端交互的接口封装在开发工具包（SDK）中，开发者无需自行实现同服务端交互的复杂逻辑，直接将SDK导入自己的工程后，通过sdk示例代码实现同银盛服务端的交互。

    @Test
    public void applyWxAuthor() throws Exception {
        /**1、获取需要的参数*/
        OnlineReqDataVo req = new OnlineReqDataVo();
        //微信实名认证开户意愿申请的请求路径,建议配置在项目的配置文件里面
        String reqUrl = "https://openapi.ysepay.com/gateway.do";
        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        String privateKeyFilePath = "D:\\openRSA\\hyfz_test2.pfx";
        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        String privateKeyPassworde = "123456";
        //银盛公钥证书路径: 证书入网申请后随邮件发放
        String publicKeyFilePath = "D:\\openRSA\\businessgate.cer";
        //商户在银盛支付平台开设的用户号[商户号]:入网申请后发放
        String partnerId = "hyfz_test2";

        //设置私钥证书路径
        req.setPrivateKeyFilePath(privateKeyFilePath);
        //设置私钥密钥
        req.setPrivateKeyPassword(privateKeyPassworde);
        //设置ys公钥证书路径
        req.setYsPublicKeyFilePath(publicKeyFilePath);
        //设置请求路径
        req.setReqUrl(reqUrl);
        req.setPartnerId(partnerId);

        /**2、组装业务参数*/
        Map<String,Object> bizContentMap = new HashMap<>();
        bizContentMap.put("usercode","hyfz_test2");//商户号，入网申请后随邮件发送
        bizContentMap.put("cust_name","龙行百货");//商户名称 ：1）商户名称必须与商家营业执照上的名称一致。2）若个体工商户营业执照没有商家名称或者名称为“”或者“**”，则商户名称应填 “个体户XXX”（XXX为营业执照上经营者姓名）。3）若商家为小微商户，商户名称应填 “商户_XXX”（XXX为小微商户身份证上的姓名）
        bizContentMap.put("contact_cert_type","00");  //联系人证件类型
        bizContentMap.put("contact_cert_no",SrcDesUtil.encryptData(partnerId,"430626199701215716"));//联系人证件号,请加密传输 注：如果签名方式为RSA，则用DES加密，密钥Src用户号前8位，不足8位前补空; 如果签名方式为SM，则用SM加密
        bizContentMap.put("legal_cert_initial","20250905");//企业法人身份证证件有效开始日期,格式为yyyyMMdd
        bizContentMap.put("legal_cert_expire","29991231");//企业法人身份证证件有效期结束日期,格式为yyyyMMdd。此时间为29991231默认长期有效
        bizContentMap.put("bus_license_initial",null);//营业执照有效开始日期，格式为yyyyMMdd。当长期有效时取当前时间即可(客户类型为企业、个体时必填)
        bizContentMap.put("bus_license_expire",null);//营业执照有效结束日期，格式为yyyyMMdd。此时间为29991231默认长期有效（客户类型为企业、个体时必填）
        bizContentMap.put("store_type",null);//小微经营类型,(00):门店场所,(01):流动经营/便民服务,(02):线上商品/服务交易（客户类型为小微商户时必填）
        bizContentMap.put("store_name",null);//(00):门店场所：填写门店名称。(01):流动经营/便民服务：填写经营/服务名称。(02):线上商品/服务交易：填写线上店铺名称。示例值：杭州小笼包（客户类型为小微商户时必填）
        bizContentMap.put("token",null);//图片token值（客户类型为小微商户时必填）

        req.setParamData(bizContentMap);
        logger.info("微信实名认证开户意愿申请请求入参为:"+ JSONObject.toJSONString(req));

        /**2、调用API的方法*/
        String result = null;
        try{
            result = WxAuthorApi.applyWxAuthor(req);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            logger.info("微信实名认证开户意愿申请失败:"+e.getCause().getMessage());
            e.printStackTrace();
            //根据自己要求处理业务逻辑
        }
    }

7.证件类别

8.附录：图片上传

8.1 图片上传口令获取

8.1.1 图片上传口令获取

8.1.2.请求公共参数说明

请求参数是商户在与银盛支付进行数据交互时，提供给银盛支付的请求数据，以便银盛支付根据这些数据进一步处理。本文档中的所定义的三个接口，请求头部均要求按照此表格烈出的参数给出。

8.1.3.图片上传口令获取

参数名biz_content,值为一个json格式对象，下面业务参数的列表描述json对象的值，每一个请求的biz_content都请按业务参数列表来填写）：

该请求为空参数（但是biz_content依然要求按照json格式填写），每次请求都会获取到一个 TOKEN（口令）字符串，您需要在有效时间内，凭此TOKEN上传图片文件至银盛文件服务器中以备注册使用。TOKEN有效时间为120s，一个TOKEN可以上传N张类型不同的图片文件，同类型的图片文件将以最近一次上传为准，为了提高注册成功率，请一次性将需要提高的图片信息全部上传。

图片上传完毕之后请发起商户注册请求，进行注册。申请接口中的token属性是您上传文件时使用的TOKEN值，您需要记住。

8.1.4. 响应参数说明说明

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

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

8.1.4. 1 公共响应参数

8.1.4. 2 业务响应参数

8.2.文件上传服务-图片上传

8.2.1.图片上传注意事项

为确保商户申请成功率，请按照以下注意事项检查图片后再上传：

1.基本要求：图像文字清晰，人眼可辨别；对比度、亮度适中；尽量不要有背景，即证件充满图片，如果不能保证没有背景，请选择纯黑背景而且背景不宜过多。

2.对扫描图像的要求：扫描时选择分辨率300dpi，不能低于150 dpi，分辨率最好不要过高。

3.对拍摄图像的要求：拍摄时注意光照的影响，尽量避免反光和黑影，尤其是证件有薄膜覆盖的时候；拍摄时做好聚焦，以免图像模糊不清；拍摄时将证件放正；尽量不要使拍摄角度倾斜过大，以免造成图像变形；拍摄时请不要选择过高的分辨率拍摄，一方面造成图片过大，不利于传输，一方面分辨率过高也会影响识别率。拍摄时可以选择1280*960分辨率拍摄，低一些的分辨率也可以选择，但是要确保图像文字清晰

4.为确保商户申请响应速度，建议图片大小在1M内.

8.2.2.图片上传地址：

8.2.3.请求图片上传参数

请求参数是商户在与银盛支付进行数据交互时，提供给银盛支付的请求数据，以便银盛支付根据这些数据进一步处理。

8.2.4.响应参数说明

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

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

8.2.5.图片文件的类型

附表1 图片类型的必要性，打钩为必填项：