换取授权访问令牌

开发环境

POST

/v3/alipay/system/oauth/token

换取授权访问令牌

错误码

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	isv.grant-type-invalid	grant_type参数不正确	grant_type必须是authorization_code、refresh_token二者之一若传入authorization_code为code换取令牌，若传入refresh_token为刷新令牌
400	isv.code-invalid	授权码(auth_code) 错误、状态不对或过期	使用有效的auth_code重新执行令牌换取，或引导用户重新授权
400	isv.refresh-token-invalid	刷新令牌(refresh_token)错误或状态不对	使用有效的refresh_token重新执行令牌刷新，或引导用户重新授权
400	isv.refresh-token-time-out	刷新令牌(refresh_token)过期	使用有效的refresh_token重新执行令牌刷新，或引导用户重新授权
400	isv.refreshed-token-invalid	刷新出来的令牌无效	使用返回的刷新令牌再次刷新
400	isv.unmatched-app-id	调用接口的应用标识(app_id)与令牌授权的应用不相符	传入正确的app_id和令牌，若开发者支付宝账号名下有多个app_id，或者开发者管理多个归属于不同支付宝账号的app_id，请注意不要混用不同app_id的code
400	isp.unknow-error	未知错误	重试，或联系支付宝客服

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/system/oauth/token' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"grant_type":"authorization_code",
	"code":"4b203fe6c11548bcabd8da5bb087a83b",
	"refresh_token":"201208134b203fe6c11548bcabd8da5bb087a83b"
}'

响应示例

{
  "user_id": "2088102150477652",
  "access_token": "20120823ac6ffaa4d2d84e7384bf983531473993",
  "expires_in": "3600",
  "refresh_token": "20120823ac6ffdsdf2d84e7384bf983531473993",
  "re_expires_in": "3600",
  "auth_start": "2010-11-11 11:11:11"
}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

grant_type

string

必需

授权方式枚举值用授权码来换取授权令牌: authorization_code 用刷新令牌来换取一个新的授权令牌: refresh_token

code

string

必需

授权码，用户对应用授权后得到。本参数在 grant_type 为 authorization_code 时必填；为 refresh_token 时不填。

refresh_token

string

必需

刷新令牌，上次换取访问令牌时得到。本参数在 grant_type 为 authorization_code 时不填；为 refresh_token 时必填，且该值来源于此接口的返回值 app_refresh_token（即至少需要通过 grant_type=authorization_code 调用此接口一次才能获取）。

示例

返回响应

🟢200成功

application/json

Body

user_id

string

必需

支付宝用户的唯一标识。以2088开头的16位数字。

access_token

string

必需

访问令牌。通过该令牌调用需要授权类接口

expires_in

string

必需

访问令牌的有效时间，单位是秒。

refresh_token

string

必需

刷新令牌。通过该令牌可以刷新access_token

re_expires_in

string

必需

刷新令牌的有效时间，单位是秒。

auth_start

string

可选

授权token开始时间，作为有效期计算的起点

修改于 2023-11-23 02:14:47

芝麻先享信用服务订单状态变更通知

统一收单交易支付接口

换取授权访问令牌

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码