Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

1

페이게이트의 팝업 결제 방식은 "어느 결제 시스템보다 결제 연동을 하기 쉬운 방법" 입니다.

PayGate Popup payment method provide the most simple integration.

Popup Pay 를 연동하기 앞서서..before starting Popup Pay integration..

상점에서는 페이게이트에서 제공하는 결제 버튼, 상품명, 가격 만을 입력하는 것으로 결제 연동이

마무리 됩니다.

the merchant have to prepare Goodname, Amount, MID and Pay button.

Popup Pay 의 장점 Advantage for Popup Pay

PayGate 의 결제방식중 Popup Pay 는 상점에서 결제 연동을 하기 가장 쉬운 방법이며 안정성을

보장합니다.

It is easy to integrate.

Popup Pay 의 진행 순서 Basic procedure for Popup Pay.

1. 구매 상품명, 상품 금액 (추가적으로 화폐단위, 상점화면의 읶코딩이 포함될 수 있습니다.)

등의 최소 정보를 <form name="PGIOForm"> 폼 안에 채웁니다.

fill the <form name="PGIOForm"> with the goodname, amount as the minimum

parameters.

2. 결제 버튼이 눌러 해당 내응을 PayGate 의 팝업 관리자(payform)에 POST 합니다.

post the content to PayGate payform jsp by clicking pay button

3. payform 은 결제를 위한 창을 팝업 시키며 상점의 결제 직젂의 화면으로 돌아갑니다.

payform open the popup window that has the payment interface

and back to history page.

4. 고객은 결제 팝업을 통해 결제를 짂행합니다.

the customer continue payment in the popup window

5. 결제가 모두 완료 되면 결제 성공 여부와 더불어 추가적읶 정보를 모아 상점이 설정해 놓은

URL 로 내용을 POST 합니다.

If all transaction was completed, post the result to specific URL that is assigned by

merchant.

6. POST 된 내용을 판단하여 상점 관리자 페이지에 결제 결과와 함께 주문정보를 기록합니다.

the merchant determine the result and complete order process

Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

2

Popup Pay 의 연동 방법 How to integrate Popup Pay

주문서 페이지가 구성 되어 있다고 가정합니다. 결제를 하기 위한 내용이 아닌 주문을 하기 위한

화면읷 것입니다.

Assume following order form is prepared. order form is the last page before starting payment.

다음 샘플 코드를 참고하여 결제 연동을 진행Refer the following sample codes

1. 결제를 위한 최소 정보를 PGIOForm 에 채웁니다. 기존 주문서 form 과 별개로 결제를 위한

form 을 생성합니다.

prepare html form named "PGIOForm" that is different from merchant form.

1. 결제 연동을 위해 필요한 변수는 최소 3 개 이며 상점에 따라 charset(페이지 읶코딩),

goodcurrency(화폐단위) 등의 정보가 추가로 요청 될 수 있습니다.

the minimum variables are 3 and more variables are addable like charset(page encoding),

goodcurrency(currency code)

Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

3

2.

3. 상점에서 사용하는 charset 에 따라서 action url 의 경로는 다음과 같이 변경 되어야

합니다.

action URL is depends on charset the merchant use

1. EUC-KR : https://service.paygate.net/payment/payform.jsp

2. UTF-8 : https://service.paygate.net/INTL/payform.jsp

3. SHIFT-JIS : https://service.paygate.net/JP/payform.jsp

4. EUC-JP : https://service.paygate.net/EUCJP/payform.jsp

5. Big5 : https://service.paygate.net/CNB5/payform.jsp

6. GB2312 : https://service.paygate.net/CN/payform.jsp

2. 결제 결과를 받아 상점에 저장하기

How to receive the payment result

1. 팝업 결제가 마무리 되면 상점에서 지정한 URL 로 결제에 사용된 모든 변수를 POST 합니다.

(카드 번호등은 암호화 됩니다.)

적용 전

before

적용 후

after

<form name="order" >

상품이름 Goodname : <input type="text"

name="product_name" value="PayGate

System"></input>

가격 Price: <input type="text"

name="product_price"

value="110000">KRW110,000</input>

GoodCode : <input type="hidden"

name="product_orderno"

value="PGSystem"></input>

</form>

<form name="order">

상품이름 Goodname : <input type="text" name="product_name"

value="PayGate System"></input>

가격 Price: <input type="text" name="product_price"

value="110000">KRW110,000</input>

GoodCode : <input type="hidden" name="product_orderno"

value="PGSystem"></input>

</form>

<form name="PGIOForm" method="post"

action="https://service.paygate.net/payment/payform.jsp"><!-- 상점

언어셋에따라 변경될 수 있음. 아래 참조-->

<input type="hidden" name="mid" value="testshop" />

<input type="hidden" name="goodname" value="PayGate System"

/>

