无卡快捷接口

1.修订记录

2、即时到账快捷类

2.1 快捷消费申请

2.1.1 请求地址

2.1.2 请求参数说明

2.1.2.1公共请求参数

2.1.2.2 业务请求参数

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

2.1.2.3 二级商户 SubMerchantInfo

2.1.2.4 收货人信息 ConsigeeInfo

2.1.3 响应参数说明

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

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

2.1.3.1 公共响应参数

2.1.3.2 业务响应参数

2.1.4 SDK请求示例

        @Test
    public void fastPayApplyTest() throws Exception {
        /**1、组装调用快捷消费申请 FastPayApi.fastPayApply需要的参数*/
        OnlineReqDataVo reqDataVo = new OnlineReqDataVo();
        //请求路径,具体见文档
        reqDataVo.setReqUrl("https://qrcode.ysepay.com/gateway.do");

        //商户在银盛支付平台开设的用户号[商户号]
        reqDataVo.setPartnerId("hyfz_test2");

        //银盛支付服务器主动通知商户网站里指定的页面http路径，支持多个url进行异步通知，多个url用分隔符“,”分开，格式如：url1,url2,url3
        reqDataVo.setNotifyUrl("http://127.0.0.1");

        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        reqDataVo.setPrivateKeyFilePath("D:/cer/hyfz_test2.pfx");

        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        reqDataVo.setPrivateKeyPassword("123456");

        //银盛公钥证书路径: 证书入网申请后随邮件发放
        reqDataVo.setYsPublicKeyFilePath("D:/cer/businessgate.cer");

        //交易类型，说明：1或者空：即时到账，2：担保交易
        reqDataVo.setTranType("1");
        /** -----------组装业务参数,并设置到入参里面reqDataVo.setParamData(bizContentMap): 业务参数说明详细见接口文档 -------------*/
        Map<String, Object> bizContent = new HashMap<>();
        //商户生成的订单号，生成规则前8位必须为交易日期，如20180525，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成
        bizContent.put("out_trade_no", "201805256843192280647118");
        //商户日期(该参数做交易与查询时需要一致) 该日期需在当日的前后一天时间范围之内
        bizContent.put("shopdate", "20211013");
        //商品的标题/交易标题/订单标题/订单关键字等。该参数最长为250个汉字
        bizContent.put("subject", "快捷消费申请测试");
        //该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。Number(10,2)指10位长度，2位精度
        bizContent.put("total_amount", "2.99");
        //支持币种：CNY(人民币)、HKD(港币)、USD(美元)、EUR(欧元)、JPY(日元)
        //注:不填默认是CNY(人民币)，如是非跨境商户，币种不能填HKD(港币)、USD(美元)、EUR(欧元)、JPY(日元)中的任意一种外币币种
        bizContent.put("currency", "CNY");
        //收款方银盛支付用户号
        bizContent.put("seller_id", "hyfz_test2");
        //收款方银盛支付客户名
        bizContent.put("seller_name", "银盛支付服务股份有限公司行业发展部");
        //设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。
        //(需申请业务权限，权限未开通情况下该参数不生效，默认未付款交易的超时时间为7d)取值范围：1m～15d。m-分钟，h-小时，d-天。该参数数值不接受小数点，如1.5h，可转换为90m。
        //注意：设置了未付款交易超时时间的情况下，若我司在限定时间内没有收到成功支付通知，则会关闭交易，关闭后该笔交易若付款方支付成功的情况下，会自动原路退款至付款方
        bizContent.put("timeout_express","96h");
        //业务扩展参数，一个json字符串,order_mode订单模式，暂时可选的值为:00 代表购物车模式;seller_list参与分账的收款方信息数组，每个元素包含seller_id收款方银盛支付用户号。
        //实时分账业务，order_mode和seller_list均不能为空，order_mode的值必须为00
        bizContent.put("extend_params","{\"cartTYpe\": \"00\",\"order_mode\": \"01\",\"seller_list\": [{\"seller_id\": \"123\"},{\"seller_id\": \"456\"}]}");
        //公用回传参数
        bizContent.put("extra_common_param", "extra_common_param");
        //业务代码，反扫D0为00510080
        bizContent.put("business_code", "00510080");
        //确定快捷支付银行
        bizContent.put("bank_type", "1903000");
        //付款方银行姓名
        bizContent.put("buyer_name", "");
        //付款方银行账号
        bizContent.put("buyer_card_number", "");
        //付款方银行绑定手机号码
        bizContent.put("buyer_mobile", "18088208820");
        //付款方银行账户类型，bank_type非空时，此处必填personal:对私账户
        bizContent.put("bank_account_type", "personal");
        //支持卡类型, bank_type非空时，此处必填debit:借记卡;credit:信用卡
        bizContent.put("support_card_type", "debit");
        //付款方支付卡所对应的银行名称
        bizContent.put("bank_name", "中国银行");
        //贷记卡必填，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格；如果签名方式为SM，则用SM加密
        bizContent.put("cardCvn2", null);
        //贷记卡必填，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格，格式为MMYY;如果签名方式为SM，则用SM加密
        bizContent.put("cardExprDt", null);
        //证件类型：目前只支持身份证01，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格;如果签名方式为SM，则用SM加密
        bizContent.put("pyerIDTp", null);
        //证件号码，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格;如果签名方式为SM，则用SM加密
        bizContent.put("pyerIDNo", null);


        //=================二级商户信息, Json格式=================
        //如果有值则二级商户信息都不能为空，如果没值则都不能有值
        JSONObject subMerchantInfoJson = new JSONObject();
        subMerchantInfoJson.put("merName","");//二级商户名称,支持25个中文
        subMerchantInfoJson.put("merShortName","");//二级商户简称,支持25个中文
        subMerchantInfoJson.put("merAddr","");//二级商户地址,支持100个中文
        subMerchantInfoJson.put("telephone","");//固定电话/手机号码二选一
        subMerchantInfoJson.put("merNo","");//二级商户编号
        subMerchantInfoJson.put("category","");//类目，按附件内容输入类目编号
        subMerchantInfoJson.put("mrchntCertId","");//身份证号,只支持身份证格式(如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格,如果签名方式为SM，则用SM加密)
        //二级商户json格式
        bizContent.put("sub_merchant",subMerchantInfoJson);


        //=================收货人信息json格式(可空)=================
        JSONObject consigneeInfoJson = new JSONObject();
        subMerchantInfoJson.put("consigneeName","");//收货人姓名
        subMerchantInfoJson.put("consigneeAddr","");//收货地址
        subMerchantInfoJson.put("transportationInfo","");//物流配送信息（物流名称+订单号）
        subMerchantInfoJson.put("commodityName","");//商品名称
        subMerchantInfoJson.put("commodityNumber","");//商品数量
        //收货人信息json格式
        bizContent.put("consignee_info",consigneeInfoJson);


        //=================跨境支付付款人信息json格式，当收款方商户为跨境商户时，此域所有字段必填=================
        JSONObject crossBorderInfo = new JSONObject();
        subMerchantInfoJson.put("cross_border_name","");//付款人姓名
        crossBorderInfo.put("cross_border_idno","");//付款人身份证号码(如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格;如果签名方式为SM，则用SM加密)
        crossBorderInfo.put("cross_border_card_number","");//付款人银行卡号
        crossBorderInfo.put("cross_border_mobile","");//付款人手机号码
        crossBorderInfo.put("cross_border_tag","");//交易类型标识，只可以填写【服务类】或者【货物类】
        //跨境支付付款人信息json格式
        bizContent.put("cross_border_info",crossBorderInfo);

        //订单所属省编号（省市编号必须同时为空或者同时非空、并且需要符合层级关系）（特殊可空）
        bizContent.put("province",null);
        //订单所属市编号（省市编号必须同时为空或者同时非空、并且需要符合层级关系）（特殊可空）
        bizContent.put("city",null);
        //    Mcc码（支持上传多个，多个用|分割）(可空)
        bizContent.put("mccs",null);

        bizContent.put("mer_no",null);//第三方商户号

        //设置业务参数到biz_content
        reqDataVo.setParamData(bizContent);

        /** 2、调用FastPayApi.fastPayApply方法 */
        String result = null;
        try{
            System.out.println("快捷消费申请-调用sdk接口fastPayApply请求入参为:"+ JSONObject.toJSONString(reqDataVo));
            result = FastPayApi.fastPayApply(reqDataVo);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            System.out.println("快捷消费申请-失败:"+e.getCause().getMessage());
            e.printStackTrace();
        }
        System.out.println("快捷消费申请-调用sdk接口fastPayApply返回结果为:"+result);
    }

