xiong-it / easypay

[DEPRECATED]A simple frame for mobile pay in China, easy to use & expand . 简单易用的第三方可扩展支付框架。

EasyPay是什么

EasyPay旨在帮助Android开发者快速集成接入移动支付SDK，其中包括主流的微信APP支付，支付宝APP支付，银联支付。 欢迎右上角star/fork，感谢!

---

为什么要用EasyPay

EasyPay和微信支付等移动支付SDK的区别

EasyPay是一个开源的聚合支付可定制化框架，目前已集成微信APP支付，支付宝APP支付SDK。银联支付（开发中）。

Android开发者只需要简单调用EasyPay的几行代码，即可调起支付客户端，完成支付流程，得到支付结果。

EasyPay宗旨：简单，易用，可扩展。

EasyPay和其他第三方聚合支付的区别

第三方聚合支付，如知名的Ping++，需要同时接入其Server端SDK和Client端SDK，使接入企业面临风险：

1、信息泄露风险
2、支付集成服务商提供服务跟不上商户业务发展需要的风险
3、支付集成服务商系统稳定性、安全性的风险
4、资金安全风险
---知乎：《使用第三方支付集成有何风险，例如 Beecloud 或者 Ping++？》

此外，天下没有免费的午餐，第三方聚合支付平台一般需要收取**5%~15%**左右的手续费等各种服务费用，使得接入企业收益受损。

而使用开源的EasyPay，代码透明，与Server端无关，Android开发者只需要根据自己需求对EasyPay进行个性化定制，即可打造一个支付平台齐全的无风险支付框架。但是客观的讲，这同时也是EasyPay的短板，它只简化了APP端开发者的调用工作，Server端工作人员仍需要按照移动支付第三方平台的SDK文档进行开发。

如果觉得EasyPay对你有帮助，你付出的仅仅是一个点赞，或者一个star或者fork，如果不满意，请帮忙提issue指出，而不是5%-15%左右的手续费等各种服务费用。

通过阅读EasyPay源码，你可以知道移动支付的流程是怎样的：

APP->APP服务器->支付平台后台服务器->APP服务器->APP->支付客户端->APP

通过扩展EasyPay，你可以较快的搭建一个私有的功能完善的支付框架。

怎么用EasyPay

用户场景：

APP用户选择一个价格为666元的商品："皮皮虾"，商品描述："此商品属性过于强大，难以调教，一般人切勿轻易购买，吼吼！"，然后用户进入收款台，选择了微信支付。

好勒，皮皮虾，咱们走！此处省略：皮皮虾，咱们走.jpg

 PayParams params = new PayParams.Builder(this)
                .wechatAppID("your_wechat_appid")// 仅当支付方式选择微信支付时需要此参数
                .payWay(PayWay.WechatPay)
                .goodsPrice(66600)// 单位为：分
                .goodsName("皮皮虾")
                .goodsIntroduction("此商品属性过于强大，难以调教，一般人切勿轻易购买，吼吼！")
                .httpType(HttpType.Get)// 使用get请求
                .httpClientType(NetworkClientType.Retrofit)
                .requestBaseUrl("https://api.github.com/")// 此处替换为为你的app服务器host主机地址
                .build();

  EasyPay.newInstance(params).requestPayInfo(new OnPayInfoRequestListener() {
            @Override
            public void onPayInfoRequetStart() {
                // TODO 在此处做一些loading操作,progressbar.show();
            }

            @Override
            public void onPayInfoRequstSuccess() {
                // TODO 可以将loading状态去掉了。请求预支付信息成功，开始跳转到客户端支付。
            }

            @Override
            public void onPayInfoRequestFailure() {
                // / TODO 可以将loading状态去掉了。获取预支付信息失败，会同时得到一个支付失败的回调。
            }
        }).toPay(new OnPayResultListener() {
        
            @Override
            public void onPaySuccess(PayWay payWay) {
                // 支付成功
            }
            
            @Override
            public void onPayCancel(PayWay payWay) {
                // 支付流程被用户中途取消
            }

            @Override
            public void onPayFailure(PayWay payWay, int errCode) {
                // 支付失败，errCode码详见来源博客或者github项目主页的README文档
            }
        });

