# 移动支付 Spring Boot 组件 提供聚合支付能力。 ## 支持类型 - [x] **微信支付V2** 只提供V3不支持的部分，后续全面切向V3。 - [x] **微信支付V3** 全量支持。 - [x] **支付宝** 提供所有实现，具体以签约项目为准。 - [ ] **银联支付** 施工中…… ## 采用技术 - Spring - Jackson - Okhttp - Ali-pay-sdk ## 使用方法 ### 集成 以**Spring Boot Starter**的形式集成到项目中。 ```xml com.enongm.dianji payment-spring-boot-starter 1.0.0.RELEASE ``` ### 配置 #### 微信支付 在Spring Boot项目中的`application.yaml`中配置`wechat.pay`相关参数。 ```yaml wechat: pay: v3: # 沙盒模式 默认不开启 用于开发测试 sandbox-mode: true # 服务商模式 默认不开启 partner-mode: false # 应用appId 必填 app-id: wx55a89ae92r5d3b98 # api 密钥 必填 app-secret: 13194913301 # api v3 密钥 必填 app-v3-secret: 0e5f4fbd1333a3b44927e4355703ec # 微信支付商户号 必填 mch-id: 1602325555 # 合作商 选填 partner-key: # 商户服务器域名 用于回调 需要放开回调接口的安全策略 必填 domain: https://127.0.0.1 # 商户 api 证书 必填 cert-path: apiclient_cert.p12 ``` 然后启用`@EnableWechatPay`注解： ```java @EnableMobilePay @Configuration public class PayConfig { } ``` > 请注意：只有`wechat.pay.v3.app-id`设置了有效值才能启用下面的API。 ##### API使用 微信支付 V2、V3开放接口引入： ```java @Autowired WechatPayV3Service wechatPayV3Service; @Autowired WechatPayV2Service wechatPayV2Service; ``` ###### V2 例如V2转账到微信零钱： ```java PayToWechatModel model = new PayToWechatModel(); model.setDesc("test"); model.setAmount("10000"); model.setDeviceInfo("IOS"); model.setOpenid("wx1232131231256655"); model.setPartnerTradeNo("X323994343345"); model.setSpbillCreateIp("127.0.0.1"); WechatResponseBody responseBody = wechatPayV2Service.model(model) .payType(V2PayType.PAY_TO_WECHAT) .request(); System.out.println("responseBody = " + responseBody); ``` 打印返回（虚假的openId 预期结果应该是成功的）： ``` responseBody = WechatResponseBody(returnCode=SUCCESS, returnMsg=参数错误:openid字段不正确,请检查是否合法, mchAppid=wx55a75ae9fd5d3b98, mchid=1603257459, deviceInfo=null, nonceStr=null, resultCode=FAIL, errCode=PARAM_ERROR, errCodeDes=参数错误:openid输入有误, partnerTradeNo=null, paymentNo=null, paymentTime=null) ``` ###### V3 例如V3 APP 支付 ```java /** * App pay test. */ @Test public void appPayTest() { wechatPayV3Service .request(baseModel -> new V3PayTypeBodyAndConsumer(V3PayType.APP, baseModel.jsonBody() ,System.out::println)) .withModel(appPayModel()); } /** * 构造参数 */ private static AppPayModel appPayModel() { AppPayModel appPayModel = new AppPayModel(); appPayModel.setGoodsTag("WXG"); appPayModel.setNotifyUrl("/callback/app"); appPayModel.setDescription("中国移动-手机充值"); appPayModel.setOutTradeNo("100862342355223"); Amount amount = new Amount(); amount.setTotal(1000); appPayModel.setAmount(amount); SceneInfo sceneInfo = new SceneInfo(); sceneInfo.setDeviceId("12312"); sceneInfo.setPayerClientIp("129.122.0.1"); StoreInfo storeInfo = new StoreInfo(); storeInfo.setAddress("cn"); storeInfo.setAreaCode("471800"); storeInfo.setId("232313213"); storeInfo.setName("jack"); sceneInfo.setStoreInfo(storeInfo); H5Info h5Info = new H5Info(); h5Info.setAppName("APP"); h5Info.setAppUrl("https://felord"); h5Info.setBundleId("1313213"); h5Info.setPackageName("com.dj"); h5Info.setType("IOS"); // sceneInfo.setH5Info(h5Info); appPayModel.setSceneInfo(sceneInfo); return appPayModel; } ``` 打印参数： ```json {"prepay_id":"wx0414551907326482fbd40b51189c3e0000"} ``` #### 支付宝 ##### 使用须知 请注意因为未来**SHA1withRSA**将被淘汰，因此采用最新的**SHA256withRSA**证书，旧的模式将不提供支持。步骤如下： 1.使用支付宝开发助手申请CSR文件 ![先申请密钥对，再申请csr](./img/csr.png) 申请成功后看文件说明： ![](./img/file_info.png) 2.上传CSR设置证书 ![](./img/set.png) 上传成功后需要下载证书，和配置的对应关系为： ![](./img/cert_path.png) 3. 其它开发平台商户平台的配置，参考支付宝接入文档。 ##### 项目开发配置 在Spring Boot项目中的`application.yaml`中配置`ali.pay`相关参数。 ```yaml ali: pay: v1: # 可以替换为沙箱 server-url: https://openapi.alipaydev.com/gateway.do # 蚂蚁开放平台申请并认证的应用appId app-id: 2016102700769563 app-private-key-path: META-INF/app_rsa alipay-public-cert-path: META-INF/alipayCertPublicKey_RSA2.crt alipay-root-cert-path: META-INF/alipayRootCert.crt app-cert-public-key-path: META-INF/appCertPublicKey_2016102700769563.crt charset: utf-8 format: json sign-type: RSA2 ``` > 请注意：只有`ali.pay.v1.app-id`设置了有效值才能启用下面的API。 ##### API的使用 引入接口： ```java @Autowired AlipayClient alipayClient; ``` 调用，以现金红包为例： ```java @SneakyThrows public void campaignCash() { AlipayMarketingCampaignCashCreateRequest request = new AlipayMarketingCampaignCashCreateRequest(); request.setBizContent("{" + "\"coupon_name\":\"XXX周年庆红包\"," + "\"prize_type\":\"random\"," + "\"total_money\":\"10000.00\"," + "\"total_num\":\"1000\"," + "\"prize_msg\":\"XXX送您大红包\"," + "\"start_time\":\"2020-11-02 22:48:30\"," + "\"end_time\":\"2020-12-01 22:48:30\"," + "\"merchant_link\":\"http://www.weibo.com\"," + "\"send_freqency\":\"D3|L10\"" + " }"); AlipayMarketingCampaignCashCreateResponse execute = alipayClient.certificateExecute(request); System.out.println("execute = " + execute.getBody()); } ``` 打印响应体： ```json {"alipay_marketing_campaign_cash_create_response":{"code":"40004","msg":"Business Failed","sub_code":"isv.UNKNOW_SYSTEM_ERROR","sub_msg":"系统繁忙，请稍后再试"},"alipay_cert_sn":"e65893247c520d9d46db3000158505ee","sign":"M7gyi6ZwnRoHmdzd1IIxLc+XEE1pCx6ptOyQP4aRGMc01bJebNL7PbMpfU7TcB75KHmk3Oor2fYZfVEB7+5gxV9YwMuW3QtZbyACw3Gzt7wz4D1YCXkQD9PRvSsgw8xgNL+WnZxEI2yFdSp47Mc/Um73M101zFeo2dYKYXyVRdsGxnipY8fZs0JaXlX5OoROfHDcbvzBDjQyernspIoFoNiAwpaBwyQcEzh8V34ca4Rep/LSyI4N4VtU0n2nq3dO0Jor36n0o4j0QobWSE3c8StkVjbdP5XJB+adE51MUmh7xDdixQXE2fTRKw5wYlBO9O3bpF/uw78hWW/y3JwG9Q=="} ``` ## CHANGELOG ### 1.0.0.RELEASE - 支持微信支付、支付宝支付