uniapp支付之微信支付

写在前面的话

本文内容是指的uni-app项目的支付,文档中5+ APP的项目类型不涉及。
虽然uni-app已经为我们封装好了一个统一的API,所以在uni-app中我们只需要调用uni.requestPayment即可。但是uni-app官方文档的散乱看起来也挺头疼的。这里我精简整个流程,并对自己开发时碰到问题做个总结。
需要注意的是,支付模块的开发不仅仅是需要客户端的开发,还需要服务端的开发。这里是在保证服务端的配置正确的前提下,对于前端uni-app的开发与配置指南。

开通微信支付

这里有必要说明一下,申请微信支付流程对于初次申请者会感觉有些混乱,如果不理清相应关系可能会在各种平台找来找去。

微信支付各平台关联图.png

对于小程序,首先要在微信公众平台(https://mp.weixin.qq.com)注册申请小程序。注这里公司使用需要300元/年认证费。

对于APP,要在微信开放平台(https://open.weixin.qq.com)注册申请账号。注这里公司使用需300元认证费。在应用详情中申请开通微信支付功能。

当审核都通过了,就可以获取到应用ID(APPID,即类似于个人ID一样,唯一标识)
有了以上基础,申请微信商户平台(https://pay.weixin.qq.com),注册申请账号。之后只需关联AppID,即可。

关联AppID.png

配置

小程序

无需配置,只需保证微信小程序配置即可。

APP

在manifest.json文件“App模块配置”项的“Payment(支付)”下,勾选“微信支付”项


App微信支付配置.png
参数说明
  • 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这两个字母必须添加。

wechat-schemes.png

2.在 info.plist 添加 Schemes 白名单配置
weichat-plist.png

3.配置Associated Domains(域名)
weixin-associated.png

填写通用链接域名
weixin-assoDomains.png

4.在info.plist root 节点添加UniversalLinks字段,值和您在微信开放平台配置的一致,参考如下:(SDK 3.2.0版本以后 此项已废弃,仅保留字段,配置参数已经位置如步骤5所示)
weixin-unlinks.png

5.在 info.plist 添加 weixin(3.2.0 以前为weixinoauth,这里就根据工程里面的修改即可) 项,填写微信 appidappSecret, UniversalLinks,值和您在微信开放平台配置的一致,参考如下:
weixin_plist.jpg

一定要按照以上的配置进行一一对照,否则会出现各种问题,比如无法调起微信,报错。或者无法回到APP内。

你可能感兴趣的:(uniapp支付之微信支付)