美文网首页
uniapp支付之微信支付

uniapp支付之微信支付

作者: 淇水朱华 | 来源:发表于2022-02-11 15:18 被阅读0次

    写在前面的话

    本文内容是指的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支付之微信支付

          本文链接:https://www.haomeiwen.com/subject/tgbnkrtx.html