结论先行:支付宝与微信小程序的框架思路高度相似,差异集中在四个层面——文件结构与 API 前缀、登录授权链路、支付调起方式、类目资质与审核口径。业务逻辑本身几乎可以完全复用。推荐策略是:用 uni-app 这类跨端框架抹平语法差异,平台差异点用条件编译隔离,服务端统一账号与订单模型,一套代码维护两端。各平台规则会调整,具体以微信与支付宝官方最新文档为准。
一、文件结构与基础 API 对照
| 对比项 | 微信小程序 | 支付宝小程序 |
|---|---|---|
| 模板文件 | .wxml | .axml |
| 样式文件 | .wxss | .acss |
| API 命名空间 | wx.xxx | my.xxx |
| 列表渲染指令 | wx:for / wx:if | a:for / a:if |
| 事件绑定 | bindtap / catchtap | onTap / catchTap |
| 全局配置 | app.json | app.json(字段有差异) |
| 数据更新 | this.setData | this.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 验签),不要共用一套验签代码。
四、审核与运营口径差异
两端都要求类目与实际功能一致、特殊行业提供资质、收集用户信息有隐私声明。差异在口径与流程细节:
- 类目体系不同:同一业务在两端可能落在不同类目名下,资质材料要按各自后台要求准备,不能直接照搬;
- 隐私合规实现不同:微信有《用户隐私保护指引》与隐私授权 API 的配套机制,支付宝有自己的隐私声明与授权规范,两端都要单独配置;
- 虚拟支付限制:微信对 iOS 端虚拟商品支付有明确限制,支付宝端规则口径不同,涉及会员、课程类商品要分别核对;
- 备案与域名:两端都要求 HTTPS 与相应备案,合法域名配置入口与修改次数限制不同。
这一层没有捷径,提审前分别对照两端官方审核规范自查,以微信官方与支付宝官方最新文档为准。
五、多端复用策略:一套代码两个壳
推荐架构分三层:
- 视图层用 uni-app:一套 Vue 语法编译到微信与支付宝,平台差异用条件编译隔离:
// #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- 接口层用统一 SDK:「api工厂」提供 apifm-wxapi(微信)、apifm-uniapp(uni-app 多端)等配套 SDK,接口风格一致,统一返回 code、data、msg。商品 SKU、订单、售后、优惠券、微信支付与支付宝支付都是现成能力,两端调同一套后台数据,不用为支付宝单独再建一套商城后端。官网:https://www.it120.cc/ 。
- 服务端统一模型:账号、订单、库存、营销只有一份,渠道字段区分来源;支付回调按渠道各自验签,落库走同一个订单状态机。
落地顺序建议:先做微信端跑通业务,再用条件编译补支付宝差异点(登录、支付、分享、隐私弹窗四处为主),最后双端分别提审。真实的双端电商与会员卡案例可参考 https://www.it120.cc/cases.html ,能直观看到同一套后台支撑多端的形态。
六、差异自查清单
- 请求层是否抹平 wx.request 与 my.request 的行为差异;
- 登录是否按渠道换 code,服务端是否统一 token;
- 支付金额单位、调起参数、回调验签是否按渠道隔离;
- 类目、资质、隐私声明是否两端分别配置;
- 条件编译是否只包平台差异,业务代码是否保持单份。