开始使用
ampe
多端开发
插件
安全
openid 开发指南
openid 概览
自研开发
服务商开发
存量 userid 转换 openid
扩展能力
开发 > 指南 > openid 开发指南 >  > openid 简介
收藏
订阅更新
我的文档
设置

公告openid 目前已经全面对客开放,openid 相关字段请在公开的 api 文档中查看。

openid 标准目前会对新增 appid 进行灰度,灰度中应用原有涉及 userid 的接口将会支持 openid,详情可查看 。未处于灰度中的应用可查看 openid 配置申请 进行自助申请。

页面配置操作:登录 开放平台控制台 > 应用详情页 > 开发设置 > openid配置管理 点击 设置 进行查看/修改应用openid 用户标识。

说明:如暂时无法支持 openid 标准,可选择回退至 userid 标准,操作详情可查看 。

uid 作为支付宝系统内标,在数字化业务开放过程面临着不断升级要求,为了减少开发者适配改造成本,支付宝将统一提供 openid 作为稳定且唯一的用户的标识。同时支付宝还将围绕 openid 不断开放 棋盘密云小橱窗 等一系列特色营销产品能力,帮助商家更好的进行数字化升级。

openid 相比 userid 的优势

  • 用户在应用下的标识后续将统一切换到 openid,系统内部标识 userid 会进行升位扩展。
  • 尽早使用 openid 可以避免 userid 变更产生的影响,开发成本更低。
  • 棋盘密云、会员营销等新产品仅支持 openid。
    注意支付宝未来推出的新产品将只支持 openid

openid 覆盖的开放能力范围

目前支付宝开放平台所有产品能力都支持 openid。

类型

概念

appid

appid 是支付宝开放平台应用的唯一标识。

  • 例如:小程序的 appid、网页移动应用的 appid、生活号的 appid、第三方应用的 appid 等。

openid

openid 是支付宝用户在应用维度下的唯一标识。

  • 支付宝用户访问小程序、网页移动应用、生活号等应用,会产生唯一的 openid。并且对于同一用户,不同应用的 openid 是不同的。
  • 例如,对于不同小程序,同一用户的 openid 不同;同理,对于不同的网页移动应用,同一用户的 openid 也是不同的。

unionid

unionid 是支付宝用户在应用分组下的唯一标识,用于跨应用识别用户。

  • 如果开发者在支付宝开放平台有多个应用(包括小程序、生活号、网页/移动应用等),可以根据 unionid 识别多个应用下的唯一用户。
  • 有关应用分组:每个商家账号对应一个唯一的应用分组,可以将需要联动管理的应用绑定到应用分组中;所有绑定到应用分组中的应用,可以通过调用接口获取到同一个 unionid。
  • 例如,同一用户,对于某一支付宝商家账号的应用分组中的不同应用,unionid 是相同的。

关于实现应用间的数据互通的流程,可查看 。

userid

支付宝用户系统内部标识,后续将不再独立开放,以 openid 替换。

","id":"fcumz","rows":5,"cols":2,"hideborder":false}" id="fcumz">

类型

概念

appid

appid 是支付宝开放平台应用的唯一标识。

  • 例如:小程序的 appid、网页移动应用的 appid、生活号的 appid、第三方应用的 appid 等。

openid

openid 是支付宝用户在应用维度下的唯一标识。

  • 支付宝用户访问小程序、网页移动应用、生活号等应用,会产生唯一的 openid。并且对于同一用户,不同应用的 openid 是不同的。
  • 例如,对于不同小程序,同一用户的 openid 不同;同理,对于不同的网页移动应用,同一用户的 openid 也是不同的。

unionid

unionid 是支付宝用户在应用分组下的唯一标识,用于跨应用识别用户。

  • 如果开发者在支付宝开放平台有多个应用(包括小程序、生活号、网页/移动应用等),可以根据 unionid 识别多个应用下的唯一用户。
  • 有关应用分组:每个商家账号对应一个唯一的应用分组,可以将需要联动管理的应用绑定到应用分组中;所有绑定到应用分组中的应用,可以通过调用接口获取到同一个 unionid。
  • 例如,同一用户,对于某一支付宝商家账号的应用分组中的不同应用,unionid 是相同的。

关于实现应用间的数据互通的流程,可查看 。

userid

支付宝用户系统内部标识,后续将不再独立开放,以 openid 替换。

为了避免开发者混淆这几个关键的概念,可参考下面的图例理清关系。

注意:实例中的 appid 属于支付宝内部测试应用,仅用于说明 openid 相关概念,请勿将其用于其它商业行为。

openid 示例

商家账号 a 下,拥有小程序应用 1(appid1=2021003146694026)。

商家账号 b 下,拥有生活号应用 2(appid2=2021003163674018)。

支付宝用户 1 和支付宝用户 2 访问不同的应用时返回的 openid 情况如下:

  • 支付宝用户 1 访问小程序应用 1 时,返回 openid1=084y_69bghbvbmhgjh5dhvzac5jadyz95zyc50sqq25pqk7
  • 支付宝用户 2 访问小程序应用 1 时,返回 openid2=042y_69bghbvbmhgjh5dhvzad_gl9ujnvxtegonzltw7pya
  • 支付宝用户 1 访问生活号应用 2 时,返回 openid3=084kdksybzhbed_lwiwd6gj3uqupkmafn1mkunprrczkuk9
  • 支付宝用户 2 访问生活号应用 2 时,返回 openid4=042kdksybzhbed_lwiwd6gj3ic25rvnnkzqycz6mb98hv46

不同用户访问不同的开放平台应用,返回的 openid 是不同的。

unionid 示例

商家账号 a 下,拥有小程序应用 1(appid1=2021003146694026) 和生活号应用 2(appid2=2021003146626065),并将两个应用都绑定到了自己账号的应用分组中。

商家账号 b 下,拥有小程序应用 3(appid3=2021002113608014)和网页应用 4(appid4=2021003162631218),小程序应用 3 未绑定到任何应用分组中,网页应用 4 绑定到了自己账号的应用分组中。

支付宝用户 1 访问不同的应用时返回的 unionid 差异如下:

  • 访问商家账号 a 的小程序应用 1 和生活号应用 2 时,返回相同的 unionid1=084brgpjzsffon5eugozywfn3glphaweuorbbuk_iwjzg83
  • 访问商家账号 b 的小程序应用 3 时,因应用不在任何应用分组中,不返回 unionid。
  • 访问商家账号 b 的网页应用 4 时,返回 unionid2=084xkwfh-2jy9iwdqteyy5csyeekk08azcxqbxwcxfeiqi8
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图