KG INICIS MANUAL

PC(웹표준)결제

PC에서 ActiveX 설치 없이 여러 지불수단을 이용하여 결제할 수 있도록 지원하는 인터넷 전자지불 서비스입니다.

제공된 샘플은 API 구동을 위한 최소한의 샘플링이오니 참고부탁드립니다.

※ 좌측 메뉴 샘플 다운로드 내 패키징 파일을 통해 "즉시 연동" 할 수 있습니다.

STEP1. 결제요청

결제요청JS : https://stdpay.inicis.com/stdjs/INIStdPay.js

HTTP Method : POST
Accept-charset : UTF-8

HTML

			<html>
<head>
<title>WebStandard example</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">              
<script language="javascript" type="text/javascript" src="https://stdpay.inicis.com/stdjs/INIStdPay.js" charset="UTF-8"></script>      
</head>

 <body>

   <form id="SendPayForm_id" name="" method="POST" >

        <input type="text"    name="goodname" value="테스트" >
        <input type="text"    name="buyername" value="홍길동" >
        <input type="text"    name="buyertel" value="010-1234-5678" >
        <input type="text"    name="buyeremail" value="test@inicis.com" >
        <input type="text"    name="price" value="1000" >
        <input type="hidden"  name="mid" value="INIpayTest" ><!-- 에스크로테스트 : iniescrow0, 빌링(정기과금)테스트 : INIBillTst -->
        <input type="hidden"  name="gopaymethod" value="Card" >
        <input type="hidden"  name="mKey" value="3a9503069192f207491d4b19bd743fc249a761ed94246c8c42fed06c3cd15a33" >
        <input type="hidden"  name="signature" value="58a5e0be41312e6f92e2cbc6356700b6f5f731c1eafe20ef5f0adf27d3fa4594" >
        <input type="hidden"  name="oid" value="INIpayTest_1653767003754" >
        <input type="hidden"  name="timestamp" value="1653767003754" >
        <input type="hidden"  name="version" value="1.0" >
        <input type="hidden"  name="currency" value="WON" >
        <input type="hidden"  name="acceptmethod" value="below1000" ><!-- 에스크로옵션 : useescrow, 빌링(정기과금)옵션 : BILLAUTH(Card) -->
        <input type="hidden"  name="returnUrl" value="http://localhost/stdpay/INIStdPayReturn_simple.asp" >
        <input type="hidden"  name="closeUrl" value="http://localhost/stdpay/close.asp" >

   </form>

      <button onclick="INIStdPay.pay('SendPayForm_id')" style="padding:10px; margin-left:10%">결제요청</button>

 </body>
</html>

결제요청 상세파라미터 규격 확인

필수파라미터
선택파라미터
추가옵션

파라미터

설명

SIZE(Byte)

version

전문 버전 ["1.0" 고정]

gopaymethod

요청지불수단 Info

요청지불수단

* 대/소문자 구분하여 세팅바랍니다.
* 여러지불수단 사용 시 구분자는 ":"(콜론)을 사용합니다.

지불수단	Value
신용카드	Card
실시간계좌이체	DirectBank
가상계좌(무통장입금)	VBank
휴대폰	HPP
폰빌, 전화결제	PhoneBill
문화상품권	Culture
스마트문상	DGCL
도서문화상품권	Bcsh
해피머니상품권	HPMN
틴캐시	TeenCash
페이핀	Paypin
OKCashbag 포인트	OCBPoint
포인트	POINT
상품권	GiftCard

* 빈값으로 세팅 시, 전체 결제수단 표시

N/A

mid

상점아이디

oid

주문번호
* 반드시 Unique 값으로 생성 (거래추적 시 사용됨)

price

결제금액
* 숫자만, 1달러는 100으로 시작

timestamp

타임스템프 [TimeInMillis(Long형)]

signature

SHA256 Hash값 [대상: oid, price, timestamp] HASH

signature 개요

언어별 제공된 라이브러리 소스를 통해서 생성가능합니다.
생성방법: NVP 방식으로 연결한 데이터를 SHA256으로 Hash한 값 입니다.

