微信支付接入比较坑的是其官方文档很简洁,文档结构不清晰,往往不容易找到自己想要看到的东西。下面对接入微信支付作一个完整的介绍。
一、创建应用
注册申请开放平台账号是为了创建应用,不管是移动、网页、公众号还是小程序都需要通过开放平台创建应用,下面仅描述创建应用中的细节。
a. 应用图标大小,必须按照限定的尺寸;
b. 继上一步之后,下一步填写平台信息,需填写应用签名与包名,值得注意的是需要把签名的MD5值的冒号去掉,
获得该值的方式:
1、在Android Studio的Treminal窗口中使用命令:keytool -list -v -keystore + keystore-path,若在此处执行命令失败,可以在JDK安装目录的bin目录下打开cmd运行此命令,而此处若你的电脑是win10,仍可能提示如下信息,按照提示输入命令 .\keytool -list -v -keystore xxx-path.jks即可。
2、转入官方文档APP端开发步骤,下载官方获取应用签名的APK,GetSignApk,安装上输入报名即可。但是此处需要注意调试和Release时所使用的keySotre路径,如果为了方便可以在App的build.gradle中加入签名配置,方便更改keystore路径进行调试。
signingConfigs {
debug {
storeFile file('xxxx.jks')
storePassword"xxxxxxx"
keyAlias"xxxxxxx"
keyPassword"xxxxxx"
}
}
3、下一步就是提交申请,等待审核,然后开通支付功能,需要填写商户信息,提交资料,这里就涉及到微信商户平台,已有商户平台账号就快捷很多了,没有商户平台账号就需要注册。商户Id、商户签名的key都是来源于商户平台。
二、集成开发与调试
1、按照指定步骤接入支付到工程,Android接入指南;
2、进行调试,通常统一下单生成微信预支付订单、以及对AppId、partnerid、prepayid、noncestr、timestamp、package这些必需参数进行签名都由服务器端完成,客户端只需要对服务器返回的这些参数进行封装,本地发起支付即可,代码如下:
此时,当你欣喜的编译代码,想要发起支付的时候,发现支付回调的code为-1,哈哈,大多数人都会跳进这个坑,摸不着头脑,关键是官方对-1作如下解释:
可能的原因:签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等。
一个“其他异常等”就是最大的坑,这里是真想吐槽一下官方文档的简略,下面就来说说返回-1的坑。
3、客户端错误排查
a. 检查签名,是否是如步骤一中去掉了冒号;
b. 检查APPID是否和服务器端签名使用的appId一致,同时需到开放平台对比;
c. 能够返回-1,这里不需要像大多数攻略去检查包目录结构,如果没有任何回调可采用,但是不得不提一提微信回调的类必须放在工程包名下的第一级目录,名字必须为wxapi。如下图:
4、服务器端排错
a. 检查签名参数组合的顺序,如官方描述(见下图),通常顺序就是appid、partnerid、prepayid、noncestr、timestamp、package;
b. 检查参与签名参数的key和value,官方的API文档参数说明很多带有连接符(见下图),一定得注意,所有参数的key都是小写并且不带连接符,appid、partnerid、prepayid、noncestr、timestamp、package;
c. 检查参数时间戳,是否是以秒为单位,是否是东八区(标准北京时间,时区为东八区,自1970年1月1日 0点0分0秒以来的秒数。注意:部分系统取到的值为毫秒级,需要转换成秒(10位数字));
d. 检查package参数,如果appid、partnerid、package这三个参数只是放在客户端,也得注意他们参与了签名。
e. 检查签名所使用的key,是否是商户平台的API秘钥,而不是开发平台的APPSecret。
上面的坑,签名设置踩过,但是服务器端的坑都踩过,哈哈。排除上面的错误,基本上微信支付就可以成功了。
记录一下,避免下次再次摔倒,到处搜寻攻略,也为需要的小伙伴分享。