微信支付接入指南

微信作为大平台,开放SDK的功能很多,比如支付功能的接入,大家可能需要在繁多的功能中找出相应的文档,甚是耗时。


这篇文章来自于 xiong_it 的投稿,将手把手教你如何快速接入微信支付,希望能给恰有此需求的朋友带来帮助。


xiong_it 的博客地址:http://blog.****.net/xiong_it


写在前面


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


接入流程


1.申请开发者资质


地址:

https://open.weixin.qq.com


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


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

     

  • 进行开发者资质认证需要支付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服务器,参数包含但不限于以下:


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


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

  • 详细字段请参考:

    https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_1


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


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

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


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


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


微信支付代码:


微信支付接入指南


在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 代码示例:


微信支付接入指南


回调中errCode值列表:


  • 0 :支付成功 。

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

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


manifest声明所需权限


<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服务器的得到的异步通知为准。


完事了,祝各位集成微信支付成功!


最后


附上微信官方支付demo下载:

https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=11_1


吐槽语:官方demo下载藏的有点深。。。开放平台居然没有提供下载,放在微信支付商户平台。




如果你有好的技术文章想和大家分享,欢迎向我的公众号投稿,投稿具体细节请在公众号主页点击“投稿”菜单查看。


欢迎长按下图 -> 识别图中二维码或者扫一扫关注我的公众号:

微信支付接入指南