※ NVP 방식 : oid=oidValue&price=priceValue&timestamp=timestampValue
ex) hash생성 예시
PlainText: oid=INIpayTest_1361252896871&price=1004&timestamp=1361252896871 Hash 데이터: ec1e9c63ddad0b81f316ada2e3861e81db5f4f6652d9ff0f255b4cb5499ce893

※ 주의사항
1. 필드 순서 유지(알파벳순), 마지막 &는 생략, 공백생략,
2. 모든대상 필드는 Form에 설정되는 데이터와 동일한 값을 이용합니다.

파라미터	설명	SIZE(Byte)
quotabase	할부개월수 노출옵션 [할부개월:할부개월] * 금액이 할부조건일 경우 동작	N/A
nointerest	상점부담 무이자할부 옵션 [카드코드-할부개월:할부개월,카드코드-할부개월:할부개월] `Code` * 상점부담무이자 계약필요	N/A
tax	부가세 * "부가세 업체정함" 계약가맹점만 설정필요 / 주의사항: 전체금액의 10%이하로 설정	64
taxfree	비과세 (면세상품 금액) * "부가세 업체정함" 계약가맹점만 설정필요	64
charset	결과 수신 인코딩 [UTF-8,EUC-KR] * Default: UTF-8	6
offerPeriod	제공기간 [Y2:년단위결제, M2:월단위결제, YYYYMMDD-YYYYMMDD:시작일-종료일] * 결제 고객에게 노출용도	N/A
payViewType	결제창 호출 방법 [overlay,popup] * Default: overlay	7
languageView	결제창 언어 설정 ["ko":국문, "en":영문, "cn":중문] * Default: "ko":국문	2
logo_url	메인로고 삽입 [size: 8918] 이미지 전체 도메인주소 세팅	N/A
logo_2nd	서브로고 삽입 [size: 6413] 이미지 전체 도메인주소 세팅	N/A
popupUrl	팝업처리 URL * payViewType=popup 으로 진행 시 세팅 필요	N/A
parentemail	보호자 이메일주소 * 14세 미만 필수, "@", "." 외 특수문자 입력불가	60
ini_ssgpay_mdn	SSGPAY 결제요청 시 PUSH전송 휴대폰번호 * 숫자만 허용	20
merchantData	가맹점 임의 데이터 (인증결과수신 구간에서 전달) * 한글 입력불가, 한글입력은 urlencode 필수	2000
acceptmethod	지불수단별 추가옵션 * 상단 [추가옵션] 탭 참고	N/A

