Android App支付系列（一）：微信支付接入详细指南(附官方支付demo)

写在前面

一家移动互联网公司，说到底，要盈利总是需要付费用户的，自己开发支付系统显然是不明智的，国内已经有多家成熟的移动支付提供商，腾讯就是其中之一。梳理了下微信支付的接入，今天给大家分享下腾讯旗下的微信支付SDK的接入流程。
接入流程

1.申请开发者资质

地址：https://open.weixin.qq.com/

使用公司管理者/高层帐号登录微信开放平台，进入“账号中心”，进行开发者资质认证，需要填写公司资料，包括但不限于，公司注册号，公司营业执照，公司对外办公电话，公司对公银行卡信息（卡号，发卡行）。审核时间为一周左右。

备注：因为从2015年10月1日起，国家实行三证（组织机构代码证，企业营业执照，税务登记证）合一，所以组织机构代码处填写-工商执照注册号，同样，组织机构代码证，上传-企业工商营业执照。

备注2：进行开发者资质认证需要支付300元人名币/年，只有具备开发者资质认证的开发者才能够使用app支付，授权登录等接口。

2.申请APP_ID/APP_KEY

每个应用/游戏要调用微信的接口都需要有一个微信标志，这个唯一标志通常成为APP_ID或者APP_KEY，各开放平台差异不大
 进入管理中心，创建移动应用，每个开发者具有10个应用的创建机会，好在创建的应用可以随时删除。已上线的应用就不建议手贱删除！！

申请appid需要填写应用信息：应用名称，包名，签名(keystore的md5值去分号小写)，icon(28*28 & 108*108)，app下载地址等信息，即可分配到一个appid。
 备注：测试支付时，务必使用申请时填写的keystore文件签名，包名也需要核对清楚，必然无法调起支付，返回-1错误码。

3.申请支付能力 

在管理中心，查看需要集成支付能力的app，找到“微信支付”一栏，点击右侧“申请开通”，填写一些企业信息后等待审核，审核时间为一周左右，审核通过后，会得到一个企业商户号及密码，对公银行卡中将收到几分钱，进入商户平台，输入收到的金钱金额以验证。验证通过后即可开始集成支付调用。在这之前，调用支付接口是无法完成支付的。

4.代码集成微信支付 

支付流程图

微信支付流程图白话版：

1.客户端代码得到用户购买的商品信息，将之传给自己公司app服务器，参数包含但不限于以下：

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

备注：以上是参数字段是我们公司服务器定义，给服务器用以获取预支付订单号prePayId用。

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

2.app服务器调用微信“统一下单”接口，得到prePayId订单号并返回prePayId给手机客户端；

3.手机客户端使用prePayId及商品信息调起微信客户端进行支付；

3.1用户操作：输入密码进行支付；返回键取消支付；网络无连接支付失败等；

4.微信客户端回调支付结果给咱们的APP客户端；

5.微信服务器异步通知咱们公司app服务器支付结果（服务器的工作，与客户端无关）

微信支付代码：

IWXAPI mWxApi = WXAPIFactory.createWXAPI(mContext, WX_APPID, true);
mWxApi.registerApp(WX_APPID);
      /**
       * 请求app服务器得到的回调结果
       */
      @Override
      public void onGet(JSONObject jsonObject) {
        if (mWxApi != null) {
          PayReq req = new PayReq();

          req.appId = WX_APPID;// 微信开放平台审核通过的应用APPID
          try {
            req.partnerId = jsonObject.getString("partnerid");// 微信支付分配的商户号
            req.prepayId = jsonObject.getString("prepayid");// 预支付订单号，app服务器调用“统一下单”接口获取
            req.nonceStr = jsonObject.getString("noncestr");// 随机字符串，不长于32位，服务器小哥会给咱生成
            req.timeStamp = jsonObject.getString("timestamp");// 时间戳，app服务器小哥给出
            req.packageValue = jsonObject.getString("package");// 固定值Sign=WXPay，可以直接写死，服务器返回的也是这个固定值
            req.sign = jsonObject.getString("sign");// 签名，服务器小哥给出，他会根据：https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=4_3指导得到这个
          } catch (JSONException e) {
            e.printStackTrace();
          }
          mWxApi.sendReq(req);
          Log.d("发起微信支付申请");
        }

      }

在app包下新建wxapi包，比如app包名为com.xiongit.app，那个新建的包路径为com.xiongit.app.wxapi，该包下新建WXPayEntryActivity，继承自任意Activity。该Activity用以接收支付结果回调,清单声明此Activity的格式为

<activity
    android:name=".wxapi.WXPayEntryActivity"
    android:exported="true"
    android:launchMode="singleTop"/>

WXPayEntryActivity代码示例

public class WXPayEntryActivity extends Activity implements IWXAPIEventHandler{

  private static final String TAG = "MicroMsg.SDKSample.WXPayEntryActivity";

  private IWXAPI api;
  private static final String APP_ID = "your app id";

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.pay_result);

    api = WXAPIFactory.createWXAPI(this, APP_ID);
    api.handleIntent(getIntent(), this);
  }

  @Override
  protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
    api.handleIntent(intent, this);
  }

  @Override
  public void onReq(BaseReq req) {
  }

  /**
   * 得到支付结果回调
   */
  @Override
  public void onResp(BaseResp resp) {
    Log.d(TAG, "onPayFinish, errCode = " + resp.errCode);// 支付结果码
  }
}

回调中errCode值列表：

0 支付成功

-1 发生错误 可能的原因：签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等。

-2 用户取消 发生场景：用户不支付了，点击取消，返回APP。

清单menifest申明所需权限

 <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"/>

备注：支付结果最终以app服务器的得到的异步通知为准。

微信SDK混淆

-keep class com.tencent.mm.sdk.** {
  *;
}

update 20160704

当支付时，微信尚未登录，得不到任何回调，如果调起支付时有弹窗进度框,并且你想在得到响应码后让它消失是行不通的，需要在跳出的onStop中处理进度条，不然未登录并且用户取消了支付时进度条无法消失。

update 20160722

当支付时,WXPayEntryActivity会以透明的形式启动,所以你可能需要在支付完成得到支付响应码后手动finish该activity,不然你自己写的支付页面的activity需要返回两次才能退出,因为第一次按下back键实际是finish掉WXPayEntryActivity.第二次才是你自己的activity.

完事了，祝各位集成微信支付成功！

最后附上微信官方支付demo下载：https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=11_1，吐槽语：官方demo下载藏的有点深。。。开放平台居然没有提供下载，放在微信支付商户平台。