본문으로 바로가기
링크허브 공식블로그

연동이 쉬워진다

링크허브 공식블로그

가치를 연결하다/튜토리얼

[Java - Spring] 팝빌 현금영수증 API 연동 가이드

안녕하세요. 고객의 가치를 연결하는 비즈니스 파트너 링크허브 입니다.


본 포스팅에서는 JAVA - Spring 개발환경에서 고객사들이 팝빌 현금영수증 API SDK를 쉽고 빠르게 이용할 수 있도록, 예시를 이용하여 연동 설정 방법을 안내드리겠습니다. 먼저, SDK를 추가한 후 "즉시발행(RegistIssue) API"를 구현하는 순서로 진행하겠습니다. 

팝빌 SDK는 JDK V1.6 개발환경에 최적화 되어 있으며, API 호출과 응답의 메시지 인코딩은 "UTF-8 Character-Set"을 지원합니다.


"팝빌은 링크허브에서 자체 개발하고 직접 운영하는 현금영수증 서비스 Brand Name 입니다."



아래 설명하는 예시는 [ JDK 1.6 | Tomcat 7 | STS 3.6.4 ] 기준으로 작성되어 있어, 이용 중이신 개발환경과 차이가 있을 수 있는 점 감안해 주시기 바랍니다.


1. Popbill SDK 추가


① "pom.xml" 파일에 팝빌 SDK 라이브러리를 추가합니다. 


<dependency>
	<groupId>kr.co.linkhub</groupId>
	<artifactId>popbill-sdk</artifactId>
	<version>1.20.0</version>
</dependency>


 현금영수증 클래스를 빈으로 등록하기 위해 아래코드를 참조하여  "servlet-context.xml" 파일을 수정합니다.


<?xml version="1.0" encoding="UTF-8"?>

            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:beans="http://www.springframework.org/schema/beans"
            xmlns:context="http://www.springframework.org/schema/context"
            xmlns:util="http://www.springframework.org/schema/util"

<!-- DispatcherServlet Context: defines this servlet's request-processing infrastructure -->
<!-- Enables the Spring MVC @Controller programming model -->
<annotation-driven />

<!-- Handles HTTP GET requests for /resources/** by efficiently serving up static resources in the ${webappRoot}/resources directory -->
<resources mapping="/resources/**" location="/resources/" />

<!-- Resolves views selected for rendering by @Controllers to .jsp resources in the /WEB-INF/views directory -->
<beans:bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<beans:property name="prefix" value="/WEB-INF/views/" />
<beans:property name="suffix" value=".jsp" />
</beans:bean>
<context:component-scan base-package="com.popbill.example" />

<util:properties id="EXAMPLE_CONFIG">

       <!-- 링크아이디 -->
      <beans:prop key="LinkID">TESTER</beans:prop>

       <!-- 비밀키 -->
      <beans:prop key="SecretKey">SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=</beans:prop>

       <!-- 연동환경 설정값 true(개발용), false(상업용) -->
      <beans:prop key="IsTest">true</beans:prop>

       <!-- 인증토큰 아이피 제한 기능 사용여부 권장(true) -->
      <beans:prop key="IsIPRestrictOnOff">true</beans:prop>
  </util:properties>

  <beans:beans>

      <!-- 현금영수증 Service Implementation Bean registration.  -->
      <beans:bean id="cashbillService" class="com.popbill.api.cashbill.CashbillServiceImp">
          <beans:property name="linkID" value="#{EXAMPLE_CONFIG.LinkID}"/>
          <beans:property name="secretKey" value="#{EXAMPLE_CONFIG.SecretKey}"/>
          <beans:property name="test" value="#{EXAMPLE_CONFIG.IsTest}"/>
          <beans:property name="IPRestrictOnOff" value="#{EXAMPLE_CONFIG.IsIPRestrictOnOff}"/>
      </beans:bean>
  </beans:beans>

</beans:beans>


▶ 링크허브에서 발급받은 고객사 인증정보로 링크아이디(LinkID)와 비밀키(SecretKey) 값을 변경하시기 바랍니다.



2. API 구현


① 현금영수증 즉시발행(RegistIssue) 함수를 테스트하기 위해 CashbillServiceExample.java 를 생성하고  GET Request URL 을 처리하는 코드를 추가합니다. 

- 예제코드를 참조하여 @Controller 어노테이션 과 현금영수증 서비스 객체주입을 위한 @Autowired 어노테이션을 추가합니다. 





 API 호출 결과를 확인하기 위한 "src/main/webapp/WEB-INF/views/response.jsp" 페이지를 생성합니다.


<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<title>현금영수증 API 연동 가이드</title>
	</head>

	<body>
		Response.code : ${Response.code}</br>
		Response.message : ${Response.message}
	</body>
</html>



 현금영수증 발행 처리결과를 응답메시지를 통해 확인합니다.


예) 함수호출 성공처리



예) 함수호출 실패처리






 발행된 현금영수증은 팝빌 개발용(test.popbill.com) 사이트에서 확인할 수 있습니다.

[참고] 팝빌 연동 개발을 위한 테스트베드(개발용) 안내 - https://linkhub.tistory.com/91



팝빌에서 제공하는 다양한 API는 동일한 컨셉으로 개발되어 있어, 하나의 서비스를 이용한 경험이 있으면 다른 서비스들도 유사한 방법으로 빠르게 연동이 가능하니 많은 이용 부탁드립니다. 


지금까지 JAVA - Spring 개발환경에서 현금영수증 API를 연동하는 방법에 대해 안내해 드렸는데, 내용에 대한 추가적인 문의가 있으면 기술지원센터로 편하게 연락주시기 바랍니다.





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

기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr







  • Today
  • Total