01)银盛开放平台互联网子商户进件,YSEPAYSHOP一款私域电商独立站H5小程序搭建系统，系统可以同时对接A/T直连接入，三方支付API接入

已于 2024-08-08 15:07:04 修改
阅读量774 收藏 19
点赞数 18
分类专栏： 银盛开放平台 文章标签： 数据库 java 服务器
于 2024-08-08 15:06:42 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ryfpos/article/details/141027459
版权

1.修订记录

修订日期说明作者
V0.12018/01/29新接口参数定义黄月巧
V0.22018/4/12新加同步返回“是否需要电子合同”字段，新加异步通知接口黄月巧
V0.32018/9/26注册新加客服电话，上传图片法人手持身份证正扫面照和门头照非必填张丁元
V0.42018/12/05更新notify_type参数说明郭勇
V0.52019/01/17新增参数:机构号org_no，分账参与商户标识sub_account_flag张丁元
V0.62019/01/17异步通知增加字段online_url, offline_url陈宋东
V0.72019/07/03补充图片上传注意事项郭勇
V0.82020/06/04需上传的图片需要新增50,51宁华雄
V0.92020/10/10不支持结算至贷记卡汤吉齐
V1.02021/12/21授权信息上送刘雷
V1.12021/12/27支持国密王晶

2.接口说明

（1）场景说明

1、线上子商户进件，包括口令获取、商户注册、注册查询、图片上传接口
2、需要调用口令获取(上传图片需要用到)、图片上传、注册接口进行注册
3、调用查询接口查看注册结果

（2）接口说明

1、商户进件上传口令获取、注册文本接口与查询接口-V3.0版本(新)
2、口令获取：调用接口获取token口令，在图片上传时需要此值
3、图片上传：根据token上传图片，调用商户注册接口时通过上传的token关联对应的图片
4、商户注册：传入商户资料进行子商户注册，注册成功返回子商户号
5、注册查询：商户注册结果未知时，调用接口获取商户注册状态

3.请求地址

环境HTTPS请求地址
正式环境https://register.ysepay.com:2443/register_gateway/gateway.do

4.请求参数说明

4.1 公共请求参数

