튜토리얼

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

1. BaroCert SDK 추가

① .NET SDK 예제코드 다운로드 후 압축을 해제합니다.
② 다운받은 SDK 예제코드의 Linkhub/, Barocert/ 폴더를 SDK를 적용할 프로젝트 경로에 복사하고. Linkhub.csproj, Barocert.csproj를 각각 기존 프로젝트로 추가합니다.
③ Barocert 프로젝트를 적용할 프로젝트의 참조로 추가합니다.

2. BaroCert SDK 설정

프로젝트에 Global.asax.cs 파일을 생성하여 연동환경 설정값, 네이버써트 서비스 클래스를 선언하고 Application_Start() 함수에 네이버써트 서비스 클래스 초기화 코드를 추가합니다.

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.SessionState;
using System.Xml.Linq;

namespace Barocert.Navercert
{
	public class Global : System.Web.HttpApplication
	{
		// Navercert 서비스 객체 선언
		public static NavercertService navercertService;

		// 링크아이디
		private string LinkID = "TESTER";
		// 비밀키
		private string SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=";

		protected void Application_Start(object sender, EventArgs e)
		{
			// Navercert 서비스 객체 초기화
			navercertService = new NavercertService(LinkID, SecretKey);

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

			// 통신 고정 IP, true-사용, false-미사용, (기본값:false)
			navercertService.UseStaticIP = false;
		}
	}
}

3. RequestCMS 기능 구현

Web Form을 추가하여 requestCMS.aspx를 생성하여 응답코드, 메시지 확인 페이지를 추가하고, requestCMS.aspx.cs 파일의 Page_Load 이벤트에 함수 호출 코드를 추가합니다.

requestCMS.aspx.cs

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;

namespace Barocert.Navercert.Example
{
	public partial class requestCMS : System.Web.UI.Page
	{

		public string code;
		public string message;
		public CMSReceipt result;

		/*
		 * 네이버 이용자에게 자동이체 출금동의를 요청합니다.
		 * https://developers.barocert.com/reference/naver/dotnet/cms/api#RequestCMS
		 */
		protected void Page_Load(object sender, EventArgs e)
		{

			// Navercert 이용기관코드, Navercert 파트너 사이트에서 확인
			string clientCode = "023090000021";

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

			// 수신자 휴대폰번호 - 11자 (하이픈 제외)
			cms.receiverHP = Global.navercertService.encrypt("01012341234");
			// 수신자 성명 - 80자
			cms.receiverName = Global.navercertService.encrypt("홍길동");
			// 수신자 생년월일 - 8자 (yyyyMMdd)
			cms.receiverBirthday = Global.navercertService.encrypt("19700101");

			// 인증요청 메시지 제목
			cms.reqTitle = "출금동의 요청 메시지 제목";
			// 인증요청 메시지
			cms.reqMessage = Global.navercertService.encrypt("출금동의 요청 메시지");
			// 고객센터 연락처 - 최대 12자
			cms.callCenterNum = "1600-9854";
			// 인증요청 만료시간 - 최대 1,000(초)까지 입력 가능
			cms.expireIn = 1000;

			// 청구기관명
			cms.requestCorp = Global.navercertService.encrypt("청구기관");
			// 출금은행명
			cms.bankName = Global.navercertService.encrypt("출금은행");
			// 출금계좌번호
			cms.bankAccountNum = Global.navercertService.encrypt("123-456-7890");
			// 출금계좌 예금주명
			cms.bankAccountName = Global.navercertService.encrypt("홍길동");
			// 출금계좌 예금주 생년월일
			cms.bankAccountBirthday = Global.navercertService.encrypt("19700101");

			// AppToApp 인증요청 여부
			// true - AppToApp 인증방식, false - 푸시(Push) 인증방식
			cms.appUseYN = false;
			// ApptoApp 인증방식에서 사용
			// 모바일장비 유형('ANDROID', 'IOS'), 대문자 입력(대소문자 구분)
			// cms.deviceOSType = "IOS";
			// AppToApp 방식 이용시, 호출할 URL
			// "http", "https"등의 웹프로토콜 사용 불가
			// cms.returnURL = "navercert://cms";

			try
			{
				result = Global.navercertService.requestCMS(clientCode, cms);
			}
			catch (BarocertException ex)
			{
				code = ex.code.ToString();
				message = ex.Message;
			}
		}
	}
}

requestCMS.aspx

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="requestCMS.aspx.cs" Inherits="Barocert.Navercert.Example.requestCMS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
	<title>Barocert ASP.NET Example</title>
	<link href="../Example.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="content">
	<p class="heading1">Response</p>
	<br/>
	<fieldset class="fieldset1">
		<legend>네이버 출금동의 요청</legend>
		<ul>
			<% if (!String.IsNullOrEmpty(code)) { %>
				<li>Response.code : <%= code %> </li>
				<li>Response.message : <%= message %></li>
			<% } else { %>
				<li>접수아이디 (ReceiptID) : <%= result.receiptID%></li>
				<li>앱스킴 (Scheme) :  <%= result.scheme %></li>
				<li>앱다운로드URL (MarketURL) :  <%= result.marketUrl %></li>
			<% } %>
		</ul>
	</fieldset>
</div>
</body>
</html>

4. 결과 확인

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