▶_MiniApp ToolkitAgent 接入

支付宝小程序

T1平台

支付宝小程序是一种运行在支付宝客户端内的轻量应用。依托支付宝的信任体系和支付能力,适合生活服务、商业服务类场景。支持小程序云(Serverless)、芝麻信用、花呗分期等特色能力。

📊 月活 6.54亿(2025-05)
支付宝小程序金融支付信用生态行业小程序

详细文档

支付宝小程序

平台概述

支付宝小程序于 2018 年正式上线,运行在支付宝客户端内,依托支付宝 10 亿+ 月活用户。与微信小程序相比,支付宝小程序的核心差异在于 信任体系商业服务能力

核心优势:

  • 芝麻信用:可基于用户信用分提供免押金等创新服务
  • 花呗分期:支持商品分期购买,提升转化率
  • 口碑生态:线下商家通过口碑获得自然流量
  • 小程序云:Serverless 能力,免服务器开发

典型场景:

  • 生活服务:饿了么、口碑、哈啰出行
  • 金融理财:基金定投、保险服务
  • 信用服务:免押金租车(芝麻信用)、酒店信用住
  • 政务服务:电子证件、公积金查询

设计规范

尺寸单位

  • 支持 rpx(与微信通用:750rpx = 屏幕宽度
  • 也支持 pxvh/vw 等标准单位

组件规范

  • 基本组件与微信类似:<view>, <text>, <image>, <scroll-view>, <swiper>
  • 特色组件:<contact-button>(客服按钮)、<lifestyle>(生活号关注)
  • 没有 <map> 的原生组件(使用高德地图 JS API 替代)

导航模式

  • 与微信类似:my.navigateTo / my.redirectTo / my.switchTab / my.navigateBack
  • 页面栈最大深度:10 层

样式差异

  • .acss.wxss 基本兼容
  • 部分微信特有属性不支持(如 @supports 在低版本不支持)

审核规范

常见被拒原因

  1. 金融资质:涉及基金、保险、借贷需相应金融牌照
  2. 诱导行为:禁止强制分享、关注生活号后才能使用
  3. 虚拟支付:与微信类似,iOS 上不允许虚拟商品内购
  4. 类目资质:医疗、教育、金融等需额外资质认证
  5. 个人信息:收集手机号、位置等需明示并获得用户授权

审核周期

  • 通常 1-3 个工作日
  • 金融类应用审核更严格,可能需要 5-7 天

企业 vs 个人

  • 支付宝小程序以企业主体为主
  • 个人开发者功能受限(不支持支付等)

开发指南

快速上手

code
// app.js
App({
  onLaunch() {
    console.log('支付宝小程序启动')
  }
})

// pages/index/index.js
Page({
  data: { msg: 'Hello 支付宝' },
  onLoad() {
    console.log('页面加载')
  }
})

// pages/index/index.axml
<view class="container">
  <text>{{msg}}</text>
  <button onTap="handleTap">点我</button>
</view>

与微信的核心差异

维度微信支付宝
API 命名空间wx.xxxmy.xxx
模板文件.wxml.axml
样式文件.wxss.acss
支付 APIwx.requestPaymentmy.tradePay
登录wx.logincode2Sessionmy.getAuthCodealipay.system.oauth.token
绑定事件bindtaponTap
分享onShareAppMessagemy.shareAppMessage

常见陷阱

  1. 事件绑定语法:支付宝用 onTap 而非微信的 bindtap(但 Taro/uni-app 会自动处理)
  2. my.request 超时:默认超时 30s,建议设置合理超时时间
  3. 花呗分期接入:需要单独申请花呗分期能力,非默认开放
  4. 小程序云 vs 独立服务器:云开发适合快速验证,但复杂业务建议独立后端
  5. my.getAuthCodemy.getOpenUserInfo:两个 API 需分别调用,AuthCode 换 Token 在服务端完成

从微信迁移

使用 Taro 或 uni-app 等跨端框架时,通常只需处理以下差异:

  • 支付 API 替换(wx.requestPaymentmy.tradePay
  • 登录流程替换(wx.loginmy.getAuthCode
  • 微信特有能力降级(如 onShareTimeline 在支付宝不存在)

生态资源

推荐框架

框架支持度说明
Taro⭐⭐⭐支付宝端支持良好,支付宝也是 Taro 早期合作方
uni-app⭐⭐⭐内置支付宝适配,条件编译处理差异
Remax⭐⭐阿里出品,React 语法,支付宝端支持最好

推荐 UI 库

说明
Ant Design Mini蚂蚁出品,专为支付宝小程序设计
mini-ali-ui阿里出品,轻量级组件库
Vant AliappVant 的支付宝适配版

社区资源

版本更新

近期重要变更

  • TypeScript 支持:IDE 内置 TS 编译,无需额外配置
  • 小程序云 2.0:增强的 Serverless 能力,支持云函数、云数据库、云存储
  • 生活号关联:小程序可与生活号联动,获得信息流推荐
  • 多端投放:支持支付宝、口碑、饿了么等多端运行