参数类型(字节长度）必填参数说明
methodString(1,128)Y接口名称 获取上传口令接口：ysepay.merchant.register.token.get 商户注册接口：ysepay.merchant.register.accept 查询注册接口：ysepay.merchant.register.query
partner_idString(1,20)Y在银盛支付开设的服务商商户号，请联系客户经理提供
timestampString(1,19)Y发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" 示例值：2014-07-24 03:07:50
charsetString(1,10)Y商户网站使用的编码格式，如UTF-8、GBK、GB2312等，默认值 GBK
sign_typeString(1,10)Y报文签名算法，RSA/SM
signString(1,256)Y签名字符串，再用Base64编码
notify_urlString(190)Y银盛支付服务器主动通知商户网站里指定的页面http路径。
versionString(1,3)Y接口版本3.0 当前版本：3.0
biz_contentStringY业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递

5.业务参数说明

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

5.1 图片上传口令获取

5.1.1 图片上传口令获取

参数类型(字节长度）必填参数说明样例是否可为空

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

图片上传地址：
生产环境:https://uploadApi.ysepay.com:2443/yspay-upload-service?method=upload
测试环境:https://cloudbilltest.ysepay.com:2080/yspay-upload-service?method=upload

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

5.1.2 业务响应参数

参数类型(字节长度）必填参数说明
codeStringY响应代码
msgStringY响应代码描述
tokenString(32)Ytoken值
token_statusString(20)Y获取TOKEN返回的状态，指示业务进度，TOKEN_GET_SUCCESS获取成功；TOKEN_GET_NULL获取失败

5.1.3 SDK调用示例

  • 银盛将与服务端交互的接口封装在开发工具包（SDK）中，开发者无需自行实现同服务端交互的复杂逻辑，直接将SDK导入自己的工程后，通过sdk示例代码实现同银盛服务端的交互。
 @Test
    public void getToken() throws Exception {
        /**1、获取需要的参数*/
        OnlineReqDataVo req = new OnlineReqDataVo();
        //获取图片上传token的请求路径,建议配置在项目的配置文件里面
        String reqUrl = "https://register.ysepay.com:2443/register_gateway/gateway.do";
        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        String privateKeyFilePath = "D:\\openRSA\\hyfz_test2.pfx";
        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        String privateKeyPassworde = "123456";
        //银盛公钥证书路径: 证书入网申请后随邮件发放
        String publicKeyFilePath = "D:\\openRSA\\businessgate.cer";
        //商户在银盛支付平台开设的用户号[商户号]:入网申请后发放
        String partnerId = "hyfz_test2";
        //银盛支付服务器主动通知商户网站里指定的页面http路径。
        String notifyUrl = "http://127.0.0.1";
        //设置私钥证书路径
        req.setPrivateKeyFilePath(privateKeyFilePath);
        //设置私钥密钥
        req.setPrivateKeyPassword(privateKeyPassworde);
        //设置ys公钥证书路径
        req.setYsPublicKeyFilePath(publicKeyFilePath);
        //设置请求路径
        req.setReqUrl(reqUrl);
        //设置通知路径
        req.setNotifyUrl(notifyUrl);
        req.setPartnerId(partnerId);

        logger.info("获取图片上传token请求入参为:"+ JSONObject.toJSONString(req));

        /**2、调用API的方法*/
        String result = null;
        try{
            result =  OnlineMercApi.getToken(req);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            logger.info("获取图片上传token失败:"+e.getCause().getMessage());
            e.printStackTrace();
            //根据自己要求处理业务逻辑
        }
    }

5.1.4 API接口代码示例

  • 需要开发者自己封装调用逻辑，实现调用银盛api接口同银盛服务端交互,该示例没有加签验签及发送http请求代码，需自行下载demo查看。
   @Test
    public void getToken() throws Exception {
        //组装公共请求参数
        Map<String,String> mapDate = new HashMap<String, String>();
        mapDate.put("method","ysepay.merchant.register.token.get");
        mapDate.put("partner_id","hyfz_test2");
        mapDate.put("timestamp", DateUtil.getDateNow());
        mapDate.put("charset","UTF-8");
        mapDate.put("sign_type","RSA");
        mapDate.put("notify_url","http://127.0.0.1");
        mapDate.put("version","3.0");
        mapDate.put("biz_content","{}");
        //进行参数签名，获取sign
        try{
            String sign = YsPaySignUtils.sign(mapDate);
            log.info("产生的签名sign："+sign);
            mapDate.put("sign",sign);
        }catch (Exception e){
            log.info("签名异常："+e);
        }
        //调用TOKEN获取接口
        String result = HttpRequest.sendPost("https://register.ysepay.com:2443/register_gateway/gateway.do",CommonUtil.mapToString(mapDate));
        if(StringUtil.isBlank(result)){
            log.info("接口返回为空");
        }

        //返回数据验签
        boolean flag = false;
        try {
            flag = YsPaySignUtils.resultVerify(result,"ysepay_merchant_register_token_get_response");
            if (!flag){
                throw new Exception("验签失败");
            }
        }catch (Exception e){
            log.info("验签异常："+e);
        }
        //解析接口回执，获取token值
        JSONObject response = (JSONObject) JSON.parseObject(result, Feature.OrderedField).get("ysepay_merchant_register_token_get_response");
        String token = response.get("token").toString();
        log.info("TOKEN:"+token);
    }

5.2 商户注册接口

商户通过上传口令获取接口拿到银盛返回的Token值之后，等同于拿到了一个可以上传图片的口令。商户可以根据这个口令完成图片的上传，这些上传的图片会与本接口传递的文本信息是注册商户不可缺少的元素。图片上传接口是文件上传服务提供的接口，并不是网关接口，商户可以根据下面给出的地址进行访问。

上传图片接口的地址：
https://uploadApi.ysepay.com:2443/yspay-upload-service?method=upload

接口参数请参看4.附相关内容

图片上传完成之后需要在网关上传注册的文本信息，本接口定义的是上传注册文本信息时需要传递的参数。

5.2.1 请求注册接口

参数类型(字节长度）必填参数说明
merchant_noString(1,20)Y平台商唯一标识（自定义）
remarkString(0,500)N备注
cust_typeString(1,1)Y客户类型O：小微；B：企业；C:个体
tokenString(1,50)Ytoken值
another_nameString(1,100)Y商户简称
cust_nameString(1,100)Y公司名称或者客户名称，客户类型是小微商户时客户名称需和身份证号码、法人手机号码匹配
mer_flagString(0,1)N商户属性。11为普通商户，12为代理商户，不填的情况下默认为普通商户
industryString(1,4)Y行业类别 ，详细类别见3.6节的定义
provinceString(1,40)Y省，为完善企业信息请准确填写
cityString(1,40)Y市,为完善企业信息请准确填写
company_addrString(1,200)Y详细地址，为完善企业信息请准确填写
legal_nameString(1,100)N企业法人名字，需和身份证号码、法人手机号码匹配，当客户类型为小微商户时，企业法人可以为空，
legal_telString(1,20)Y企业法人手机号码
mailString(0,60)N登陆邮箱，请按照正确邮箱格式填写
contact_manString(0,100)N联系人
contact_phoneString(0,11)N联系人手机号码
legal_cert_typeString(1,2)Y企业法人证件类型，支持类型请参照3.7小节
legal_cert_noString(1,80)Y企业法人证件号,请加密传输 注：如果签名方式为RSA，则用DES加密，密钥Src用户号前8位，不足8位前补空 ；如果签名方式为SM，则用SM加密
legal_cert_expireString(8,8)N企业法人证件有效期,格式为yyyyMMdd。为空时默认长期有效
bus_licenseString(0,40)N营业执照，客户类型为个体商户、企业户时为必填，为保证商户信息准确，请填写有效营业执照号 示例值：沪-A1283123132
bus_license_expireString(0,8)N营业执照有效期，客户类型为个体商户、企业商户时为必填，格式为yyyyMMdd 示例值：20181229
notify_typeString（0,1）N通知方式，此通知为商户号审核通知，通知内容包含帐号信息，为空的情况下将不发送通知，支持通知方式1、邮箱，2手机短信，3、邮箱+手机短信 固定值：1
settle_typeString(1,1)Y结算方式，0:平台内账户1:银行卡账户.结算方式为0时银行卡信息只涉及提现，为1时涉及到提现以及清算
bank_account_noString(10，23)Y银行帐号，注：当bank_account_type为对公账户时，该属性字段长度可以为String(1,32)
bank_account_nameString(1,100)Y开户人，银行卡账户名，需和法人姓名或客户姓名一致
bank_account_typeString(3,9)Y银行账户类型，此处必填corporate :对公账户;personal:对私账户
bank_card_typeString(4,6)Y银行卡类型，可填debit、unit、debit借记卡，unit单位结算卡
bank_nameString(1,128)Y开户行名称，为交易能顺利进行，请尽可能填写到街道 示例值：中国银行深圳分行民治支行
bank_typeString(1,128)Y银行行别 示例值：中国银行
bank_provinceString(40)Y开户行所在的省份
bank_cityString(1,40)Y开户行所在城市
cert_typeNumber(2,2)Y开户人证件类型，目前只支持00,00为身份证
cert_noString(1,50)Y开户人证件号码，请加密传输 如果签名方式为RSA，则用DES加密，密钥Src用户号前8位，不足8位前补空 ; 如果签名方式为SM，则用SM加密
bank_telephone_noString(11)Y银行预留手机号
service_telString(10,12)N客服电话
org_noString(10)Y银盛下发的商户机构号，该参数不为空的情况下，商户机构号以上送的为准 【联系银盛运营/技术支持获取子商户归属的机构号】
sub_account_flagString(1)N分账参与商户标识，Y：是，N或空：否；该参数为Y的情况下，则表示商户仅参与分账，无需开通交易业务权限；为N或空的情况下，默认非分账参与商户
auth_protocol_verString(64)N用户授权协议版本号
auth_protocol_noString(64)N用户授权协议流水号

5.2.2 业务响应参数

参数类型(字节长度）必填参数说明
codeStringY响应代码
msgStringY响应代码描述
usercodeString(20)Y用户名
custnameString(100)Y客户名
custidString(20)Y客户ID
user_statusString(2)Y状态
createtimeString(8,8)Y创建时间

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

5.2.3 SDK调用示例

  • 银盛将与服务端交互的接口封装在开发工具包（SDK）中，开发者无需自行实现同服务端交互的复杂逻辑，直接将SDK导入自己的工程后，通过sdk示例代码实现同银盛服务端的交互。
 @Test
    public void merchantRegister() throws Exception {
        /**1、获取需要的参数*/
        OnlineReqDataVo req = new OnlineReqDataVo();
        //注册线上进件商户的请求路径,建议配置在项目的配置文件里面
        String reqUrl = "https://register.ysepay.com:2443/register_gateway/gateway.do";
        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        String privateKeyFilePath = "D:\\openRSA\\hyfz_test2.pfx";
        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        String privateKeyPassworde = "123456";
        //银盛公钥证书路径: 证书入网申请后随邮件发放
        String publicKeyFilePath = "D:\\openRSA\\businessgate.cer";
        //商户在银盛支付平台开设的用户号[商户号]:入网申请后发放
        String partnerId = "hyfz_test2";
        //银盛支付服务器主动通知商户网站里指定的页面http路径。
        String notifyUrl = "http://127.0.0.1";
        //设置私钥证书路径
        req.setPrivateKeyFilePath(privateKeyFilePath);
        //设置私钥密钥
        req.setPrivateKeyPassword(privateKeyPassworde);
        //设置ys公钥证书路径
        req.setYsPublicKeyFilePath(publicKeyFilePath);
        //设置请求路径
        req.setReqUrl(reqUrl);
        //设置通知路径
        req.setNotifyUrl(notifyUrl);
        req.setPartnerId(partnerId);

        /**2、组装业务参数*/
        Map<String,Object> bizContentMap = new HashMap<>();
        bizContentMap.put("merchant_no","youname");//平台商唯一标识
        bizContentMap.put("remark","第一个商户");//备注
        bizContentMap.put("cust_type","O");//客户类型O：小微；B：企业；C:个体
        bizContentMap.put("token","TK20211012165208644yMaMr2UD");//token值 :通过getToken接口获取
        bizContentMap.put("another_name","龙商龙行");//商户简称
        bizContentMap.put("cust_name","龙行百货");//公司名称或者客户名称，客户类型是小微商户时客户名称需和身份证号码、法人手机号码匹配
        bizContentMap.put("mer_flag","11");//商户属性。11为普通商户，12为代理商户，不填的情况下默认为普通商户
        bizContentMap.put("industry","23");//行业类别 ，详细类别见3.6节的定义
        bizContentMap.put("province","内蒙古自治区");//省，为完善企业信息请准确填写
        bizContentMap.put("city","呼和浩特市");//市,为完善企业信息请准确填写
        bizContentMap.put("company_addr","滨河北路中海外滩");//详细地址，为完善企业信息请准确填写
        bizContentMap.put("legal_name","李四");//企业法人名字，需和身份证号码、法人手机号码匹配，当客户类型为小微商户是，企业法人可以为空，
        bizContentMap.put("legal_tel","13747255939");//企业法人手机号码
        bizContentMap.put("mail","7691345307@qq.com");//登陆邮箱，请按照正确邮箱格式填写
        bizContentMap.put("contact_man","张三");//联系人
        bizContentMap.put("contact_phone","18888888888");//联系人手机号码
        bizContentMap.put("legal_cert_type","00");//企业法人证件类型，支持类型请参照3.7小节
        bizContentMap.put("legal_cert_no", SrcDesUtil.encryptData(partnerId,"110101198001010010"));//企业法人证件号,请加密传输 注：如果签名方式为RSA，则用DES加密，密钥Src用户号前8位，不足8位前补空; 如果签名方式为SM，则用SM加密
        bizContentMap.put("legal_cert_expire","20360810");//企业法人证件有效期,格式为yyyyMMdd。为空时默认长期有效
        bizContentMap.put("bus_license","沪-A1283123132");//营业执照，客户类型为个体商户、企业户时为必填，为保证商户信息准确，请填写有效营业执照号
        bizContentMap.put("bus_license_expire","20181229");//    营业执照有效期，客户类型为个体商户、企业商户时为必填，格式为yyyyMMdd
        bizContentMap.put("notify_type","1");//通知方式，此通知为商户号审核通知，通知内容包含帐号信息，为空的情况下将不发送通知，支持通知方式1、邮箱，2手机短信，3、邮箱+手机短信
        bizContentMap.put("settle_type","1");//结算方式，0:平台内账户1:银行卡账户.结算方式为0时银行卡信息只涉及提现，为1时涉及到提现以及清算
        bizContentMap.put("bank_account_no","43672221090449733315");//银行帐号，注：当bank_account_type为对公账户时，该属性字段长度可以为String(1,32)
        bizContentMap.put("bank_account_name","王二小");//开户人，银行卡账户名，需和法人姓名或客户姓名一致
        bizContentMap.put("bank_account_type","personal");//银行账户类型，此处必填corporate :对公账户;personal:对私账户
        bizContentMap.put("bank_card_type","debit");//银行卡类型，可填debit|unit.debit借记卡，unit单位结算卡
        bizContentMap.put("bank_name","中国建设银行呼和浩特赛罕区支行");//    开户行名称，为交易能顺利进行，请尽可能填写到街道
        bizContentMap.put("bank_type","中国建设银行");//银行行别
        bizContentMap.put("bank_province","内蒙古自治区");//开户行所在的省份
        bizContentMap.put("bank_city","呼和浩特市");//开户行所在城市
        bizContentMap.put("cert_type","00");//开户人证件类型，目前只支持00,00为身份证
        bizContentMap.put("cert_no",SrcDesUtil.encryptData(partnerId,"110101198001010010"));//开户人证件号码，请加密传输
        bizContentMap.put("bank_telephone_no","13347255979");//银行预留手机号
        bizContentMap.put("service_tel","13347259638");//客服电话
        bizContentMap.put("org_no","6190000067");//机构号
        bizContentMap.put("sub_account_flag","N");//分账参与商户标识

        req.setParamData(bizContentMap);
        logger.info("注册线上进件商户请求入参为:"+ JSONObject.toJSONString(req));

        /**2、调用API的方法*/
        String result = null;
        try{
            result =  OnlineMercApi.merchantRegister(req);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            logger.info("注册线上进件商户失败:"+e.getCause().getMessage());
            e.printStackTrace();
            //根据自己要求处理业务逻辑
        }
    }

5.2.4 API接口代码示例

  • 需要开发者自己封装调用逻辑，实现调用银盛api接口同银盛服务端交互,该示例没有加签验签及发送http请求代码，需自行下载demo查看。
public static void merchantRegister(){
        //获取token ,查看API接口代码示例获取token接口
        String token = getToken();
        //1.组装报文
        Map<String,String> mapDate = new HashMap<String,String>();

        //1.1组装外层报文 API请求参数
        mapDate.put("charset","UTF-8");
        mapDate.put("method", "ysepay.merchant.register.accept");
        mapDate.put("notify_url","http://127.0.0.1");
        mapDate.put("partner_id","hyfz_test2");
        mapDate.put("sign_type","RSA");
        mapDate.put("timestamp",DateUtil.getDateNow());
        mapDate.put("version","3.0");
        //1.2组装内层报文 业务数据
        JSONObject json = new JSONObject();
        json.put("merchant_no", "637587438028042315");
        json.put("cust_type","O");
        json.put("token",token);
        json.put("another_name","小明");
        json.put("cust_name","小明");
        json.put("industry","23");
        json.put("province","内蒙古自治区");
        json.put("city","呼和浩特市");
        json.put("company_addr","滨河北路中海外滩");
        json.put("legal_tel","13347255939");
        json.put("legal_cert_type","00");
        json.put("legal_cert_expire","20360810");
        json.put("settle_type","1");
        json.put("bank_account_no","43672221090449733315");
        json.put("bank_account_name","小明");
        json.put("bank_account_type","personal");
        json.put("bank_card_type","debit");
        json.put("bank_name","中国建设银行呼和浩特赛罕区支行");
        json.put("bank_type","中国建设银行");
        json.put("bank_province","内蒙古自治区");
        json.put("bank_city","呼和浩特市");
        json.put("cert_type","00");
        json.put("bank_telephone_no","13347255939");
        json.put("org_no","6190000067");
        //证件号加密
        try {
            //SrcDesUtil.encryptData(key,data) key直接传partner_id，方法内部会进行format：取商户号前8位，不足8位前面补空
            json.put("legal_cert_no",SrcDesUtil.encryptData("hyfz_test2","110101198001010010"));
            json.put("cert_no",SrcDesUtil.encryptData("hyfz_test2","110101198001010010"));
        } catch (Exception e){
            log.info("DES加密异常:"+e);
        }
        mapDate.put("biz_content",json.toString());

        //2 参数签名
        try {
            String sign = YsPaySignUtils.sign(mapDate);
            mapDate.put("sign",sign);
            mapDate.put("biz_content", URLEncoder.encode(mapDate.get("biz_content"),"utf-8"));
        }catch (Exception e){
            log.info("签名异常：",e);
        }

        //3发送请求
        log.info("发送请求数据"+CommonUtil.mapToString(mapDate));
        String result = HttpRequest.sendPost("https://register.ysepay.com:2443/register_gateway/gateway.do",CommonUtil.mapToString(mapDate));
        if (StringUtil.isBlank(result)){
            log.info("返回结果为空！");
        }

        //4对接口返回结果进行验签
        boolean resultVerify = false;
        try {
            log.info("待验签数据："+result);
            resultVerify = YsPaySignUtils.resultVerify(result,"ysepay_merchant_register_accept_response");
        }catch (Exception e){
            log.info("验签失败："+e);
        }
        log.info("验签结果"+resultVerify);
    }

5.3 商户注册查询接口

5.3.1 商户注册查询接口

参数类型(字节长度）必填参数说明
usercodeString(1,20)N已注册用户号（usercode与merchant_no必填一个）
merchant_noString(0,20)N平台商的用户号（usercode与merchant_no必填一个）

5.3.2 业务响应参数

参数类型(字节长度）必填参数说明
codeStringY响应代码
msgStringY响应代码描述
usercodeString(20)Y用户名
custnameString(100)Y客户名
custidString(20)Y客户ID
user_statusString(10)Y用户状态
createtimeString(8,8)Y创建时间
cust_statusString(10)Y客户状态
is_need_contractString(1,1)Y子商户是否需要电子合同
merchant_noString(1,20)Y平台商唯一标识
noteString(1,200)NN

5.3.3 SDK调用示例

  • 银盛将与服务端交互的接口封装在开发工具包（SDK）中，开发者无需自行实现同服务端交互的复杂逻辑，直接将SDK导入自己的工程后，通过sdk示例代码实现同银盛服务端的交互。
@Test
    public void queryMerchant() throws Exception {
        /**1、获取需要的参数*/
        OnlineReqDataVo req = new OnlineReqDataVo();
        //主动查询商户注册信息的请求路径,建议配置在项目的配置文件里面
        String reqUrl = "https://register.ysepay.com:2443/register_gateway/gateway.do";
        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        String privateKeyFilePath = "D:\\openRSA\\hyfz_test2.pfx";
        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        String privateKeyPassworde = "123456";
        //银盛公钥证书路径: 证书入网申请后随邮件发放
        String publicKeyFilePath = "D:\\openRSA\\businessgate.cer";
        //商户在银盛支付平台开设的用户号[商户号]:入网申请后发放
        String partnerId = "hyfz_test2";
        //银盛支付服务器主动通知商户网站里指定的页面http路径。
        String notifyUrl = "http://127.0.0.1";
        //设置私钥证书路径
        req.setPrivateKeyFilePath(privateKeyFilePath);
        //设置私钥密钥
        req.setPrivateKeyPassword(privateKeyPassworde);
        //设置ys公钥证书路径
        req.setYsPublicKeyFilePath(publicKeyFilePath);
        //设置请求路径
        req.setReqUrl(reqUrl);
        //设置通知路径
        req.setNotifyUrl(notifyUrl);
        req.setPartnerId(partnerId);

        /**2、组装业务参数*/
        Map<String,Object> bizContentMap = new HashMap<>();
        bizContentMap.put("usercode",null);//已注册用户号（usercode与merchant_no必填一个）
        bizContentMap.put("merchant_no","hyfz_test2");//平台商的用户号（usercode与merchant_no必填一个)

        req.setParamData(bizContentMap);
        logger.info("主动查询商户注册信息请求入参为:"+ JSONObject.toJSONString(req));

        /**2、调用API的方法*/
        String result = null;
        try{
            result =  OnlineMercApi.queryMerchant(req);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            logger.info("主动查询商户注册信息失败:"+e.getCause().getMessage());
            e.printStackTrace();
            //根据自己要求处理业务逻辑
        }
    }

5.3.4 API接口代码示例

  • 需要开发者自己封装调用逻辑，实现调用银盛api接口同银盛服务端交互,该示例没有加签验签及发送http请求代码，需自行下载demo查看。
 public void queryMerchant()throws Exception{
        Map<String,String> mapDate = new HashMap<>();
        mapDate.put("charset","UTF-8");
        mapDate.put("method", "ysepay.merchant.register.query");
        mapDate.put("notify_url","http://127.0.0.1");
        mapDate.put("partner_id","hyfz_test2");
        mapDate.put("sign_type","RSA");
        mapDate.put("timestamp",DateUtil.getDateNow());
        mapDate.put("version","3.0");

        JSONObject json = new JSONObject();
        json.put("merchant_no","hyfz_test2");
        json.put("usercode",null);

        mapDate.put("biz_content",json.toString());

        //签名
        try {
            String sign = YsPaySignUtils.sign(mapDate);
            mapDate.put("sign",sign);
        }catch (Exception e){
            log.info("签名异常："+e);
        }

        //调用查询接口
        String result = HttpRequest.sendPost("https://register.ysepay.com:2443/register_gateway/gateway.do",CommonUtil.mapToString(mapDate));
        if (StringUtil.isBlank(result)){
            log.info("结果返回空");
            throw new Exception("查询接口结果返回空");
        }
        JSONObject jsonObject = JSONObject.parseObject(result,Feature.OrderedField);
        JSONObject content = (JSONObject) jsonObject.get("ysepay_merchant_register_query_response");
        String sign = jsonObject.get("sign").toString();
        //验签
        boolean resultVerify = false;
        try{
            log.info("待验签数据："+content);
            resultVerify = YsPaySignUtils.resultVerify1(content.toJSONString(),sign);
        }catch (Exception e){
            log.info("验签异常："+e);
        }

        log.info("验签结果："+resultVerify);
    }

5.4 商户注册异步通知接口

银盛支付对商户的请求数据处理完成后，会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

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

参数类型(字节长度）必填参数说明
usercodeString(20)Y用户名
custnameString(100)Y客户名
custidString(20)Y客户ID
user_statusString(10)Y用户状态
createtimeString(8,8)Y创建时间
cust_statueString(10)Y客户状态
is_need_contractString(1,1)Y子商户是否需要电子合同 Y、N
merchant_noString(1,20)Y平台商唯一标识
noteString(1,200)N备注
online_urlStringN电子合同预览地址
offline_urlStringN电子合同下载地址
notify_typeStringY通知类型 固定值：T9004
notify_timeString(19)Y发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" 示例值：2014-07-24 03:07:50
sign_typeStringY报文签名算法，交易请求是的签名类型RSA/SM
signStringY签名字符串，Base64编码

5.5 参考错误码

错误码错误描述解决方案
ACQ.SYSTEM_ERROR系统错误请调用查询接口查询订单状态
ACQ.BUSINESS_TIMEOUT_ERROR业务超时请调用查询接口查询订单状态
ACQ.INVALID_PARAMETER参数无效检查请求参数，修改后重新发起请求
ACQ.REGISTER_USERCODE_EXISTED预注册用户号已经存在更新商户号重新发起请求
PARAM_ERROR参数错误检查请求参数，修改后重新发起请求
sub_code错误代码其他基础服务直接返回的错误信息，直接根据提示对参数进行修改即可。比如sub_code:6535 sub_msg:平台商唯一识别码重复 ，说明已经注册过了
ACQ.GETBANKCARINFO获取银行信息或者获取银行账户类型失败卡的类型为贷记卡，或者根据银行卡账号查询出来卡的类型为贷记卡，解决方案：使用借记卡来进行注册

5.6 用户状态与客户状态

用户状态与客户状态是两个不同的概念，一个用户不一定是客户，是客户就一定是用户。

用户状态说明客户状态说明
未激活未生效
待补全待补全
待审核待审核
生效生效
禁用注销
锁定冻结
冻结挂起
注销暂停
审核失败审核失败
临时挂失
正式挂失
电子合同签约成功
电子合同签约失败
电子合同签约中

5.7 行业类别

类型描述类型描述类型描述
01服饰鞋包23打车、智慧城市58批发零售业
02数码家电24移动支付手游59制造业
03鲜花礼品25融资租赁60文化活动服务
04美容护肤26投资理财61福利彩票
05团购27保险行业62股票操盘
06机票旅游31消费分期63众筹
07商务办公32其他行业66大宗商品
08文体用品33小贷消金67服装鞋包
09图书音像34直播行业68互联网金融
10家居装潢35信息咨询69话费充值
1001餐饮娱乐类36综合商城70计算机软件
1002一般类41机械设备71计算机系统集成
1003民生类42直销行业72建筑工程
1004便民服务43通信行业73理财投资
1005环保类44汽车贸易74金融租赁
11母婴儿童45拍卖75旅游机票
12健康保健46税务服务78人力资源
13食品饮料47情趣用品79生活服务
14资讯杂志48供应链服务80软件定制商城
15教育咨询49医疗服务82物流运输
16金融保险理财50酒店管理83消费金融
17软件定制创意51跨境直购84物业管理
18虚拟点卡52银行机构85小额贷款
19域名主机53事业单位86游戏行业
20电子商务55租赁行业87游戏点卡
21酒店预订56人力资源88影视传媒
22彩票57房地产89艺术品类

5.8 证件类别

类型描述类型描述
00公民身份证正面12军事院校学员证
01中国护照13武装警察身份证
02军人身份证14军官证
03警官证15文职干部证
04户口簿16军人士兵证
05临时身份证17武警士兵证
06外国护照18其他证件
07港澳通行证19营业执照
08台胞通行证20税务登记证
09离休干部荣誉证30公民身份证反面
10军官退休证31客户协议
11文职干部退休证32授权书

6.附：文件上传服务-图片上传

6.1 图片上传注意事项

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

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

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

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

4.企业商户请尽量使用最新的竖版“三证合一”营业执照。

5.为确保商户进件响应速度，建议图片大小在1M内，企业客户注册时我司会进行营业执照真伪校验，整体响应时间预计在40-60s内。

6.2 请求图片上传参数

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

参数类型(字节长度）必填参数说明
picTypeString(1,2)Y图片类型 示例值：附6.4
picFilemultipartY通过body的mutipartfile类型上传
tokenString(1,50)Ytoken值
superUsercodeString(1,20)Y合作方用户号

6.3 业务响应参数

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

参数类型(字节长度）必填参数说明
isSuccessbooleanY是否成功 true:成功；false:失败
errorCodeString(1,4)N错误码
errorMsgString(1,200)N错误信息
tokenString(1,50)Ntoken值

6.4 图片文件的类型以及说明

类型描述
00公民身份证正面
19营业执照
20税务登记证
30公民身份证反面
31客户协议
32授权书
33手持身份证正扫面照
34门头照
35结算银行卡正面照
36结算银行卡反面照
37开户许可证或印鉴卡
50经营场所图1
51经营场所图2

附表1

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

序号类别小微商户个体商户企业商户
1法人身份证正反面√√√
2法人手持身份证正扫面照√√√
3营业执照√√
4组织机构代码证
5门头照√√√
6结算银行卡正反面照√√
7客户协议书√√√
8授权书
9开户许可证或印鉴卡√
10经营场所图1√√√
11经营场所图2√√√
Limapay
关注
专栏目录
银盛支付银账通进件接口php demo 签名 上传图片 进件 获取token 超简洁sdk
xbb1314159的博客
03-14 2749
银盛支付进件sdk,银盛银账通sdk, phpsdk, phpdemo, 超简单的sdk 对接银账通进件接口,获取token, 上传图片,进件, 签名
5【银盛小Y聚合收银台接口使用说明】YSEPAYSHOP©一款基于线上场景互联网搭建系统工具，互联网支付接口对接服务商。
YSEPAYSHOP电商独立站,银盛收款码,银盛API,银盛SAAS
05-24 509
3、收银台服务系统收到下单请求，校验下单信息，校验通过，生成订单支付信息和加密字符串并返回商户。6、收银台系统后台处理支付请求，进行交易处理，处理成功后，返回支付结果。5、用户确认支付金额等信息，提交支付，聚合收银台前端发起支付请求。8、商户获取到订单状态后，可以向用户展示支付结果。1、用户进入商户前台页面，选择商品，提交订单。2、商户系统后台生成订单，并调用聚合。
银盛支付ecshop,shopex,shopnc在线支付接口，最新接口(含源码)
04-19
最后注意，接收到银盛异步通知之后一定要发送握手回执信息，否则被银盛放入黑名单。 大家如果有需要开发这个接口的可以用QQ跟我交流：804752009 注明支付接口。
银盛海关接口
04-10
银盛支付平台的支付接口文档，便于开发人员进行开始使用，以及测试等
PHP对接第三方接口，数据加密 使用AES和RSA方式
杰姆小生的博客
12-02 647
PHP对接第三方接口，数据加密 使用AES和RSA方式
2020年-银盛支付-Java中级.pdf
08-19
2020年银盛支付面试经验，祝你面试成功！旗开得胜！ 努力不一定成功，但是不努力，就别白日做梦了！加油吧，少年
银盛开放平台为支付相关解决方案提供一键式API接入服务,并赋予相关的接入方式介绍YSEPAYSHOP一款私域电商独立站H5小程序搭建系统，系统可以同时对接A/T直连接入，三方支付API接入
最新发布
YSEPAYSHOP电商独立站,银盛收款码,银盛API,银盛SAAS
08-04 345
银盛开放平台为支付相关解决方案提供一键式API接入服务，并赋予相关的接入方式介绍，帮助客户实现产品与支付整合，提高运营效率，降低开发成本，提高盈利能力。最近更新时间：2022.11.16。
前端2【银盛小Y聚合收银台H5调用支付宝、公众号收银台】YSEPAYSHOP©一款基于线上场景互联网搭建系统工具，互联网支付接口对接服务商。
YSEPAYSHOP电商独立站,银盛收款码,银盛API,银盛SAAS
05-24 480
创建应用，填写商户app的资料，提交后获取该app在微信开放平台的appid。添加微信scheme到白名单中。集成微信SDK，看参考。调用预下单接口，参加。
“小Y聚合收银台”是银盛设计研发的线上场景聚合收银台，目前已经支持微信、支付宝支付。接入指引，YSEPAYSHOP©一款基于线上场景互联网搭建系统工具，互联网支付接口对接服务商。
YSEPAYSHOP电商独立站,银盛收款码,银盛API,银盛SAAS
05-23 735
收银台产品面向具备开发能力的企业商户、服务商、开发者，开放平台目前提供两种接入方式：商户模式和机构模式。1、已有银盛商户号的存量商户暂时不支持同时开通多个业务，只能由原来的业务切换成收银台业务。收银台产品不单独计费，具体计费形式或标准跟随商户入网开通的场景和支付方式而定。产品沟通开通需求，并收集开通信息（商户号、商户名称、appid）2、新商户需要联系客户经理在小Y管家云商服系统入网开通收银台。收银台管理员后台创建生产环境appID。开通接口权限（收银台相关接口）客户经理OA发起开通申请。
盛付通接口文档
03-21
盛付通 ecshop接口文档。本文描述了盛付通针对合作商户提供的支付解决方案,帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了盛付通的工作方式和开发过程,可以帮助开发人员快速入门并掌握开发技能,同时也可以作为日后接口参数以及参数类型的速查手册。
5、银盛支付(15问)1
08-03
2. 用什么组件发请求 3. 注册中心心跳是几秒 4. 消费者是如何发现服务提供者的 5. 多个消费者调用同一接口，eruka默认的分配方式是什么 6. 说说常
支付Demo及SDK
10-11
适用于商家在App应用中集成支付宝支付功能。 商家APP调用支付宝提供的SDK调用支付宝客户端内的支付模块，商家APP会跳转到支付宝中完成支付，支付完后跳回到商家APP内，最后展示支付结果。 目前支持手机系统有：iOS（苹果）、Android（安卓）。
微信公众号支付V3接口-ecshop二次开发成手机版(含includes文件夹)资源分享
02-19
微信公众号支付V3接口-ecshop二次开发成手机版(含includes文件夹)
银盛支付（商户进件，支付，退款，订单统计等功能，D1+D0+T1）
12-29
银盛支付（商户进件，支付，退款，订单统计等功能，D1+D0+T1）; 1.该代码采用jeecg-boot编写，前端采用阿里巴巴的ant，不准用于商业用途； 2.支持商户进件； 3.支付正常支付，支付宝，微信（云闪付暂时不支持）; 4....
【毕业设计】基于微信小程序的研学自习室预约选座系统_自习室预约小程序选题背景(1)
pCITv1C的博客
05-01 287
蚂蚁面试比较重视基础，所以Java那些基本功一定要扎实。蚂蚁的工作环境还是挺赞的，因为我面的是稳定性保障部门，还有许多单独的小组，什么三年1班，很有青春的感觉。面试官基本水平都比较高，基本都P7以上，除了基础还问了不少架构设计方面的问题，收获还是挺大的。经历这次面试我还通过一些渠道发现了需要大厂真实面试主要有：蚂蚁金服、拼多多、阿里云、百度、唯品会、携程、丰巢科技、乐信、软通动力、OPPO、银盛支付、中国平安等初，中级，高级Java面试题集合，附带超详细答案，希望能帮助到大家。
关于电商秒杀系统中防超卖处理方案简述，看这一篇就够了！
04-28 1059
前言 Alibaba作为国内互联网行业的“老大”，一直以来也是很多“数码宝贝”梦寐以求的公司，我个人是做Java开发的，阿里这些年也开发了很多屌炸天的开源项目，像什么Spring Cloud Alibaba，开源Java诊断工具Arthas，Apache Dubbo，JDBC连接池、监控组件Druid等等，属实牛逼！ 阿里能做到这样，也不知道各位“数码宝贝”花了多少个日日夜夜换来的，因此我本也不想进大厂累死累活的。之前每个月在北京每个月拿个小30k，日子过的也还算不错，但自从有了娃以后，越发有种家庭责任感，
银盛支付java对接
05-15
银盛支付是一家提供全球支付服务的第三方支付机构，其提供了多种支付方式，包括银行卡支付、支付宝支付、微信支付等。如果您需要进行银盛支付的Java对接，可以参考以下步骤： 1. 首先需要在银盛支付官网注册账号，并进行实名认证。 2. 在开发者中心中创建应用，并获取相应的应用ID和密钥。 3. 根据银盛支付提供的API文档，在Java项目中添加相应的SDK包和依赖。 4. 在代码中进行配置，包括应用ID、密钥、回调地址等信息。 5. 调用相应的API接口进行支付操作。 需要注意的是，银盛支付的API文档中有详细的参数说明和示例代码，可以根据具体的需求进行开发。此外，银盛支付也提供了专业的技术支持服务，如果您在开发过程中遇到问题，可以随时联系他们的技术支持团队寻求帮助。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值