지불수단	파라미터	Value	설명
공통	acceptmethod	SKIN(색상코드)	결제창 배경색상 [Default: #C1272C]
popreturn	부모페이지 유지옵션 (결제창 종료 후 returnUrl 호출 시, 강제로 결제요청페이지 내 프레임을 지정하여 호출)
신용카드	acceptmethod	below1000	신용카드 결제 시 1000원 이하금액 결제가능 옵션
paypopup	안심클릭계열 신용카드 POPUP 형태 표시옵션
hidebar	프로그래스바 미노출 옵션
ini_onlycardcode(카드코드:카드코드)	결제 카드사 선택 노출옵션 `Code` * Default: 결제가능한 모든 카드사 표시
cardpoint	카드포인트 사용유무 선택창 표시옵션 * 별도계약시 사용가능
ocb	카드 메인화면에 OCB 적립을 위한 카드번호 창 표시옵션 * 별도계약시 사용가능
slimquota(카드코드-개월:개월)	부분무이자 설정 `Code` * 별도계약시 사용가능
mallpoint(카드코드:카드코드)	몰포인트 `Code` * 별도계약시 사용가능
계좌이체	acceptmethod	no_receipt	현금영수증 UI 미노출 옵션 * Default: 현금영수증 UI 노출
가상계좌	acceptmethod	va_receipt	현금영수증 UI 노출 옵션 * Default: 현금영수증 UI 미노출
vbank(YYYYMMDD)	입금기한 및 입금시간 설정옵션 * 시, 분까지 지정 시 YYYYMMDDhhmm 로 세팅
휴대폰	acceptmethod	HPP(1)	휴대폰결제 상품유형 ["1":컨텐츠, "2":실물] * MID 계약사항에 맞게 세팅
에스크로	acceptmethod	useescrow	신에스크로 사용옵션 * 신에스크로 계약 가맹점만 사용
빌키발급	acceptmethod	BILLAUTH(Card)	신용카드 빌링키발급 결제창 호출 옵션
hidebillprice	신용카드 빌링키발급 시 금액미노출 옵션 * 신용카드 빌링에서만 사용
BILLAUTH(HPP):HPP(4)	휴대폰 빌링키발급 결제창 호출 옵션 [4:컨텐츠, 5:실물] * MID 계약사항에 맞게 세팅

STEP2. 인증결과수신

			<?php

 header("Content-Type: text/html; charset=utf-8");
 
 require_once('../libs/INIStdPayUtil.php');
 require_once('../libs/HttpClient.php');
 require_once('../libs/sha256.inc.php');
 require_once('../libs/json_lib.php');

 $util = new INIStdPayUtil();

        

        //#######################################
        // 인증결과 파라미터 일괄 수신, 인증이 성공일 경우만
        //#######################################
 
        if (strcmp("0000", $_REQUEST["resultCode"]) == 0) {            
        
            echo "####인증성공 승인데이터 만들기####"."<br/>";
            //echo print_r($_POST);   //인증 데이터 확인

			<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="com.inicis.std.util.ParseUtil"%>
<%@ page import="com.inicis.std.util.SignatureUtil"%>
<%@ page import="com.inicis.std.util.HttpUtil"%>
<%@ page import="java.util.*"%>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

</head>
<body >

<% 

try{

//#############################
// 인증결과 파라미터 일괄 수신
//#############################
request.setCharacterEncoding("UTF-8");
Map<String,String> paramMap = new Hashtable<String,String>();
Enumeration elems = request.getParameterNames();
String temp = "";
while(elems.hasMoreElements())
{
temp = (String) elems.nextElement();
paramMap.put(temp, request.getParameter(temp));
}
System.out.println("paramMap : "+ paramMap.toString());

			<% @Language="VBScript" CODEPAGE="949" %>
<%
Response.CharSet="euc-kr"
Session.codepage="949"
Response.codepage="949"
Response.ContentType="text/html;charset=euc-kr"
%>
<!--#include virtual="/INIStdweb_ASP/include/function.asp"-->
<!--#include virtual="/INIStdweb_ASP/include/signature.asp"-->
<!--#include virtual="/INIStdweb_ASP/include/aspJSON1.17.asp"-->
<% 
'#############################
' 인증결과 파라미터 일괄 수신
'#############################
        
Set oJSON = New aspJSON

인증결과 상세파라미터 규격 확인

파라미터	설명	SIZE(Byte)
resultCode	결과코드 ["0000": 정상, 이외 실패]	10
resultMsg	결과메시지	100
mid	상점아이디	10
orderNumber	주문번호 * 결제요청 시 세팅한 주문번호	40
authToken	승인요청 검증 토큰	N/A
authUrl	승인요청 Url * 해당 URL로 HTTPS API Request 승인요청 - POST	N/A
netCancelUrl	망취소요청 Url * 승인요청 후 승인결과 수신 실패 / DB저장 실패 시	64
charset	인증결과 인코딩 [Default: UTF-8]	6
merchantData	가맹점 임의 데이터	2000

상단 이동

STEP3. 승인요청/응답

승인요청URL : 인증결과수신 시 authUrl

통신방식 : http-Client
HTTP Method : POST

            // STEP2 에 이어 인증결과가 성공일 경우 STEP2 에서 받은 인증결과로 아래 승인요청 진행
        
            //############################################
            // 1.전문 필드 값 설정(***가맹점 개발수정***)
            //############################################
        
            $mid = $_REQUEST["mid"];     // 가맹점 ID 수신 받은 데이터로 설정
            $timestamp = $util->getTimestamp();   // util에 의해서 자동생성
            $charset = "UTF-8";        // 리턴형식[UTF-8,EUC-KR](가맹점 수정후 고정)
            $format = "JSON";        // 리턴형식[XML,JSON,NVP](가맹점 수정후 고정)
            $authToken = $_REQUEST["authToken"];   // 취소 요청 tid에 따라서 유동적(가맹점 수정후 고정)
            $authUrl = $_REQUEST["authUrl"];    // 승인요청 API url(수신 받은 값으로 설정, 임의 세팅 금지)       
            $mKey = hash("sha256", $signKey); // 가맹점 확인을 위한 signKey를 해시값으로 변경 (SHA-256방식 사용)
           
         
            //#####################
            // 2.signature 생성
            //#####################
            $signParam["authToken"] = $authToken;  // 필수
            $signParam["timestamp"] = $timestamp;  // 필수
            // signature 데이터 생성 (모듈에서 자동으로 signParam을 알파벳 순으로 정렬후 NVP 방식으로 나열해 hash)
            $signature = $util->makeSignature($signParam);
        
        
            //#####################
            // 3.API 요청 전문 생성
            //#####################
            $authMap["mid"] = $mid;   // 필수
            $authMap["authToken"] = $authToken; // 필수
            $authMap["signature"] = $signature; // 필수
            $authMap["timestamp"] = $timestamp; // 필수
            $authMap["charset"] = $charset;  // default=UTF-8
            $authMap["format"] = $format;  // default=XML
        
            
           $httpUtil = new HttpClient();
        
            //#####################
            // 4.API 통신 시작
            //#####################
            
            $authResultString = "";
            if ($httpUtil->processHTTP($authUrl, $authMap)) {
            $authResultString = $httpUtil->body;
        
            $result =  str_replace (",", "<br/>",  $authResultString);
        
                //PRINT DATA
            
            
            //############################################################
            //5.API 통신결과 처리(***가맹점 개발수정***)
            //############################################################
            
           echo "<p><b>승인결과 내용 :</b> $result</p>";
        
            }

        }

?>

			// STEP2 에 이어 인증결과가 성공일 경우 STEP2 에서 받은 인증결과로 아래 승인요청 진행

//#####################
// 인증이 성공일 경우만
//#####################
if("0000".equals(paramMap.get("resultCode"))){

out.println("## 인증데이터 일괄수신 ##");
out.println("<p>"+paramMap.toString()+"</p>");

String mid = paramMap.get("mid");   // 가맹점 ID 수신 받은 데이터로 설정
String timestamp= SignatureUtil.getTimestamp();   // util에 의해서 자동생성
String charset = "UTF-8";                // 리턴형식[UTF-8,EUC-KR](가맹점 수정후 고정)
String format = "JSON";                 // 리턴형식[XML,JSON,NVP](가맹점 수정후 고정)
String authToken= paramMap.get("authToken");    // 취소 요청 tid에 따라서 유동적(가맹점 수정후 고정)
String authUrl= paramMap.get("authUrl");            // 승인요청 API url(수신 받은 값으로 설정, 임의 세팅 금지)
String netCancel= paramMap.get("netCancelUrl");  // 망취소 API url(수신 받은 값으로 설정, 임의 세팅 금지)

//#####################
// 2.signature 생성
//#####################
Map<String, String> signParam = new HashMap<String, String>();

signParam.put("authToken",authToken);// 필수
signParam.put("timestamp",timestamp);// 필수

// signature 데이터 생성 (모듈에서 자동으로 signParam을 알파벳 순으로 정렬후 NVP 방식으로 나열해 hash)
String signature = SignatureUtil.makeSignature(signParam);

//#####################
// 3.API 요청 전문 생성
//#####################
Map<String, String> authMap = new Hashtable<String, String>();

authMap.put("mid"    ,mid);               // 필수
authMap.put("authToken",authToken);  // 필수
authMap.put("signature",signature);     // 필수
authMap.put("timestamp",timestamp);  // 필수
authMap.put("charset"  ,charset);         // default=UTF-8
authMap.put("format"  ,format);          // default=XML
            
System.out.println("##승인요청 API 요청##");

HttpUtil httpUtil = new HttpUtil();

//#####################
// 4.API 통신 시작
//#####################
String authResultString = "";
authResultString = httpUtil.processHTTP(authMap, authUrl);

//############################################################
//5.API 통신결과 처리(***가맹점 개발수정***)
//############################################################
out.println("## 승인 API 결과 ##");
String test = authResultString.replace(",", "&").replace(":", "=").replace("\"", "").replace(" ","").replace("\n", "").replace("}", "").replace("{", "");
out.println("<pre>"+authResultString.replaceAll("<", "&lt;").replaceAll(">", "&gt;")+"</pre>");

}else{

//#############
// 인증 실패시
//#############
out.println("<br/>");
out.println("####인증실패####");
out.println("<p>"+paramMap.toString()+"</p>");

}

}catch(Exception e){
System.out.println(e);
}
%>

			'STEP2 에 이어 인증결과가 성공일 경우 STEP2 에서 받은 인증결과로 아래 승인요청 진행

'#####################
' 인증이 성공일 경우만
'#####################

if ("0000"=request("resultCode")) then

response.write ("<br/><br/><br/>")
response.write ("####인증성공/승인요청####")
response.write ("<br/><br/><br/>")

'############################################
' 1.전문 필드 값 설정(***가맹점 개발수정***)
'############################################
maid = request("mid")                ' 가맹점 ID 수신 받은 데이터로 설정
correct = "09"                           ' 표준시와의 차이를 2자리 숫자로 입력 (예: 대한민국은 표준시와 9시간 차이이므로 09)
timestamp= time_stamp(correct)
charset = "EUC-KR"                    ' 리턴형식[UTF-8,EUC-KR](가맹점 수정후 고정)
format = "JSON"                        ' 리턴형식[XML,JSON,NVP](가맹점 수정후 고정)
authToken= request("authToken")  ' 취소 요청 tid에 따라서 유동적(가맹점 수정후 고정)
authUrl= request("authUrl")          ' 승인요청 API url(수신 받은 값으로 설정, 임의 세팅 금지)

'#####################
' 2.signature 생성
'#####################
signParam = "authToken=" & replace(authToken," ", "+")
signParam = signParam & "&timestamp=" & timestamp
' signature 데이터 생성 (signParam을 알파벳 순으로 hash)
signature = MakeSignature(signParam)

'#####################
' 3.API 요청 전문 생성
'#####################
dim xmlHttp,  postdat
Set xmlHttp = Server.CreateObject("Microsoft.XMLHTTP")
'Set xmlHttp = CreateObject("Msxml2.XMLHTTP")
'Set xmlHttp = CreateObject("Msxml3.XMLHTTP")
' 환경에 맞는 dll 사용가능

send_text = "mid="&maid
send_text = send_text & "&timestamp="&timestamp
send_text = send_text & "&signature="&signature
send_text = send_text & "&authToken="&Server.URLEncode(authToken)
send_text = send_text & "&&charset="&charset
send_text = send_text & "&format="&format

'#####################
' 4.API 통신 시작
'#####################
response.write("##승인요청 API 요청##<br>")
 xmlHttp.Open "POST", authUrl, False
 xmlHttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded; text/html; charset=euc-kr"
xmlHttp.Send send_text
result= xmlHttp.responseText

Set oJSON = New aspJSON
      oJSON.loadJSON(result)

response.write("##승인 처리 완료##</br></br></br>")
authResultString = ""

'############################################################
'5.API 통신결과 처리(***가맹점 개발수정***)
'############################################################
response.write ("## 승인 API 결과 ##")
response.write("<pre>")
response.write (result)

End IF

%>

승인요청 상세파라미터 규격 확인

파라미터

설명

SIZE(Byte)

mid

상점아이디

authToken

승인요청 검증 토큰

N/A

timestamp

타임스템프 [TimeInMillis(Long형)]

signature

SHA256 Hash값 [대상: authToken, timestamp] HASH

signature 개요

언어별 제공된 라이브러리 소스를 통해서 생성가능합니다.
생성방법: NVP 방식으로 연결한 데이터를 SHA256으로 Hash한 값 입니다.

※ NVP 방식 authToken=authTokenValue&timestamp=timestampValue
※ 주의사항
1. 필드 순서 유지(알파벳순), 마지막 &는 생략, 공백생략,
2. 모든대상 필드는 Form에 설정되는 데이터와 동일한 값을 이용합니다.

리턴 형식별 승인결과 예시

유형	승인결과 전문 예시	ContentType
XML		text/xml
JSON		application/json
NVP		text/plain

price

인증가격
* 옵션필드 (제외가능)

상단 이동

STEP4. 승인결과 상세

모든 결제 프로세스 종료 후 최종적으로 전달되는 응답파라미터에 대하여 안내합니다.

* 참고) 1. PC(웹표준) 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
2. 실패 응답시 일부 파라미터 응답이 null 일 수 있습니다.

