KG이니시스 웹 결제 기본 요청데이터 필드

필드명	한글명칭	예시 [Data Type, 밑줄은 기본값]	설명	필수 여부	크기 (최대)
version	버전	[String]"1.0" [1.0]	전문 버전	Yes	20 Byte
mid	상점아이디	[String] "INIpayTest"	제공된 mid * 10자리 고정	Yes (위변조검증)	10 Byte Fixed
oid	주문번호	[String] INIpayTest__1335233672723	주문단위 unique한 값 ( mid+”_”+timestamp )	Yes	40 Byte
goodsname	상품명	[String] “키보드/마우스”	한글/특수기호 입력가능 * 40Byte 초과 요청시 37Byte+...으로 자동 변환	Yes	40 Byte
price	결제금액	[Number] 1004	숫자만 입력 1달러는 100으로 시작	Yes (위변조검 증)	64 Byte
tax	부가세	[Number] 1004	숫자만 입력 대상: ‘부가세업체정함’ 설정업체에 한함 주의: 전체금액의 10%이하로 설정 가맹점에서 등록시 VAT가 총 상품가격의 10% 초과할 경우는 거절됨	No	64 Byte
taxfree	비과세	[Number] 1004	숫자만 입력 대상: ‘부가세업체정함’ 설정업체에 한함 과세되지 않는 금액	No	64 Byte
currency	통화구분	[String] "WON" [WON:한화,USD:달러]	* USD는 카드 결제만 가능(ISP는 결제안됨)	Yes	3 Byte
buyername	구매자명	[String] "홍길동"	한글/특수기호 입력가능 * 30Byte 초과 요청시 30Byte 으로 자동 변환	Yes	30 Byte
buyertel	구매자Mobi le번호	[String] ”010-2000-1234	숫자와 "-"만 허용	Yes	20 Byte
buyeremail	구매자Email	[String] "buyer@example.com"	이메일 형식에 맞도록	No	60 Byte
parentemail	보호자Email	[String] "parent@example.com"	14세 미만 필수		60 Byte
timestamp	타임스탬프	[Number] 1335233672723	TimeInMillis(Long형) → 제공라이브러로 생성가능(샘플소스참조)	Yes (위변조검 증)	20 Byte
signature	signature	[String]"8ca9e064777ea2fc0d4 b79a5c891f3bdf30edd45c129d cfc226ba5e7e85cd5f3"	위변조 방지 SHA256 Hash 값 → 아래 “[TABLE 1-3] signature 생성 대상(Target) 필드” 참조	Yes	64 Byte Fixed
returnUrl	리턴Url (인증결과수 신Url)	[String] "HTTPS://www.exsample.com/I NIpayStandardSample/INIpayR esult.jsp	결제창을 통해 인증완료된 결과를 수신받고 승인요청을 해서 결과를 표시할 페이지 URL → 3.3 리턴 페이지(인증수신/승인API) 작성(INIStdPayReturn) 참조	Yes	N/A
mKey	signkey에 대한 hash값	[String] “3a9503069192f207491d4b19 bd743fc249a761ed94246c8c42 fed06c3cd15a33”	signkey에 대한 검증값	Yes	N/A
gopaymeth od	요청결제수 단	[String] “Card” →별첨 “A.1.결제수단코드” 참조	하나의 결제 수단만을 제공할 경우 사용함. 생략시 전체 결제 수단 표시	No	N/A
offerPeriod	제공기간	[String]”20130101-20130331” [Y2:년단위결제, M2:월단위결제, yyyyMMdd- yyyyMMdd : 시작일-종료일]	가맹점에서 판매상품에 대한 제공기한 설정	No	N/A
languageVie w	초기 표시 언어	[String]”ko“ [ko:한국어, en:영어]	결제창 표시 언어 * PC는 결제창내 언어변경 버튼 존재	No	2Byt e
charset	결과 인코딩	[String] ”UTF-8” [UTF-8, EUC-KR]	결과 수신 charset	No	5Byt e
payViewTyp e	결제창 표시방법	[String] [overlay]	Default:overlay	No	N/A
closeUrl	결제창 닫기처리Url	[String] "HTTPS://www.exsample.com/inipaysmart/close.jsp	close.jsp 샘플사용(소스 수정 불필요)	Yes	N/A
popupUrl	팝업처리Url	[String] "HTTPS://www.exsample.com/inipaysmart/popup.jsp	popup.jsp 샘플사용(소스 수정 불필요 : 비권장)	Yes	N/A
merchantDa ta	가맹점데이 터	[String] a=A&b=B	인증 성공시 가맹점으로 리턴 (한글사용불가)	No	2000 Byte
acceptmethod	acceptmethod	[String]CARDPOINT:va_receipt:v bank(20150425)::SKIN(ORIGINAL ):FONT(ORIGINAL):popreturn	결제수단별 추가 옵션값	No	N/A