토큰 발급

POST /v2/oauth-apps/token 으로 인가 코드를 연결된 앱의 액세스 토큰으로 바꾸는 요청 형식, 클라이언트 인증, 응답 필드와 오류를 설명해요.

POST /v2/oauth-apps/token

파트너 서버에서 인가 요청으로 받은 인가 코드를 액세스 토큰으로 바꿔요. 요청과 응답은 OAuth 2.0(RFC 6749) 형식이에요. 페이싱크 v2 API의 {code, data} 형식을 쓰지 않아요.

요청 본문

본문은 application/x-www-form-urlencoded예요.

클라이언트 인증

둘 중 하나로 해요.

• Authorization: Basic <base64(client_id:client_secret)> 헤더. 이 헤더가 있으면 본문의 client_id, client_secret은 보지 않아요.
• 본문의 client_id와 client_secret

요청 예시

curl -X POST https://api.paysync.kr/v2/oauth-apps/token \
  -u "$PAYSYNC_CLIENT_ID:$PAYSYNC_CLIENT_SECRET" \
  -d grant_type=authorization_code \
  -d code="$CODE" \
  --data-urlencode redirect_uri=https://partner.example.com/paysync/callback \
  -d code_verifier="$CODE_VERIFIER"

const res = await fetch("https://api.paysync.kr/v2/oauth-apps/token", {
  method: "POST",
  headers: {
    Authorization: "Basic " + Buffer.from(`${clientId}:${clientSecret}`).toString("base64"),
  },
  body: new URLSearchParams({
    grant_type: "authorization_code",
    code,
    redirect_uri: "https://partner.example.com/paysync/callback",
    code_verifier: codeVerifier,
  }),
});
const token = await res.json();

import os
import requests

res = requests.post(
    "https://api.paysync.kr/v2/oauth-apps/token",
    auth=(os.environ["PAYSYNC_CLIENT_ID"], os.environ["PAYSYNC_CLIENT_SECRET"]),
    data={
        "grant_type": "authorization_code",
        "code": code,
        "redirect_uri": "https://partner.example.com/paysync/callback",
        "code_verifier": code_verifier,
    },
)
token = res.json()

URLSearchParams 본문과 requests의 data는 Content-Type: application/x-www-form-urlencoded로 보내져요.

응답

성공하면 HTTP 200과 아래 JSON이 와요. 응답에는 Cache-Control: no-store 헤더가 붙어요.

{
  "access_token": "oat_7v2m9q4k1x8c3n6b5z0p2w7r4t9y1u3i8o5a6s2d",
  "token_type": "Bearer",
  "scope": "invoices:read transactions:read",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8i9j0k1l2"
}

액세스 토큰에는 만료가 없고, 리프레시 토큰도 없어요. 고객이 연결을 끊거나 다시 연결할 때까지 같은 토큰을 써요. 토큰은 고객의 API 키와 같은 무게로 다루세요. 서버의 비밀 저장소에 두고, 로그나 브라우저에 남기지 마세요.

같은 워크스페이스에서 다시 연결해 새 토큰을 받으면 이전 토큰은 바로 멈춰요. 자세한 내용은 연결이 끊기거나 다시 연결될 때를 참고하세요.

오류는 { "error": "..." } 형식이에요.

{
  "error": "invalid_grant"
}

{
  "error": "unsupported_grant_type"
}

{
  "error": "invalid_request"
}

{
  "error": "invalid_client"
}

오류

invalid_grant가 오면 같은 코드로 다시 시도하지 말고 인가 요청부터 다시 시작하세요.