에러 코드

토스인증 API 호출 시 발생할 수 있는 에러 코드와 대응 방법을 안내합니다.

본인확인·간편인증·전자서명

HTTP 상태	에러코드	에러 메시지	설명
500	CE0001	시스템 장애로 인하여 통신이 원활하지 않습니다	시스템 장애
400	CE0002	서비스 점검중입니다. 잠시 후 다시 시도해주세요	긴급/정기 점검 중
400	CE0003	잘못된 요청입니다	요청값이 유효하지 않음
401	CE1000	토큰이 유효하지 않습니다	만료되거나 무효한 Access Token
401	CE1001	요청 권한이 없습니다	인증 서비스 권한 없음
400	CE3000	사용자를 찾을 수 없습니다	등록되지 않은 사용자 또는 이용 불가 계정
400	CE3001	사용자 정보가 올바르지 않습니다	개인정보 유효성 오류
400	CE3002	차단된 사용자입니다	토스 계정이 차단된 상태
400	CE3003	사용가능 횟수가 초과되었습니다	일일 이용 횟수 초과
400	CE3006	서비스 이용 연령 기준에 해당하지 않아서 이용할 수 없어요.	만 14세 미만 사용자
400	CE3100	존재하지 않는 요청입니다	유효하지 않은 txId
400	CE3101	최종 결과는 2회만 조회할 수 있습니다	결과조회 API 2회 초과 호출
400	CE3102	요청이 아직 완료되지 않았습니다	인증 완료 상태가 아님
400	CE3103	요청이 만료되었습니다	인증 유효시간 초과
400	CE3200	사용자 토큰이 유효하지 않습니다	이미 사용된 ciToken 또는 5분 유효시간 초과
400	CE4000	토스앱 알림이 차단되어 인증 서비스 알림을 받지 못하고 있어요, 토스 고객센터로 문의해 알림 차단을 해제해주세요	토스 앱 알림 차단 상태
400	CE5000	이용기관을 찾을 수 없습니다	이용기관 미존재 또는 사용 불가 상태

---

마이데이터 통합인증 에러코드

HTTP 상태	에러코드	에러 메시지	설명
200	00000	성공	정상 완료
200	00000	성공 (UP_TO_DATE)	최신 상태 유지
400	40001	잘못된 요청입니다	요청 형식 오류
400	40001	해당 유저가 존재하지 않습니다	토스 미가입 사용자
400	40001	서명이 완료되지 않았습니다	전자서명 미완료
400	40001	유효하지 않은 sign_tx_id입니다	무효한 서명 거래 ID
400	40002	헤더 값 미존재 또는 잘못된 헤더값	필수 헤더 누락/오류
400	40002	유효하지 않은 x-api-tran-id입니다	거래 ID 오류
400	40002	잘못된 content-type입니다	Content-Type 형식 오류
401	40101	유효하지 않은 접근토큰입니다	만료되거나 무효한 접근토큰
401	40106	요청시간이 초과하였습니다	요청 타임아웃
500	50001	시스템 장애로 인하여 통신이 원활하지 않습니다	시스템 오류
500	50002	시스템 장애로 인하여 통신이 원활하지 않습니다	시스템 오류 (일시적)