목차

- 본인확인, 간편인증, 전자서명 에러코드
- 마이데이터 통합인증 에러코드

에러코드

각 API에서 발생할 수 있는 에러 목록입니다. 에러 코드는 지속적으로 업데이트 됩니다. DB에 저장하는 방식으로 연동하면 오류가 발생할 수 있으니 유의하세요.

본인확인, 간편인증, 전자서명 에러코드

Https 응답코드	에러 코드(errorCode)	에러 메시지(reason)	설명
500	CE0001	시스템 장애로 인하여 통신이 원활하지 않습니다.
400	CE0002	서비스 점검중입니다. 잠시 후 다시 시도해주세요.	긴급, 정기 서비스 점검 중에 발생
400	CE0003	잘못된 요청입니다.	요청 값이 유효하지 않는 경우 발생
401	CE1000	토큰이 유효하지 않습니다.	만료된 `Access Token`이거나 유효하지 않는 값으로 재 발급 필요
401	CE1001	요청 권한이 없습니다.	고객사의 인증 서비스 권한이 없는 경우 발생하며 상세한 원인은 토스로 문의
400	CE3000	사용자를 찾을 수 없습니다.	인증을 요청한 사용자를 토스에서 찾을 수 없거나 사용자의 토스 계정 상태가 이용 불가한 경우 발생하며 상세한 원인은 토스로 문의
400	CE3001	사용자 정보가 올바르지 않습니다. 다시 한번 확인해주세요.	인증 요청에서 전달된 사용자의 개인정보가 유효하지 않을 때 발생하며 오탈자 혹은 사용자 정보 재 확인 필요
400	CE3002	차단된 사용자입니다.	인증 요청된 사용자의 토스 계정이 차단된 경우 발생
400	CE3003	사용가능 횟수가 초과되었습니다.	하루 이용 가능한 횟수가 초과한 경우 발생
400	CE3100	존재하지 않는 요청입니다.	인증 결과 확인 시 유효하지 않은 `txId`를 사용하는 경우 발생
400	CE3101	최종 결과는 2회만 조회할 수 있습니다.	인증 결과 확인 API가 2회 이상 호출되는 경우 발생
400	CE3102	요청이 아직 완료되지 않았습니다.	요청 결과 확인은 인증완료 상태에만 가능
400	CE3103	요청이 만료되었습니다.	인증 가능한 유효시간이 만료된 경우 발생
400	CE3200	사용자 토큰이 유효하지 않습니다.	이미 사용된 `ciToken`를 재 사용하는 경우 혹은 `5분`의 유효시간이 초과된 후 조회하는 경우 발생
400	CE5000	이용기관을 찾을 수 없습니다.	이용기관이 존재하지 않거나 사용 불가한 상태의 경우 발생

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

Https 응답코드	에러 코드(rsp_code)	에러 메시지(rsp_msg)	설명
200	00000	성공
200	00000	성공 (UP_TO_DATE)
400	40001	잘못된 요청입니다.
400	40001	해당 유저가 존재하지 않습니다.	토스에 가입되지 않은 사용자 정보의 경우 발생
400	40001	서명이 완료되지 않았습니다.	전자서명이 완료되지 않은 상태에서 서명결과 조회된 경우 발생
400	40001	전자서명이 완료되지 않은 상태에서 서명결과 조회된 경우 발생
400	40001	유효하지 않은 sign_tx_id 입니다.
400	40002	헤더 값 미존재 또는 잘못된 헤더값
400	40002	유효하지 않은 x-api-tran-id 입니다.
400	40002	잘못된 content-type 입니다.
401	40101	유효하지 않은 접근토큰입니다.	유효기간이 만료되거나 유효하지 않은 접근토큰으로 재 발급 필요
401	40106	요청시간이 초과하였습니다.
500	50001	시스템 장애로 인하여 통신이 원활하지 않습니다.
500	50002	시스템 장애로 인하여 통신이 원활하지 않습니다.
500	50002	일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해주세요.