跳到主要内容
api工厂
跨端开发

跨端支付能力矩阵:微信/支付宝/Apple IAP/Stripe 各端限制与方案

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

结论先行:跨端支付的难点不在调 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/AppStripe、PayPal按目标市场选择,注意币种与合规

两条最容易踩的红线单独强调:其一,微信 H5 支付是给微信外浏览器用的,在微信内打开必须走 JSAPI,否则直接报错;其二,iOS 端卖课程、会员、虚拟币这类数字商品,绕开 IAP 接第三方支付属于违规,审核与下架风险真实存在,实物电商则不受影响。各渠道费率、签约条件与政策细节,以微信支付、支付宝、Apple、Stripe 官方文档为准。

二、服务端统一下单:渠道只是参数

架构上把「创建订单」和「发起支付」拆成两步。订单服务只管业务:校验库存、算优惠、生成统一订单号(金额用分)。支付服务按「订单号 + 渠道 + 端」返回对应参数:

code
// 统一下单后,按端请求支付参数
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 这类强端侧能力仍需按苹果官方流程单独接入,但权益发放可以复用同一套会员接口。渠道政策变化频繁,接入前务必核对各官方最新规则。

文章标签

支付微信支付Apple IAPStripe

相关产品

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

架构设计多端复用统一后台

一套数据多端复用架构:小程序+H5+App 共用后台的设计

多端共用后台靠三个统一:用户身份、商品订单模型与支付抽象。一个 uid 挂多渠道身份,金额用分,渠道只是订单字段,前端各端只留薄 SDK 适配层。

跨端开发约 5 分钟阅读
React Native新架构Fabric

React Native 新架构:Fabric/TurboModules/无桥化带来了什么

RN 新架构用 JSI 取代 JSON Bridge,Fabric 支持并发渲染,TurboModules 惰性加载,Codegen 编译期校验接口。迁移工作量集中在原生第三方库适配。

跨端开发约 5 分钟阅读