웰컴페이먼츠 표준결제 결제요청 샘플
이 페이지는 웰컴페이먼츠 웹표준 결제요청을 위한 예시입니다.
결제처리를 위한 action등의 모든 동작은 Import 된 스크립트에 의해 자동처리됩니다.
Form에 설정된 모든 필드의 name은 대소문자 구분하며,
이 Sample은 결제를 위해서 설정된 Form은 테스트 / 이해돕기를 위해서 모두 type="text"로 설정되어 있습니다.
운영에 적용시에는 일부 가맹점에서 필요에 의해 사용자가 변경하는 경우를 제외하고
모두 type="hidden"으로 변경하여 사용하시기 바랍니다.
함께 제공되는 매뉴얼을 참조하여 작성 개발하시기 바랍니다.
결제요청
***** 필 수 *****
version
:
mid
:
goodname
:
oid
:
price
:
currency
:
[WON|USD]
buyername
:
buyertel
:
buyeremail
:
returnUrl
:
***** 기본 옵션 *****
gopaymethod
: 결제 수단 선택
ex) Card (계약 결제 수단이 존재하지 않을 경우 에러로 리턴)
사용 가능한 입력 값
Card,DirectBank,HPP,Vbank,kpay,Swallet,Paypin,EasyPay,PhoneBill,GiftCard,EWallet
onlypoint,onlyocb,onyocbplus,onlygspt,onlygsptplus,onlyupnt,onlyupntplus
offerPeriod
: 제공기간
ex)20210101-20211231, [Y2:년단위결제, M2:월단위결제, yyyyMMdd-yyyyMMdd : 시작일-종료일]
acceptmethod
: acceptmethod
acceptmethod ex) CARDPOINT:SLIMQUOTA(코드-개월:개월):no_receipt:va_receipt:vbanknoreg(0):vbank(20150425):va_ckprice:vbanknoreg:
KWPY_TYPE(0):KWPY_VAT(10|0) 기타 옵션 정보 및 설명은 연동정의보 참조 구분자 ":"
***** 표시 옵션 *****
languageView
: 초기 표시 언어
[ko|en] (default:ko)
charset
: 리턴 인코딩
[UTF-8|EUC-KR] (default:UTF-8)
payViewType
: 결제창 표시방법
[overlay] (default:overlay)
closeUrl
: payViewType='overlay','popup'시 취소버튼 클릭시 창닥기 처리 URL(가맹점에 맞게 설정)
close.jsp 샘플사용(생략가능, 미설정시 사용자에 의해 취소 버튼 클릭시 인증결과 페이지로 취소 결과를 보냅니다.)
popupUrl
: payViewType='popup'시 팝업을 띄울수 있도록 처리해주는 URL(가맹점에 맞게 설정)
popup.jsp 샘플사용(생략가능,payViewType='popup'으로 사용시에는 반드시 설정)
***** 결제 수단별 옵션 *****
-- 카드(간편결제도 사용) --
nointerest
: 무이자 할부 개월
ex) 11-2:3:4,04-2:3:4
quotabase
: 할부 개월
ex) 2:3:4
d_card
: 카드 코드
ex) 01
d_quota
: 할부 선택
ex) 02
-- 가상계좌 --
INIregno
: 주민번호 설정 기능
13자리(주민번호),10자리(사업자번호),미입력시(화면에서입력가능)
***** 추가 옵션 *****
merchantData
: 가맹점 관리데이터(1000byte)
**인증결과 리턴시 함께 전달됨(한글 지원 안됨, 개인정보 암호화(권장))