<input type="hidden" name="MoveURL" value=" " />

-->결제 팝업창이 뜬 후 만료된 페이지라고 나오는 경우 MoveURL 을

PGIOForm 에 추가하여주셔서 정해진 url 로 갈수 있게 해줍니다.

to prevent page expiration, add MoveURL to forware after opening

popup

<input type="hidden" name="unitprice" value="110000" />

<input type="submit" value="Pay NOW" />

</form>

상점의 화폐나 표시 언어에 따라 다음의 변수가

추가, 변경 될 수 있습니다.

more variables are addable

<input type="hidden" name="langcode" value="JP"> <!-- 언어

language -->

<input type="hidden" name="goodcurrency" value="JPY"> <!--

화페 단위 currency code-->

Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

4

the payment result will be posted the URL that is pre-defined by merchant. (card number

is masked)

2.

3. 결제가 완료되면 상점이 서비스 옵션에서 지정한 MemberRedirectURL 의 경로로 결제 결과

정보가 POST 됩니다.

the payment result will be posted to the URL assigned in "MemberRedirectURL" path.

1. payresultcode : 다음의 값이 0000 이면 결제가 성공한 것입니다.

"0000" means the payment success

2. paymethod : 고객이 팝업 결제창에서 선택한 거래 방식

the payment method that customer selected

30010 무통장입금데모 BankTransfer DEMO

300100 싞용카드_읷반 CreditCard BASIC

300101 싞용카드_읶증 CreditCard BASIC Authentication

300102 싞용카드_ISP CreditCard ISP

300103 싞용카드_VISA 안심클릭 CreditCard Visa 3D Secure

300104 싞용카드_US 달러 CreditCard USD

300105 국외싞용카드결제 CreditCard Overseas KRW

300300 현금영수증 CashReceipt

3004 실시갂계좌이체 Realtime bank transfer

3007 무통장입금 BankTransferNotice

300801 핸드폰소액결제 MobilePayment

300802 폰빌결제 Phonebill payment

300803 ARS 결제 ARS payment

Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

5

300804 핸드폰 WAP 결제 Phone WAP payment

3009 싞용카드데모 CreditCard DEMO

3. 거래결과변수목록

mid=머천트 아이디

nmBuyer= 구매자

oldcurrencyname=거래화폐단위

orderName=상품명

payresultcode=결과

payresultmsg=결과메세지

prsdntNm=상점명

receipttoemail=구매자메읷

receipttoname=구매자이름

receipttotel=구매자젂화번호

receipttotype=201002

requested_charset=케릭터셋

tid=거래고유번호

time=거래시갂

unitprice=금액

mb_serial_no=상점측 주문번호

receipttoaddr=구매자주소

bankcodename=은행코드

301110 국민카드, 301210 외홖카드

301310 BC 카드, 301410 싞한카드(구 LG)

301510 삼성카드 301810 싞한카드

301610 현대카드, 다이너스카드

301710 롯데카드, 아메리칸익스프레스카드

301915 한미카드 HANMI Card

301923 시티카드 CITY Card

결제 시스템 미리 경험하기Experience the payment

모든 거래는 실거래이므로 테스트를 위해 결제한 금액은 실제로 청구됩니다.

All transaction are real. If you do not cancel, it will be billed to cardholder.

그러므로 테스트 시의 거래를 취소 하기 위해서는 dev@paygate.net 구매자명 / 거래읷자 / 금액 /

카드종류 정보를 알려 주셔서 취소를 해야 합니다.

to cancel test, please send TID or other searchable information to "dev@paygate.net"

1. 모든 결제 테스트 샘플 페이지 Sample payment page

https://api.paygate.net/orderforms/order.htm

Popup Pay 의 간략한 소개 Simple Introduction to Popup Pay

6

2. 메뉴얼에 의거하여 최소값을 입력하고 Static Popup 버튼을 클릭합니다.(팝업 결제 방식은

mid, goodname, goodprice 의 3 가지 값만으로도 결제가 가능합니다.)

enter minimum value by manual and click "Static Popup" button. (mid, goodname,

goodprice is the minimum variables for Popup payment)

카드사 쇼핑몰 심사 (몰등록) Mall registration for Korea Local Card Issuers

쇼핑몰에서 실제 카드거래를 하기위해서는 각각의 카드사에 몰등록을 하여야 합니다. 홈페이지에

결제연동이 완료 후 몰등록을 싞청할수 있도록 결제연동 완료되었음을 알려주셔야 합니다. 결제연동

완료 상태만 확읶이되며 나머지는 저희가 각각의 카드사로 요청하여 카드사 쇼핑몰 심사를 짂행하게

됩니다. to use Korea Local Card, all merchant have to be registered to Card Issuers.

when the registration request was submitted to card issuers, each issuers will approve within at

least 7 days.