튜토리얼
PHP 개발환경에서 팝빌 SDK를 추가하여 현금영수증 즉시 발행 (RegistIssue) 함수를 구현하는 예시입니다.
1. POPBiLL SDK 추가 및 설정
① 팝빌 연동자료실에서 PHP SDK 예제코드 다운로드 후 압축을 해제합니다.
② 압축해제한 SDK 예제코드에 포함된 Popbill/ 폴더를 웹사이트 Root Directory 경로에 복사합니다.
③ 서비스 연동환경 설정을 위해 프로젝트 Root Directory에 common.php 파일을 생성하고 아래의 코드를 참고하여 API Key 를 설정합니다.
<?php
require_once './Popbill/PopbillCashbill.php';
// 링크아이디
$LinkID = 'TESTER';
// 비밀키
$SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';
// 통신방식 기본은 CURL , curl 사용에 문제가 있을경우 STREAM 사용가능.
// STREAM 사용시에는 php.ini의 allow_url_fopen = on 으로 설정해야함.
define('LINKHUB_COMM_MODE','CURL');
// 서비스 객체 초기화
$CashbillService = new CashbillService($LinkID, $SecretKey);
// 연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
$CashbillService->IsTest(true);
// 인증토큰 IP 검증 설정, true-사용, false-미사용, (기본값:true)
$CashbillService->IPRestrictOnOff(true);
// 통신 IP 고정, true-사용, false-미사용, (기본값:false)
$CashbillService->UseStaticIP(false);
// 로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:true)
$CashbillService->UseLocalTimeYN(true);
?>
2. RegistIssue 기능 구현
프로젝트 Root Directory에 함수 호출을 처리하는 파일을 생성하고, 아래의 코드를 참조하여 코드를 추가합니다.
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Popbill Cashbill Response</title>
</head>
<?php
include 'common.php';
// 팝빌 회원 사업자번호, '-' 제외 10자리
$testCorpNum = '1234567890';
// 문서번호
// 문서 관리를 위해 파트너가 할당하는 식별번호
// 1~24자리 영문 대소문자, 숫자, 특수문자('-','_')로 구성
$mgtKey = '20250314-001';
// 현금영수증 객체 생성
$Cashbill = new Cashbill();
$Cashbill->mgtKey = $mgtKey;
// 거래일시, 형식(yyyyMMddHHmmss)
// 발행기준 전일부터 당일까지 입력 가능
// 미입력시 기본값(발행일시) 처리됨
$Cashbill->tradeDT = '20250319093919';
// 문서형태
$Cashbill->tradeType = '승인거래';
// 거래구분, [소득공제용, 지출증빙용] 중 기재
$Cashbill->tradeUsage = '소득공제용';
// 거래유형, [일반, 도서공연, 대중교통] 중 기재
$Cashbill->tradeOpt = '일반';
// 과세형태, [과세, 비과세] 중 기재
$Cashbill->taxationType = '과세';
// 합계금액, 공급가액 + 부가세 + 봉사료
$Cashbill->totalAmount = '11000';
// 공급가액
$Cashbill->supplyCost = '10000';
// 부가세
$Cashbill->tax = '1000';
// 봉사료
$Cashbill->serviceFee = '0';
// 가맹점 사업자번호, "-" 제외 10자리
$Cashbill->franchiseCorpNum = $testCorpNum;
// 가맹점 종사업장 식별번호
$Cashbill->franchiseTaxRegID = '';
// 가맹점 상호
$Cashbill->franchiseCorpName = '발행자 상호';
// 가맹점 대표자 성명
$Cashbill->franchiseCEOName = '발행자 대표자명';
// 가맹점 주소
$Cashbill->franchiseAddr = '발행자 주소';
// 가맹점 전화번호
$Cashbill->franchiseTEL = '070-1234-1234';
// 식별번호, 거래구분에 따라 작성
// 소득공제용 - 주민등록/휴대폰/카드번호/자진발급용 번호(010-000-1234) 기재가능
// 지출증빙용 - 사업자번호/주민등록/휴대폰/카드번호 기재가능
$Cashbill->identityNum = '0101112222';
// 주문 상품명
$Cashbill->itemName = '상품명';
// 주문번호
$Cashbill->orderNumber = '주문번호';
// 구매자(고객) 성명
$Cashbill->customerName = '고객명';
// 구매자(고객) 이메일
// 팝빌 개발환경에서 테스트하는 경우에도 안내 메일이 전송되므로,
// 실제 구매자의 메일주소가 기재되지 않도록 주의
$Cashbill->email = 'test@test.com';
// 구매자(고객) 휴대폰
$Cashbill->hp = '010-111-222';
// 구매자 알림문자 전송 여부
// 알림문자 전송시 포인트가 차감되며, 전송실패시 환불처리됨
$Cashbill->smssendYN = false;
// 현금영수증 상태 이력을 관리하기 위한 메모
$memo = '현금영수증 즉시 발행 메모';
// 팝빌회원 아이디
$testUserID = 'testkorea';
// 현금영수증 발행 안내메일 제목
$emailSubject = null;
try {
$result = $CashbillService->RegistIssue($testCorpNum, $Cashbill, $memo, $testUserID, $emailSubject);
$code = $result->code;
$message = $result->message;
}
catch(PopbillException $pe) {
$code = $pe->getCode();
$message = $pe->getMessage();
}
?>
<body>
<div id="content">
<p class="heading1">Response</p>
<br/>
<fieldset class="fieldset1">
<legend>현금영수증 즉시 발행</legend>
<ul>
<li>Response.code : <?php echo $code ?></li>
<li>Response.message : <?php echo $message ?></li>
</ul>
</fieldset>
</div>
</body>
</html>
3. 결과 확인
함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 숫자 1 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]