写在前面的话
本文内容是指的uni-app项目的支付,文档中5+ APP的项目类型不涉及。
虽然uni-app已经为我们封装好了一个统一的API,所以在uni-app中我们只需要调用uni.requestPayment即可。但是uni-app官方文档的散乱看起来也挺头疼的。这里我精简整个流程,并对自己开发时碰到问题做个总结。
需要注意的是,支付模块的开发不仅仅是需要客户端的开发,还需要服务端的开发。这里是在保证服务端的配置正确的前提下,对于前端uni-app的开发与配置指南。
开通微信支付
这里有必要说明一下,申请微信支付流程对于初次申请者会感觉有些混乱,如果不理清相应关系可能会在各种平台找来找去。
对于小程序,首先要在微信公众平台(https://mp.weixin.qq.com)注册申请小程序。注这里公司使用需要300元/年认证费。
对于APP,要在微信开放平台(https://open.weixin.qq.com)注册申请账号。注这里公司使用需300元认证费。在应用详情中申请开通微信支付功能。
当审核都通过了,就可以获取到应用ID(APPID,即类似于个人ID一样,唯一标识)
有了以上基础,申请微信商户平台(https://pay.weixin.qq.com),注册申请账号。之后只需关联AppID,即可。
配置
小程序
无需配置,只需保证微信小程序配置即可。
APP
在manifest.json文件“App模块配置”项的“Payment(支付)”下,勾选“微信支付”项
参数说明
- appid
微信开放平台申请的应用ID(AppID) - iOS平台通用链接(Universal Link)
在iOS平台微信支付使用的通用链接,必须与微信开放平台 “管理中心” > “应用详情” > “开发信息” 中的“Universal Links”项中配置一致
注:关于通用链接,如果没有配置一致,iOS是无法在支付完成后回到APP的。
应用内发起支付——API使用
调用 [uni.requestPayment(OBJECT)]发起支付,OBJECT参数中provider属性值固定为wxpay
、
示例代码
微信小程序支付:
这里 的timeStamp, nonceStr, package, signType, paySign是由后端与微信交互生成的,值得注意的是package,微信直传过来的值是packageValue。
uni.requestPayment({
provider: 'wxpay', //支付类型-固定值
timeStamp: res.data.orderInfo.timeStamp, // 时间戳(单位:秒)
nonceStr: res.data.orderInfo.nonceStr, // 随机字符串
package: res.data.orderInfo.packageValue, // 固定值
signType: res.data.orderInfo.signType, //固定值
paySign: res.data.orderInfo.paySign, //签名
success: function (res) {
console.log('success:' + JSON.stringify(res));
console.log("支付成功");
},
fail: function (err) {
console.log('fail:' + JSON.stringify(err));
console.log("支付失败");
}
});
APP支付
这里是orderInfo,该属性值为订单对象。依然值得注意的是package,微信直传过来的值是packageValue。
partnerid,微信传过来的是partnerId。
prepayid,微信传过来是prepayId。
noncestr,微信传过来的是nonceStr。
timestamp,微信传过来的是timeStamp。
这里一定一定要注意大小写,不然订单请求失败,让你找问题,找到痛不欲生。
//订单对象,从服务器获取
var orderInfo = {
"appid": res.data.orderInfo.appId, // 应用ID(AppID)
"partnerid": res.data.orderInfo.partnerId, // 商户号(PartnerID)
"prepayid": res.data.orderInfo.prepayId, // 预支付交易会话ID
"package": res.data.orderInfo.packageValue, // 固定值
"noncestr": res.data.orderInfo.nonceStr, // 随机字符串
"timestamp": res.data.orderInfo.timeStamp, // 时间戳(单位:秒)
"sign": res.data.orderInfo.sign, // 签名,这里用的 MD5 签名
};
uni.requestPayment({
provider: "wxpay",
orderInfo: orderInfos,
success(res) {
console.log('success:' + JSON.stringify(res));
console.log("支付成功");
},
fail(err) {
console.log('fail:' + JSON.stringify(err));
console.log("支付失败");
});
至此,微信小程序已经可以正常支付了。而APP则需要打包才可以。uni-app有两种打包方式,一个是提交云端打包,一个是本地离线打包。这里说下离线打包的相关配置和问题。
iOS离线打包微信支付
关于离线打包我会单独出一篇,这里不在讲解。只进行微信支付相关配置讲解。
在uni-app官方提供的App离线SDK中有一个打包工程,如果想使用微信支付,就需要添加相应的依赖库以及资源,这点我就很怀念cocopods,方便太多了。
添加依赖库及资源
依赖库 | 系统库 | 资源文件 |
---|---|---|
liblibPayment.a、libwxpay.a、libWeChatSDK_pay.a | libsqlite3.0.dylib、libz.dylib、CoreTelephony.framework、SystemConfiguration.framework | 无 |
注意:SDK 中的
- libWeChatSDK_pay.a 为带支付功能的微信SDK,支持微信分享、微信支付及微信授权登录功能
- libWeChatSDK.a 为不带支付功能的SDK,仅支持微信分享和授权登录,不使用支付功能请添加此库,避免审核被拒
- 不要同时添加到工程避免冲突
工程配置
1.在URL Types 中添加配置: identifier 填写 weixin ,URL Schemes 填写wx[后面是您在微信平台申请的appkey]
,如果没有该项按照图中的格式创建。注意wx
这两个字母必须添加。
2.在 info.plist 添加 Schemes 白名单配置
3.配置Associated Domains(域名)
填写通用链接域名
4.在info.plist root 节点添加
UniversalLinks
字段,值和您在微信开放平台配置的一致,参考如下:(SDK 3.2.0版本以后 此项已废弃,仅保留字段,配置参数已经位置如步骤5所示)
5.在 info.plist 添加
weixin
(3.2.0 以前为weixinoauth
,这里就根据工程里面的修改即可) 项,填写微信 appid
及 appSecret
, UniversalLinks
,值和您在微信开放平台配置的一致,参考如下:
一定要按照以上的配置进行一一对照,否则会出现各种问题,比如无法调起微信,报错。或者无法回到APP内。