开发者调用步骤：

1. 通过建造者模式创建支付参数PayParams实例并传入EasyPay的创建方法中
2. 传入支付结果回调接口实例得到支付结果回调

假如你的app中每个商品有id,请求服务器时可以用商品id代替价格，让服务器自己去查询价格，防止客户端中的商品价格被恶意修改。

---

开发者需要做什么

上一节是开发者在Activity/Fragment之类的View层调用代码，除此之外，开发者还需要做一些少量的额外的工作。

需要导入EasyPay/library源码依赖并修改app客户端相关文件

1. 下载EasyPay源码到本地
2. 在Android Studio中打开你的app项目
3. Android Studio左上角File->New->Import Module->... 选择library目录导入，app会自动依赖library这个module
4. 复制EasyPay/sample下wxapi包到你的包路径下，假如你的包名:com.app.payclient，那么wxapi包应该放在payclient包下面
5. 按照EasyPay/sample的AndroidMenifest.xml文件修改你的清单文件
6. 按照EasyPay/sample的proguard-rules.pro修改你的混淆文件
7. 拷贝EasyPay/sample的assets到你的assets
     需要修改服务器请求路径和请求字段和返回的json解析

由于笔者并不知道你的服务器地址和请求路径及字段和返回json格式，所以你只需要动动小手修改EasyPay/library中网络请求和解析部分代码即可.

假如你的支付api接口文档如下:
host：http://api.yourhost.com/
路径：pay/
请求方式为：Http，get
请求需要的参数字段:

字段	类型	意义
pay_way	int	支付方式：0-微信，1-支付宝，2-银联 等
price	int	商品价格，单位：人民币-分
goods_name	String(128)	商品名称，将在支付客户端展示
goods_introduction	String(512)	商品描述，微信支付可填，支付宝必填

假设你想使用的网络框架是Retrofit2。那么network/NetwrokClientInterf的实现类RetrofitClient需要做如下修改： 由于Retrofit请求一般需要借助一个xxService类，那么实际修改的是xxService类，以EasyPay源码中的network/PrePayInfoService为例，它需要修改成如下：

public interface PrePayInfoService {
    @GET("pay/")
    Call<ResponseBody> getPrePayInfo(@Query("pay_way")String payWay, @Query("price") String GoddsPrice, @Query("goods_name") String goodsName, @Query(("goods_introduction")) String goodsIntroduce);

   /*@POST("pay/")
    Call<ResponseBody> postPrePayInfo(@Query("pay_way")String payWay, @Query("price") String GoddsPrice, @Query("goods_name") String goodsName, @Query(("goods_introduction")) String goodsIntroduce);*/
}
// （如需更多字段请自行添加参数）

当网络连接使用其他框架时，需要在NetworkClientInterf对应的实现类中修改路径及请求参数字段。

假如当前用户使用了微信支付，当服务器返回的数据格式如下时:

字段	类型	意义
errCode	int	错误码，0表示数据正确返回
errString	String	错误提示
data	String	返给客户端的json数据

假如json的格式如下:

字段	类型	意义
appid	String	微信appid
partnerid	String	商户号
prepayid	String	预支付交易id
package	String	固定值：Sign=WXPay
noncestr	String	随机字符串
timestamp	String	时间戳
sign	String	签名

以你们server端人员给出的实际json字段来修改pay/PrePayInfo。

当为其他支付方式时，也需要在对应的PayStragetyInterf支付实现策略类中修改解析。

library源码中需要修改的地方都打上了TODO标签，导入Android Studio后，如下图方式查看：

---

