# API02009: 리프레시 토큰 만료

## 의미[​](#what-this-means "의미으로 직접 링크")

리프레시 토큰의 유효 기간이 만료되어 더 이상 새로운 액세스 토큰을 얻는 데 사용할 수 없습니다. 액세스 토큰(빠르게 만료됨)과 달리 리프레시 토큰은 보통 며칠 또는 몇 주 동안 유효하지만 결국 만료됩니다.

## 일반적인 원인[​](#common-causes "일반적인 원인으로 직접 링크")

* **장기간 비활성 상태** — POS를 오랫동안 사용하지 않음
* **짧은 토큰 유효 기간** — 짧은 리프레시 토큰 만료로 서버가 구성됨
* **시간 차이** — 장치 또는 서버 시간이 크게 어긋남

## 해결 방법[​](#how-to-fix "해결 방법으로 직접 링크")

### 1. 다시 로그인[​](#1-log-in-again "1. 다시 로그인으로 직접 링크")

리프레시 토큰이 만료되면 다시 인증해야 합니다:

1. POS에서 로그아웃
2. 자격 증명을 입력
3. 새로운 리프레시 토큰이 발급됩니다

### 2. POS를 정기적으로 사용[​](#2-use-pos-regularly "2. POS를 정기적으로 사용으로 직접 링크")

앞으로 이를 피하기 위해:

* 토큰을 신선하게 유지하기 위해 POS를 정기적으로 사용
* 활성 상태일 때 자동으로 토큰이 새로 고쳐짐
* 장기간 비활성 상태일 경우 다시 로그인해야 함

### 3. 시간 설정 확인[​](#3-check-time-settings "3. 시간 설정 확인으로 직접 링크")

모든 시스템에서 정확한 시간을 보장합니다:

* 장치에서 자동 시간 동기화를 활성화
* 서버 시간이 올바른지 확인
* 시간 차이는 조기 만료를 초래할 수 있음

### 4. 토큰 유효 기간 조정(고급)[​](#4-adjust-token-lifetime-advanced "4. 토큰 유효 기간 조정(고급)으로 직접 링크")

토큰이 필요에 비해 너무 빨리 만료되는 경우, 서버 관리자는 인증 설정에서 리프레시 토큰 유효 기간을 조정할 수 있습니다.

## 관련 오류[​](#related-errors "관련 오류으로 직접 링크")

* [API02002](/ko/error-codes/API02002.md) — 토큰 만료
* [API02007](/ko/error-codes/API02007.md) — 토큰 새로 고침 실패