开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
公域产品
营销产品
商家券 2.0
商家会员卡
红包
棋盘密云
支付券
芝麻实力标
api 列表
资金产品
会员产品
信用产品
安全产品
广告产品
开发 > 服务端 >  >  > 接入指南
收藏
订阅更新
我的文档
设置
完成 后,商家/服务商可根据本文指引快速接入 芝麻实力标
说明:
芝麻实力标 仅支持自研商家/服务商通过 自研应用第三方应用 代调用方式,调用 api 接入。
芝麻实力标 支持沙箱调试。
完整接口时序图

实力标预查询
在合作平台正式获取实力标之前,可以先通过 调用以查询该企业名下是否有可展示的实力标,以及企业名下是否有需要授权后才可作展示的实力标等信息。即用于合作平台查询该企业主是否已开通授权过实力标服务、是否有实力标、可(公开)展示的实力标样例、和企业名下实力标的展示相关状态。
示例代码
接口返回的使用说明
如果 label_show_type标签展示类型)为 displayable可展示),说明企业名下有可展示的标签,平台可以选择拉起 sdk 插件。
同时,如果企业名下标签待获取数量大于 0,平台侧可以通过芝麻企业信用提供的引导页跳转 或者 直接拉起支付宝app > 芝麻企业信用 > 实力标签管理页,企业的法定代表人用户可查看并管理名下的实力标,通过企业主管理后的标签内容也会由平台侧接入的 sdk 插件进行同步展示。
如果企业名下全部标签数量大于公开标签数量并且是未授权状态,平台侧可以通过芝麻企业信用提供的引导页跳转至支付宝企信授权页面或实力标签管理页,企业的法定代表人用户完成授权或者管理后,平台侧接入的 sdk 插件进行同步展示。
如果 label_show_type标签展示类型)为 management_displayable(管理后可展示),需要先引导企业的法定代表人用户可管理名下的实力标,再展示 sdk 插件。
如果 label_show_type标签展示类型)为 auth_displayable(授权后可展示),同样通过芝麻企业信用提供的引导页会跳转到支付宝企信实力标授权页,企业的法定代表人用户完成授权即可在 sdk 插件进行同步展示企业名下全量标签。
如果label_show_type标签展示类型)为 not_displayable(不可展示),说明企业名下没有标签。
获取实力标
平台商户在  签约 产品成功之后,通过接入服务端接口及前端 sdk 插件,面向平台上的企业商户或者企业用户进行实力标服务的开通和授权,并获取实力标在页面上进行展示。
产品签约成功之后,在调用接口之前,需要先通过支付宝企业账号登录 进行实力标前端 sdk 插件的相关属性配置,并以此获取到企业信用分配的场景码,再进行接口调用。
时序图

合作平台商户在获取某企业名下的实力标签,在交互链路上主要分为两种情况:
1若平台侧在接口调用时,对于指定企业未开通授权或平台侧未指定企业的情况下,平台侧需通过芝麻企业信用提供的引导页跳转至或者直接拉起支付宝 app > 芝麻实力标开通授权页面,在该页面需要该企业的法定代表人用户完成芝麻实力标服务的开通及授权,平台侧才可完整的获取到该企业的实力标签并在 sdk 做展示。
2若平台侧在接口调用时,指定的企业已开通授权的情况,平台侧也可以通过芝麻企业信用提供的引导页跳转至或者直接拉起支付宝 app > 芝麻企业信用 > 实力标签管理页,企业的法定代表人用户可查看并管理名下的实力标,通过企业主管理后的标签内容也会由平台侧接入的 sdk 插件进行同步展示。
平台企业主开通授权流程:

服务受理初始化
商户调用  完成初始化。
示例代码:
说明场景码 scene_code 在商户自助配置完成后返回,和 appid 一一对应。即商户在  签约 企业实力标签 产品成功之后,再通过支付宝企业账户登录 进行实力标展示 sdk 的相关属性配置。配置完成之后,即会自动分配场景码 scene_code