공통 응답파라미터
주요 지불수단
그 외 지불수단

지불수단

파라미터

설명

SIZE(Byte)

공통

resultCode

결과코드 ["0000":성공, 이외 실패 (실패코드 6byte)]

resultMsg

결과메세지

100

tid

거래번호

goodName

상품명

TotPrice

결제금액

MOID

주문번호
* 결제 요청시 oid 필드에 설정된 값

payMethod

지불수단 Info

지불수단

지불수단	value
신용카드(안심클릭)	Card
신용카드(ISP)	VCard
실시간계좌이체	DirectBank
가상계좌(무통장입금)	VBank
휴대폰	HPP
폰빌전화결제	PhoneBill
문화상품권	Culture
스마트문상	DGCL
도서문화상품권	Bookcash
해피머니상품권	HPMN
틴캐시	TeenCash
OKCashbag 포인트	OCBPoint
GS&POINT	GSPT
삼성 U-point	UPNT

N/A

applNum

승인번호
* 지불수단에 따라 미전송

applDate

승인일자 [YYYYMMDD]

applTime

승인시간 [hh24miss]

EventCode

이벤트 코드, 카드 할부 및 행사 적용 코드 Code

이벤트코드

※ 이벤트 관련 자세한 내용은 영업담당자분을 통해 계약사항 확인해주시기 바랍니다.

