Toss 登录
这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。
这是用于发放 OAuth2 token 的请求正文。
这是通过 OAuth2 认证流程发放的 Authorization Code。此代码会在用户完成认证后作为查询参数传递到重定向 URL。
SplxlOBeZQQYbYS6WxSbIA这是用户进入应用的来源路径。例如，表示通过深度链接、推送通知、应用内横幅等哪种路径使用了该功能。
deeplink请求成功，返回已颁发的令牌信息。
请求正文不符合格式。请在error.data.errorDetails中查看各字段详情。
未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。
POST /api-partner/v1/apps-in-toss/user/oauth2/generate-token HTTP/1.1
Host: apps-in-toss-api.toss.im
Content-Type: application/json
{
"authorizationCode": "SplxlOBeZQQYbYS6WxSbIA",
"referrer": "deeplink"
}{
"resultType": "SUCCESS",
"success": {
"accessToken": "ya29.A0ARrdaM9bZxZJ...",
"expiresIn": 3600,
"refreshToken": "1//0gdfg23rF9sds...",
"scope": "profile message:send",
"tokenType": "Bearer"
}
}这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。
这是包含 Bearer 形式 Access Token 的 Authorization 头值。Access Token 通过 获取 AccessToken API 颁发。
Bearer ya29.A0ARrdaM9bZxZJ...请求成功，查询到的用户个人资料信息会作为响应返回。部分项目可能会根据用户同意情况而为 null。
没有 Authorization 头。error.data 是空对象，error.reason 会以 Unknown Error 返回。
未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。
GET /api-partner/v1/apps-in-toss/user/oauth2/login-me HTTP/1.1
Host: apps-in-toss-api.toss.im
Authorization: Bearer {accessToken}{
"resultType": "SUCCESS",
"success": {
"agreedTerms": [
"tos_terms_1",
"privacy_policy"
],
"birthday": "19900101",
"callingCode": "82",
"ci": "aaf7cb53...",
"di": "b712df83...",
"email": "user@example.com",
"gender": "M",
"name": "홍길동",
"nationality": "KR",
"phone": "1012345678",
"scope": "profile message:send",
"userKey": 123456789
}
}这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。
这是使用已签发的 refresh token 重新签发 access token 的请求。
这是已签发的 refresh token。可使用该 token 请求新的 access token。
1//0gdfg23rF9sds...请求成功，返回重新颁发的 Access Token 相关信息。
请求正文不符合格式。请在error.data.errorDetails中查看各字段详情。
未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。
POST /api-partner/v1/apps-in-toss/user/oauth2/refresh-token HTTP/1.1
Host: apps-in-toss-api.toss.im
Content-Type: application/json
{
"refreshToken": "1//0gdfg23rF9sds..."
}{
"resultType": "SUCCESS",
"success": {
"accessToken": "ya29.A0ARrdaM9bZxZJ...",
"expiresIn": 3600,
"refreshToken": "1//0gdfg23rF9sds...",
"scope": "profile message:send",
"tokenType": "Bearer"
}
}这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。
这是包含用户 Access Token 的 Authorization 头值。Access Token 通过 获取 AccessToken API 颁发。
Bearer ya29.A0ARrdaM9bZxZJ...请求成功，已成功解除与 Access Token 对应用户的连接。
没有 Authorization 头。error.data 是空对象，error.reason 会以 Unknown Error 返回。
未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。
POST /api-partner/v1/apps-in-toss/user/oauth2/access/remove-by-access-token HTTP/1.1
Host: apps-in-toss-api.toss.im
Authorization: Bearer {accessToken}{
"resultType": "SUCCESS",
"success": {
"userKey": 123456789
}
}这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。
通过 UserKey 解除 OAuth2 用户连接请求
这是要解除连接的用户唯一标识符。用于在内部系统中识别用户。
123456789请求成功，基于 userKey 已解除连接的用户的 userKey 返回。
请求正文不符合格式。请在error.data.errorDetails中查看各字段详情。
未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。
POST /api-partner/v1/apps-in-toss/user/oauth2/access/remove-by-user-key HTTP/1.1
Host: apps-in-toss-api.toss.im
Content-Type: application/json
{
"userKey": 123456789
}{
"resultType": "SUCCESS",
"success": {
"userKey": 123456789
}
}这有帮助吗？