微信支付集成简介

前言

移动支付目前在市场上风生水起，微信支付也逐渐成为人们消费的一大主力方式。今天对Android端微信支付的集成做一个简单的说明。

流程

先盗一张官网上的时序图

微信支付的主要流程：

1. 商户APP端选择择商品下单并选择微信支付
2. 商户APP端将商品信息传到商户后台端，商户后台调用微信支付统一下单接口
3. 微信支付系统返回预付订单信息(prepay_id)到商户后台，商户后台生成带签名的客户端支付信息，并传给商户APP客户端
4. 商户APP客户端收到信息后通过SDK调起微信支付
5. 用户确认支付，微信提交支付授权，微信支付系统将支付结果通知商户后台和微信
6. 微信将支付结果返回到商户APP客户端，商户APP端也要向商户后台查询支付结果并展示。支付结果以商户后台的查询为准。

集成步骤

测试支付时，务必使用申请时填写的keystore文件签名，包名也需要核对清楚，必然无法调起支付，返回-1错误码。

1.平台配置

首先需要在微信开放平台申请开发应用，微信开放平台会生成APP的唯一标识APPID。此处需要填写应用包名和应用签名。此处这个应用签名需要使用微信平台提供的app获取。签名工具下载地址https://open.weixin.qq.com/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android.apk。

2.添加依赖和权限

// 微信支付compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:1.0.2'

    <uses-permission android:name="android.permission.INTERNET" />    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

3.注册APPID

IWXAPI mWxApi = WXAPIFactory.createWXAPI(this, Constants.APP_ID);// 将该app注册到微信mWxApi.registerApp(Constants.APP_ID);

4.向商户后台传商品信息

        params.put("appid", Constants.APP_ID);// 微信appid，选择性上传，服务器写死亦可        params.put("money", 1);// 支付金额，单位：分        params.put("name", "book");// 商品名称        params.put("currencytype", "CNY");// 支付币种，只能填CNY，代表人民币

详细字段请参考：https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_1

微信支付和银联支付都是「分」为单位,而支付宝则使用「元」为单位。

5.唤起微信支付

商户后台返回支付参数，由商户APP唤起微信支付。

     /**     * 用服务器传回的信息调起微信支付     */    private void pay(ResponseInfo responseInfo) {        mWxApi.registerApp(Constants.APP_ID);        if (mWxApi != null) {            PayReq req = new PayReq();            req.appId = Constants.APP_ID;// 微信开放平台审核通过的应用APPID            req.partnerId = responseInfo.getPartnerId();            req.prepayId = responseInfo.getPrepayId();            req.packageValue = responseInfo.getPackage();            req.nonceStr = responseInfo.getNonceStr();            req.timeStamp = responseInfo.getTimeStamp();            req.sign = responseInfo.getSign();            mWxApi.sendReq(req);            Log.i(TAG, "发起微信支付申请");        }    }

6.处理微信支付返回信息

在app包下新建wxapi包，在该包下新建WXPayEntryActivity。需要注意的是，package和Activity一定要这么写，包名或类名不一致会造成无法回调。

在WXPayEntryActivity类中实现onResp函数，支付完成后，微信APP会返回到商户APP并回调onResp函数，开发者需要在该函数中接收通知，判断返回错误码，如果支付成功则去后台查询支付结果再展示用户实际支付结果。
注意一定不能以客户端返回作为用户支付的结果，应以服务器端的接收的支付通知或查询API返回的结果为准。

回调中errCode值列表：

名称 描述 解决方案 0 成功 展示成功页面（要自行向服务器请求支付结果，以服务器未返回为准） -1 错误 签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等。(╯‵□′)╯︵┻━┻ -2 用户取消 无需处理。发生场景：用户不支付了，点击取消，返回APP。

WXPayEntryActivity示例代码：

public class WXPayEntryActivity extends AppCompatActivity implements IWXAPIEventHandler {    private static final String TAG = "fate";    private IWXAPI mWxApi;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_wxpay_entry);        mWxApi = WXAPIFactory.createWXAPI(this, Constants.APP_ID);        mWxApi.handleIntent(getIntent(), this);    }    @Override    protected void onNewIntent(Intent intent) {        super.onNewIntent(intent);        setIntent(intent);        mWxApi.handleIntent(intent, this);    }    @Override    public void onReq(BaseReq baseReq) {    }    /**     * 得到支付结果回调     */    @Override    public void onResp(BaseResp baseResp) {        Log.d(TAG, "onPayFinish, errCode = " + baseResp.errCode);// 支付结果码        switch (baseResp.errCode) {        case BaseResp.ErrCode.ERR_OK:            Log.i(TAG, "支付成功");            // 还需要向商户后台请求支付结果，最终结果以后台返回结果为准            finish();            break;        case BaseResp.ErrCode.ERR_COMM:            // 发生错误 可能的原因：签名错误、未注册APPID、项目设置APPID不正确、            // 注册的APPID与设置的不匹配、其他异常等。            Log.i(TAG, "发生错误");            Toast.makeText(WXPayEntryActivity.this, "支付失败", Toast.LENGTH_SHORT).show();            finish();            break;        case BaseResp.ErrCode.ERR_USER_CANCEL:            // -2 用户取消 发生场景：用户不支付了，点击取消，返回APP。            Log.i(TAG, "用户取消");            break;        default:            Log.i(TAG, "支付失败-其他的锅" + baseResp.errCode);            break;        }    }}

参考文章

微信支付开发文档
android微信支付问题总结
官方DEMO下载