Authorization: Bearer <access_token> 방식에 쓰는 토큰을 발급합니다. 기존 연동 호환용으로만 남아 있습니다.
신규 연동에는 쓰지 마세요. 모든 v1 API 는 요청마다
Authorization: Basic base64(clientKey:secretKey)로 호출할 수 있습니다. 토큰을 발급·갱신·보관할 필요가 없습니다. 자세한 내용은 인증을 봅니다.
POST /v1/request/token
액세스 토큰을 발급합니다. 같은 키로 발급한 유효한 토큰이 있고 만료까지 5분 넘게 남았으면 그 토큰을 그대로 돌려주고, 없거나 5분 이내로 남았으면 새로 발급합니다. 토큰 유효 시간은 발급 시각부터 30분입니다.
인증
둘 중 하나로 인증합니다.
Authorization: Basic base64(clientKey:secretKey)— 인증- (레거시)
Authorization헤더 없이 본문에server_key·private_key
필요한 scope: scope 검사 없음. 회원 JWT(Bootpay-User-JWT): 필요 없음.
요청
| 위치 | 이름 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|---|
| body | server_key | string | 헤더 없을 때 O | (레거시) 서버 키 | |
| body | private_key | string | 헤더 없을 때 O | (레거시) 프라이빗 키 |
응답
200 OK
{
"expire_in": 1800,
"access_token": "3f9a..."
}json| 필드 | 타입 | 설명 |
|---|---|---|
| access_token | string | Authorization: Bearer 에 넣을 토큰 |
| expire_in | integer | 만료까지 남은 초. 기존 토큰을 돌려줄 때는 1800 보다 작습니다 |
만료된 토큰으로 호출하면 404 TOKEN_NOT_FOUND 가 옵니다. expire_in 이 지나기 전에 다시 발급받으세요.
오류
| HTTP | error_code | 언제 |
|---|---|---|
| 404 | PROJECT_SERVER_KEY_INVALID |
server_key 가 없거나 없는 키 |
| 401 | PROJECT_PK_INVALID |
private_key 불일치 |
Basic 인증 오류·IP 차단·이용 중지 오류는 인증을 봅니다.
변경 이력
- 2026-09-23 문서 최초 작성
