开发|只需 10 分钟!让你的小程序轻松接入「微信支付」

小程序

2017-09-08 20:00

在小程序开发中,微信支付的接口调用一直是一件「麻烦事」

你可能需要花半天时间看微信支付文档,再花半天调试支付签名,最后还得加两天时间搞定支付回调通知以及和自己的业务结合。

好不容易上线了,又得做各种保障措施确保支付功能不挂掉……

而这并不是「必然」现象,你同样可以选择只用 10 分钟完成微信支付的所有接入工作

今天,知晓程序「微信号 zxcx0101」将借着一款小程序的开发案例,向大家介绍史上最快完成微信支付接口调用的方法。

关注「知晓程序」微信公众号,在微信后台回复「开发」,获取小程序全套开发经验。

诞生背景

「未来社」是国内首创融合科技教育和生活美学的实验工场,其配套的小程序主要聚焦在商家入驻、会员付费两大功能。

「未来社」是第一批用上知晓云的小程序。从刚开始开发到最后成品,后端所有逻辑都交给了知晓云。

相比较于另外一款自己写后端逻辑的小程序项目,知晓云的确能够让开发者快速进行开发,免除环境安装、配置、后端代码管理的麻烦。

具体怎么使用呢?下面我就来为大家简单讲解。

构建界面

对接初期,「未来社」相关的负责人给了我一份整体页面设计稿。这份设计稿非常精美,所有元素都可以查询到具体样式。

有了这么精美的界面,小程序的界面外壳很快就搭建完成了。

这里简单地提及一下的,就是 Swiper 组件的使用。

「未来社」小程序主页有三个页面,前两个页面用来展示「未来社」介绍,并允许用户直接购买「未来社」空间使用权;第三个页面则用于展示用户资料。

用户只需要在页面上左右滑动,就可以切换前后页面。

同时,屏幕右下角也需要一个直接跳转个人资料页的按钮,用户点击之后可以直接跳过未来社介绍,直接进入个人中心填写资料。

看上去需求挺复杂,但是利用小程序的 Swiper 组件,这些功能都可以轻松完成

二话不说,上代码:

<!-- Swiper 组件 -->
<swiper current="{{pageindex_active}}" bindchange='swiper'>
  <swiper-item id='page1'> 第一页 </swiper-item>
  <swiper-item id='page2'> 第二页 </swiper-item>
  <swiper-item id='page3'> 第三页 </swiper-item>
</swiper>

<!-- 显示个人资料页面按钮 -->
<view wx:if='{{pageindex != 2}}'> <!-- 当用户就在个人资料页时,不显示按钮 -->
  <view class='profilebtn'>
    <image src='/path/to/btn.png' class='profilebtn-img' mode='aspectFit' bindtap='gotoprofile'></image>
  </view>
</view>
Page({
  swiper: function (res) {
    page.setData({
      pageindex: res.detail.current
    })
  },
  gotoprofile: function () {
    page.setData({
      pageindex_active: 2,
    })
  }
})

搞定!剩下的事情,就是填充 Swiper 组件的具体内容了。最后,再写写具体的样式,就是我们看到的小程序界面了。

关注「知晓程序」微信公众号,在微信后台回复「支付」,获取本项目源代码。

逻辑

界面搞定之后,我们就要搞搞数据交互的逻辑部分了。

当他们丢了一个知晓云 SDK 给我的时候,其实我是拒绝的。我不能说你让我用,我就立刻用,我必须要试一试……

关注「知晓程序」微信公众号,回复「支付」,获取知晓云 SDK 下载地址。

因为刚拿到 SDK 的时候,我有点懵,因为知晓云的 SDK 将 API 请求也封装了起来,而且封装到了微信的 wx 对象中。

其他同类集成式后端环境,通常也会用 RESTful 形式给接口,开发者在小程序中,调用 wx.request,完成数据交换。

当然,这种方式的好处也是显而易见:开发者不用自己封装 wx.request 写网络请求方法,也不需要在需要调用的时候,写又臭又长的网络请求参数。

开发者只需要在知晓云进行注册,同时加载知晓云体积极小的的 SDK,就能直接在小程序中,使用知晓云的后端集成服务。

回到「未来社」小程序。这个小程序的具体作用就是向用户展示、介绍「未来社」业务,然后允许用户直接购买「未来社」空间使用权。

展示和介绍的任务我们之前解决了,接下来就是要让用户买买买。想要实现在小程序里直接交易,我需要实现两个功能:

  • 小程序要先让用户留下联系方式,方便客服联系用户,完成服务。
  • 客户心动的时候,应该让他直接在小程序里购买会员资格。

1. 资料补充与修改

利用知晓云的数据表功能,以及配套的读写接口,我就可以保存用户的个人资料。

