튜토리얼

Java 개발환경에서 바로써트 SDK를 추가하여 출금동의 요청(requestCMS) 함수를 구현하는 예시입니다.

1. BaroCert SDK 추가

① 카카오써트 연동자료실에서 Java - JSP SDK 예제코드 다운로드 후 압축을 해제합니다.
② SDK 예제코드의 WEB-INF/lib/ 폴더의 3개 jar파일 구현할 프로젝트의 라이브러리 폴더에 복사합니다.

gson-version.jar
linkhub-auth-version.jar
barocert-sdk-version.jar

2. BaroCert SDK 설정

프로젝트 경로에 출금동의 서비스 연동환경 설정을 위한 "$CATALINA_HOME/webapps/ROOT/common.jsp" 파일을 생성하고 아래의 코드를 참고하여 API Key를 설정합니다.

<%-- 카카오써트 클래스 빈 생성 --%>
<jsp:useBean id="kakaocertService" scope="application" class="com.barocert.kakaocert.KakaocertServiceImp"/>

<%-- 링크아이디 --%>
<jsp:setProperty name="kakaocertService" property="linkID" value="TESTER"/>

<%-- 비밀키 --%>
<jsp:setProperty name="kakaocertService" property="secretKey" value="SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="/>

<%-- 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true) --%>
<jsp:setProperty name="kakaocertService" property="IPRestrictOnOff" value="true"/>

<%-- 통신 고정 IP, true-사용, false-미사용, (기본값:false) --%>
<jsp:setProperty name="kakaocertService" property="useStaticIP" value="false"/>

3. RequestCMS 기능 구현

① "$CATALINA_HOME/webapps/ROOT/Request.jsp" 파일을 생성하고, 아래의 코드를 참조하여 함수 호출 코드를 추가합니다.

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
		<link rel="stylesheet" type="text/css" href="${pageContext.request.contextPath}/resources/main.css" media="screen" />
		<title>Barocert JSP Example</title>
	</head>

<%@ include file="common.jsp" %>

<%@page import="com.barocert.BarocertException"%>
<%@page import="com.barocert.kakaocert.cms.CMS"%>
<%@page import="com.barocert.kakaocert.cms.CMSReceipt"%>

<%
	/*
	 * 카카오톡 이용자에게 자동이체 출금동의를 요청합니다.
	 * https://developers.barocert.com/reference/kakao/java/cms/api#RequestCMS
	 */

	// 이용기관코드 (파트너 사이트에서 확인가능)
	String clientCode = "023040000001";

	// 출금동의 요청 정보 객체
	CMS cms = new CMS();

	// 수신자 휴대폰번호 - 11자 (하이픈 제외)
	cms.setReceiverHP(kakaocertService.encrypt("01012341234"));
	// 수신자 성명 - 80자
	cms.setReceiverName(kakaocertService.encrypt("홍길동"));
	// 수신자 생년월일 - 8자 (yyyyMMdd)
	cms.setReceiverBirthday(kakaocertService.encrypt("19700101"));

	// 인증요청 메시지 제목 - 최대 40자
	cms.setReqTitle("출금동의 요청 메시지 제목");
	// 커스텀 메시지 - 최대 500자
	cms.setExtraMessage(kakaocertService.encrypt("출금동의 커스텀 메시지"));
	// 인증요청 만료시간 - 최대 1,000(초)까지 입력 가능
	cms.setExpireIn(1000);

	// 청구기관명 - 최대 100자
	cms.setRequestCorp(kakaocertService.encrypt("청구기관명란"));
	// 출금은행명 - 최대 100자
	cms.setBankName(kakaocertService.encrypt("출금은행명란"));
	// 출금계좌번호 - 최대 32자
	cms.setBankAccountNum(kakaocertService.encrypt("9-4324-5117-58"));
	// 출금계좌 예금주명 - 최대 100자
	cms.setBankAccountName(kakaocertService.encrypt("예금주명 입력란"));
	// 출금계좌 예금주 생년월일 - 8자
	cms.setBankAccountBirthday(kakaocertService.encrypt("19930112"));
	// 출금유형
	// CMS - 출금동의용, FIRM - 펌뱅킹, GIRO - 지로용
	cms.setBankServiceType(kakaocertService.encrypt("CMS")); // CMS, FIRM, GIRO

	// AppToApp 인증요청 여부
	// true - AppToApp 인증방식, false - Talk Message 인증방식
	cms.setAppUseYN(false);

	CMSReceipt result = null;

	try {

		result = kakaocertService.requestCMS(clientCode, cms);

	} catch(BarocertException ke) {
		throw ke;
	}
%>
	<body>
		<div id="content">
			<p class="heading1">Response</p>
			<br/>
			<fieldset class="fieldset1">
				<legend>카카오 출금동의 요청</legend>
				<ul>
					<li>접수아이디 (ReceiptID) : <%=result.getReceiptID()%></li>
					<li>앱스킴 (Scheme) : <%=result.getScheme()%></li>
				</ul>
			</fieldset>
		</div>
	</body>
</html>

4. 결과 확인

함수 호출이 정상적으로 처리되면 "채널 메시지 인증" 방식은 접수아이디(32자리 숫자)가 반환되며, "앱투앱 인증" 방식은 접수아이디와 AppScheme 이 함께 반환됩니다. 실패인 경우 BarocertException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드]