易宝对接注意事项

一、开发前准备

1. 开发者设置
   

   图1
   
   1.1商户通知地址：相关接口会返回回调信息、比如支付成功失败的异步回调通知。开发阶段写本地域名，http://lsj.ngrok2.xiaomiqiu.cn用了小米球做内网穿透。
   1.2 生成RSA公私钥，将公钥上传。保存私钥在本地，保存易宝公钥在本地。http://web.chacuo.net/netrsakeypair在线生成称非对称加密公私钥（如：rsa非对称加密）

2. SDK下载，下载易宝所需要的依赖jar

二、项目接入

1. 配置
   公私钥可配置在resource下，YopRequest request = new YopRequest();将自动获取yop_sdk_config_default.json文件中的相关参数。

   图2
   
   
   图3
   需要改动的点为：1.app_key，开通易宝之后会自动生成key，可在：易宝商户管理后台查看，地址：https://open.yeepay.com/#/dashboard/setting，位置可见图1。
   无此文件的情况下需写出参数，YopRequest request = new YopRequest(appKey,privateKey);

2. 开发相关接口注意事项。
   2.1 商户入网

   图4 易宝入网流程
   流程：易宝作为SAAS服务商，其他商户可选项为平台商、入驻商户。本方需求：XXXX公司作为平台商，其他餐饮公司作为入驻商户，本方作为平台商统一收款，在进行分账给其他入驻商户。
   2.2 接口
   2.2.1 特约商户入网(企业/个体) /rest/v2.0/mer/register/saas/merchant
   字段：
   requestNo（入网请求号）：自定义可以用UUID不重复。
   parentMerchantNo（商户编号）：平台商入网填SAAS服务商商编，找易宝咨询。
   businessRole（入网商户业务角色）：平台商入网填 PLATFORM_MERCHANT，入驻商户填 SETTLED_MERCHANT
   productInfo（开通产品信息）：按照签约的合同开通相应的产品和费率，结算为D1时结算账户信息（settlementAccountInfo）必传
   入网之后需要回复邮箱和短信，之后会有回调结果。如：协议签署和审核结果，协议签署需要点击地址进去签署确认。
   2.2.2 公众号配置接口 /rest/v2.0/aggpay/wechat-config/add
   微信小程序无需传支付授权目录列表（tradeAuthDirList）、支付宝小程序无需授权
   2.2.3 聚合API收银台 /rest/v1.0/nccashierapi/api/pay
   微信和支付宝小程序走聚合支付。
   2.2.4 支付、分账相关问题
   1.app跳转支付宝小程序出现：暂未开通此功能，请稍后再试。支付宝小程序只能发布才能对接，否则无法跳转支付宝小程序界面
   图5
   
   2.支付宝小程序跳转参数(界面参数)url编码之后拼接在page后面，不需要拼接query启动参数。
   String path="token="+jsonObject.get("token").getAsString()+"&userIp="+Utils.getIPAddress();// 这里是传的参数
   String link = URLEncoder.encode(path, "UTF-8");//这里是encode传的参数
   String url = "alipays://platformapi/startapp?appId=2021001187625203&page=pages/pay/pay?"+link;
   3.微信小程序可跳转回APP、支付宝小程序无法跳转回APP。
   图6
   
   4.Android小程序返回APP无响应，需要配置launcherMode为singleTask
   5.微信小程序传参。
   req.userName = "gh_b7a47e397a71"; // 填小程序原始id
   req.path = "pages/pay/pay"; //拉起小程序页面的可带参路径，不填默认拉起小程序首页
   req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;// 可选打开 开发版，体验版和正式版
   userName原始id不是appId。
   图7
   
   6.开发微信、支付宝小程序可以用uniapp做统一开发，开发工具为：HBuilderX。发布上线需要点击发行
   
   图8
   
   7.小程序获取code，传递给后台获取openId/userId。发起支付：聚合支付，小程序调用，APP端只需传支付token等相关参数即可。
   8.交易下单预支付token接口：分账订单需要点完结分账金额才会进入账户余额
   9.单个订单可以进行多次分账，但是一次分账中分账详情中商户编号不能重复
   10.退款需要把分账资金做分账归还，否则会遇到余额不足情况将无法进行退款
   11.相关接口

中台SAAS 
其它接口地址：https://open.yeepay.com/docs/v2/products/fwssfk/index.html
子商户入网接口
资质上传接口，上传资质图片获取图片链接 调入网接口时使用：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__yos__v1.0__sys__merchant__qual__upload/index.html
特约商户入网(企业/个体)：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__rest__v2.0__mer__register__saas__merchant/index.html
小微商户：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__rest__v2.0__mer__register__saas__micro/index.html
入网进度查询：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__rest__v2.0__mer__register__query/index.html
入网回调：https://open.yeepay.com/docs/v2/products/ptssfk/others/5f3de63c20289f001ba82527/index.html

交易接口
调交易接口获取TOKEN 调支付接口完成支付
公众号、小程序appid 支付授权目录配置接口：https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__aggpay__wechat-config__add/index.html
交易：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__rest__v1.0__trade__order/index.html
网银、银行卡快捷支付：https://open.yeepay.com/docs/v2/products/ptssfk/others/5f4ca53e00f514001b61b553/index.html
聚合API收银台：https://open.yeepay.com/docs/v2/products/fwssfk/apis/options__rest__v1.0__nccashierapi__api__pay/index.html
支付成功回调：https://open.yeepay.com/docs/v2/products/ptssfk/others/5f3bd27d20289f001ba82522/index.html

分账
申请分账：https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__divide__apply/index.html
完结分账（如订单后续不需要再进行分账，可直接调用此接口将订单剩余可分账金额全部给收款商户）：https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__divide__complete/index.html

查询分账（发起分账请求后，可调用此接口查询分账结果。
）https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__divide__query/index.html
申请分账归还（平台商可调用此接口，将已分账的资金从分账接收方的账户回退给分账方账户。退款时如需分账接收方归还分账资金，可以先调此接口，再发起退款。
注意：分账订单的退款与分账资金归还并无强耦合，分账资金归还可先于退款发起，可后于退款发起，或者根据分账接收方与商户的约定，不发起分账资金归还。）：https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__divide__back/index.html

查询分账归还结果：https://open.yeepay.com/docs/v2/products/ptssfk/apis/options__rest__v1.0__divide__back__query/index.html