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

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

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


PC(웹표준)결제


PC(웹표준)결제 서비스에서 추가적으로 이용가능한 기능에 대하여 소개합니다.

 
 
 

결제창 추가옵션


PC(웹표준)결제창에서 빌링서비스, 에스크로서비스를 사용하기 위한 옵션을 안내합니다.

결제창 호출규격은 동일하며, acceptmethod 필드에 하기 옵션을 세팅하시면 됩니다.

※ 세팅예시 : <input name="acceptmethod" value="...기존옵션...:useescrow">


구분 파라미터 옵션value 비고
신에스크로 acceptmethod useescrow 신에스크로 MID는 해당옵션이 없을 경우 일반결제 진행됨
신용카드 빌링키발급 acceptmethod BILLAUTH(Card)
휴대폰 빌링키발급 acceptmethod BILLAUTH(HPP):HPP(4) [ 컨텐츠: HPP(4) / 실물: HPP(5) ]

※ 휴대폰 빌링 시 주의사항

휴대폰 빌링의 경우는 통신사 정책으로 빌키 발급시 인증+승인이 자동으로 됩니다.
2회차 부터는 1회차 동일금액, 익월+-5일이내 로 승인요청이 되어야 합니다.

휴대폰 빌링의 경우는 계약에 따라 회차 처리 로직이 다를 수 있으니 필히 계약 상태 확인후 진행바랍니다.

 
 
 

망취소요청


가맹점에서 승인결과 전문 처리 중 예외발생 시 망취소 요청할 수 있습니다.
승인요청 전문과 동일한 스펙으로 진행되며, 인증결과 수신 시 전달받은 "netCancelUrl" 로 망취소요청합니다.

제공된 샘플 INIStdPayReturn 에서 망취소 요청에 대한 예시 참고부탁드립니다.

** 망취소를 일반 결제취소 용도로 사용하지 마십시오.
    일반 결제취소는 INIAPI 취소/환불 서비스를 통해 진행해주시기 바랍니다.


망취소요청URL : 인증결과수신 시 netCancelUrl

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

<< 망취소요청 파라미터 >>

파라미터 설명 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

<< 망취소응답 파라미터 >>

파라미터 설명 SIZE(Byte)
resultCode 결과코드 ["0000":정상, 그외 실패]
* 승인처리가 되지 않은 거래건 망취소 시 실패코드 전달됨
10
resultMsg 결과메세지 100
timestamp 타임스템프 [TimeInMillis(Long형)] 20
tid 거래번호 40
mid 상점아이디 10
MOID 주문번호 40
selectPayMethod 지불수단   Info
×

지불수단


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

 
 
 

가상계좌 입금통보


가상계좌 입금통보 수신 페이지는 고객이 가상계좌이체 서비스를 사용하여 가상계좌번호를 발급 받은 후,
무통장 입금을 하였을 때, 은행으로부터 통보된 입금결과를 상점으로 전송해 주기 위해 상점 측에 필요한 페이지입니다.

URL 입금내역 통보 방식으로 안내해 드리고 있으며, HTTP/HTTPS 모두 지원합니다.


PC 가상계좌 입금내역 수신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.

항목 내용
연결방향 INBOUND
IP 203.238.37.15 / 39.115.212.9 / 183.109.71.153

노티수신 시 유의사항

1. 이니시스 PG에서 요청했는지 여부(IP로 체크)를 반드시 확인하셔야합니다.

2. 리턴 메시지를 반드시 적용해주셔야합니다.
   상점 데이터베이스 등록 성공 유무에 따라서 성공시에는 "OK" 문자열만 응답되어야합니다.

   JSP : out.print("OK");
   PHP : echo "OK";
   ASP : response.write "OK"

3. 로그를 반드시 작성해주시기 바랍니다.
   로그는 문제 발생시 이니시스와 데이터를 확인할 수 있는 근거 데이터이므로 반드시 적용해주시기 바랍니다.

4. 입금통보 노티전송 시 파라미터는 추후 요건에 의해 추가될 수 있습니다.

노티수신URL : 가맹점관리자 내 세팅된 URL    입금통보URL 세팅방법

HTTP Method : POST
Accept-charset : EUC-KR (한글데이터 Urlencode 하여 전달됨)

			

<?php

//@extract($_POST);
@extract($_SERVER);

$TEMP_IP = getenv("REMOTE_ADDR");
$PG_IP = substr($TEMP_IP, 0, 10);

