认证中心机制

AuC: 授权中心机制。
DiDi BNPL 正在使用JWT_Token授权机制来识别机构身份。

AuC 工作流程

BNPL api docs图 version 1_中文版-part2 - AuC Work Flow.jpg

1. 获取秘钥阶段

机构向DiDi申请Client_id和Client_secret。
可通过您的商务同学，联系DiDi工作人员进行client_id和client_secret的获取。

P.S.如果client_id和client_secret暴露了，请直接联系滴滴BD团队，询问滴滴团队:

丢弃旧的client_id和client_secret。
生成新的client_id和client_secret。

这将是滴滴团队的当务之急。滴滴团队会优先处理，并立即更改。

2. ACCESS-TOKEN

2.1 The Token Expiration Flow

您应该使用"POST /external/oauth2/token" 来获取ACCESS-TOKEN。
此ACCESS-TOKEN将在10分钟后过期。无论您是否生成新的ACCESS-TOKEN，ACCESS-TOKEN都将在10分钟后失效（有效期10分钟）。
我们建议集成方（机构 or 合作伙伴）可以设置一个机制，在十分钟内来获取下一个ACCESS-TOKEN，例如9分钟和30秒。

BNPL api docs图 version 1_中文版-part2 - The Token Expiration Flow.jpg

我们在这个SDK中也包含了这个逻辑。您可以使用我们的SDK来实现此过期时间控制功能。

2.2 令牌 API 请求

Path: /external/oauth2/token

Method: POST

Header

字段名称	字段说明	参数值	展示 (必填/选填/条件性)	备注
Content-Type	内容类型	application/x-www-form-urlencoded	必填
X-Paylater-Request-Id	幂等键（uuid）	e.g., "f81d4fae-7dec-11d0-a765-00a0c91e6bf6"	必填	必须是带连字符的小写UUID字符串。使用大写字母或缺失连字符的请求将被拒绝。

Body

字段名	类型	字段描述	展示 (必填/选填/条件性)
grant_type	String	授权类型。固定值: client_credentials	必填
client_id	String	您从 "客户端集成阶段" 获得的client_id。	必填
client_secret	String	您从 "客户端集成阶段" 获得的client_secret。	必填

2.3 令牌 API 响应

Header

字段名称	字段说明	参数值	展示 (必填/选填/条件性)	备注
Content-Type	内容类型	application/x-www-form-urlencoded	必填

Body

字段名称	类型	字段描述	展示 (必填/选填/条件性)
access_token	String	access_token信息。您应该将此值放入请求标头的授权字段中。	必填
token_type	String	令牌的类型。通常，它将是承载访问令牌。	必填
expires_in	Integer	过期时间。我们将其设置为600秒。这意味着access_token将在600秒后过期。	必填
scope	String	access_token应用范围。现在，它是固定值：全部。	必填

3. API调用阶段

对于每个API，请将access_token插入到请求头的Authorization字段中。
具体请参考其他的API接口。

文档中心