2.2 快捷授权

2.2.1 请求地址

2.2.2 请求参数说明

2.2.2.1公共请求参数

2.2.2.2业务请求参数

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

2.2.3 响应参数说明

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

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

2.2.3.1 公共响应参数

2.2.3.2 业务响应参数

2.2.4 SDK请求示例

@Test
    public void fastpayAuthorizeTest() throws Exception {
        /**1、组装调用快捷授权 FastPayApi.fastpayAuthorize需要的参数*/
        OnlineReqDataVo reqDataVo = new OnlineReqDataVo();
        //请求路径,具体见文档
        reqDataVo.setReqUrl("https://qrcode.ysepay.com/gateway.do");

        //商户在银盛支付平台开设的用户号[商户号]
        reqDataVo.setPartnerId("hyfz_test2");

        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        reqDataVo.setPrivateKeyFilePath("D:/cer/hyfz_test2.pfx");

        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        reqDataVo.setPrivateKeyPassword("123456");

        //银盛公钥证书路径: 证书入网申请后随邮件发放
        reqDataVo.setYsPublicKeyFilePath("D:/cer/businessgate.cer");

        /** -----------组装业务参数,并设置到入参里面reqDataVo.setParamData(bizContentMap): 业务参数说明详细见接口文档 -------------*/
        Map<String, Object> bizContent = new HashMap<>();
        //商户生成的订单号，生成规则前8位必须为交易日期，如20180525，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成
        bizContent.put("out_trade_no", "6843192280647118");
        //付款方银行绑定手机号码
        bizContent.put("buyer_mobile", "18688786376");
        //验证码
        bizContent.put("mobile_verify_code", "778666");
        //贷记卡必填，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格; 如果签名方式为SM，则用SM加密
        bizContent.put("cardCvn2", null);
        //贷记卡必填，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格，格式为MMYY; 如果签名方式为SM，则用SM加密
        bizContent.put("cardExprDt", null);

        //设置业务参数到biz_content
        reqDataVo.setParamData(bizContent);

        /** 2、调用FastPayApi.fastpayAuthorize方法 */
        String result = null;
        try{
            System.out.println("快捷授权-调用sdk接口fastpayAuthorize请求入参为:"+ JSONObject.toJSONString(reqDataVo));
            result = FastPayApi.fastpayAuthorize(reqDataVo);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            System.out.println("快捷授权-失败:"+e.getCause().getMessage());
            e.printStackTrace();
        }
        System.out.println("快捷授权-调用sdk接口fastpayAuthorize返回结果为:"+result);
    }

2.3 快捷重新获取授权码

2.3.1 请求地址

2.3.2 请求参数说明

2.3.2.1公共请求参数

2.3.2.2业务请求参数

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

2.3.3 响应参数说明

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

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

2.2.3.1 公共响应参数

2.4 异步通知参数说明

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

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

3、样例

3.1 extend_params 说明

{
    "cartTYpe": "00",
    "order_mode": "01",
    "seller_list": [{
        "seller_id": "123"
    }, {
        "seller_id": "456"
    }]
}

3.2 sub_merchant 说明

{
    "merName": "二级商户名称",
    "merShortName": "二级商户简称",
    "merAddr": "二级商户地址",
    "telephone": "二级商户服务电话",
    "merNo": "二级商户编号",
    "category": "类目",
    "mrchntCertId": "身份证号"
}

3.3 consignee_info 说明

{
    "consigneeName": "收货人姓名",
    "consigneeAddr": "收货地址",
    "transportationInfo": "物流配送信息",
    "commodityName": "商品名称",
    "commodityNumber": "商品数量"
}

4、附录

4.1 即时到账业务错误码

4.2 交易状态