跳到主要内容
api工厂
小程序

支付宝小程序与微信小程序差异清单:API、审核、支付对比与多端复用策略

api工厂资讯栏目 约 6 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:支付宝与微信小程序的框架思路高度相似,差异集中在四个层面——文件结构与 API 前缀、登录授权链路、支付调起方式、类目资质与审核口径。业务逻辑本身几乎可以完全复用。推荐策略是:用 uni-app 这类跨端框架抹平语法差异,平台差异点用条件编译隔离,服务端统一账号与订单模型,一套代码维护两端。各平台规则会调整,具体以微信与支付宝官方最新文档为准。

一、文件结构与基础 API 对照

对比项微信小程序支付宝小程序
模板文件.wxml.axml
样式文件.wxss.acss
API 命名空间wx.xxxmy.xxx
列表渲染指令wx:for / wx:ifa:for / a:if
事件绑定bindtap / catchtaponTap / catchTap
全局配置app.jsonapp.json(字段有差异)
数据更新this.setDatathis.setData(基本一致)

请求接口差异值得单独注意:wx.request 与 my.request(旧版为 my.httpRequest)在超时、返回结构、header 处理上不完全一致;支付宝端历史上对 content-type 与数据序列化有自己的默认行为,跨端封装请求层时要统一抹平。存储、路由、弹窗类 API 大多一一对应,改名即可。

二、登录与用户身份链路

微信:wx.login 取 code,服务端 code2Session 换 openid 与 session_key;手机号通过 getPhoneNumber 按钮获取 code 后服务端解密换取。

支付宝:my.getAuthCode 获取授权码(authCode),服务端调 alipay.system.oauth.token 换取 user_id 与访问令牌;手机号获取走 my.getPhoneNumber,需要用户主动触发且返回加密数据,服务端用应用私钥解密。

共同点:临时票据都必须在服务端兑换,密钥都不能进前端。差异点:身份主键不同(openid 对 user_id),同一用户在两端是两个身份,账号打通要靠手机号。服务端建议用户表以手机号或内部 uid 为主键,微信 openid、支付宝 user_id 放第三方身份子表,登录出参统一为同一套业务 token,这样订单、会员、优惠券全端共享。

三、支付链路对比

环节微信小程序支付宝小程序
下单接口微信支付 v3 JSAPI 下单alipay.trade.create
关键入参appid、mchid、openid、金额(分)app_id、buyer_id、金额(元,字符串)
前端调起wx.requestPayment(五参数加签名)my.tradePay(传 tradeNO)
结果确认服务端回调验签解密或查单服务端异步通知验签或查单
主体要求企业或个体工商户企业或个体工商户

三个易错点:金额单位微信是分、支付宝是元,服务端统一用分存储、按渠道换算;支付宝 my.tradePay 的 success 同样不代表支付成功,必须以后端通知或查单为准;两端回调验签体系完全不同(微信 RSA 加 AES-GCM,支付宝 RSA2 验签),不要共用一套验签代码。

四、审核与运营口径差异

两端都要求类目与实际功能一致、特殊行业提供资质、收集用户信息有隐私声明。差异在口径与流程细节:

  1. 类目体系不同:同一业务在两端可能落在不同类目名下,资质材料要按各自后台要求准备,不能直接照搬;
  2. 隐私合规实现不同:微信有《用户隐私保护指引》与隐私授权 API 的配套机制,支付宝有自己的隐私声明与授权规范,两端都要单独配置;
  3. 虚拟支付限制:微信对 iOS 端虚拟商品支付有明确限制,支付宝端规则口径不同,涉及会员、课程类商品要分别核对;
  4. 备案与域名:两端都要求 HTTPS 与相应备案,合法域名配置入口与修改次数限制不同。

这一层没有捷径,提审前分别对照两端官方审核规范自查,以微信官方与支付宝官方最新文档为准。

五、多端复用策略:一套代码两个壳

推荐架构分三层:

  1. 视图层用 uni-app:一套 Vue 语法编译到微信与支付宝,平台差异用条件编译隔离:
js
// #ifdef MP-WEIXIN
wx.login({ success: (r) => login({ channel: 'weixin', code: r.code }) });
// #endif
// #ifdef MP-ALIPAY
my.getAuthCode({ scopes: 'auth_base', success: (r) => login({ channel: 'alipay', code: r.authCode }) });
// #endif
  1. 接口层用统一 SDK:「api工厂」提供 apifm-wxapi(微信)、apifm-uniapp(uni-app 多端)等配套 SDK,接口风格一致,统一返回 code、data、msg。商品 SKU、订单、售后、优惠券、微信支付与支付宝支付都是现成能力,两端调同一套后台数据,不用为支付宝单独再建一套商城后端。官网:https://www.it120.cc/ 。
  2. 服务端统一模型:账号、订单、库存、营销只有一份,渠道字段区分来源;支付回调按渠道各自验签,落库走同一个订单状态机。

落地顺序建议:先做微信端跑通业务,再用条件编译补支付宝差异点(登录、支付、分享、隐私弹窗四处为主),最后双端分别提审。真实的双端电商与会员卡案例可参考 https://www.it120.cc/cases.html ,能直观看到同一套后台支撑多端的形态。

六、差异自查清单

  • 请求层是否抹平 wx.request 与 my.request 的行为差异;
  • 登录是否按渠道换 code,服务端是否统一 token;
  • 支付金额单位、调起参数、回调验签是否按渠道隔离;
  • 类目、资质、隐私声明是否两端分别配置;
  • 条件编译是否只包平台差异,业务代码是否保持单份。

文章标签

支付宝小程序微信小程序多端开发uni-app

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

微信小程序订阅消息用户召回

小程序订阅消息与用户召回:模板消息退场后的合规触达

订阅消息的本质是把触达选择权还给用户:一次授权一条消息,营销式群发走不通。正确做法是在下单、预约等关键节点顺势请求授权,服务端管理订阅额度,用服务通知加短信、会员权益做合规召回组合。

小程序约 6 分钟阅读