연동준비하기
• 연동가능환경 • 방화벽정보 • 대칭키 • HASH 방법 • 유의사항

연동파라미터 규격
• 결제요청 • 인증결과수신 • 승인요청/응답 • 승인결과 상세 샘플 다운로드

추가기능
• 결제창 추가옵션 • 망취소요청 • 가상계좌 입금통보 • 에스크로 구매결정 • 매출전표(영수증)


PC(웹표준)결제


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

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


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


 
 
 

STEP1. 결제요청


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

HTTP Method : POST
Accept-charset : UTF-8

			
<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="d64193e524a974bc7f98166e57feef48039c895bd8f9a07525e5c2ff86c553fd" >
        <input type="hidden"  name="oid" value="INIpayTest_1642446270088" >
        <input type="hidden"  name="timestamp" value="1642446270088" >
        <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" 고정] 20
gopaymethod 요청지불수단   Info
* 빈값으로 세팅 시, 전체 결제수단 표시
N/A
mid 상점아이디 10
oid 주문번호
* 반드시 Unique 값으로 생성 (거래추적 시 사용됨)
40
price 결제금액
* 숫자만, 1달러는 100으로 시작
64
timestamp 타임스템프 [TimeInMillis(Long형)] 20
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에 설정되는 데이터와 동일한 값을 이용합니다.


관련 웹매뉴얼로 이동하기
64
mKey SHA256 Hash값 [대상: mid 와 매칭되는 signkey]   HASH
×
mkey 개요

mid(상점아이디)와 매칭되는 signkey 를 SHA256으로 hash한 값 입니다.

ex) hash생성 예시

PlainText: SU5JTElURV9UUklQTEVERVNfS0VZU1RS
Hash 데이터: 3a9503069192f207491d4b19bd743fc249a761ed94246c8c42fed06c3cd15a33


관련 웹매뉴얼로 이동하기
64
currency 통화구분 ["WON":한화,"USD":달러]
* USD는 카드 결제만 가능
3
goodname 상품명
* 40Byte 초과 요청시 37Byte + ...으로 자동 변환
40
buyername 구매자명
* 30Byte 초과 요청시 30Byte로 자동 변환
30
buyertel 구매자 휴대폰번호
* 숫자와 "-" 만 허용
20
buyeremail 구매자 이메일주소
* "@", "." 외 특수문자 입력불가
60
returnUrl 결과수신 URL N/A
closeUrl 결제창 닫기 URL N/A
파라미터 설명 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: 89*18]
* 이미지 전체 도메인주소 세팅
N/A
logo_2nd 서브로고 삽입 [size: 64*13]
* 이미지 전체 도메인주소 세팅
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(authMapauthUrl);

//############################################################
//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)
timestamptime_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
resultxmlHttp.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 상점아이디 10
authToken 승인요청 검증 토큰 N/A
timestamp 타임스템프 [TimeInMillis(Long형)] 20
signature SHA256 Hash값 [대상: authToken, timestamp]   HASH
×
signature 개요

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

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


관련 웹매뉴얼로 이동하기
60
charset 인증결과 인코딩 [Default: UTF-8] 6
format 리턴형식 [XML, JSON, NVP]   example
×

리턴 형식별 승인결과 예시


유형 승인결과 전문 예시 ContentType

XML
<result> <CARD_Quota>00</CARD_Quota> <buyerTel>010-1234-5678</buyerTel> <applDate>20200921</applDate> <buyerEmail>test@inicis.com</buyerEmail> <resultCode>0000</resultCode> <mid>INIpayTest</mid> <CARD_Num>538720*********9</CARD_Num> <tid>StdpayISP_INIpayTest20200921143539546778</tid> <TotPrice>1000</TotPrice> <payMethod>VCard</payMethod> <MOID>INIpayTest_1600666344293</MOID> <currency>WON</currency> <CARD_PrtcCode>1</CARD_PrtcCode> <applTime>143540</applTime> <CARD_Code>11</CARD_Code> <CARD_BankCode>00</CARD_BankCode> <buyerName>홍길동</buyerName> <applNum>41346698</applNum> <resultMsg>정상완료</resultMsg> <CARD_Interest>0</CARD_Interest> <CARD_SrcCode></CARD_SrcCode> <CARD_ApplPrice>1000</CARD_ApplPrice> <CARD_GWCode>G</CARD_GWCode> <custEmail>test@inicis.com</custEmail> <CARD_PurchaseName>BC카드</CARD_PurchaseName> <CARD_PRTC_CODE>1</CARD_PRTC_CODE> <payDevice>PC</payDevice> </result>
text/xml

JSON
{ "CARD_Quota": "00", "buyerTel": "010-1234-5678", "applDate": "20200921", "buyerEmail": "test@inicis.com", "resultCode": "0000", "mid": "INIpayTest", "CARD_Num": "538720*********9", "tid": "StdpayISP_INIpayTest20200921143539546778", "TotPrice": "1000", "payMethod": "VCard", "MOID": "INIpayTest_1600666344293", "currency": "WON", "CARD_PrtcCode": "1", "applTime": "143540", "CARD_Code": "11", "CARD_BankCode": "00", "buyerName": "홍길동", "applNum": "41346698", "resultMsg": "정상완료", "CARD_Interest": "0", "CARD_SrcCode": "", "CARD_ApplPrice": "1000", "CARD_GWCode": "G", "custEmail": "test@inicis.com", "CARD_PurchaseName": "BC카드", "CARD_PRTC_CODE": "1", "payDevice": "PC" }
application/json

