연동매뉴얼

Java API

(Spring / SpringBoot / JSP)

kakaoCert 오류코드

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

오류코드 분류

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

  • -300*kakaoCert 공통 오류코드
  • -330*자동이체 출금동의 오류코드
  • -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자)를 초과하였습니다.
-30010024 서명완료일시로부터 30분이 경과한 이후에는 검증이 불가합니다.
-33000001 수신자 휴대폰 번호가 입력되지 않았습니다.
-33000002 수신자 성명이 입력되지 않았습니다.
-33000003 생년월일이 입력되지 않았습니다.
-33000004 처리마감시간(초)은 0이상의 정수로 입력하시기 바랍니다.
-33000005 고객센터 전화번호가 입력되지 않았습니다.
-33000006 납부자 식별번호가 입력되지 않았습니다.
-33000007 은행코드가 입력되지 않았습니다.
-33000008 은행 계좌번호가 입력되지 않았습니다.
-33000009 최대 처리마감시간(초)를 초과하였습니다. 1000 이하로 입력하시기 바랍니다.
-33000010 출금동의 API 요청에 실패하였습니다.
-33000011 출금동의 API 요청에 실패하였습니다. [카카오 오류코드 - 카카오 오류메시지]
-33000012 접수아이디에 해당하는 요청이 존재하지 않습니다.
-33000013 카카오 트랜잭션 아이디가 올바르지 않습니다.
-33000014 출금동의 상태확인 API 요청에 실패하였습니다.
-33000015 출금동의 상태확인 API 요청에 실패하였습니다. [카카오 오류코드 - 카카오 오류메시지]
-33000016 출금동의 서명검증 API 요청에 실패하였습니다.
-33000017 출금동의 서명검증 API 요청에 실패하였습니다.?[카카오 오류코드 - 카카오 오류메시지]
-33000018 인증요청 메시지 제목이 입력되지 않았습니다.
-33000019 별칭을 사용할 수 없는 상태입니다.
-33010001 잘못된 KakaoAccessToken 이거나 API 접근 권한이 없습니다.
-33010002 카카오톡 사용자가 아니거나 해지된 사용자입니다.
-33010003 휴대폰번호가 누락되었거나 형식이 올바르지 않습니다.
-33010004 고객성명이 누락되었거나 형식이 올바르지 않습니다.
-33010005 생년월일이 누락되었거나 형식이 올바르지 않습니다.
-33010006 고객센터번호가 누락되었거나 형식이 올바르지 않습니다.
-33010007 납부자 식별번호가 누락되었거나 형식이 올바르지 않습니다.
-33010008 은행코드가 누락되었거나 형식이 올바르지 않습니다.
-33010009 계좌번호가 누락되었거나 형식이 올바르지 않습니다.
-33010010 예금주성명이 누락되었거나 형식이 올바르지 않습니다.
-33010011 생년월일이 카카오톡에 등록된 생년월일과 일치하지 않습니다.
-33010012 고객성명과 카카오톡에 등록된 성명이 일치하지 않습니다.
-33010013 카카오페이 시스템 서버 오류가 발생하였습니다.
-33010014 출금동의 API 요청에 실패하였습니다.
-33010015 조회 식별자가 존재하지 않습니다.
-33010016 서명 결과가 존재하지 않습니다.
-33010017 카카오 tx_id가 존재하지 않습니다.
-33010018 서명 검증 API는 1회만 호출할 수 있습니다.
-33010019 조회 식별자가 존재하지 않습니다.
-33010020 서명 결과가 존재하지 않습니다.
-33010021 서명이 완료되지 않았습니다.
-33010022 전자서명 데이터 전문이 올바르지 않습니다.
-33010023 자동이체 출금동의 요청정보를 파싱할 수 없습니다.
-33010024 수신자 휴대폰 번호가 최대길이(11자)를 초과하였습니다.
-33010025 수신자 성명이 최대길이(20자)를 초과하였습니다.
-33010026 생년월일이 최대길이(8자)를 초과하였습니다.
-33010027 처리마감시간(초) 최대값(99999999)을 초과하였습니다.
-33010028 고객센터 전화번호가 최대길이(20자)를 초과하였습니다.
-33010029 납부자 식별번호가 최대길이(40자)를 초과하였습니다.
-33010030 은행코드가 최대길이(10자)를 초과하였습니다.
-33010031 은행계좌번호가 최대길이(31자)를 초과하였습니다.
-33010032 인증요청 메시지 부가내용이 최대길이(50자)를 초과하였습니다.
-33010033 Payload 값이 최대길이(200)를 초과하였습니다.
-33010034 인증요청 메시지 제목이 최대길이(40자)를 초과하였습니다.
-33010035 은행계좌 예금주명이 최대길이(20)자를 초과하였습니다.
-33010050 서명완료일시로부터 30분이 경과한 이후에는 검증이 불가합니다.
-99005001 파트너 잔여포인트가 부족합니다.
-99005002 후불 월한도를 초과하였습니다.
-99005003 차감할 충전포인트가 부족합니다.
-99005004 차감할 보너스포인트가 부족합니다.
-99005005 잔여포인트가 부족합니다.
-99005006 환불 가능한 건수가 없습니다.
-99005007 과금위치를 확인할 수 없습니다.
-99005008 일반SITE 과금이 제한되어 있습니다.
-99005009 연동API 과금이 제한되어 있습니다.
-99005010 파트너과금 방식이 아닙니다.
-99005011 회원정보가 필요한 서비스입니다.
-99005012 파트너과금 전용 서비스입니다.
-99005013 후불 일한도를 초과하였습니다.
-99005014 완충금 한도를 초과하였습니다.
-99005015 일 사용건수 한도를 초과하였습니다.
-99005016 월 사용건수 한도를 초과하였습니다.
-99005017 파트너 완충금 한도를 초과하였습니다.

기술지원센터

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