코드	이벤트 설명
1	업종 무이자
2	SK 상점 무이자
A1	상점무이자
A2	상점 할인
A3	상점무이자 + 할인
A4	상점무이자 + 카드별 할인
A5	카드별할인
A6	상점 금액 할인
A7	비인증 쿠폰할인
B4	상점무이자 + 카드(prefix별) 할인
B5	카드(prefix별) 할인
B6	ISP제휴 코드별 할인
C0	카드사수수료 유보를 위한 상점무이자 이벤트
C1	카드사수수료 유보를 위한 상점무이자 이벤트
C2	카드사수수료 유보를 위한 상점무이자 이벤트
Q1	상점 할부개월 고정변경
Q2	상점 할부개월 고정변경
Q3	상점 할부개월 고정변경 + 고객 포인트사용 체크 - 고객이 체크하지 않아도 포인트사용 되도록 바뀜
Q4	상점 할부개월 고정변경 + 고객 포인트사용체크 - 고객이 체크하지 않아도 포인트사용 되도록 바뀜
Q5	상점 할부개월 고정변경 + 고객 포인트사용 체크
Q6	상점 할부개월 고정변경 + 고객 포인트사용 체크
P1	포인트적립 할부개월 변경 이벤트

buyerName

구매자명

buyerTel

