微信公众号支付开发手记

前段时间由于公司业务发展,需要开发一个微信端的支付页面,并需要嵌入到公众号中。本文着手记录开发过程以及几点需要注意的地方。

需求简述

在微信公众号中,底部添加导航栏充值入口。点击进入充值页面后,选择相应商品购买,能调起微信支付。

前期准备

  • 因为公众号页面中使用了微信支付,所以需要在公众号对应的商户后台内配置微信支付授权目录,支付授权目录详细配置如下:

    • 进入该公众号对应的微信商户平台
    • 进入产品中心——开发配置——支付设置
    • 在支付授权目录中填写支付页面的链接,选择对应的协议httphttps
    • 链接写到最后一级目录,如支付页面是https://yoursite/dir/index.html,则支付授权目录为:https://yoursite/dir/

    否则可能会出现chooseWXPay:fail, the permission value is offline verifying等错误。参考链接

  • 页面还涉及到获取微信用户信息,所以页面需要接入微信网页授权。需要配置授权回调域名:

    在微信公众号请求用户网页授权之前,开发者需要先到公众平台官网中的“开发 - 接口权限 - 网页服务 - 网页帐号 - 网页授权获取用户基本信息”的配置选项中,修改授权回调域名。请注意,这里填写的是域名(是一个字符串),而不是URL,因此请勿加 http:// 等协议头;

    详细的接入配置请阅读上述微信网页授权文档。

页面制作

上述配置完成后,我们可以使用下面这种格式的授权链接:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=公众号对应的APPID&redirect_uri=授权成功之后的跳转链接&response_type=code&scope=授权类型&state=STATE#wechat_redirect

关于网页授权的两种scope的区别说明

1、以snsapi_base为scope发起的网页授权,是用来获取进入页面的用户的openid的,并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页(往往是业务页面)

2、以snsapi_userinfo为scope发起的网页授权,是用来获取用户的基本信息的。但这种授权需要用户手动同意,并且由于用户同意过,所以无须关注,就可在授权后获取该用户的基本信息。

3、用户管理类接口中的“获取用户基本信息接口”,是在用户和公众号产生消息交互或关注后事件推送后,才能根据用户OpenID来获取用户基本信息。这个接口,包括其他微信接口,都是需要该用户(即openid)关注了公众号后,才能调用成功的。

引导用户在微信浏览器中打开该链接,微信会自动拉起授权。当授权成功之后,页面会自动重定向到上述链接中的redirect_uri页面,并且会以GET参数的形式携带授权成功的参数code,该链接中redirect_uri参数对应的值(业务页面链接)需要使用URI编码

当微信授权成功之后,页面会跳转到填写的业务页面。然后在业务页面中取得url中微信传过来的code,去服务器请求open_id,再进行下一步的业务逻辑。

当用户选完商品之后,点击购买按钮,页面将商品信息和open_id等发送给后台。后台接入微信生成预订单并将预订单的信息返回给前端。在前端接收到预订单信息之后,可以使用下述代码调起微信支付(仅在微信浏览器中生效)

function onBridgeReady() {
  WeixinJSBridge.invoke(
    "getBrandWCPayRequest",
    {
      appId: 对应的appid, //公众号名称,由商户传入
      timeStamp: res.timeStamp, //时间戳,自1970年以来的秒数
      nonceStr: res.nonceStr, //随机串
      package: "prepay_id=" + res.prepay_id,
      signType: "MD5", //微信签名方式:
      paySign: res.paySign //微信签名
    },
    function(res) {
      if (res.err_msg == "get_brand_wcpay_request:ok") {
        // 使用以上方式判断前端返回,微信团队郑重提示:
        //res.err_msg将在用户支付成功后返回ok,但并不保证它绝对可靠。
      }
    }
  );
}
if (typeof WeixinJSBridge == "undefined") {
  if (document.addEventListener) {
    document.addEventListener(
      "WeixinJSBridgeReady",
      onBridgeReady,
      false
    );
  } else if (document.attachEvent) {
    document.attachEvent("WeixinJSBridgeReady", onBridgeReady);
    document.attachEvent("onWeixinJSBridgeReady", onBridgeReady);
  }
} else {
  onBridgeReady();
}

至此主体的业务逻辑即是完成了。

公众号自定义菜单配置

当业务页面都开发完成之后,我们需要将页面的链接配置到微信公众号的底部菜单中。此时我们可以登录进微信工作平台,在左侧的功能菜单下,找到自定义菜单选项。点击即可进入自定义菜单配置,这种配置方式比较直观和简单。

还有一种情况是,点击了自定义菜单,但是页面提示:

未开启自定义菜单

由于开发者通过接口修改了菜单配置,当前菜单配置已失效并停用。你可以前往开发者中心进行停用。

当出现这种情况的时候,有两种解决办法

  • 第一种是根据提示,进入开发者中心,停用掉服务器配置,再进行修改菜单,再启用服务器配置,再找到“添加功能插件”中的自定义菜单,选择启用。这种方式需要停用服务器配置,在此期间可能会影响到线上的自动回复等功能,并不建议,这里建议第二种方法
  • 第二种方式是直接使用接口的方式向微信发起一次post请求,并且携带需要配置的菜单信息,这种方式需要获得Access Token,这里有一篇文章写得非常详细:微信公众平台开发(58)自定义菜单,这里就不赘述了。

注意事项

这里有几个需要注意的地方

  • 如果在微信公众号调试工具中,无法正确调起支付,那可以尝试在真机上进行调试。

  • 如果在安卓机器上,可以唤起支付但是不出现输密码的步骤而且没报错,可以在IOS平台的微信上重试一下,也许就会有错误信息出现

  • 无法正常调起支付优先检查代码,如果不是代码错误则检查配置,几个配置需要检查的点:

    • 是否在公众号后台中配置了授权回调域名,授权回调域名格式是否正确(多加了http协议头,多了空格等)
    • 公众号对应的商户后台,是否配置了支付授权目录,支付授权目录的格式是否正确(http和https是否和实际访问链接匹配,链接是否写到了最后一级目录)
  • 在调起支付的参数中,前端代码中的timeStamp中的S是大写的,写错了也可能会无法调起支付。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,723评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,485评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,998评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,323评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,355评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,079评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,389评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,019评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,519评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,738评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,293评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2 345

推荐阅读更多精彩内容