快捷协议支付

1.修订记录

2.业务说明

（1）场景说明

用户签约成功后，通过该接口可以创建无卡快捷订单及明细登记 协议快捷支付流程： 1、协议签约接口签约； 2、协议签约后，会收到短信验证码，再调用协议签约确认接口进行确认； 3、协议签约确认完成后，调用创建无卡快捷订单及明细登记接口订单创建； 4、创建无卡快捷订单及明细登记后，会收到短信验证码，调用确认协议快捷支付短信接口进行确认支付； 5、如果没有收到协议快捷短信验证码，调用重新获取协议快捷支付短信接口再发送短信验证码进行确认支付；

（2）接口说明

1、用户先进行签约，签约完成后进调用本接口进行支付

3.请求地址

4.参数说明

4.1公共请求参数

4.2 业务请求参数

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

4.4 二级商户 SubMerchantInfo

4.5 收货人信息 ConsigeeInfo

5.响应参数说明

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

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

5.1 公共响应参数

5.2 业务响应参数

5.3 分期响应 installmentResp

6.服务器异步通知参数说明

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

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

7.样例

7.1 SDK调用示例

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

@Test
    public void fastPay() throws Exception {
        /**1、获取需要的参数*/
        OnlineReqDataVo req = new OnlineReqDataVo();
        //快捷协议支付的请求路径,建议配置在项目的配置文件里面
        String reqUrl = "https://trusteeship.ysepay.com/gateway.do";
        //客户端私钥证书路径: 证书是在入网流程中自己申请的
        String privateKeyFilePath = "D:\\openRSA\\hyfz_test2.pfx";
        //客户端私钥密钥: 私钥密钥在入网流程中自己申请私钥证书时填写的
        String privateKeyPassworde = "123456";
        //银盛公钥证书路径: 证书入网申请后随邮件发放
        String publicKeyFilePath = "D:\\openRSA\\businessgate.cer";
        //商户在银盛支付平台开设的用户号[商户号]:入网申请后发放
        String partnerId = "hyfz_test2";
        //银盛支付服务器主动通知商户网站里指定的页面http路径，支持多个url进行异步通知，多个url用分隔符“,”分开，格式如：url1,url2,url3
        String notify_url = "http://api.test.ysepay.net/atinterface/receive_return.htm";
        //同步通知地址。(非必填)
        String return_url = "http://api.test.ysepay.net/atinterface/receive_return.htm";
        //设置私钥证书路径
        req.setPrivateKeyFilePath(privateKeyFilePath);
        //设置私钥密钥
        req.setPrivateKeyPassword(privateKeyPassworde);
        //设置ys公钥证书路径
        req.setYsPublicKeyFilePath(publicKeyFilePath);
        //设置请求路径
        req.setReqUrl(reqUrl);
        //设置通知路径
        req.setNotifyUrl(notify_url);
        req.setReturnUrl(return_url);

        req.setPartnerId(partnerId);

        /**2、组装业务参数*/
        Map<String,Object> bizContentMap = new HashMap<>();
        bizContentMap.put("out_trade_no","20211015843192280647222");//商户生成的订单号，生成规则前8位为交易日期，如20180525，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成
        bizContentMap.put("shopdate","20211013");//商户日期(该参数做交易与查询时需要一致) 该日期需在当日的前后一天时间范围之内
        bizContentMap.put("subject","木木牛");//商品的标题/交易标题/订单标题/订单关键字等。该参数最长为250个汉字。
        bizContentMap.put("total_amount","0.01");//该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。Number(10,2)指10位长度，2位精度
        bizContentMap.put("currency","CNY");//支持币种：CNY（人民币）、HKD（港币）、USD（美元）、EUR（欧元）、JPY（日元）。注：不填默认是CNY（人民币），如是非跨境商户，币种不能填HKD（港币）、USD（美元）、EUR（欧元）、JPY（日元）中的任意一种外币币种。
        bizContentMap.put("seller_id","hyfz_test2");//收款方银盛支付用户号
        bizContentMap.put("seller_name","银盛支付服务股份有限公司行业发展部");//收款方银盛支付客户名
        bizContentMap.put("timeout_express","96h");//设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。取值范围：1m～15d。m-分钟，h-小时，d-天。该参数数值不接受小数点，如1.5h，可转换为90m。
        bizContentMap.put("extend_params",null);//业务扩展参数，一个json字符串,order_mode订单模式，暂时可选的值为:00 代表购物车模式;seller_list参与分账的收款方信息数组，每个元素包含seller_id收款方银盛支付用户号。实时分账业务，order_mode和seller_list均不能为空，order_mode的值必须为00。
        bizContentMap.put("extra_common_param",null);//公用回传参数
        bizContentMap.put("business_code","01000010");//业务代码
        bizContentMap.put("user_id","hyfz_test2");//唯一客户标识，商户旗下客户号。签约时的user_id
        bizContentMap.put("protocol_no","K2021101436720150055");//银盛支付平台的签约流水号：商户签约确认接口（mercSignConfirm）返回的protocol_no
        bizContentMap.put("cardCvn2",null);//贷记卡必传，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格;如果签名方式为SM，则用SM加密
        bizContentMap.put("cardExprDt",null);//贷记卡必传，如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格，格式为MMYY; 如果签名方式为SM，则用SM加密
        bizContentMap.put("sub_merchant",null);//二级商户信息, Json格式，暂包括merName、merShortName、merAddr、telephone、merNo、category、mrchntCertId
        bizContentMap.put("| :-merName",null);//二级商户名称,支持25个中文
        bizContentMap.put("| :-merShortName",null);//二级商户简称,支持25个中文
        bizContentMap.put("| :-merAddr",null);//二级商户地址,支持100个中文
        bizContentMap.put("| :-telephone",null);//固定电话/手机号码二选一
        bizContentMap.put("| :-merNo",null);//二级商户编号
        bizContentMap.put("| :-category",null);//类目，按附件内容输入类目编号
        bizContentMap.put("| :-mrchntCertId",null);//身份证号,只支持身份证格式如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格; 如果签名方式为SM，则用SM加密)
        bizContentMap.put("consignee_info",null);//收货人信息json格式
        bizContentMap.put("| :- consigneeName",null);//收货人姓名
        bizContentMap.put("| :- consigneeAddr",null);//收货地址
        bizContentMap.put("| :-transportationInfo",null);//物流配送信息（物流名称+订单号）
        bizContentMap.put("| :- commodityName",null);//商品名称
        bizContentMap.put("| :- commodityNumber",null);//商品数量,
        bizContentMap.put("| :- cross_border_info",null);//跨境支付付款人信息json格式，当收款方商户为跨境商户时，此域所有字段必填。
        bizContentMap.put("| :-cross_border_name",null);//付款人姓名
        bizContentMap.put("| :-cross_border_idno",null);//付款人身份证号码(如果签名方式为RSA，则用DES加密，密钥为商户号partner_id前8位，不足8位在商户号前补空格; 如果签名方式为SM，则用SM加密)
        bizContentMap.put("| :-cross_border_card_number",null);//付款人银行卡号
        bizContentMap.put("| :-cross_border_mobile",null);//付款人手机号码
        bizContentMap.put("| :-cross_border_tag",null);//交易类型标识，只可以填写【服务类】或者【货物类】
        bizContentMap.put("province",null);//订单所属省编号（省市编号必须同时为空或者同时非空、并且需要符合层级关系）
        bizContentMap.put("city",null);//订单所属市编号（省市编号必须同时为空或者同时非空、并且需要符合层级关系）
        bizContentMap.put("mccs",null);//Mcc码（支持上传多个，多个用|分割）
        bizContentMap.put("mer_no",null);//第三方商户号
        bizContentMap.put("submer_ip",null);//子商户ip
        bizContentMap.put("installment_req",null);//分期请求信息，如果business_code为00510140协议支付分期，该参数必填。否则该参数无效
        req.setParamData(bizContentMap);
        logger.info("快捷协议支付请求入参为:"+ JSONObject.toJSONString(req));
        /**2、调用API的方法*/
        String result = null;
        try{
            result =  TrusteeshipApi.fastPay(req);
            //根据返回结果处理自己的业务逻辑,result内容详见接口文档
        }catch (Exception e){
            logger.info("快捷协议支付失败:"+e.getCause().getMessage());
            e.printStackTrace();
            //根据自己要求处理业务逻辑
        }
    }

7.2 extend_params

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

7.3 sub_merchant 说明

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

7.4 consignee_info 说明

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

8.附录

8.1 交易状态

8.2 类目

类目字典：下载地址