if($PG_IP == "203.238.37" || $PG_IP == "39.115.212" || $PG_IP == "183.109.71") //PG에서 보냈는지 IP로 체크
{
    // 이니시스 NOTI 서버에서 받은 Value
    $no_tid = $_REQUEST["no_tid"];                      // 거래TID
    $no_oid = $_REQUEST["no_oid"];                    // 상점주문번호
    $cd_bank = $_REQUEST["cd_bank"];                // 은행코드
    $cd_deal = $_REQUEST["cd_deal"];                  // 거래취급 기관코드(실제입금은행)

    $dt_trans = $_REQUEST["dt_trans"];                 // 금융기관 발생 거래일자

    $tm_trans = $_REQUEST["tm_trans"];               // 금융기관 발생 거래시각

    $no_vacct = $_REQUEST["no_vacct"];               // 계좌번호

    $amt_input = $_REQUEST["amt_input"];           // 입금금액

    $flg_close = $_REQUEST["flg_close"];               // 마감구분[0:당일마감전, 1:당일마감후]

    $cl_close = $_REQUEST["cl_close"];                  // 마감구분코드[0:당일마감전, 1:당일마감후]

    $type_msg = $_REQUEST["type_msg"];             // 거래구분[0200:정상]

    $nm_inputbank = $_REQUEST["nm_inputbank"]; // 입금은행명

    $nm_input = $_REQUEST["nm_input"];             // 입금자명

    $dt_inputstd = $_REQUEST["dt_inputstd"];        // 입금기준일자

    $dt_calculstd = $_REQUEST["dt_calculstd"];       // 정산기준일자

    $dt_transbase = $_REQUEST["dt_transbase"];     // 거래기준일자

    $cl_trans = $_REQUEST["cl_trans"];                  // 거래구분코드

    $cl_kor = $_REQUEST["cl_kor"];                      // 한글구분코드

    $dt_cshr = $_REQUEST["dt_cshr"];                   // 현금영수증 발급일자

    $tm_cshr = $_REQUEST["tm_cshr"];                 // 현금영수증 발급시간

    $no_cshr_appl = $_REQUEST["no_cshr_appl"];   // 현금영수증 발급번호

    $no_cshr_tid = $_REQUEST["no_cshr_tid"];       // 현금영수증 발급TID

    
    // if(데이터베이스 등록 성공 유무 조건변수 = true) 
    // 주의 : DB처리후 정상일경우만 OK출력
   echo "OK";
   // else

 //echo "FAIL";

}

?>

 
상세파라미터 규격 확인

파라미터 설명 SIZE(Byte)
no_tid 거래번호 (입금거래에 대한 입금TID)
* 가상계좌 채번TID 와 상이
40
no_oid 상점 주문번호 (가상계좌 채번요청 시 주문번호) 40
cd_bank 가상계좌 발급 시 은행코드   Code 8
cd_deal 고객 실입금 시 은행코드   Code 8
dt_trans 금융기관 발생 거래 일자 8
tm_trans 금융기관 발생 거래 시각 6
no_vacct 가상계좌번호 20
amt_input 입금금액 13
flg_close 마감구분 [0:당일마감전, 1:당일마감후] 1
cl_close 마감구분코드 [0:당일마감전, 1:당일마감후] 1
type_msg 거래구분 [0200:정상] 4
nm_inputbank 입금은행명 10
nm_input 입금자명 20
dt_inputstd 입금기준일자 8
dt_calculstd 정산기준일자 8
dt_transbase 거래기준일자 8
cl_trans 거래구분코드 [1100] 4
cl_kor 한글구분코드 1
dt_cshr 현금영수증 발급일자
* 현금영수증 발행요청 건의 한함
8
tm_cshr 현금영수증 발급시간
* 현금영수증 발행요청 건의 한함
6
no_cshr_appl 현금영수증 발급번호
* 현금영수증 발행요청 건의 한함
9
no_cshr_tid 현금영수증 발급TID
* 현금영수증 발행요청 건의 한함
40

 
 
 

에스크로 구매결정


PC 에서 에스크로 구매결정 시 호출JS 와 파라미터에 대하여 안내합니다.


구매결정JS : https://stdpay.inicis.com/stdjs/INIStdPay_escrow_conf.js

HTTP Method : POST
Accept-charset : UTF-8

<< 구매결정 요청파라미터 >>

파라미터 설명 필수(O/X) SIZE(Byte)
version 전문 버전 ["1.0" 고정] O 20
mid 결제요청 시 설정한 P_MID 값 O 10
tid 에스크로 결제 승인 TID O 40
currency 통화구분 ["WON":한화, "USD":달러]
* USD는 카드 결제만 가능
O 40
timestamp 타임스템프 (TimeInMillis(Long형)) O 20
mKey SHA256 Hash값 [대상: mid 와 매칭되는 signkey]   HASH
×
mkey 개요

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

ex) hash생성 예시

PlainText: SU5JTElURV9UUklQTEVERVNfS0VZU1RS
Hash 데이터: 3a9503069192f207491d4b19bd743fc249a761ed94246c8c42fed06c3cd15a33


관련 웹매뉴얼로 이동하기
O 64
returnUrl 결과수신URL O N/A
closeUrl 결제창 닫기 URL O N/A
popupUrl 팝업처리 URL O N/A
payViewType 결제창 표시 방법 [overlay,popup] * Default: Default: overlay X 2
charset 결과 수신 인코딩 [UTF-8,EUC-KR] X 6
acceptmethod 복합파라미터
구매확인만 표시 : value="escrow_buyd(co)"
구매거절만 표시 : value="​escrow_buyd(re)"
* Default: 구매확인/거절 모두 표시
X N/A

<< 구매결정 응답파라미터 >>

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


파라미터 설명 SIZE(Byte)
resultCode 결과코드 ["0000": 정상, 그 외 실패] 6
resultMsg 결과메시지 100
CNF_Date 구매확정일 경우, 처리일자 [YYYYMMDD] 8
CNF_Time 구매확정일 경우, 처리시간 [hhmmss] 6
DNY_Date 구매거절일 경우, 처리일자 [YYYYMMDD] 8
DNY_Time 구매거절일 경우, 처리시간 [hhmmss] 6
 
 
 

매출전표(영수증)


매출전표(영수증) 발급 확인은 하기 URL 방식 참고하셔서 구성이 필요합니다.

매출전표URL

"https://iniweb.inicis.com/DefaultWebApp/mall/cr/cm/mCmReceipt_head.jsp?noTid=" + "거래건TID" + "&noMethod=1"

ex ) 버튼 형태의 타입에 매출전표 URL 연동
주의: 고객분은 요청하셨던 정보(구매자명, 금액 등) 를 입력해야 확인 가능