개발가이드

1. 서비스를 선택하여 주세요.

2. 사용하시는 개발언어를 선택하여 주세요.

Index

1. 전자서명 요청

2. 전자서명 결과확인

A. 객체정보

1. 전자서명 요청

1.1. RequestESign - 전자서명 요청

· 카카오톡 사용자에게 전자서명을 요청합니다.

public String requestESign(String ClientCode, RequestESign esignRequest) throws KakaocertException

Parameter

순번 변수명 타입 길이 필수 설명
1 ClientCode String 12 O kakaocert에 등록된 이용기관 코드
관리자 사이트에서 확인가능
2 esignRequest RequestESign - O 전자서명 요청 정보

Return

String - 접수아이디

Throws

KakaocertException

2. 전자서명 결과확인

2.1. GetESignResult - 전자서명 결과확인

· 전자서명 요청시 반환된 접수아이디를 통해 전자서명 결과를 확인합니다.

public ResultESign getESignResult(String ClientCode, String receiptID) throws KakaocertException

Parameter

순번 변수명 타입 길이 필수 설명
1 ClientCode String 12 O kakaocert에 등록된 이용기관 코드
관리자 사이트에서 확인가능
2 receiptID String 20 O 전자서명 요청시 반환된 접수아이디

Return

ResultESign

Throws

KakaocertException

A. 객체정보

A.1. KakaocertException - kakaocert 예외 처리

순번 변수명(항목명) 타입 길이 설명
1 code
코드
long - API 처리 실패에 대한 오류코드("-"로 시작하는 8자리 숫자값)
[참고] 오류코드
2 message
메시지
String - API 처리 실패에 대한 오류메시지

A.2. RequestESign - 전자서명 요청 정보

순번 변수명(항목명) 필수 타입 길이 설명
1 CallCenterNum
고객센터 전화번호
O String 20 카카오톡 인증메시지 중 "고객센터" 항목에 표시
2 Expires_in
인증요청 만료시간
O int - 최대 1000까지 입력 가능(권장 : 300), 단위 : 초(s)
└ 만료시간 안에 수신자가 미인증시, 'ResultESign' 객체의 변수 'state'를 2 (만료) 처리
3 ReceiverBirthDay
수신자 생년월일
O String 8 형식 : YYYYMMDD
4 ReceiverHP
수신자 휴대폰번호
O String 11 하이픈(-) 제외하고 입력
5 ReceiverName
수신자 성명
O String 20 -
6 Token
원문
O String 500 이용기관이 전자서명할 내용
7 TMSTitle
인증요청 메시지 제목
O String 40 카카오톡 인증메시지 중 "요청구분" 항목에 표시
8 TMSMessage
인증요청 메시지 부가내용
- String 500 카카오톡 인증메시지 중 상단에 표시
9 SubClientID
별칭코드
- String 12 관리자 사이트에서 이용기관이 등록한 별칭에 대한 코드
└ 카카오톡 인증메시지 중 "요청기관" 항목에 표시
└ 미입력시 이용기관명이 "요청기관" 항목에 표시
10 isAllowSimpleRegistYN
인증서 발급유형 선택
O boolean - true / false 중 택 1
└ true = 휴대폰 본인인증만을 이용해 인증서 발급
└ false = 본인계좌 점유 인증을 이용해 인증서 발급
11 isVerifyNameYN
수신자 실명확인 여부
O boolean - true / false 중 택 1
└ true = 확인, false = 미확인
└ 카카오페이가 본인인증을 통해 확보한 사용자 실명과 {@no.5 ReceiverName} 값과 비교하여 실명 확인함
12 PayLoad
메모
- String 200 메모의 목적으로 사용, 이용기관이 생성한 값

A.3. ResultESign - 전자서명 결과 정보

순번 변수명(항목명) 타입 길이 설명
1 receiptID
접수아이디
String 20 GetESignResult 함수 호출시 파라미터로 입력한 'receiptID' 값
2 clientCode
이용기관코드
String 12 GetESignResult 함수 호출시 파라미터로 입력한 'ClientCode' 값
3 clientName
이용기관명
String 80 {@no.2 clientCode}에 해당하는 이용기관 이름
관리자 사이트에서 확인 가능
4 subClientName
별칭
String 80 {@no.5 subClientCode}에 해당하는 별칭 이름
5 subClientCode
별칭코드
String 12 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'SubClientID'에 입력한 값
└ 이 함수 호출시 값을 입력하지 않은 경우 null 반환
6 state
상태
int - 0 / 1 / 2 중 반환
└ 0 = 서명대기, 1 = 서명완료, 2 = 만료
7 signedData
전자서명 데이터 전문
String 4096 전자서명 요청 받은 수신자가 전자서명 완료시 반환
8 token
원문
String 500 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'Token' 값
9 expires_in
인증요청 만료시간(초)
int - RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'Expires_in' 값
└ 만료시간 안에 수신자가 미인증시, {@no.6 state}를 2 (만료) 처리
10 callCenterNum
고객센터 전화번호
String 20 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'CallCenterNum' 값
11 tmstitle
인증요청 메시지 제목
String 40 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'TMSTitle' 값
12 tmsmessage
인증요청 메시지 부가내용
String 500 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'TMSMessage' 값
13 allowSimpleRegistYN
인증서 발급유형 선택
boolean - RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'isAllowSimpleRegistYN' 값
└ true / false 중 반환
└ true = 휴대폰 본인인증만을 이용해 인증서 발급
└ false = 본인계좌 점유 인증을 이용해 인증서 발급
14 verifyNameYN
수신자 실명확인 여부
boolean - RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'isVerifyNameYN' 값
└ true (확인) / false (미확인) 중 반환
└ 카카오페이가 본인인증을 통해 확보한 사용자 실명과 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'ReceiverName' 값과 비교하여 실명 확인함
15 requestDT
카카오 인증서버 등록일시
String 14 형식 : yyyyMMddHHmmss
16 expireDT
인증 만료일시
String 14 형식 : yyyyMMddHHmmss
17 regDT
인증요청 등록일시
String 14 형식 : yyyyMMddHHmmss
18 viewDT
수신자 카카오톡 인증메시지 확인일시
String 14 형식 : yyyyMMddHHmmss
19 completeDT
수신자 카카오톡 전자서명 완료일시
String 14 형식 : yyyyMMddHHmmss
20 verifyDT
서명 검증일시
String 14 형식 : yyyyMMddHHmmss
21 payload
메모
String 200 RequestESign 함수 호출시 입력한 'RequestESign' 객체의 'PayLoad' 값

기술지원센터

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