特别参数说明:
如果商户需要指定企业,需要同时传入正确的企业账号(企业统一社会信用代码)和企业名称
商户在进行调用时,可指定从 支付宝 app > 芝麻实力标开通授权页面 成功之后的回跳地址。
商户设备类型( pc 或者移动端)是用来控制返回前置引导页的渲染格式,如果商户在接入配置时不需要前置引导页,页面申请接口会返回小程序地址直接跳转。
前置引导页/受理页面地址获取
前置引导页的地址可在 zhima.credit.ep.acceptance.apply(芝麻企业信用受理页面申请)接口中获取对应的引导页面地址或者支付宝小程序的跳转地址。
若配置了开通前置引导页,商户在初始化受理传 devicetype 可指定设备类型( pc 或者移动端),从而返回对应的页面链接。
若商户页面是 pc 页面时,可在页面的实力标开通入口点击时跳转至企信提供的 开通前置引导pc,页面中会展示可扫码跳转至支付宝 app 的二维码。
若商户页面是 h5 或者 app 页面时,可在页面的实力标开通入口点击时直接拉起 支付宝 app 进入芝麻企业信用的受理台页面,进行实力标服务的开通及授权。
若未开通前置引导页,则直接返回支付宝小程序跳转地址,即支付宝 app 芝麻企业信用受理台页面。
请求参数biz_no受理单号),在  中获取。
示例代码:
返回地址-小程序受理台页面链接打开方式
未开通前置引导页时,返回的链接需要引导用户通过支付宝打开,不支持 h5 和 web 浏览器网页访问。
宿凯发k8官方网娱乐官方主页面为支付宝小程序
宿凯发k8官方网娱乐官方主页面为 app
对于 app 端需要按规则拼接一个 landing 页的地址并引导用户打开此 url。landing 页是连接支付宝站外 h5,第三方应用与支付宝钱包 app 的桥梁,是全站公用的中转页面。
若商户能自行判断用户是否已安装支付宝,可直接拼接 alipays 开头 scheme,避免经过一层中转页
返回地址—开通前置引导 pc/h5 页打开方式
开通了前置引导页时,用浏览器打开返回链接即可。
pc版页面示例
在该页面中,用户通过支付宝扫描二维码即可进入支付宝小程序完成服务开通。

移动版h5页面示例
在该页面中,支持用户点击底部按钮拉起支付宝小程序,或者通过吱口令的形式打开支付宝小程序,完成服务开通。

展示实力标
商户在服务端接入接口之后,还需要在前端页面中嵌入企业实力标签的页面或展示 sdk 插件,才能将该企业名下的实力标签内容展示。
实力标的展示形式包括两种:
一种是可直接在平台页面中嵌入二级页面芝麻实力标 h5 页面。目前主要适配于移动端,可支持在 app 、支付宝小程序、微信小程序中直接嵌入该页面。
另一种则是在平台页面中的特定区域中嵌入芝麻实力标 sdk 插件,目前主要是列表式的插件,可至多展示 2 行或 3 行的标签内容。
时序图

实力标 h5 页面
中返回的 assessurl 即 h5 形式的实力标详情页,移动端浏览器打开即可,可直接将页面嵌入至客户侧的手机端内。

实力标 sdk 嵌入式插件
中返回的 accesstoken 可用于实力标插件接入鉴权。在平台页面中的特定区域中嵌入 芝麻企业信用服务插件可展示企业名下的实力标签内容,插件分 多行卡片 单行卡片 两种标签展示方式。插件接入流程如下。
使用示例
多行卡片

单行卡片
单行单标签

单行多标签

接入插件
商家可根据使用场景,选择不同的方式接入。
支付宝小程序接入
web页面/h5页面接入
支付宝小程序接入
接入须知
使用此插件前,请进入 页面订购插件。完成插件订购并绑定主体小程序后,可使用插件,详见 插件使用文档
支付宝版本要求 10.1.92 及以上,小程序的最低基础库版本要求 2.7.16 及以上。配置操作详情可查看 配置最低基础库版本
小程序插件只支持在小程序中使用,不支持在小程序插件中使用小程序插件。
声明插件
在小程序项目的根目录 app.json中声明使用插件。
示例中的epserviceplugin为插件引用名,可自定义。
version:指定插件版本号。建议使用 * ,自动选择最新版本,后续插件更新宿主无需改动。
provider:插件 id,固定 2021004122659594。
展示插件
商家可根据嵌入页面样式选择不同的展示方式。
展示方式
组件名
多行卡片
label-card
单行卡片
label-tag
具体属性见下方 参数说明
web/h5页面接入
展示方式
组件名
多行卡片
crediteplabelcard
单行卡片
crediteplabeltag
安装sdk
通过 npm 安装。
引入sdk
首先,请在您的 html 结构中预留一个空节点,并赋给一个 id 属性,例如。
然后,在您的 js 代码中,引入 @ant-credit/atome-web-sdk。
展示插件
按以下顺序进行组件调用和渲染。
注意: accesstoken 在这里不作为组件的属性,用于初始化sdk。具体属性见下方 参数说明
参数说明
多行卡片
属性
描述
是否必须
类型
备注
accesstoken
鉴权token

