KIS정보통신 POSPORTAL

4.3. KIS 모듈 4.3.1. API 가이드 4.3.1.1. 결제 통신 API

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.3.1.1. 결제 통신 API

케이아이에스정보통신(주) 와 결제 통신하는 모듈입니다.<h3>Windows API</h3>본 문서는 KIS정보통신의 인터넷 승인 결제 라이브러리의 설명서입니다. <blockquote>주의 사항<ol><li>함수의 리턴값이 0인 경우는 응답 전문을 수신한 경우이며 정상승인과는 별개입니다.</li></ol>리턴값이 0인 경우에도 승인 거절일 수도 있습니다.<ol><li>함수의 리턴값이 99,98,97인 경우 망상취소가 발생한 경우이며 DLL에서 자동망상취소전문 생성하여 HOST로 전송하지만 자동망상취소 실패 시에는 반드시 POS프로그램에서 망상 취소전문(통신장애전문)을 생성하여 HOST로 전송하여야 합니다.</li><li>멀티 스레드의 경우 거래일련번호 생성 시 파일에 접근하는 업무가 있으므로 불안정합니다. 단일 스레드를 사용해야 합니다.</li><li>거래 일련 번호는 DLL에서 별도로 저장된 거래일련번호로 대치되어 사용되어지므로 유의하시기 바랍니다</li><li>POS프로그램의 개발 언어가 Visual Basic계열(파워빌더포함)인 경우 함수명은 VB_로 시작하는 함수를 호출하여 주시기 바랍니다.</li><li>이 모듈은 KIS정보통신 전문포맷 사양서만 지원합니다. </li></ol></blockquote><h3>NACF_Approval_VANKEY API</h3><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>inIpAddress</td><td>String</td><td>IP 주소</td></tr><tr><td>inPortNo</td><td>int</td><td>Port 번호</td></tr><tr><td>inSendData</td><td>char *</td><td>결제요청 데이터</td></tr><tr><td>inSendLen</td><td>int</td><td>결제요청 데이터 길이</td></tr><tr><td>inSignGubun</td><td>String</td><td>서명데이터 구분</td></tr><tr><td>inSignData</td><td>String</td><td>서명데이터</td></tr><tr><td>inSignLen</td><td>int</td><td>서명데이터 길이</td></tr><tr><td>outRecvData</td><td>char *</td><td>결제응답 데이터</td></tr></tbody></table> Retrun Value<blockquote>[0] 정상적으로 응답전문 수신[2] 사인데이터 사이즈가 1700byte일때, (재 서명 요청하여 주십시오)[-21, -23] 네트워크 오류 KIS서버 접속 실패. 망상처리 안함[99] Timeout발생 후 DLL에서 자동 망상 처리가 성공한 경우 (취소가 거절될 수 있음)[98] Timeout발생 후 DLL에서 자동 망상 처리가 Timeout된 경우.[97] Timeout발생 후 DLL에서 자동 망상 처리할 수 없는 경우 (예, 신용취소)</blockquote> Req Auth Spec<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>Type</td><td>Name</td><td>Length</td><td>Description</td></tr><tr><td>String</td><td>Stx</td><td>1</td><td>STX(0x02)</td></tr><tr><td>String</td><td>inTranCode</td><td>2</td><td>전문 구분코드 ‘D1’</td></tr><tr><td>String</td><td>inPosNo</td><td>3</td><td>POS번호</td></tr><tr><td>String</td><td>inSerialNo</td><td>6</td><td>일련번호(Uinque)</td></tr><tr><td>String</td><td>inReqTime</td><td>14</td><td>요청일시(YYYYMMDDHHMMSS)</td></tr><tr><td>String</td><td>inWcc</td><td>1</td><td>"S" : SWIPE, "K" : KEY_IN, "C" : IC, "F" : Fallback</td></tr><tr><td>String</td><td>inSecureInfo</td><td>161</td><td>암호화 데이터</td></tr><tr><td>String</td><td>inInstallment</td><td>2</td><td>할부 기간(‘00’,’03’)</td></tr><tr><td>String</td><td>inTotAmt</td><td>8</td><td>금액(ex&gt; ‘00001004’)</td></tr><tr><td>String</td><td>inCatID</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>inAuthGubun</td><td>12</td><td>인증시구분정보</td></tr><tr><td>String</td><td>inPinBlock</td><td>16</td><td>인증시 비밀번호: 비밀번호(앞2자리) + SPACE</td></tr><tr><td>String</td><td>inVatFlag</td><td>2</td><td>세금사용플래그 부가세,봉사료 사용시‘US’ 셋팅함</td></tr><tr><td>String</td><td>inSvcAmt</td><td>8</td><td>Ex&gt; 00010000</td></tr><tr><td>String</td><td>inVatAmt</td><td>8</td><td>Ex&gt; 00010000</td></tr><tr><td>String</td><td>inOilInfo</td><td>17</td><td>유종정보</td></tr><tr><td>String</td><td>inFiller</td><td>31</td><td>예비필드(SPACE)</td></tr><tr><td>String</td><td>inRoyaltyInfo</td><td>206</td><td>로열티정보</td></tr><tr><td>String</td><td>inSecurePosNo</td><td>30</td><td>POS보안 일련번호</td></tr><tr><td>String</td><td>inICConvertInfo</td><td>39</td><td>IC전환 데이터</td></tr><tr><td>String</td><td>inEmvData</td><td>261</td><td>Chip Data</td></tr><tr><td>String</td><td>inVankey</td><td>16</td><td>VANKEY</td></tr><tr><td>String</td><td>CR</td><td>1</td><td>CR(0x0d)</td></tr><tr><td>String</td><td>ETX</td><td>1</td><td>ETX(0x03)</td></tr></tbody></table>Res Auth Spec<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>STX</td><td>1</td><td>STX(0x02)</td></tr><tr><td>String</td><td>outTranCode</td><td>2</td><td>전문 구분코드 ‘D1’</td></tr><tr><td>String</td><td>outPosNo</td><td>3</td><td>POS번호</td></tr><tr><td>String</td><td>outSerialNo</td><td>6</td><td>일련번호(Uinque)</td></tr><tr><td>String</td><td>outReqDate</td><td>14</td><td>요청일시(YYYYMMDDHHMMSS)</td></tr><tr><td>String</td><td>outReplyCode</td><td>4</td><td>응답코드 정상시"0000", 오류시 오류코드 SET</td></tr><tr><td>String</td><td>outJanAmt</td><td>6</td><td>잔액</td></tr><tr><td>String</td><td>outAccepterCode</td><td>2</td><td>매입사코드</td></tr><tr><td>String</td><td>outIssuerCode</td><td>2</td><td>카드발급사코드</td></tr><tr><td>String</td><td>outIssuerName</td><td>20</td><td>가맹점번호</td></tr><tr><td>String</td><td>outCatId</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>outAuthNo</td><td>8</td><td>승인번호</td></tr><tr><td>String</td><td>outIssuerName</td><td>20</td><td>카드 발급사명</td></tr><tr><td>String</td><td>outAccepterName</td><td>20</td><td>매입사 명</td></tr><tr><td>String</td><td>outReplyMsg</td><td>40</td><td>응답메세지</td></tr><tr><td>String</td><td>outVanCode</td><td>5</td><td>‘KIS’ + 2BYTE(SPACE)</td></tr><tr><td>String</td><td>outAuthDate</td><td>8</td><td>KIS 승인일자</td></tr><tr><td>String</td><td>outFiller</td><td>80</td><td>SPACE (응답메세지2 (40바이트))</td></tr><tr><td>String</td><td>outRoyaltyInfo</td><td>310</td><td>로열티정보</td></tr><tr><td>String</td><td>outEmvData</td><td>326</td><td>EMV데이터</td></tr><tr><td>String</td><td>outVankey</td><td>16</td><td>VAN KEY</td></tr><tr><td>String</td><td>CR</td><td>1</td><td>CR(0x0d)</td></tr><tr><td>String</td><td>ETX</td><td>1</td><td>ETX(0x03)</td></tr></tbody></table>Req Auth Cancel Spec<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>STX</td><td>1</td><td>STX(0x02)</td></tr><tr><td>String</td><td>inTranCode</td><td>2</td><td>전문 구분코드 ‘D2’</td></tr><tr><td>String</td><td>inPosNo</td><td>3</td><td>POS번호</td></tr><tr><td>String</td><td>inSerialNo</td><td>6</td><td>일련번호(Uinque)</td></tr><tr><td>String</td><td>inReqTime</td><td>8</td><td>요청일(YYYYMMDD)</td></tr><tr><td>String</td><td>inWcc</td><td>6</td><td>요청시간(HHMMSS)</td></tr><tr><td>String</td><td>inInstallment</td><td>161</td><td>암호화 정보</td></tr><tr><td>String</td><td>inTotAmt</td><td>2</td><td>할부 기간(‘00’,’03’)</td></tr><tr><td>String</td><td>inCatID</td><td>8</td><td>금액(ex&gt; ‘00001004’)</td></tr><tr><td>String</td><td>inAuthGubun</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>inOrgAuthNo</td><td>8</td><td>원승인번호</td></tr><tr><td>String</td><td>inOrgDate</td><td>6</td><td>원승인 일자 YYMMDD</td></tr><tr><td>String</td><td>inPinBlock</td><td>14</td><td>SPACE(은련시 비밀번호 세팅)</td></tr><tr><td>String</td><td>inSvcAmt</td><td>8</td><td>부가세 Ex&gt; 00010000</td></tr><tr><td>String</td><td>inVatAmt</td><td>8</td><td>봉사료 Ex&gt; 00010000</td></tr><tr><td>String</td><td>inOilInfo</td><td>17</td><td>유종정보</td></tr><tr><td>String</td><td>inFiller</td><td>31</td><td>FILLER 예비필드(SPACE)</td></tr><tr><td>String</td><td>inRoyaltyInfo</td><td>206</td><td>로열티정보</td></tr><tr><td>String</td><td>inEmvData</td><td>30</td><td>POS보안 일련번호 SPACE(내부사용)</td></tr><tr><td>String</td><td>inICConvertInfo</td><td>39</td><td>IC전환 데이터</td></tr><tr><td>String</td><td>inEmvData</td><td>261</td><td>EMV데이터</td></tr><tr><td>String</td><td>inVankey</td><td>16</td><td>VAN KEY</td></tr><tr><td>AN</td><td>CR</td><td>1</td><td>CR(0x0d)</td></tr><tr><td>AN</td><td>ETX</td><td>1</td><td>ETX(0x03)</td></tr></tbody></table>Res Auth Cancel Spec<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>STX</td><td>1</td><td>0x02</td></tr><tr><td>String</td><td>outTranCode</td><td>2</td><td>‘D2’</td></tr><tr><td>String</td><td>outPosNo</td><td>3</td><td>POS번호</td></tr><tr><td>String</td><td>outSerialNo</td><td>6</td><td>일련번호(Uinque)</td></tr><tr><td>String</td><td>outReqDate</td><td>14</td><td>요청일(YYYYMMDD)</td></tr><tr><td>String</td><td>outReplyCode</td><td>4</td><td>정상시"0000" 오류시 오류코드 SET</td></tr><tr><td>String</td><td>outJanAmt</td><td>6</td><td>잔액</td></tr><tr><td>String</td><td>outAccepterCode</td><td>2</td><td>매입사코드</td></tr><tr><td>String</td><td>outIssuerCode</td><td>2</td><td>카드발급사코드</td></tr><tr><td>String</td><td>outMerchantRegNo</td><td>20</td><td>가맹점번호</td></tr><tr><td>String</td><td>outAuthNo</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>outAuthNo</td><td>8</td><td>승인번호</td></tr><tr><td>String</td><td>outIssuerName</td><td>20</td><td>카드 발급사명</td></tr><tr><td>String</td><td>outAccepterName</td><td>20</td><td>매입사 명</td></tr><tr><td>String</td><td>outReplyMsg</td><td>40</td><td>응답메세지</td></tr><tr><td>String</td><td>outVanCode</td><td>5</td><td>‘KIS’ + 2BYTE(SPACE)</td></tr><tr><td>String</td><td>outFiller</td><td>8</td><td>KIS 승인일자</td></tr><tr><td>String</td><td>outRoyaltyInfo</td><td>80</td><td>FILLER</td></tr><tr><td>String</td><td>outEmvData</td><td>310</td><td>로열티정보</td></tr><tr><td>String</td><td>outEmvData</td><td>326</td><td>EMV데이터</td></tr><tr><td>String</td><td>outVankey</td><td>16</td><td>VAN KEY (KIS UNIQUE KEY)</td></tr><tr><td>String</td><td>CR</td><td>1</td><td>CR(0x0d)</td></tr><tr><td>String</td><td>ETX</td><td>1</td><td>ETX(0x03)</td></tr></tbody></table>여신금융협회 신용카드 단말기 보안인증을 받을 업체인 경우 사용 가능합니다. {% embed url="<a href="https://www.crefia.or.kr/">https://www.crefia.or.kr/</a>" %} jarKisvan API<h3>JAVA Class 구성</h3><table><thead><tr><th>Class 명</th><th>Package</th><th>설명</th></tr></thead><tbody><tr><td>KisvanSpec</td><td>kr.co.kisvan.lib</td><td>KIS정보통신 전문생성을 도와주는 Class</td></tr><tr><td>Kisvan</td><td>kr.co.kisvan.lib</td><td>KIS정보통신 서버와 통신하는 Class</td></tr><tr><td>KisvanSign</td><td>kr.co.kisvan.lib</td><td>KIS정보통신 암호화 서명데이터 생성 Class</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table><h3>Kisvan Class</h3>함수목록<table><thead><tr><th>함수명</th><th>설명</th><th>Retrun Type</th></tr></thead><tbody><tr><td>Kisvan_Init</td><td>초기화</td><td> </td></tr><tr><td>Kisvan_Approval</td><td>승인요청</td><td>-11 : 요청데이터 확인요망-12 : 요청전문암호화 실패(KEY생성오류)-13 : 요청전문암호화 실패-14 : 응답전문복호화 실패(KEY생성오류)-15 : 응답전문복호화 실패-16 : 응답전문 길이 오류-17 : 서명 암호화 오류-18 : 서명 관련 데이터 확인 요망-21 : Server Connect Error-22 - -23 : Socket Send Error-24 - -27 : Socket Read Error</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table>Request<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>inServerIP</td><td>String</td><td>서버IP</td></tr><tr><td>inServerPort</td><td>int</td><td>서버포트</td></tr><tr><td>inCryptType</td><td>int</td><td>"0"평문,"1"SEED</td></tr><tr><td>inSpecType</td><td>String</td><td> </td></tr><tr><td>inReqSpec</td><td>String</td><td>요청 데이터</td></tr><tr><td>inReqSpecLen</td><td>int</td><td>요청 데이터 길이</td></tr><tr><td>inSignType</td><td>int</td><td> </td></tr><tr><td>inSignData</td><td>Byte[]</td><td>서명 데이터</td></tr><tr><td>inSignDataLen</td><td>int</td><td>서명 데이터 길이</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table>Response<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>outResSpec</td><td>Byte[]</td><td>응답전문</td></tr><tr><td>outResSpecLen</td><td>int</td><td>응답전문 길이</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table><h3>KisvanSpec Class</h3>Kis 전문 생성을 도와주는 함수 함수목록<table><thead><tr><th>함수명</th><th>설명</th><th>Return Type</th></tr></thead><tbody><tr><td>Init</td><td>초기화</td><td> </td></tr><tr><td>MakeReqSpec</td><td>요청전문 생성</td><td>"0":정상"-1":요청데이터 확인요망"-2":지원하지 않는 전문 Type"-3":지원하지 않는 거래 Type</td></tr><tr><td>GetResSpec</td><td>응답전문 Slice</td><td>"0":정상"-2":지원하지 않는 전문 Type"-3":지원하지 않는 거래 Type"-4":요청전문 메모리 부족"-5":응답전문 확인 요망</td></tr></tbody></table><h3>KisvanSign Class</h3>Kis 서명암호화 함수<table><thead><tr><th>Name</th><th>설명</th><th>Return Type</th></tr></thead><tbody><tr><td>EncryptSignData</td><td>서명암호화</td><td>"0 보다 큰경우":데이터길이 "-1":서명데이터 읽기 실패 "-2":서명Type 오류</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table>Request<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>inSignType</td><td>int</td><td> </td></tr><tr><td>inSignData</td><td>Byte[]</td><td>BMP인 경우 사용</td></tr><tr><td>inSignFileName</td><td>String</td><td>BMP FilePath인 경우 사용</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table>Response<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>outSignData</td><td>Byte[]</td><td>암호화된 서명데이터</td></tr><tr><td> </td><td> </td><td> </td></tr></tbody></table><h3>KisvanSpec 상세 요청</h3><table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>inServerIP</td><td>21</td><td>KIS 서버 주소 테스트 : 210.112.100.97</td></tr><tr><td>String</td><td>inServerPort</td><td>n/a</td><td>KIS 서버 포트 테스트 : 9019</td></tr><tr><td>String</td><td>inSpecType</td><td>2</td><td>스펙구분 3 : NACF3_VANKEY 4 : NACF3_HOSPITAL</td></tr><tr><td>String</td><td>inCatID</td><td>10</td><td>가맹점단말기번호</td></tr><tr><td>String</td><td>inAgencyCode</td><td>3</td><td>개발업체구분</td></tr><tr><td>String</td><td>inTranCode</td><td>2</td><td>전문구분코드 "D1" 신용승인, "D2" 신용취소</td></tr><tr><td>String</td><td>inWCC</td><td>1</td><td>WCC "C" : IC, "F" : Fallback , "S" : SWIPE, "K" : KEY_IN,</td></tr><tr><td>String</td><td>inDeviceAuthValue</td><td>32</td><td>단말기인증값 리더기 인증값(16) + POS 인증값 (16)</td></tr><tr><td>String</td><td>inSafeCardICData</td><td>575</td><td>암호화된 IC 데이터 시트 참조</td></tr><tr><td>String</td><td>inSafeCardMSData</td><td>174</td><td>암호화된 MS 데이터 ( fallback거래에 한함)</td></tr><tr><td>String</td><td>inCardNo</td><td>37</td><td>키인 승인 시 카드번호 앱카드 바코드 승인 시 OTC번호 21자리 토큰 승인 시 토큰번호</td></tr><tr><td>String</td><td>inInstallment</td><td>2</td><td>할부 개월 수 ( 일시불 : "00", 3개월: "03" )</td></tr><tr><td>String</td><td>inTotAmt</td><td>8</td><td>결제금액 ( 부가세 포함, 봉사료 제외)</td></tr><tr><td>String</td><td>inSvcAmt</td><td>8</td><td>봉사료 금액</td></tr><tr><td>String</td><td>inVatAmt</td><td>8</td><td>부사세액</td></tr><tr><td>String</td><td>inOrgAuthNo</td><td>8</td><td>취소시 원승인번호</td></tr><tr><td>String</td><td>inOrgAuthDate</td><td>6</td><td>취소시 원거래일자 ( YYMMDD )</td></tr><tr><td>String</td><td>inPinBlock</td><td>16</td><td>비밀번호 은련결제시 암호화된PIN(16)</td></tr><tr><td>String</td><td>inOilInfo</td><td>14</td><td>유종정보 시트</td></tr><tr><td>String</td><td>inCertificationYn</td><td>1</td><td>구인증 사용여부 "Y" 사용, "N" : 사용안함</td></tr><tr><td>String</td><td>inCertificationCategory</td><td>2</td><td>구인증 구분자 ‘YJ’생년월일 인증+승인, ‘YB’사업자번호 인증+승인 ‘yj’생년월일 인증, ‘yb’사업자번호 인증</td></tr><tr><td>String</td><td>inCertificationInfomation</td><td>10</td><td>구인증 인증정보 개인:생년월일(6BYTE) + SPACE(4) 법인:사업자번호(10BYTE)</td></tr><tr><td>String</td><td>inCertificationInfomation</td><td>2</td><td>구인증 비밀번호 인증시 비밀번호: 비밀번호</td></tr><tr><td>String</td><td>inVanKey</td><td>16</td><td>무카드 취소 거래시 사용</td></tr><tr><td>String</td><td>inSerialNo</td><td>6</td><td>거래일련번호 안드로이 11이상인 경우 필수 사용. 거래마다 유니크해야하며 정수값 필수.</td></tr><tr><td>String</td><td>inIssuerCodeConvertYn</td><td>1</td><td>호텔 발급사코드 변경 구분자 "Y" : 허용 "N" : 비허용</td></tr><tr><td>String</td><td>inCardBinEight</td><td>1</td><td>카드빈8자리 주는 리더기인 경우 "Y" 그 이외는 공백</td></tr><tr><td>String</td><td>indepositAmt</td><td>7</td><td>컵보증금</td></tr><tr><td>String</td><td>inHospitalInfo</td><td>V</td><td>병원정보 데이터</td></tr><tr><td> </td><td>context</td><td>　</td><td>안드로이드 OS에서만 사용 안드로이드 11버전 이상에서 거래일련번호를 생성 할 수 없는 경우 Context 생성하여 전달</td></tr></tbody></table><h3>KisvanSpec 상세 응답</h3><table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>outReplyCode</td><td>4</td><td>응답코드</td></tr><tr><td>String</td><td>outJanAmt</td><td>8</td><td>GIFT카드 잔액</td></tr><tr><td>String</td><td>outAccepterCode</td><td>2</td><td>매입사코드</td></tr><tr><td>String</td><td>outAccepterName</td><td>20</td><td>매입사명</td></tr><tr><td>String</td><td>outAuthDate</td><td>8</td><td>승인일자(YYYYMMDD)</td></tr><tr><td>String</td><td>outAuthNo</td><td>12</td><td>승인번호</td></tr><tr><td>String</td><td>outIssuerCode</td><td>2</td><td>발급사코드</td></tr><tr><td>String</td><td>outIssuerName</td><td>20</td><td>발급사명</td></tr><tr><td>String</td><td>outMerchantRegNo</td><td>20</td><td>카드사 가맹점번호</td></tr><tr><td>String</td><td>outDisplayMsg</td><td>40</td><td>거래 메시지</td></tr><tr><td>String</td><td>outEMVData</td><td>326</td><td>EMV응답데이터</td></tr><tr><td>String</td><td>outVanKey</td><td>16</td><td>VANKEY</td></tr></tbody></table>참고&gt;<ol><li>jarKisvan 개발가이드(별첨).xlsx 파일 참조</li></ol>

4.3.1. API 가이드

4.3.1.2. 통합간편결제 통신 API

KIS정보통신(주)

개인정보처리방침