연동매뉴얼

Node.js API

(Express)

kakaoCert 오류코드

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

오류코드 분류

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자)를 초과하였습니다.
-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)자를 초과하였습니다.
-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