NVP
CARD_Quota=00&buyerTel=010-1234-5678&applDate=20200921&buyerEmail=test@inicis.com& resultCode=0000&mid=INIpayTest&CARD_Num=538720*********9&tid=StdpayISP_INIpayTest202009 21143539546778&TotPrice=1000&payMethod=VCard&MOID=INIpayTest_1600666344293&currency=WON& CARD_PrtcCode=1&applTime=143540&CARD_Code=11&CARD_BankCode=00&buyerName=홍길동&applNum= 41346698&resultMsg=정상완료&CARD_Interest=0&CARD_SrcCode=&CARD_ApplPrice=1000&CARD_GWCode =G&custEmail=test@inicis.com&CARD_PurchaseName=BC카드&CARD_PRTC_CODE=1&payDevice=PC
text/plain
5
price 인증가격
* 옵션필드 (제외가능)
64
상단 이동
 
 
 

STEP4. 승인결과 상세


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

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


지불수단 파라미터 설명 SIZE(Byte)
공통 resultCode 결과코드 ["0000":성공, 이외 실패 (실패코드 6byte)] 6
resultMsg 결과메세지 100
tid 거래번호 40
goodName 상품명 40
TotPrice 결제금액 20
MOID 주문번호
* 결제 요청시 oid 필드에 설정된 값
40
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 승인번호
* 지불수단에 따라 미전송
8
applDate 승인일자 [YYYYMMDD] 8
applTime 승인시간 [hh24miss] 6
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 포인트적립 할부개월 변경 이벤트
2
buyerName 구매자명 30
buyerTel 구매자 휴대폰번호 20
buyerEmail 구매자 이메일주소 60
custEmail 최종 이메일주소 60
지불수단 파라미터 설명 SIZE(Byte)
신용카드 CARD_Num 신용카드번호 16
CARD_Interest 상점부담 무이자 할부여부 ["1":상점부담 무이자] 1
CARD_Quota 카드 할부기간 2
CARD_Code 카드사 코드   Code 2
CARD_CorpFlag 카드구분 ["0":개인카드, "1":법인카드, "9":구분불가]
* 승인실패 시 빈값 전달
1
CARD_CheckFlag 카드종류 ["0":신용카드, "1":체크카드, "2":기프트카드] 1
CARD_PRTC_CODE 부분취소 가능여부 ["1":가능 , "0":불가능] 1
CARD_BankCode 카드발급사(은행) 코드   Code 2
CARD_SrcCode 간편(앱)결제구분   Code
×

간편(앱)결제구분


간편(앱)결제 Value
PAYCO C
삼성페이 B
삼성페이(체크) D
SSGPAY G
KAKAOPAY O
LPAY L
국민앱카드 K
KPAY A
토스페이 H
네이버페이 I (대문자 i)
차이페이 R
티머니페이 U
1
CARD_Point 카드포인트 사용여부 ["":카드 포인트 사용안함, "1":카드 포인트 사용] 1
CARD_CouponPrice 실제 카드승인 금액 N/A
CARD_CouponDiscount 쿠폰(즉시할인) 금액 N/A
CARD_UsePoint 포인트 사용금액 12
NAVERPOINT_UseFreePoint 네이버포인트 무상포인트 12
NAVERPOINT_CSHRApplYN 네이버포인트 현금영수증 발행여부 ["Y":발행, "N":미발행] 1
NAVERPOINT_CSHRApplAmt 네이버포인트 현금영수증 발행 금액 12
currency 통화코드 3
OrgPrice 달러 환전금액
* 해외카드 + 달러(USD) 결제 일 경우 환전금액
N/A
CARD_Billkey 신용카드 빌링키
* 빌키발급 요청시에만 반환
40
실시간 계좌이체 ACCT_BankCode 은행코드   Code 2
CSHR_ResultCode 현금영수증 발행 정상여부 ["220000": 정상] 6
CSHR_Type 현금영수증구분 ["0":소득공제, "1":지출증빙] 1
ACCT_Name 계좌주명 30
가상계좌 (무통장입금)

입금통보수신 가이드
VACT_Num 가상계좌번호 14
VACT_BankCode 입금은행코드   Code 2
vactBankName 입금은행명 N/A
VACT_Name 예금주명 20
VACT_InputName 송금자명
* 결제창 내 입력한 '송금자명' / Default: 구매자명값
N/A
VACT_Date 입금기한일자 [YYYYMMDD] 8
VACT_Time 입금기한시각 [hhmmss] 6
휴대폰(통신사) 결제 HPP_Num 휴대폰번호 14
payDevice 결제장치 6
HPP_Billkey 휴대폰 빌링키
* 빌키발급 요청시에만 반환
40
지불수단 파라미터 설명 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
상단 이동