API02003: 토큰 유효하지 않음
이것이 의미하는 바
사용 중인 인증 토큰이 서버에서 인식되지 않습니다. 이는 만료된 토큰과는 다른 것으로, 이 토큰은 처음부터 유효하지 않거나 취소되었습니다.
일반적인 원인
- 토큰 취소됨 — 관리자가 세션을 취소했습니다.
- 토큰 손상됨 — 저장 또는 전송 중 데이터 손상
- 서버 재설정 — 서버 비밀 키가 변경되어 모든 토큰이 무효화됨
- 잘못된 서버 — 다른 WordPress 설치에서 가져온 토큰
서버 오류 매핑
이 오류 코드는 서버가 다음을 반환할 때 발생합니다:
| 서버 코드 | 출처 |
|---|---|
jwt_auth_invalid_token | JWT 인증 플러그인 |
해결 방법
1. 다시 로그인
세션을 지우고 새로 인증하세요. 이 기기에 매장에 도착하지 않은 판매가 있을 수 있다면 먼저 2단계의 경고 내용을 확인하세요:
- 완전히 로그아웃합니다.
- POS를 닫고 다시 엽니다.
- 자격 증명으로 로그인합니다.
2. 애플리케이션 데이터 지우기
저장되지 않은 작업을 먼저 확인하세요
로컬 데이터를 지우거나 앱을 다시 설치하면 매장에 도착하지 않은 이 기기의 모든 데이터가 삭제됩니다. 오프라인 중 발생한 판매, 열린 장바구니, 저장되지 않은 수정 사항이 여기에 포함됩니다. 삭제하기 전에 매장 상태 → 데이터베이스를 열어 보류 중이거나 서버에 도달한 적 없는 항목이 없는지 확인한 다음, 매장 상태 → 로그에서 중단된 레코드 0개 및 전송 대기 중인 변경 사항 0개인지 확인하세요. 이어서 열린 장바구니를 모두 완료하거나 내용을 기록해 두세요. WCPOS에 매장 상태 페이지가 없다면 먼저 WCPOS를 업데이트한 후 확인하세요. 항목이 있거나 전송 대기 중이거나 확인할 수 없다면 삭제하지 말고 매장 관리자에게 문의하거나 지원팀에 연락하세요.
로그아웃이 작동하지 않는 경우에만, 그리고 위 내용을 확인한 후에만 진행하세요:
- POS 앱 캐시/데이터를 지웁니다.
- 웹에서는: 사이트에 대한 브라우저 쿠키 및 로컬 저장소를 지웁니다.
- 데스크탑에서는: "데이터 지우기" 옵션이 있는지 앱 설정을 확인합니다.
3. 서버 구성 확인
문제가 모든 사용자에게 영향을 미치는 경우:
- WordPress 소금이 변경되었는지 확인합니다.
- JWT 또는 인증 플러그인 설정을 검증합니다.
- 최근 서버 변경 사항을 검토합니다.
4. 올바른 서버에 연결되어 있는지 확인
POS가 올바른 WordPress 사이트에 연결되도록 설정되어 있는지 확인하세요. 특히 여러 설치가 있는 경우 더욱 중요합니다.