微信代扣 Android 开发流程

最近几天采坑了微信代扣，开发流程很简单，但是官方文档实在缺少一个具体的指引，导致走了很多弯路，因此本文分享一下自己的经验。
微信代扣开发者文档： https://pay.weixin.qq.com/wiki/doc/api/pap.php?chapter=18_1

微信代付文档截图

上图是文档的网页截图，其中红框里的 SDK 需要配置一下，APP跳转签约页面方法指引 是外部唤起微信的方法，（话说这个入口我找了好久才发现，一把辛酸泪……）
文档很长，对于各个端做什么也没有明确描述，所以我站在 Android 端的角度，讲一下开发流程。总共分以下三步：

1、调用服务端接口进行签约
服务端接口的返回类型是自定义的 Contract 类，其中 contractId 和 contractUrl 是 Android 端能用到的。（接口格式以你们服务端给的为准，此处仅供参考）

  //签约
  @POST("/xxx/contracts")
  Observable<Response<Contract>> getContract();

public class Contract {
    @JsonProperty("contract_id")
    public String contractId; // 微信给的签约合同号

    @JsonProperty("contract_url")
    public String contractUrl;// 可以调起微信的url

    @JsonProperty("product_id")
    public String productId; // IOS 会用到的 id，Android 端可以直接忽略
}

2、利用服务端返回的 contractUrl 调起微信签约付款页

private void toWeChatScan(String url) {
      try {
          WeChatPayUtil.pay(getActivity(), url);
      } catch (Exception e) {
          //若无法正常跳转，在此进行错误处理
          Toast.makeText(getContext(), "跳转到微信失败",Toast.LENGTH_SHORT).show();
      }
}

public class WeChatPayUtil {
    private static IWXAPI sWXAPI;
     /**
     * 微信代扣
     * @param pActivity
     * @param url
     * @return
     * @throws Exception
     */
    public static boolean pay(Activity pActivity, String url) throws Exception {
        if (sWXAPI == null) {
            sWXAPI = WXAPIFactory.createWXAPI(pActivity, WeChatHelper.WECHAT_APP_ID);
        }
        if (微信未安装) {
            ToastUtils.showLongToast(pActivity, R.string.toast_text_weixin_not_installed);
            return false;
        }
        toWechatContractPay(url);
        return true;
    }
    private static void toWechatContractPay(String url) {
        OpenWebview.Req req = new OpenWebview.Req();
        req.url = url;
        sWXAPI.sendReq(req);
    }
}

3、调用服务端接口轮询检查支付状态
微信代付的话，在微信中支付完成后，并不会同步返回结果给我们的 app，只会把支付结果通知我们的服务器，所以需要在我们的 app 中对服务器进行轮询来检查支付结果。
检查也不需要很多次，我们项目里是轮询 5 次，1 秒一次，已经足够了。
（接口格式以你们服务端给的为准，此处仅供参考）

    /**
     * 查看自动续费签约状态
     *
     * @param packageId
     * @param contractId
     * @return
     */
    @GET("/xxx/contracts/{contract_id}")
    Observable<Response<OrderStatus>> getOrderStatus(@Path("contract_id") String contractId);

其中的 contract_id 是在步骤1中返回的，这里需要用这个合同号来检查状态。

public class OrderStatus {
    @JsonProperty("status")
    public String status;//granted, ungranted, pending, unsubscribed

    @JsonProperty("singed_at")
    public long singedAt;//签约成功的时间（这个只有在 granted 状态时才有效）

    @JsonProperty("contract_type")
    public String contractType;//wechat, iap

    @JsonProperty("withhold")
    public OrderStatusWithhold withhold;
}

public class OrderStatusWithhold {
    @JsonProperty("status")
    public String status;//<"created", "pending", "succeeded", "failed">

    @JsonProperty("error_message")
    public String errorMessage;

}

需要注意上面两个 status 代表不同的意义， orderStatus.status 是签约状态，而orderStatusWithhold.status 是扣款状态，有可能签约成功，但是扣款时因为余额不足等原因而失败。

附一个讲代扣整体过程的文章，要开发的话值得一看：
http://jverson.com/2015/12/20/wechat/