장바구니·마이페이지·주문 내역처럼 구매자 본인의 데이터를 다루는 API 는 프로젝트 인증(Basic)에 더해 회원 JWT 를 받습니다.
Authorization: Basic base64(clientKey:secretKey)
Bootpay-User-JWT: <회원 로그인 시 받은 JWT>받는 방법
회원 로그인 API(POST /v1/users/login, 서버용 POST /v1/users/login/token)가 응답으로 JWT 를 돌려줍니다. 가입 API 는 JWT 를 주지 않으므로 가입 후 로그인을 한 번 더 합니다. 자세한 내용은 회원 문서를 봅니다.
JWT 와 user_id
인증 절에 회원 JWT 만 적힌 API 는 JWT 가 가리키는 회원으로 처리합니다.
인증 절에 JWT 또는 user_id 로 적힌 API 는 둘 중 하나만 보내면 됩니다.
- 둘 다 보내면 JWT 가 우선입니다.
user_id가 JWT 와 다른 회원을 가리키면 403USER_NOT_MATCH로 거절합니다. user_id는 secretKey 인증(Basic·Bearer)일 때만 받습니다. 규칙은 인증 — 호출 구조를 봅니다.
예외로 GET·DELETE /v1/users/session 은 대상이 회원이 아니라 "이 JWT 세션"이라 JWT 전용입니다. user_id 계열 키를 보내면 400 API_PARAM_INVALID 로 거절합니다.
회원 JWT 를 쓰지 않고 user_id 로만 회원을 받는 API 도 있습니다. 어느 쪽이든 값은 쇼핑몰 서버가 자기 로그인 세션에서 꺼내 넣습니다.
필수 / 선택
각 엔드포인트 문서의 인증 절에 표시합니다.
- 필수: JWT 가 없거나 유효하지 않으면 401 로 거절합니다.
- 선택: JWT 가 있고 유효하면 회원 기준 정보(예: 내가 누른 도움돼요)를 채우고, 없거나 무효면 비회원으로 처리합니다. 오류를 내지 않습니다. 무효 JWT 와 함께
user_id를 보냈으면(secretKey 인증) 비회원 대신 그 회원으로 처리합니다.
오류 (필수인 API)
| HTTP | error_code | 언제 |
|---|---|---|
| 401 | USER_SESSION_INVALID |
헤더가 없음, 로그아웃·만료·탈퇴한 세션, 다른 프로젝트의 회원 |
| 401 | USER_JWT_INVALID |
서명이 맞지 않거나 변조됐거나 만료된 JWT |
| 403 | USER_NOT_MATCH |
JWT 와 user_id 를 함께 보냈는데 서로 다른 회원 |
USER_JWT_INVALID 를 받으면 다시 로그인해 새 JWT 를 받으세요.

