연동매뉴얼

Java API

(Spring / JSP)

kakaoCert 오류코드

kakaoCert SDK 함수 호출이 정상적으로 처리되지 않은 경우 함수 리턴으로 오류코드(code)와 오류메시지(message)가 반환됩니다. kakaoCert SDK 함수 호출시 발생하는 오류의 원인파악이 어려운 경우, 반환되는 오류정보를 확인하여 기술지원센터( 1600-9854 / code@linkhub.co.kr )로 문의하여 주시기 바랍니다.

오류코드 분류

kakaoCert SDK 함수 호출이 정상적으로 처리되지 않은 경우 -로 시작하는 8자리 숫자값이 반환됩니다.

  • -300*kakaoCert 공통 오류코드
  • -310*전자서명 오류코드
  • -990*포인트 관련 오류코드

오류코드 테이블

오류코드 오류메시지
-30000001 이용기관명이 입력되지 않았습니다.
-30000002 사업자 상호가 입력되지 않았습니다.
-30000003 사업자등록번호가 올바르지 않습니다.
-30000004 사업자 주소가 입력되지 않았습니다.
-30000005 이용기관 고객센터 번호가 입력되지 않았습니다.
-30000006 이용기관 코드가 존재하지 않습니다.
-30000007 이용기관 등록 API 요청에 실패하였습니다.
-30000008 서비스코드 등록 API 요청에 실패하였습니다.
-30000009 이용기관 정보를 수정할 수 없는 상태입니다.
-30000010 이용기관 정보수정 API 요청에 실패하였습니다.
-30000011 이용기관 별칭등록 API 요청에 실패하였습니다.
-30000012 이용기관 별칭이 입력되지 않았습니다.
-30000013 하위 이용기관 코드가 존재하지 않습니다.
-30000014 하위 이용기관 정보 수정 API 요청에 실패하였습니다.
-30000015 이용기관 별칭을 삭제할 수 없는 상태입니다.
-30000016 이용기관 별칭정보를 수정할 수 없는 상태입니다.
-30000017 과금세션이 준비되지 않았습니다.
-30000018 해당 사업자의 이용기관 정보가 존재하지 않습니다.
-30000019 이용기관 등록을 대기중입니다.
-30000020 취소된 이용기관입니다.
-30000021 사용중지된 이용기관입니다.
-30000022 해지된 이용기관입니다.
-30010001 이용기관 코드에 해당하는 이용기관이 존재하지 않습니다.
-30010002 별칭코드에 해당하는 별칭이 존재하지 않습니다.
-30010003 이용기관의 카카오 인증토큰이 존재하지 않습니다.
-30010004 이용기관을 사용할 수 없는 상태입니다.
-30010005 별칭을 사용할 수 없는 상태입니다.
-30010006 링크아이디가 입력되지 않았습니다.
-30010007 이용기관 코드가 입력되지 않았습니다.
-30010008 이용기관 정보 파싱실패. [Malformed JSON]
-30010009 이용기관 정보가 입력되지 않았습니다.
-30010010 파트너 링크아이디가 입력되지 않았습니다.
-30010011 No input body.
-30010012 링크아이디에 해당하는 파트너정보가 존재하지 않습니다.
-30010013 이용기관명이 최대길이(80자)를 초과하였습니다.
-30010014 사업자 상호명이 최대길이(80자)를 초과하였습니다.
-30010015 사업자 주소가 최대길이(1000자)를 초과하였습니다.
-30010016 이용기관 고객센터 번호가 최대길이(20자)를 초과하였습니다.
-30010017 이용기관 별칭이 최대길이(80자)를 초과하였습니다.
-30010018 사업자 대표자 성명이 최대길이(30자)를 초과하였습니다.
-30010019 사업자 업태가 최대길이(50자)를 초과하였습니다.
-30010020 사업자 종목이 최대길이(50자)를 초과하였습니다.
-30010021 담당자 성명이 최대길이(100자)를 초과하였습니다.
-30010022 담당자 연락처가 최대길이(20자)를 초과하였습니다.
-30010023 담당자 이메일 주소가 최대길이(100자)를 초과하였습니다.
-31000001 수신자 휴대폰 번호가 입력되지 않았습니다.
-31000002 수신자 성명이 입력되지 않았습니다.
-31000003 생년월일이 입력되지 않았습니다.
-31000004 처리마감시간(초)은 1이상의 정수로 입력하시기 바랍니다.
-31000005 고객센터 전화번호가 입력되지 않았습니다.
-31000006 인증요청 메시지 제목이 입력되지 않았습니다.
-31000007 토큰 원문이 입력되지 않았습니다.
-31000008 전자서명 API 요청에 실패하였습니다.
-31000009 별칭을 사용할 수 없는 상태입니다.
-31010001 잘못된 KakaoAccessToken 이거나 API 접근 권한이 없습니다.
-31010002 카카오톡 사용자가 아니거나 해지된 사용자입니다.
-31010003 휴대폰번호가 누락되었거나 형식이 올바르지 않습니다.
-31010004 고객성명이 누락되었거나 형식이 올바르지 않습니다.
-31010005 생년월일이 누락되었거나 형식이 올바르지 않습니다.
-31010006 고객센터번호가 누락되었거나 형식이 올바르지 않습니다.
-31010007 생년월일이 카카오톡에 등록된 생년월일이 일치하지 않습니다.
-31010008 고객성명과 카카오톡에 등록된 성명이 일치하지 않습니다.
-31010009 카카오페이 시스템 서버 오류가 발생하였습니다.
-31010010 전자서명 API 요청에 실패하였습니다.
-31010011 접수아이디에 해당하는 요청이 존재하지 않습니다.
-31010012 전자서명 상태확인 API 요청에 실패하였습니다.
-31010013 조회 식별자가 존재하지 않습니다.
-31010014 서명 결과가 존재하지 않습니다.
-31010015 카카오 tx_id가 존재하지 않습니다.
-31010016 전자서명 상태확인 API 요청에 실패하였습니다.
-31010017 전자서명 서명검증 API 요청에 실패하였습니다.
-31010018 서명 검증 API는 1회만 호출할 수 있습니다.
-31010019 조회 식별자가 존재하지 않습니다.
-31010020 서명 결과가 존재하지 않습니다.
-31010021 서명이 완료되지 않았습니다.
-31010022 카카오 tx_id가 존재하지 않습니다.
-31010023 카카오페이 시스템 서버 오류가 발생하였습니다.
-31010024 전자서명 서명검증 API 요청에 실패하였습니다.
-31010025 카카오 트랜잭션 아이디가 올바르지 않습니다.
-31010026 전자서명 데이터 전문이 올바르지 않습니다.
-31010027 전자서명 요청정보를 파싱할 수 없습니다.
-31010028 수신자 휴대폰 번호가 최대길이(11자)를 초과하였습니다.
-31010029 수신자 성명이 최대길이(20자)를 초과하였습니다.
-31010030 생년월일이 최대길이(8자)를 초과하였습니다.
-31010031 처리마감시간(초) 최대값(1000)을 초과하였습니다.
-31010032 고객센터 전화번호가 최대길이(20자)를 초과하였습니다.
-31010033 인증요청 메시지 제목이 최대길이(40자)를 초과하였습니다.
-31010034 토큰 원문이 최대길이(500자)를 초과하였습니다.
-31010035 인증요청 메시지 부가내용이 최대길이(500자)를 초과하였습니다.
-31010036 Payload 값이 최대길이(200)를 초과하였습니다.
-99005001 파트너 잔여포인트가 부족합니다.
-99005002 후불 월한도를 초과하였습니다.
-99005003 차감할 충전포인트가 부족합니다.
-99005004 차감할 보너스포인트가 부족합니다.
-99005005 잔여포인트가 부족합니다.
-99005006 환불 가능한 건수가 없습니다.
-99005007 과금위치를 확인할 수 없습니다.
-99005008 일반SITE 과금이 제한되어 있습니다.
-99005009 연동API 과금이 제한되어 있습니다.
-99005010 파트너과금 방식이 아닙니다.
-99005011 회원정보가 필요한 서비스입니다.
-99005012 파트너과금 전용 서비스입니다.
-99005013 후불 일한도를 초과하였습니다.
-99005014 완충금 한도를 초과하였습니다.
-99005015 일 사용건수 한도를 초과하였습니다.
-99005016 월 사용건수 한도를 초과하였습니다.
-99005017 파트너 완충금 한도를 초과하였습니다.

기술지원센터

kakaoCert 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.
T. 1600-9854E. code@linkhub.co.kr