开发者能做什么

EasyPay目前实现了微信，支付宝app支付，如果你觉得支付逻辑代码不OK？完全可以通过实现PayStragetyInterf来完全重写一个自己的微信，支付宝支付策略。

EasyPay支持的平台（微信，支付宝，银联）不在你的需求范围内？可以通过实现PayStragetyInterf来扩展一种支付方式。

EasyPay支持的网络框架（HttpUrlConnection，OkHttp3（前两者严格意义上不属于框架）,Volley,Retrofit2）用的不顺手？那就自己撸一个NetworkClientInterf接口的实现类来实现自己的网络请求客户端。

其他，还是不够满足你的需求，欢迎提出issue，或者加入一起开发，完善该repo，打造一个更加优秀的EasyPay。

---

附录

移动支付开发博文

微信支付：Android App支付系列（一）：微信支付接入详细指南
支付宝：Android App支付系列（二）：支付宝SDK接入详细指南

移动支付的流程

1. APP将商品信息post给APP服务器
2. APP服务器携带商品信息和一些其他信息请求支付平台服务器，获取预支付订单信息
3. APP服务器得到预支付订单信息并返给APP
4. APP解析预支付订单信息
5. APP利用解析后的预支付信息调起支付客户端（微信，支付宝，等）
6. 支付客户端将支付结果返给APP
7. APP向用户展示支付结果

EasyPay的回调errCode错误码列表

通用errCode	意义
1	当前网络无连接（尚未进入支付阶段）
2	请求APP服务器超时（尚未进入支付阶段）
-1	支付失败-原因未知，需要开发者手动排查
微信errCode	一般不会碰到
-3	微信接收支付请求失败
-4	微信支付认证失败，拒绝支付交易
-5	微信版本低，不支持交易
-6	微信拒绝了支付交易
-7	未安装微信客户端，交易失败
支付宝errCode	一般不会碰到
8000	支付结果待确认,生成了交易订单，但是未支付。
6002	网络差导致支付失败
6004	支付结果未知
6005	支付失败，原因未知
银联errCode	一般不会碰到
-10	银联支付插件未安装
-11	银联支付插件需要升级，基本不会碰到

easypay's Issues

怎么不以jar的形式发布到jcenter，这样调用的方式会不会更简单一点，哈哈

支付成功后关于服务端的回调

我看支付宝微信支付结束后，把支付结束结果返回给客户端后，客户端还需要在服务端进行验证，这里怎么没有进行验证

设置支付方式的判断

 PayWay way = mPayParams.getPayWay();
        if (mPayParams.getPayWay() == null) {
            throw new NullPointerException("请设置支付方式");
        }

建议是把请求参数的判断放到获取预付订单之前，如果没有设置支付方式这样就可以减少一次网络请求

不更新了吗

不更新了吗

你好. 这个库还在维护么 ？

我想集成支付功能了，看到了你这个库 不知道是否还在维护中呢 ？

这样写不就空指针了吗

下载工程依赖的过程中各种dumplicate entry

还是依赖直接得好。不断删除现有工程的依赖和jar包真的还是有点伤啊。

银联支付可以了吗?

支付宝支付，

How can I use my order number?

As usual, I get an order number from server and put it to payment client and send a payment request. The question is that how I can use this order number through your "EasyPay"?

谢谢

谢谢，看到了

在没有网络的情况下会空指针导致程序崩溃

原因是：
在EasyPay类中,先是在requestPayInfo()中调用了一次sendPayResult();即调用了一次 releaseMemory();此时mPayParams为null，后来又在toPay()中又调用了一次。
mOnPayResultListener.onPayFailure(mPayParams.getPayWay(), code);mPayParams.getPayWay()为空指针。
建议将releaseMemory()方法放在doPay()中

关于微信支付回调

为什么你没有用WXPayEntryActivity 而官方文档说要用 大神你是怎么做到的 求教