这个部分的实现,用到的就是上一篇「我的书架」文章中的数据表读写功能,这里就不详细展开。有兴趣的,可以先阅读那篇文章

这里我所使用的方法比较简单粗暴:先检测当前用户是否在表中有个人资料的记录,如果没有,就新建,如果有,则拉取 / 更新个人资料

需要注意的是,在写入数据表的时候,知晓云会自动登记新建记录的用户标识,所以,不需要额外为数据表新建 user_id 这种列。

Page({
  onLoad: function () { // 加载时判断用户是否填写过资料
    wx.BaaS.getRecordList({
      tableID: 123,
      created_by: wx.BaaS.storage.get('uid')
    }).then(
      (res) => {
        if (res.data.meta.total_count != 0) {
          newdata = false
          var data = res.data.objects[0].response // 从返回中抽取已经写好的资料
          dataid = res.data.objects[0].id
          page.setData({})// 将用户填过的资料填充至输入框,方便用户修改
        }
        else {
          newdata = true
        }
      }, (err) => {
        console.log(err)
      });
  },
  submit() { // 用户点击提交资料按钮时
    if (newdata) { // 如果用户是第一次补充资料
      wx.BaaS.createRecord({
        tableID: 123,
        data: {} // 填充个人资料
      }).then((res) => {} // 填完资料就自动返回上一层页面
      , (err) => {}); // 出现错误的处理,可能是网络问题
    }
    else { } // 如果用户已经填过资料,使用知晓云的数据更新接口,更新用户资料,此处代码类似则省略
  }
})

2. 支付功能

「未来社」的会员资格有使用时长,用户可以在小程序中购买时长。如果多次购买,时间可以累计。

那么,当用户购买会员资格时:

  • 小程序需要知道用户是否已经购买空间、是否还在会员资格期内。
  • 如果用户的会员尚在有效期,那么用户继续购买,则有效期会累加。
  • 如果用户的会员已过期,或是之前没有购买过,则有效期从购买时计算。

也就是说,我需要先从服务器获取用户会员资格有效期信息。用户购买后,我再根据有效期信息,计算新的到期日,最后更新数据库。

思路有了,那就动手做呗。首先,先从知晓云的数据表里抽数据:

wx.BaaS.getRecordList({
  tableID: 123,
  created_by: wx.BaaS.storage.get('uid')
}).then((res) => {
  if (res.data.meta.total_count != 0) {
    var data = res.data.objects[0].response
    if (data.is_member) {
      if ((data.expired_at) > (moment().unix())) {
        member_time = data.expired_at // 购买过会员,且未过期
      }
      else {
        member_time = 0 // 用户购买过会员,但已过期
      }
    }
    else {
      member_time = -1 // 用户从未购买过会员服务
    }
  }
}, (err) => {
  console.log(err)
});

接下来,就要正式接入微信支付接口,让用户在小程序里买买买。

我说过,知晓云最赞的地方,就是它的 SDK 将很多调用起来很麻烦的接口全部封装,这其中就包括微信支付接口

如果你很早关注过「知晓程序」微信公众号,应该知道在小程序里调用微信支付是多么痛苦的一件事,我甚至还打算找一整天来解决它。

但是,用了知晓云,十分钟我就做完了接入……

喏,就像这样:

var moment = require('../../resource/utils/moment') // 时间戳处理工具
function buybuybuy(buy_time, member_time) {
  var params = {}
  if (buy_time == 3) {
    params.totalCost = 1000
    params.merchandiseDescription = '会员时长 A'
  }
  else if (buy_time == 12) {
    params.totalCost = 2700
    params.merchandiseDescription = '会员时长 B'
  }
  wx.BaaS.pay(params).then((res) => {
    if (member_time > 0) {
      member_time = (moment.unix(member_time).add(buy_time, 'months').unix()); // 将其有效期继续累加
    }
    else {
      member_time = moment().add(buy_time, 'months').unix();
    }
    wx.BaaS.updateRecord({}) // 更新会员有效期
  }
}

嗯,只需要二三十行代码,传入价格和商品描述,知晓云已经帮你搞定微信支付了。

完成!其实未来社的小程序开发过程还算比较简单的。

有了知晓云,我将更多的时间花在了完善这款小程序的样式上面,在逻辑编写上,也节省了我不少精力。

关注「知晓程序」公众号 👇

  • 在微信后台回复「开发」,获取小程序全套开发经验。
  • 在微信后台回复「支付」,进群学习小程序接入微信支付技巧。

zxcx_0208

登录,参与讨论前请先登录

评论在审核通过后将对所有人可见

正在加载中

净干文科生事情的理科生,悲观的乐观主义者,希望成为路人的铺路石,不矛盾的矛盾体。

本篇来自栏目

解锁订阅模式,获得更多专属优质内容