string
accesstoken 有效期 24 小时,过期后将展示无标签的空状态,可通过 onee 监听包含'token'的错误码并重新请求 accesstoken 渲染组件
merchantid
商户id

string
-
scenecode
商户场景

string
-
companyid
企业id

string
-
maxlabelline
最大显示行数

number
默认 3,支持 1、2、3
showlabelicon
是否显示实力标icon

boolean
默认 true
extratext
右上角文案

string
-
onextraclick
右上角文案点击回调

()=>void
建议点击后跳转至企业信用提供的详情页,若无点击后的行为,建议不要设置 extratext 字段
onee
错误回调

(data:{code:string}) => void
建议处理 code 中包含'token'的错误码,代表
accesstoken 失效,需要重新请求 accesstoken
并渲染组件
单行卡片
属性
描述
是否必须
类型
备注
accesstoken
鉴权token

string
accesstoken 有效期 24 小时,过期后将展示无标签的空状态,可通过 onee 监听包含 'token' 的错误码并重新请求 accesstoken 渲染组件
merchantid
商户id

string
-
scenecode
商户场景

string
-
companyid
企业id

string
-
mode
展示模式

'carousel' | 'multiple' |
single''
carousel:跑马灯模式(默认)
multiple:多个标签平铺展开
single: 只展示1个标签
onee
错误回调

(data:{code:string}) => void
建议处理 code 中包含'token'的错误码,代表
accesstoken 失效,需要重新请求 accesstoken
并渲染组件
订阅实力标变动通知
主要面向平台侧,在接入企业实力标签产品后,可通过  接口获取历史所调用过的企业名下实力标数量增减或者内容变动的情况。使用该接口之前仔细阅读 蚂蚁消息服务,了解清楚 重试策略说明
java版本demo
支付宝实际推送的数据格式如下所示:
事件码枚举
扩展功能
说明:此部分接口适用于与芝麻企业信用合作克莱因瓶项目 cpa 模式的三方平台,即三方平台与芝麻企业信用进行商业流量合作,在芝麻企业信用小程序内进行商业投放以获取用户流量或用户授权数据,如需使用请提前联系芝麻企业信用业务人员。
业务流程

1三方平台在芝麻企业信用小程序内完成克莱因瓶项目的 cpa 商业服务投放。
2用户点击投放的商业服务,芝麻企业信用会前置判断该用户是否已完成过对当前三方平台的授权。 说明:授权项包括企业及法人的基本 5 要素信息(如企业名称/企业统代/企业法人姓名、身份证、凯发k8官方网娱乐官方的联系方式等),以及额外附加信息(如企业营业执照照片、企业经营场所照片等,需业务定制)。
a已授权:将自动跳转至三方平台投放的落地页。
b未授权:拉起 前置授权弹窗,用户点击 同意并授权 后,会跳转至三方平台的落地页。
3三方平台基于落地页获取的信息判断是否为目标用户。
a是目标用户:调用如下接口以获取完整数据,三方平台需底层静默一键帮用户完成账号注册及企业身份认证,并将结果回传至芝麻企业信用。
b非目标用户:则无需再调用如下接口。
时序图
验证是否目标用户
用户点击广告后补充授权信息并跳转至三方平台落地页,三方平台根据落地页中的企业两要素(统一社会信用代码或营业执照注册号 企业名称),验证是否为目标用户。
参数英文名
参数描述
参数示例
zmepauthno
关联芝麻企业信用业务单号
zmepauthno=auth2024091015302605016758
zmepcrn
统一社会信用代码或营业执照注册号
zmepcrn=91330000327827106l
zmepcname
企业名称
zmepcname=xxx
小程序
页面地址
取值方法
h5
页面地址
取值方法
完成认证开户
若三方平台判断为目标用户可调用获取用户完整授权数据(如法人信息、凯发k8官方网娱乐官方的联系方式等),依据用户授权的数据引导用户快速注册认证,业务流程上建议通三方平台通过获取的授权数据直接底层静默一键完成账户注册及企业身份认证,以减少前端交互流失。
请求示例
同步认证结果
用户在三方平台完成认证后,三方平台需调用将结果同步至芝麻企业信用。(用户账号在平台的权益等信息发生变化,也可通过该接口实时同步)
请求示例
批量同步平台账户信息
当存在需要批量同步用户信息的场景时,平台可通过接口将信息同步至芝麻企业信用。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图