更新记录

1.0.0(2026-10-19)

首次发布。Android 调用支付宝极简授权,用户同意后自动回到 App,回调中返回 auth_code。


平台兼容性

支付宝原生授权登录

原生唤起支付宝授权。用户在支付宝里同意后,支付宝会直接回到当前 App,回调里返回 auth_code。

支持 Android 和 iOS。需要使用 HBuilderX 云打包,标准基座不能调用。

引入

在 HBuilderX 中打开 manifest.json,进入 App 原生插件配置,选择云端插件 LiaoX-AlipayAuth。

云打包时的 Android 包名,必须和插件绑定的包名一致。iOS 的 Bundle ID 填在 manifest 的 iOS 配置里,并在插件配置中绑定同一个 Bundle ID。

iOS 的 URL Types 填 liaoxauth。Android 的 UrlSchemes 不要填 liaoxauth。

不要同时勾选其他支付宝授权插件,多个插件会抢同一个回跳页面。

开放平台

在支付宝开放平台对应应用中配置:

  • Android 包名:与云打包包名一致
  • Android 应用签名:当前安装包的证书 MD5,32 位小写,不要冒号
  • iOS Bundle ID:与云打包 Bundle ID 一致
  • iOS URL Scheme:liaoxauth
  • 授权回调地址的强校验:关闭。原生授权不走网页回调地址

接口加签的 RSA 公钥不用改。

调用

const plugin = uni.requireNativePlugin('LiaoX-AlipayAuth')
plugin.login({
  appId: '你的支付宝APPID',
  scope: 'auth_user',
  state: 'init'
}, (res) => {
  // res.resultCode === 9000 且 res.auth_code 有值,表示授权成功
  console.log(res.resultCode, res.auth_code, res.memo)
})

appId 必填,填写支付宝分配给应用的 APPID。

回调

字段 含义
resultCode 9000 成功,4001 未安装支付宝,5000 调用太频繁,4000 其他错误
auth_code 授权成功时返回,交给服务端换取用户标识
result_code SUCCESS 或 CANCEL
memo 失败说明

回跳协议已写在插件内,固定为 liaoxauth。Android 不要把 liaoxauth 填到应用自己的 UrlSchemes。iOS 要在 manifest 的 URL Types 里填写 liaoxauth,否则支付宝无法回到 App。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android.permission.INTERNET android.permission.ACCESS_NETWORK_STATE android.permission.ACCESS_WIFI_STATE 用于唤起支付宝并完成授权时的网络连接和网络状态判断。不申请相机、定位、通讯录、短信、电话等权限。iOS 端由同一套支付宝 SDK 采集 IDFV 等设备信息,说明见 https://opendocs.alipay.com/common/067o75

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件本身没有自建服务器,授权结果 auth_code 只回调给宿主 App,由宿主 App 自行处理。插件集成的 App 支付宝客户端 SDK(支付宝支付科技有限公司)会向支付宝服务器发送完成授权所需的信息,包括 AndroidID、OAID、传感器列表、设备屏幕密度、运营商信息、WIFI 参数、网络类型,以及应用包名。用途是完成支付宝授权,保障账户与服务安全稳定运行,履行反洗钱、反恐怖融资、反电信网络诈骗等法定义务,并优化网络链路。隐私说明:https://opendoc.alipay.com/common/067qfo

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。