Alipay

轻量的支付宝组件(A Lightweight Alipay Component)

• 包引入:

   <dependency>
       <groupId>me.hao0</groupId>
       <artifactId>alipay-core</artifactId>
       <version>1.0.5</version>
   </dependency>

• 依赖包，注意引入项目时是否需要exclude:

   <dependency>
       <groupId>me.hao0</groupId>
       <artifactId>alipay-api</artifactId>
       <version>1.0.5</version>
   </dependency>
   <dependency>
       <groupId>me.hao0</groupId>
       <artifactId>common</artifactId>
       <version>1.0.9</version>
   </dependency>
   

• 业务系统与支付宝系统交互图:

  

• 基本用法:

   Alipay alipay = AlipayBuilder
                   .newBuilder(merchantId, secret)
                   .config1(...)	// 其他可选配置
                   ...
                   .build();
   
   alipay.module().api();

• 已实现的组件:

  • 支付pay();
  • 退款refund();
  • 验证verify()。

• API文档这里。

• 关于测试: 测试用例中是一些基本测试，alipay-demo项目是一个可运行web项目，方便测试，可按如下步骤进行测试:

  • 复制alipay-demo中的app-example.properties为app.properties，并作相应配置:

    ## 支付宝商户编号
    merchantId=
    ## 支付宝密钥
    secret=
    ## 支付通知url
    payNotifyUrl=${your_domain}/notifies/backend
    ## 退款通知url
    refundNotifyUrl=${your_domain}/notifies/refund
    ## web支付完成页面跳转url
    webReturnUrl=${your_domain}/notifies/web/frontend
    ## wap支付完成页面跳转url
    wapReturnUrl=${your_domain}/notifies/wap/frontend

  • 注意：除了**webReturnUrl**, **wapReturnUrl可以配置为localhost外，payNotifyUrl 和refundNotifyUrl**都应该配置为支付宝可以外网调用的地址，本地测试建议使用ngrok工具来作本地外网映射。

  • 到alipay-demo根目录运行以下命令即可:

     mvn clean jetty:run -Dmaven.test.skip -Djetty.port={自定义端口号}

  • WEB支付可访问(请求正常后，应该会跳到支付宝收银台页面，完成支付后，过几秒页面会跳转到webReturnUrl，console里也会有服务器通知的日志出现):

     http://localhost:{port}/pays/web?orderNumber={自定义订单号}

  • WAP支付可访问(请求正常后，应该会跳到支付宝收银台页面，完成支付后，过几秒页面会跳转到wapReturnUrl，console里也会有服务器通知的日志出现):

     http://localhost:{port}/pays/wap?orderNumber={自定义订单号}

  • 退款可访问(退款成功后，也会有服务器通知日志打印):

     http://localhost:{port}/refunds/submit?batchNo={自定义批次号}&tradeNo={服务器通知日志中的tradeNo}

  • APP支付:

    1. 客户端支付未亲测;
    2. 支付成功后，支付宝的通知数据RSA校验已测试通过。

• 相关文档:

  • 即时到帐；
  • WAP支付；
  • APP支付。

• 历史版本:

  • 1.0.0:

    • 基本功能实现。

  • 1.0.1:

    • 必要参数校验。

  • 1.0.2:

    • 升级最新common组件；
    • 参数校验简化。

  • 1.0.3:

    • 在alipay-demo中判断交易状态，web,wap只会在交易成功后通知，app还会在交易创建后作通知.

  • 1.0.4:

    • APP支付增加body和goodsType参数。

• 你是好人:

  • 倘若你钱多人傻花不完，小弟乐意效劳😊，掏出你的微信神器做回好人吧:

    

  • 倘若你还不够尽兴，继续掏出你的支付宝神器，疯狂扫吧: