에러코드

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

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

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

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

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