튜토리얼

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

1. BaroCert SDK 추가

Python 바로써트 SDK와 암호화 통신에 필요한 외부 라이브러리(pycryptodome, cffi)를 pip install 명령어를 사용하여 설치합니다.
※ Python v3.10 부터는 OPENSSL v1.1.1 이상이 필요합니다.

$ pip install barocert pycryptodome cffi

2. BaroCert SDK 설정

Django 프로젝트의 settings.py 파일에 연동신청시 발급받은 API Key와 연동환경 설정값을 선언합니다.

# 링크아이디
LinkID = "TESTER"

# 비밀키
SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
IPRestrictOnOff = True

# 통신 고정 IP, true-사용, false-미사용, (기본값:false)
UseStaticIP = False

3. RequestCMS 기능 구현

① Django App에 생성된 views.py 파일에 카카오써트 서비스 클래스 객체 생성과 RequestCMS 함수 코드를 추가합니다.

# -*- coding: utf-8 -*-
from django.shortcuts import render
from config import settings
from barocert import KakaoCMS, KakaocertService, KakaoIdentity, BarocertException, \
    KakaoSign, KakaoMultiSign, KakaoMultiSignTokens


# config/settings.py API Key(LinkID, SecretKey)를 이용해
# KakaocertService 객체 인스턴스 생성
kakaocertService = KakaocertService(settings.LinkID, settings.SecretKey)

# 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
kakaocertService.IPRestrictOnOff = settings.IPRestrictOnOff

# 통신 고정 IP, true-사용, false-미사용, (기본값:false)
kakaocertService.UseStaticIP = settings.UseStaticIP

# 카카오톡 이용자에게 자동이체 출금동의를 요청합니다.
# https://developers.barocert.com/reference/kakao/python/cms/api#RequestCMS
def requestCMSHandler(request):
	try:
		# 이용기관코드, 파트너 사이트에서 확인
		clientCode = '023040000001'

		# 자동이체 출금동의 요청정보 객체
		requestObj = KakaoCMS(

			# 수신자 휴대폰번호 - 11자 (하이픈 제외)
			receiverHP = kakaocertService._encrypt('01012341234'),
			# 수신자 성명 - 80자
			receiverName = kakaocertService._encrypt('홍길동'),
			# 수신자 생년월일 - 8자 (yyyyMMdd)
			receiverBirthday = kakaocertService._encrypt('19700101'),

			# 인증요청 메시지 제목 - 최대 40자
			reqTitle = '출금동의 요청 메시지 제목',
			# 커스텀 메시지 - 최대 500자
			extraMessage = kakaocertService._encrypt('출금동의 커스텀 메시지'),
			# 인증요청 만료시간 - 최대 1,000(초)까지 입력 가능
			expireIn = 1000,

			# 청구기관명 - 최대 100자
			requestCorp = kakaocertService._encrypt('청구 기관명란'),
			# 출금은행명 - 최대 100자
			bankName = kakaocertService._encrypt('출금은행명란'),
			# 출금계좌번호 - 최대 32자
			bankAccountNum = kakaocertService._encrypt('9-4324-5117-58'),
			# 출금계좌 예금주명 - 최대 100자
			bankAccountName = kakaocertService._encrypt('예금주명 입력란'),
			# 출금계좌 예금주 생년월일 - 8자
			bankAccountBirthday = kakaocertService._encrypt('19700101'),
			# 출금유형
			# CMS - 출금동의용, FIRM - 펌뱅킹, GIRO - 지로용
			bankServiceType = kakaocertService._encrypt('CMS'),

			# AppToApp 인증요청 여부
			# true - AppToApp 인증방식, false - Talk Message 인증방식
			appUseYN = False,
		)

		result = kakaocertService.requestCMS(clientCode, requestObj)

		return render(request, 'kakaocert/requestCMS.html', {'result': result})
	except BarocertException as KE:
		return render(request, 'exception.html', {'code': KE.code, 'message': KE.message})

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

{% extends "base.html" %}
{% block contents %}
<div id="content">
	<p class="heading1">Barocert Django Example</p>
	<br />
	<fieldset class="fieldset1">
		<legend>{{ request.path }}</legend>
		<ul>
			<li>접수아이디 (ReceiptID) : {{ result.receiptID }}</li>
			<li>앱스킴 (Scheme) : {{ result.scheme }}</li>
		</ul>
	</fieldset>
</div>
{% endblock contents %}

4. 결과 확인

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