구매자 휴대폰번호

buyerEmail

구매자 이메일주소

custEmail

최종 이메일주소

지불수단

파라미터

설명

SIZE(Byte)

신용카드

CARD_Num

신용카드번호

CARD_Interest

상점부담 무이자 할부여부 ["1":상점부담 무이자]

CARD_Quota

카드 할부기간

CARD_Code

카드사 코드 Code

CARD_CorpFlag

카드구분 ["0":개인카드, "1":법인카드, "9":구분불가]
* 승인실패 시 빈값 전달

CARD_CheckFlag

카드종류 ["0":신용카드, "1":체크카드, "2":기프트카드]

CARD_PRTC_CODE

부분취소 가능여부 ["1":가능 , "0":불가능]

CARD_BankCode

카드발급사(은행) 코드 Code

CARD_SrcCode

간편(앱)결제구분 Code

간편(앱)결제구분

간편(앱)결제	Value
PAYCO	C
삼성페이	B
삼성페이(체크)	D
SSGPAY	G
KAKAOPAY	O
LPAY	L
국민앱카드	K
토스페이	H
네이버페이	I (대문자 i)
차이페이	R
티머니페이	U

CARD_Point

카드포인트 사용여부 ["":카드 포인트 사용안함, "1":카드 포인트 사용]

