연동매뉴얼

PHP API

(PHP / Laravel)

kakaoCert 오류코드

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

오류코드 분류

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

  • -300*kakaoCert 공통 오류코드
  • -320*본인인증 오류코드
  • -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자)를 초과하였습니다.
-32000001 수신자 휴대폰 번호가 입력되지 않았습니다.
-32000002 수신자 성명이 입력되지 않았습니다.
-32000003 생년월일이 입력되지 않았습니다.
-32000004 처리마감시간(초)은 1이상의 정수로 입력하시기 바랍니다.
-32000005 고객센터 전화번호가 입력되지 않았습니다.
-32000006 인증요청 메시지 제목이 입력되지 않았습니다.
-32000007 토큰 원문이 입력되지 않았습니다.
-32000008 별칭을 사용할 수 없는 상태입니다.
-32000009 본인인증 API 요청에 실패하였습니다.
-32000010 카카오 트랜잭션 아이디가 올바르지 않습니다.
-32000011 본인인증 상태확인 API 요청에 실패하였습니다.?
-32010001 잘못된 KakaoAccessToken 이거나 API 접근 권한이 없습니다.
-32010002 카카오톡 사용자가 아니거나 해지된 사용자입니다.
-32010003 휴대폰번호가 누락되었거나 형식이 올바르지 않습니다.
-32010004 고객성명이 누락되었거나 형식이 올바르지 않습니다.
-32010005 생년월일이 누락되었거나 형식이 올바르지 않습니다.
-32010006 고객센터번호가 누락되었거나 형식이 올바르지 않습니다.
-32010007 생년월일이 카카오톡에 등록된 생년월일이 일치하지 않습니다.
-32010008 고객성명과 카카오톡에 등록된 성명이 일치하지 않습니다.
-32010009 카카오페이 시스템 서버 오류가 발생하였습니다.
-32010010 본인인증 API 요청에 실패하였습니다.
-32010011 접수아이디에 해당하는 요청이 존재하지 않습니다.
-32010012 조회 식별자가 존재하지 않습니다.
-32010013 서명 결과가 존재하지 않습니다.
-32010014 카카오 tx_id가 존재하지 않습니다.
-32010015 본인인증 상태확인 API 요청에 실패하였습니다.
-32010016 본인인증 서명검증 API 요청에 실패하였습니다.?
-32010017 서명 검증 API는 1회만 호출할 수 있습니다.
-32010018 조회 식별자가 존재하지 않습니다.
-32010019 서명 결과가 존재하지 않습니다.
-32010020 서명이 완료되지 않았습니다.
-32010021 카카오 tx_id가 존재하지 않습니다.
-32010022 카카오페이 시스템 서버 오류가 발생하였습니다.
-32010023 본인인증 서명검증 API 요청에 실패하였습니다.
-32010024 전자서명 데이터 전문이 올바르지 않습니다.
-32010025 본인인증 요청정보를 파싱할 수 없습니다.
-32010026 수신자 휴대폰 번호가 최대길이(11자)를 초과하였습니다.
-32010027 수신자 성명이 최대길이(20자)를 초과하였습니다.
-32010028 생년월일이 최대길이(8자)를 초과하였습니다.
-32010029 처리마감시간(초) 최대값(1000)을 초과하였습니다.
-32010030 고객센터 전화번호가 최대길이(20자)를 초과하였습니다.
-32010031 인증요청 메시지 제목이 최대길이(40자)를 초과하였습니다.
-32010032 토큰 원문이 최대길이(500자)를 초과하였습니다.
-32010033 인증요청 메시지 부가내용이 최대길이(500자)를 초과하였습니다.
-32010034 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