튜토리얼

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

1. BaroCert SDK 추가 및 설정

PHP SDK 예제코드 다운로드 후 압축을 해제합니다.
압축해제한 SDK 예제코드에 포함된 Barocert/ 폴더를 웹사이트 Root Directory 경로에 복사합니다.
암호화 통신에 필요한 외부 라이브러리(mcrypt)를 설치합니다.
※ PHP v7.1 부터는 mcrypt를 지원하지 않아 OPENSSL v1.0.1g 이상이 필요합니다.

$ yum install epel-release libmcrypt libmcrypt-devel php-mcrypt php-mcrypt-devel

서비스 연동환경 설정을 위해 프로젝트 Root Directory에 KakaocertService/common.php 파일을 생성하고 아래의 코드를 참고하여 인증정보를 설정합니다.

<?php

	require_once '../Barocert/Kakaocert.php';

	// 링크아이디
	$LinkID = 'TESTER';

	// 비밀키
	$SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';

	// 통신방식 기본은 CURL , curl 사용에 문제가 있을경우 STREAM 사용가능.
	// STREAM 사용시에는 php.ini의 allow_url_fopen = on 으로 설정해야함.
	define('LINKHUB_COMM_MODE','CURL');

	$KakaocertService = new KakaocertService($LinkID, $SecretKey);

	// 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
	$KakaocertService->IPRestrictOnOff(true);

	// 통신 고정 IP, true-사용, false-미사용, (기본값:false)
	$KakaocertService->UseStaticIP(false);

?>

2. RequestCMS 기능 구현

프로젝트 Root Directory에 함수 호출을 처리하는 파일을 생성하고, 아래의 코드를 참조하여 코드를 추가합니다.

<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="../Example.css" media="screen" />
		<title>Barocert Kakao Service PHP 5.X Example.</title>
	</head>
<?php

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

	include 'common.php';

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

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

	// 수신자 휴대폰번호 - 11자 (하이픈 제외)
	$KakaoCMS->receiverHP = $KakaocertService->encrypt('01012341234');
	// 수신자 성명 - 80자
	$KakaoCMS->receiverName = $KakaocertService->encrypt('홍길동');
	// 수신자 생년월일 - 8자 (yyyyMMdd)
	$KakaoCMS->receiverBirthday = $KakaocertService->encrypt('19700101');

	// 인증요청 메시지 제목 - 최대 40자
	$KakaoCMS->reqTitle = '출금동의 요청 메시지 제목';
	// 커스텀 메시지 - 최대 500자
	$KakaoCMS->extraMessage = $KakaocertService->encrypt("출금동의 커스텀 메시지");
	// 인증요청 만료시간 - 최대 1,000(초)까지 입력 가능
	$KakaoCMS->expireIn = 1000;
	// 청구기관명 - 최대 100자
	$KakaoCMS->requestCorp = $KakaocertService->encrypt('청구 기관명란');
	// 출금은행명 - 최대 100자
	$KakaoCMS->bankName = $KakaocertService->encrypt('출금은행명란');
	// 출금계좌번호 - 최대 32자
	$KakaoCMS->bankAccountNum = $KakaocertService->encrypt('9-4324-5117-58');
	// 출금계좌 예금주명 - 최대 100자
	$KakaoCMS->bankAccountName = $KakaocertService->encrypt('예금주명 입력란');
	// 출금계좌 예금주 생년월일 - 8자
	$KakaoCMS->bankAccountBirthday = $KakaocertService->encrypt('19700101');
	// 출금유형
	// CMS - 출금동의용, FIRM - 펌뱅킹, GIRO - 지로용
	$KakaoCMS->bankServiceType = $KakaocertService->encrypt('CMS'); // CMS, FIRM, GIRO

	// AppToApp 인증요청 여부
	// true - AppToApp 인증방식, false - Talk Message 인증방식
	$KakaoCMS->appUseYN = false;

	// App to App 방식 이용시, 호출할 URL
	// $KakaoCMS->returnURL = 'https://kakao.barocert.com';

	try {
		$result = $KakaocertService->requestCMS($clientCode, $KakaoCMS);
	}
	catch(BarocertException $pe) {
		$code = $pe->getCode();
		$message = $pe->getMessage();
	}
?>
	<body>
		<div id="content">
			<p class="heading1">Response</p>
			<br/>
			<fieldset class="fieldset1">
				<legend>카카오 출금동의 요청</legend>
				<ul>
					<?php
						if ( isset($result) ) {
					?>
						<li>접수아이디 (ReceiptID) : <?php echo $result->receiptID ?></li>
						<li>앱스킴 (Scheme) : <?php echo $result->scheme ?></li>
					<?php
						} else {
					?>
						<li>Response.code : <?php echo $code ?> </li>
						<li>Response.message : <?php echo $message ?></li>
					<?php
						}
					?>
				</ul>
			</fieldset>
		</div>
	</body>
</html>

3. 결과 확인

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