CARD_UsePoint

포인트 사용금액

CARD_CouponPrice

실제 카드승인 금액

N/A

CARD_CouponDiscount

쿠폰(즉시할인) 금액

N/A

NAVERPOINT_UseFreePoint

네이버포인트 무상포인트

NAVERPOINT_CSHRApplYN

네이버포인트 현금영수증 발행여부 ["Y":발행, "N":미발행]

NAVERPOINT_CSHRApplAmt

네이버포인트 현금영수증 발행 금액

PCO_OrderNo

페이코 주문번호

N/A

currency

통화코드

OrgPrice

달러 환전금액
* 해외카드 + 달러(USD) 결제 일 경우 환전금액

N/A

CARD_Billkey

신용카드 빌링키
* 빌키발급 요청시에만 반환

실시간 계좌이체

ACCT_BankCode

은행코드 Code

CSHR_ResultCode

현금영수증 발행 정상여부 ["220000": 정상]

CSHR_Type

현금영수증구분 ["0":소득공제, "1":지출증빙]

ACCT_Name

계좌주명

가상계좌 (무통장입금)

입금통보수신 가이드

VACT_Num

가상계좌번호

VACT_BankCode

입금은행코드 Code

vactBankName

입금은행명

N/A

VACT_Name

예금주명

VACT_InputName

송금자명
* 결제창 내 입력한 '송금자명' / Default: 구매자명값

N/A

VACT_Date

입금기한일자 [YYYYMMDD]

VACT_Time

입금기한시각 [hhmmss]

휴대폰(통신사) 결제

HPP_Num

휴대폰번호

payDevice

결제장치

HPP_Billkey

휴대폰 빌링키
* 빌키발급 요청시에만 반환

지불수단	파라미터	설명	SIZE(Byte)
포인트	PayOption	포인트 사용구분	10
	OCB_Num	OK CashBag 카드번호	20
	OCB_PayPrice	OK CashBag 지불금액	12
	OCB_SaveApplNum	OK CASHBAG 적립 승인번호	12
	OCB_PayApplNum	OK CASHBAG 사용내역 승인번호	12
	OCB_ApplDate	OK CASHBAG 승인일시	8
	UPoint_Num	U포인트 카드번호	16
	UPoint_usablePoint	U포인트 가용포인트	12
	UPoint_ApplPrice	U포인트 승인요청 금액	12
	UPNT_PayOption	U포인트 지불구분	10
	UPNT_SavePrice	U포인트 복합결제시 여신 승인금액	16
	UPNT_PayPrice	U포인트 지불금액	9
	GSPT_ApplPrice	GS포인트 승인금액	15
	GSPT_SavePrice	GS포인트 적립금액	15
	GSPT_PayPrice	GS포인트 지불금액	15
상품권	CULT_UserID	컬쳐랜트 고객ID	20
	GAMG_Cnt	스마트문화상품권 사용한 카드개수	1
	GAMG_ApplPrice	스마트문화상품권 승인금액	12
	GAMG_Num1	스마트문화상품권 카드번호	18
	GAMG_Price1	스마트문화상품권 카드결제금액	12
	TEEN_ApplPrice	틴캐시 승인금액	12
	TEEN_UserID	틴개시 사용자아이디	16
	TEEN_ApplNum	틴개시 승인번호	8
	BCSH_ApplPrice	도서상품권 승인금액	12
	BCSH_UserID	도서상품권 사용자아이디	20
	BCSH_ApplNum	도서상품권 승인번호	12
전화결제	PHNB_Num	승인 전화번호	12

상단 이동

PC(웹표준)결제

STEP1. 결제요청 결제창 옵션보기

다 음

요청지불수단

STEP2. 인증결과수신

STEP3. 승인요청/응답

리턴 형식별 승인결과 예시

STEP4. 승인결과 상세

지불수단

이벤트코드

간편(앱)결제구분

STEP1. 결제요청