结论先行:跨端支付的难点不在调 SDK,而在「每个端允许用什么渠道」的规则矩阵:微信小程序只能微信支付,支付宝小程序只能支付宝,iOS App 内卖虚拟商品必须走 Apple IAP,实物电商不受此限,出海业务用 Stripe/PayPal。正确架构是服务端统一下单、按端分发支付参数、以异步通知为准更新订单。把渠道规则背下来、把订单模型统一好,支付就是配置问题而不是开发问题。
一、先背规则:各端支付能力矩阵
| 端 | 可用渠道 | 关键限制 |
|---|---|---|
| 微信小程序 | 微信支付(JSAPI) | 需小程序主体与商户号绑定 |
| 微信公众号 H5 | 微信 JSAPI 支付 | 需公众号授权拿 openid |
| 微信外浏览器 H5 | 微信 H5 支付、支付宝网页支付 | 微信 H5 支付不能在微信内置浏览器用 |
| 支付宝小程序 | 支付宝(tradePay) | 需支付宝小程序与商户签约 |
| App(Android/iOS) | 微信 App 支付、支付宝 App 支付 | 需分别申请移动应用资质 |
| iOS App 虚拟商品 | Apple IAP | 数字内容/会员必须走 IAP,抽成以苹果政策为准 |
| iOS/Android 实物商品 | 微信/支付宝等 | 实物交易不适用 IAP 强制规则 |
| 海外 Web/App | Stripe、PayPal | 按目标市场选择,注意币种与合规 |
两条最容易踩的红线单独强调:其一,微信 H5 支付是给微信外浏览器用的,在微信内打开必须走 JSAPI,否则直接报错;其二,iOS 端卖课程、会员、虚拟币这类数字商品,绕开 IAP 接第三方支付属于违规,审核与下架风险真实存在,实物电商则不受影响。各渠道费率、签约条件与政策细节,以微信支付、支付宝、Apple、Stripe 官方文档为准。
二、服务端统一下单:渠道只是参数
架构上把「创建订单」和「发起支付」拆成两步。订单服务只管业务:校验库存、算优惠、生成统一订单号(金额用分)。支付服务按「订单号 + 渠道 + 端」返回对应参数:
// 统一下单后,按端请求支付参数
const pay = await WXAPI.payRequest({
orderId: '202611200001',
channel: 'wxpay'
})
if (pay.code === 0) {
// 小程序端拿到 JSAPI 参数,直接调起收银台
// #ifdef MP-WEIXIN
uni.requestPayment({
provider: 'wxpay',
timeStamp: pay.data.timeStamp,
nonceStr: pay.data.nonceStr,
package: pay.data.packageValue,
signType: pay.data.signType,
paySign: pay.data.paySign
})
// #endif
}前端永远不拼支付签名——签名必须在服务端用商户密钥完成,私钥不出后端。支付宝小程序端同理,拿到 tradeNO 后调 uni.tradePay;H5 端跳转收银台;App 端把参数交给对应原生 SDK。
三、结果以异步通知为准,做好幂等与对账
支付结果有三个来源:渠道异步通知、前端同步回调、主动查单。可信度排序是:异步通知 > 主动查单 > 前端回调。前端回调只用于展示「支付成功页」,订单状态必须由服务端在验签后的异步通知里更新。三个工程要点:通知处理必须幂等(同一通知可能重发,按订单号加状态判断去重);通知丢失要有兜底(定时对未支付订单主动查单);每日与渠道账单对账,金额不一致立即告警。退款走统一退款接口按订单号发起,同样以异步结果为准。
四、按业务形态选组合
实物电商(国内):微信小程序微信支付 + 支付宝小程序支付宝 + H5 双渠道 + App 双渠道,一套订单全端互通。知识付费/会员类:iOS 端必须接 IAP,Android 与小程序走微信/支付宝,注意同一会员权益要在服务端按 uid 打通,避免「iOS 买了 Android 不认」。出海业务:Web/App 接 Stripe(卡支付)与 PayPal,注意币种、退款周期与税务合规。混合形态:把 IAP 也当成一个 channel 纳入统一订单模型,票据校验放服务端,权益发放与其他渠道走同一条逻辑。
五、用现成多渠道后台跳过重复造轮子
上述矩阵的签约、签名、通知、对账逻辑,每个渠道都要写一遍,自建成本不低。api工厂(https://www.it120.cc/)把微信支付、支付宝、PayPal、Stripe 做成了现成模块:后台配置商户参数,前端各端 SDK(apifm-wxapi、apifm-uniapp、apifm-webapi 等)调统一支付接口即可,订单与会员数据全端互通,专业版 399 元/年(https://www.it120.cc/price.html)。Apple IAP 这类强端侧能力仍需按苹果官方流程单独接入,但权益发放可以复用同一套会员接口。渠道政策变化频繁,接入前务必核对各官方最新规则。