팝빌 API 상업용 전환절차 안내

팝빌 연동서비스

SDK 적용방법

2018.07.04

팝빌 API SDK 연동개발 테스트 완료 후, 실제 서비스 운영을 위한 “상업용”으로 전환하는 절차는 다음과 같습니다.

STEP1. 팝빌 API 상업용 채널 오픈 요청
팝빌 API에서 연동개발을 완료한 API의 채널을 오픈하셔야 상업용 환경에서 정상적으로 이용이 가능합니다.

– 담당자 : 마케팅팀 이형국 팀장 / T. 1600-8536 / D. 070-4304-2980 / E. hklee@linkhub.co.kr
STEP2. [상업용] 팝빌 연동회원 가입

상업용 환경에서 팝빌 API를 이용하기 위해서는 실제 서비스인 팝빌에 연동회원으로 가입을 하셔야 합니다.

[참고] [상업용] 팝빌 연동회원 가입절차 안내 [http://www.popbill.com] 바로가기

STEP3. SDK 설정 변경 [테스트용 → 상업용]
SDK 소스코드의 연동환경 설정값을 상업용으로 변경하면 간단하게 전환절차가 완료됩니다.

자세한 설명은 아래의 “개발언어별 SDK 설정 변경 예시”를 참조하시기 바랍니다.

Java(SpringMVC) SDK 설정 변경

“servlet-context.xml” 파일의 IsTest Property 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


	<!-- 
		LinkID : 링크허브에서 발급받은 파트너 링크아이디.
		SecretKey : 링크허브에서 발급받는 비밀키.
		IsTest : true이면 test.popbill.com으로 연결, 기본값은 false. 
	-->
	<util:properties id="EXAMPLE_CONFIG">
		<beans:prop key="TestCorpNum">1234567890</beans:prop>
		<beans:prop key="TestUserID">testkorea</beans:prop>
		<beans:prop key="LinkID">TESTER</beans:prop>
		<beans:prop key="SecretKey">3v5o87sx07SrQ1ao1207YKZT+Fcil9OkYPPYpbFslj8=</beans:prop>
		<beans:prop key="IsTest">false</beans:prop>
		
	</util:properties>

<!--

LinkID : 링크허브에서 발급받은 파트너 링크아이디.

SecretKey : 링크허브에서 발급받는 비밀키.

IsTest : true이면 test.popbill.com으로 연결, 기본값은 false.

-->

<util:properties id="EXAMPLE_CONFIG">

<beans:prop key="TestCorpNum">1234567890</beans:prop>

<beans:prop key="TestUserID">testkorea</beans:prop>

<beans:prop key="LinkID">TESTER</beans:prop>

<beans:prop key="SecretKey">3v5o87sx07SrQ1ao1207YKZT+Fcil9OkYPPYpbFslj8=</beans:prop>

<beans:prop key="IsTest">false</beans:prop>

</util:properties>

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Java(JSP) SDK 설정 변경

“common.jsp” 파일의 test property의 value를 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


<%@page errorPage="/exception.jsp" %>
<jsp:useBean id="taxinvoiceService" scope="application" 
class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>

<%-- 연동아이디 --%>
<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTER"/>

<%-- 발급받은 비밀키, 사용자 인증에 사용되는 정보이므로 유출에 주의 --%>
<jsp:setProperty name="taxinvoiceService" property="secretKey" 
value="kcZrgaTm8V8i3MisdunwWOHDTCjMq/+o/dyENejL+mo="/>

<%-- API요청 환경설정을 위한 설정값. true(테스트용), false(상업용)
     상업용으로 전환 시 false로 처리. --%>
<jsp:setProperty name="taxinvoiceService" property="test" value="false"/>

<%@page errorPage="/exception.jsp" %>

<jsp:useBean id="taxinvoiceService" scope="application"

class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>

<%-- 연동아이디 --%>

<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTER"/>

<%-- 발급받은 비밀키, 사용자 인증에 사용되는 정보이므로 유출에 주의 --%>

<jsp:setProperty name="taxinvoiceService" property="secretKey"

value="kcZrgaTm8V8i3MisdunwWOHDTCjMq/+o/dyENejL+mo="/>

<%-- API요청 환경설정을 위한 설정값. true(테스트용), false(상업용)

상업용으로 전환 시 false로 처리. --%>

<jsp:setProperty name="taxinvoiceService" property="test" value="false"/>

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

C#.NET SDK 설정 변경

“frmExample.cs” 파일의 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


using System;
using System.Collections.Generic;
using System.Windows.Forms;

namespace Popbill.Taxinvoice.Example.csharp
{
    public partial class frmExample : Form
    {
        //연동상담시 발급받은 연동아이디
        private string LinkID = "TESTER";
        //연동상담시 발급받은 비밀키
        private string SecretKey = "OTbVGsQdnLrc8kmmyIXr8W+nX+vDH6tAERiM+DNPFXo=";

        private TaxinvoiceService taxinvoiceService;

        private const string CRLF = "\r\n";

        public frmExample()
        {
            InitializeComponent();
            //초기화
            taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey);
            //테스트를 완료한후 아래 변수를 false로 변경하거나, 아래줄을 삭제하여 상업용 환경으로 전환
            taxinvoiceService.IsTest = false;
        }

using System;

using System.Collections.Generic;

using System.Windows.Forms;

namespace Popbill.Taxinvoice.Example.csharp

{

public partial class frmExample : Form

{

//연동상담시 발급받은 연동아이디

private string LinkID = "TESTER";

//연동상담시 발급받은 비밀키

private string SecretKey = "OTbVGsQdnLrc8kmmyIXr8W+nX+vDH6tAERiM+DNPFXo=";

private TaxinvoiceService taxinvoiceService;

private const string CRLF = "\r\n";

public frmExample()

{

InitializeComponent();

//초기화

taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey);

//테스트를 완료한후 아래 변수를 false로 변경하거나, 아래줄을 삭제하여 상업용 환경으로 전환

taxinvoiceService.IsTest = false;

}

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

VB.NET SDK 설정 변경

“frmExample.vb” 파일의 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


Public Class frmExample

    '링크아이디
    Private LinkID As String = "TESTER"

    '비밀키
    Private SecretKey As String = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

    '세금계산서 서비스 변수 선언
    Private taxinvoiceService As TaxinvoiceService

    Private Sub frmExample_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

        '세금계산서 서비스 객체 초기화
        taxinvoiceService = New TaxinvoiceService(LinkID, SecretKey)

        '연동환경 설정값 (True-개발용, False-상업용)
        taxinvoiceService.IsTest = True

    End Sub

Public Class frmExample

'링크아이디

Private LinkID As String = "TESTER"

'비밀키

Private SecretKey As String = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

'세금계산서 서비스 변수 선언

Private taxinvoiceService As TaxinvoiceService

Private Sub frmExample_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

'세금계산서 서비스 객체 초기화

taxinvoiceService = New TaxinvoiceService(LinkID, SecretKey)

'연동환경 설정값 (True-개발용, False-상업용)

taxinvoiceService.IsTest = True

End Sub

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

ASP.NET SDK 설정 변경

“Global.asax” 파일의 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


namespace Popbill.Taxinvoice
{
    public class Global : System.Web.HttpApplication
    {
        // 링크아이디
        private string LinkID = "TESTER";

        // 비밀키
        private string SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=";

        // 세금계산서 서비스 객체 선언
        public static TaxinvoiceService taxinvoiceService;

        protected void Application_Start(object sender, EventArgs e)
        {
            // 세금계산서 서비스 객체 초기화
            taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey);

            // 연동환경 설정값, 개발용(true), 상업용(false)
            taxinvoiceService.IsTest = true;
        }
    }
}

namespace Popbill.Taxinvoice

{

public class Global : System.Web.HttpApplication

{

// 링크아이디

private string LinkID = "TESTER";

// 비밀키

private string SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=";

// 세금계산서 서비스 객체 선언

public static TaxinvoiceService taxinvoiceService;

protected void Application_Start(object sender, EventArgs e)

{

// 세금계산서 서비스 객체 초기화

taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey);

// 연동환경 설정값, 개발용(true), 상업용(false)

taxinvoiceService.IsTest = true;

}

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

PHP SDK 설정 변경

“common.php” 파일의 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


<?php

require_once '../Popbill/PopbillTaxinvoice.php';

//연동 아이디
$LinkID = 'TESTER';
//발급받은 비밀키. 유출에 주의하시기 바랍니다.
$SecretKey = 'jkjiPCCWfjb9yItA2CMxemSQDVEyBxZg0iymxZvaWKc=';

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

//테스트모드로 설정되면 test.popbill.com으로 연결됩니다.
//작업을 완료한 후에는 테스트모드설정을 해제하여 사용합니다. ex)아래 라인 주석처리하거나, false처리.
$TaxinvoiceService->IsTest(false);

?>

<?php

require_once '../Popbill/PopbillTaxinvoice.php';

//연동 아이디

$LinkID = 'TESTER';

//발급받은 비밀키. 유출에 주의하시기 바랍니다.

$SecretKey = 'jkjiPCCWfjb9yItA2CMxemSQDVEyBxZg0iymxZvaWKc=';

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

//테스트모드로 설정되면 test.popbill.com으로 연결됩니다.

//작업을 완료한 후에는 테스트모드설정을 해제하여 사용합니다. ex)아래 라인 주석처리하거나, false처리.

$TaxinvoiceService->IsTest(false);

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Python SDK 설정 변경

“testValue.py” 파일의 IsTest 변수 값을 “true”에서 “False”로 변경하면 상업용으로 전환됩니다.


# -*- coding: utf-8 -*-
LinkID =  'TESTER'
SecretKey  =  'Tyt59MzcdINLqbZI4Duz1SWmcsatSyYf1h5WrqqoPtc='
IsTest = False
testCorpNum = "1231212312" #테스트 회원 사업자번호
testUserID = "userid" #테스트 회원 팝빌 아아디

# -*- coding: utf-8 -*-

LinkID = 'TESTER'

SecretKey = 'Tyt59MzcdINLqbZI4Duz1SWmcsatSyYf1h5WrqqoPtc='

IsTest = False

testCorpNum = "1231212312" #테스트 회원 사업자번호

testUserID = "userid" #테스트 회원 팝빌 아아디

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Django SDK 설정 변경

“config/settings.py” 파일의 IsTest 변수 값을 “true”에서 “False”로 변경하면 상업용으로 전환됩니다.


# 링크아이디
LinkID = "TESTER"

# 발급받은 비밀키, 유출에 주의하시기 바랍니다.
SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 연동환경 설정값, 개발용(True), 상업용(False)
IsTest = True

# 팝빌회원 사업자번호
testCorpNum = "1234567890"

# 팝빌회원 아아디
testUserID = "testkorea"

# 링크아이디

LinkID = "TESTER"

# 발급받은 비밀키, 유출에 주의하시기 바랍니다.

SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 연동환경 설정값, 개발용(True), 상업용(False)

IsTest = True

# 팝빌회원 사업자번호

testCorpNum = "1234567890"

# 팝빌회원 아아디

testUserID = "testkorea"

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

ASP SDK 설정 변경

“common.asp” 파일의 IsTest 변수 값을 “true”에서 “False”로 변경하면 상업용으로 전환됩니다.


<!--#include virtual="/Popbill/Popbill.asp"--> 
<!--#include virtual="/Popbill/TaxinvoiceService.asp"-->
<%
	'연동상담시 발급받은 연동아이디' 
	LinkID = "TESTER"
	'연동상담시 발급받은 비밀키, 유출에 주의'
	SecretKey ="ut8QMlWBgUYLCgvHqit0rmPdyBPNeWUziQLT0osDvXQ="

	set m_TaxinvoiceService = new TaxinvoiceService
	m_TaxinvoiceService.Initialize LinkID, SecretKey

	'연동환경설정값, 테스트완료후 상업용 전환시 False로 값을 수정하거나 주석처리.'
	m_TaxinvoiceService.IsTest = False
%>

'연동상담시 발급받은 연동아이디'

LinkID = "TESTER"

'연동상담시 발급받은 비밀키, 유출에 주의'

SecretKey ="ut8QMlWBgUYLCgvHqit0rmPdyBPNeWUziQLT0osDvXQ="

set m_TaxinvoiceService = new TaxinvoiceService

m_TaxinvoiceService.Initialize LinkID, SecretKey

'연동환경설정값, 테스트완료후 상업용 전환시 False로 값을 수정하거나 주석처리.'

m_TaxinvoiceService.IsTest = False

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Delphi SDK 설정 변경

“Example.pas” 파일 FormCreate 프로시저의 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


procedure TfrmExample.FormCreate(Sender: TObject);
begin
        MgtKeyType := SELL;
        //세금계산서 모듈 초기화.
        taxinvoiceService := TTaxinvoiceService.Create(LinkID,SecretKey);
        taxinvoiceService.IsTest := false;
end;

168

169

170

171

172

173

174

175

176

procedure TfrmExample.FormCreate(Sender: TObject);

begin

MgtKeyType := SELL;

//세금계산서 모듈 초기화.

taxinvoiceService := TTaxinvoiceService.Create(LinkID,SecretKey);

taxinvoiceService.IsTest := false;

end;

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Visual Basic SDK 설정 변경

“frmExample.frm” 파일 Form_Load() 프로시저의 IsTest 변수 값을 “False”로 변경하면 상업용으로 전환됩니다.


Private Sub Form_Load()
    TaxinvoiceService.Initialize linkID, SecretKey
    TaxinvoiceService.IsTest = False
        
    cboPopbillTOGO.AddItem "LOGIN"
    cboPopbillTOGO.AddItem "CHRG"
    cboPopbillTOGO.AddItem "CERT"

    cboMgtKeyType.AddItem "SELL"
    cboMgtKeyType.AddItem "BUY"
    cboMgtKeyType.AddItem "TRUSTEE"
    
End Sub

2276

2277

2278

2279

2280

2281

2282

2283

2284

2285

2286

2287

2288

2289

2290

Private Sub Form_Load()

TaxinvoiceService.Initialize linkID, SecretKey

TaxinvoiceService.IsTest = False

cboPopbillTOGO.AddItem "LOGIN"

cboPopbillTOGO.AddItem "CHRG"

cboPopbillTOGO.AddItem "CERT"

cboMgtKeyType.AddItem "SELL"

cboMgtKeyType.AddItem "BUY"

cboMgtKeyType.AddItem "TRUSTEE"

End Sub

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

VBA SDK 설정 변경

“taxinvoice_example.accdb(mdb)” 파일 Form_Load() 프로시저의 IsTest 변수 값을 “”false”로 변경하면 상업용으로 전환됩니다.


Private Sub Form_Load()
    TaxinvoiceService.Initialize linkID, SecretKey
    
    TaxinvoiceService.IsTest = False
    '연동환경설정값(TaxinvoiceService.IsTest) - True(테스트용), False(상업용)'
    '테스트 완료후 연동환경설정값을 False로 변경시 상업용으로 전환'
End Sub

1562

1563

1564

1565

1566

1567

1568

1569

1570

Private Sub Form_Load()

TaxinvoiceService.Initialize linkID, SecretKey

TaxinvoiceService.IsTest = False

'연동환경설정값(TaxinvoiceService.IsTest) - True(테스트용), False(상업용)'

'테스트 완료후 연동환경설정값을 False로 변경시 상업용으로 전환'

End Sub

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

PowerBuilder SDK 설정 변경

Window폼의 “open 탭” 에 선언되어 있는 setistest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


in_taxinvoiceservice = create taxinvoiceservice
in_taxinvoiceservice.linkid = in_linkid
in_taxinvoiceservice.secretkey = in_secretkey
in_taxinvoiceservice.setistest(false)
// setistest = 연동환경설정값, true - 테스트용, false - 상업

in_taxinvoiceservice = create taxinvoiceservice

in_taxinvoiceservice.linkid = in_linkid

in_taxinvoiceservice.secretkey = in_secretkey

in_taxinvoiceservice.setistest(false)

// setistest = 연동환경설정값, true - 테스트용, false - 상업

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Node.js SDK 설정 변경

“/routes/taxinvoice.js” 파일에 IsTest 변수 값을 “true”에서 “false”로 변경하면 상업용으로 전환됩니다.


var express = require('express');
var router = express.Router();
var popbill = require('popbill');

popbill.config({
  LinkID :'TESTER', //링크아이디
  SecretKey : 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=', //비밀키
  IsTest : false,   //연동환경 설정값, true(테스트용), false(상업용)
  defaultErrorHandler :  function(Error) {
    console.log('Error Occur : [' + Error.code + '] ' + Error.message);
  }
});

// 전자세금계산서 API 모듈 초기화
var taxinvoiceService = popbill.TaxinvoiceService();

var express = require('express');

var router = express.Router();

var popbill = require('popbill');

popbill.config({

LinkID :'TESTER', //링크아이디

SecretKey : 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=', //비밀키

IsTest : false, //연동환경 설정값, true(테스트용), false(상업용)

defaultErrorHandler : function(Error) {

console.log('Error Occur : [' + Error.code + '] ' + Error.message);

}

});

// 전자세금계산서 API 모듈 초기화

var taxinvoiceService = popbill.TaxinvoiceService();

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

Ruby Rails SDK 설정 변경

테스트 완료 후 연동환경을 상업용으로 설정하기 위해서는 controller 파일에 setIsTest 값을 “false” 로 처리하면 상업용 연동환경 설정이 완료됩니다.

require 'popbill/taxinvoice'

class TaxinvoiceController < ApplicationController

  # 링크아이디
  LinkID = "TESTER"

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

  # 팝빌 연동회원 사업자번호
  TestCorpNum = "1234567890"

  # 팝빌 연동회원 아이디
  TestUserID = "testkorea"

  # 팝빌 전자세금계산서 API Service 초기화
  TIService = TaxinvoiceService.instance(
    TaxinvoiceController::LinkID,
    TaxinvoiceController::SecretKey
  )

  # 연동환경 설정, true-개발용, false-상업용
  TIService.setIsTest(false)

require 'popbill/taxinvoice'

class TaxinvoiceController < ApplicationController

# 링크아이디

LinkID = "TESTER"

# 비밀키

SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

# 팝빌 연동회원 사업자번호

TestCorpNum = "1234567890"

# 팝빌 연동회원 아이디

TestUserID = "testkorea"

# 팝빌 전자세금계산서 API Service 초기화

TIService = TaxinvoiceService.instance(

TaxinvoiceController::LinkID,

TaxinvoiceController::SecretKey

)

# 연동환경 설정, true-개발용, false-상업용

TIService.setIsTest(false)

※ 링크허브에서 발급한 인증정보(LinkID/SecretKey)는 상업용과 테스트용 모두 동일하므로 별도의 수정 불필요!

지금까지 팝빌 API 상업용 전환절차에 대해 안내해 드렸습니다. 링크허브에서 제공되는 API 상품에 대한 자세한 사항은 [ 링크허브 홈페이지 > API 상품 ] 참조하시기 바랍니다.

고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.

링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr

SDK 적용방법

' 카테고리에 해당되는 글

[VBA] SDK 적용방법 2018.07.04

[PowerBuilder] SDK 적용방법 2018.07.04

팝빌 API 상업용 전환절차 안내 2018.07.04