튜토리얼

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

1. BaroCert SDK 추가

Barocert SpringBoot Starter 추가를 위해 SpringBoot 프로젝트 "build.gradle" 파일에 dependency를 추가 후 Refresh 합니다.
※ Barocert SpringBoot Starter는 SpringBoot v1.0 이상에서 사용 가능하며 Barocert Java SDK AutoConfiguration을 지원합니다.

dependencies {
	implementation 'kr.co.linkhub:barocert-spring-boot-starter:1.4.0'
}

2. BaroCert SDK 설정

SDK 설정을 위해 아래의 코드를 application.yml 파일에 추가합니다.

kakaocert:
	#링크아이디
	linkId: TESTER
	#비밀키
	secretKey: SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=
	#이용기관코드 (파트너 사이트에서 확인가능)
	clientCode: '023040000001'
	#인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
	isIpRestrictOnOff: true
	#통신 고정 IP, true-사용, false-미사용, (기본값:false)
	useStaticIp: false

3. RequestCMS 기능 구현

① 서비스 클래스 빈 객체 추가를 위해 @Autowired 어노테이션과 RequestCMS 함수 코드를 추가합니다.

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import com.barocert.BarocertException;
import com.barocert.kakaocert.KakaocertService;
import com.barocert.kakaocert.cms.CMS;
import com.barocert.kakaocert.cms.CMSReceipt;
import com.barocert.kakaocert.cms.CMSResult;
import com.barocert.kakaocert.cms.CMSStatus;

@Controller
public class KakaocertServiceController {

	@Autowired
	private KakaocertService kakaocertService;

	// 이용기관 코드
	// 파트너가 등록한 이용기관의 코드, (파트너 사이트에서 확인가능)
	@Value("${kakaocert.clientCode}")
	private String ClientCode;
	
	/*
	 * 카카오톡 이용자에게 자동이체 출금동의를 요청합니다.
	 * https://developers.barocert.com/reference/kakao/java/cms/api#RequestCMS
	 */
	@RequestMapping(value = "kakaocert/requestCMS", method = RequestMethod.GET)
	public String requestCMS(Model m) throws BarocertException {

		// 출금동의 요청 정보 객체
		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-***4-5117-58"));
		// 출금계좌 예금주명 - 최대 100자
		cms.setBankAccountName(kakaocertService.encrypt("예금주명 입력란"));
		// 출금계좌 예금주 생년월일 - 8자
		cms.setBankAccountBirthday(kakaocertService.encrypt("19700101"));
		// 출금유형
		// CMS - 출금동의용, FIRM - 펌뱅킹, GIRO - 지로용
		cms.setBankServiceType(kakaocertService.encrypt("CMS")); // CMS, FIRM, GIRO

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

		// App to App 방식 이용시, 호출할 URL
		// cms.setReturnURL("https://www.kakaocert.com");

		try {
			CMSReceipt result = kakaocertService.requestCMS(ClientCode, cms);
			m.addAttribute("result", result);
		} catch (BarocertException ke) {
			m.addAttribute("Exception", ke);
			return "exception";
		}

		return "response";
	}
}

② 함수 호출결과 코드와 메시지를 출력하는 response.html 파일을 추가합니다.

<html xmlns:th="http://www.thymeleaf.org">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
		<link rel="stylesheet" type="text/css" href="/css/main.css" media="screen"/>
		<title>Barocert Kakaocert Service SpringBoot Example</title>
	</head>
	<body>
		<div id="content">
			<p class="heading1">Response</p>
			<br/>
			<fieldset class="fieldset1">
				<legend th:text="${#request?.requestURL}"></legend>
				<ul>
					<li>접수아이디 (ReceiptID) : <span th:text="${result.receiptID}"></span></li>
					<li>앱스킴 (Scheme) : <span th:text="${result.scheme}"></span></li>
				</ul>
			</fieldset>
		</div>
	</body>
</html>

4. 결과 확인

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