결제를 진행하기 위한 변수값을 PGIOForm에 채운다.
해당 결제를 진행하기 위한 정보들은 PGIOForm 을 name으로 하는 form tag안의 input 정보로 기록되어야 한다
- 적용전
<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 name="product_orderno" value="PGSystem"></input> </form> |
- 카드결제일 경우의 적용후 예제
<form name="PGIOForm"> <input name="mid" value="testshop" />Merchant ID <input name="paymethod" value="card" />Paymethod <input name="goodname" value="상품 A" />Goodname <input name="unitprice" value="110000" />Price <input name="cardquota" value="" />Card Quota <input name="cardexpiremonth" />Card Expiry month <input name="cardexpireyear" />Card Expiry year <input name="cardsecretnumber" />Card CVV2 value <input name="cardownernumber" />first 6 digits of card owner SSN (for Korean user only) <input name="cardtype" />CardType <input name="cardnumber" />CardNumber <input name="cardauthcode" />Approval No <input name="replycode" value="" />Payment Result Code <input name="replyMsg" value="" />Payment Result Message </form> |
- PGIOForm 안의 실제 value들은 주문서가 화면에 출력되는 시점에서 생성되거나, "결제" 버튼을 누를 때 javascript 등을 통해 값을 채워 넣어도 된다.
- 다음의 내용은 필요한 값만 채우는 것이 아니라 기본적으로 PayGate OpenPayAPI Manual 에서 명시한 input tag는 모두 만들어져 있어야 함. 이유는 결제 시작을 위한 부분도 있지만 결제 완료시에 화면에 기록될 내용을 사용하기 위한 임시 저장공간이 필요하기 때문이다.
- 해외 결제인 경우 langcode, goodcurrency 등의 추가적인 변수가 필요할 수 있으며 자세한 메뉴얼을 참고해 주기 바란다.
- 모든 결제는 다음의 값은 필수적으로 채워져야 한다.
- mid : 페이게이트 가입시 할당받은 상점의 id
- goodname : 결제를 대표하는 제품 이름 또는 코드
- unitprice : 결제 가격
- paymethod : 어떠한 결제 수단을 이용할 것인지에 대한 변수 지정되지 않을 경우
- 결제 수단이 여러가지 중복 될 경우 같이 사용되는 모든 변수 목록을 같이 두어도 된다.
- 결제 수단과는 관련 없이 다음의 변수값들은 채워 주시는 것이 좋습니다. (없어도 거래는 가능)
- receipttoname 구매자의 이름이 페이게이트 상점 관리 영역의 거래 내역 조회에서 편리하게 이용할 수 있다.
- receipttotel 결제가 완료되었을 때 상점 요청에 따라 고객에게 문자 메시지를 보낼 수 있다.
- receipttoemail 결제 완료가 되면 고객에게 결제 관련 이메일이 발송 된다.
- charset 업체의 화면에 맞는 charset 을 기록함. (ex) UTF-8, EUC-KR) 지정하지 않을 경우 거래가 비정상적으로 실패하거나 상품 명 등이 깨질 수 있다.
- 나머지 추가적인 변수 및 자세한 설명은 상세 메뉴얼을 참고해 주시기 바란다.