KIS정보통신 POSPORTAL

4.3. KIS 모듈 4.3.1. API 가이드 4.3.1.2. 통합간편결제 통신 API

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.3.1.2. 통합간편결제 통신 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>KIS_Approval_EasyPay 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>inGourpCode</td><td>String</td><td>그룹코드(ex: "" )</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>서명데이터 구분(ex: B - BMP파일)</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> 요청데이터<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>inStructVer</td><td>3</td><td>전문버전(V02)</td></tr><tr><td>String</td><td>inTranCode</td><td>2</td><td>전문구분 AC : 승인, RR : 취소, R2 : 망취소, IQ : 조회</td></tr><tr><td>String</td><td>inCatId</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>inStoreCode</td><td>6</td><td>그룹코드</td></tr><tr><td>String</td><td>inAgencyCode</td><td>3</td><td>포스관리번호</td></tr><tr><td>String</td><td>inTranNo</td><td>20</td><td>거래고유번호</td></tr><tr><td>String</td><td>inTradeReqTime</td><td>14</td><td>요청일자시간</td></tr><tr><td>String</td><td>inAppPayGubn</td><td>14</td><td>간편결제구분</td></tr><tr><td>String</td><td>inCardNo</td><td>256</td><td>인증코드번호 바코드길이(3)+바코드번호+'^'+DEVICEID(10) ex) 카카오페이 : 024281006100000000023456789^1234567890</td></tr><tr><td>String</td><td>inYNSign</td><td>1</td><td>전자서명유무</td></tr><tr><td>String</td><td>inHeaderFiler</td><td>50</td><td>헤더 여부필드</td></tr><tr><td>String</td><td>inWCC</td><td>1</td><td>입력방식</td></tr><tr><td>String</td><td>inCurrencyCode</td><td>3</td><td>통화코드</td></tr><tr><td>String</td><td>inInstallment</td><td>2</td><td>할부개월</td></tr><tr><td>String</td><td>inTranAmt</td><td>12</td><td>결제요청금액</td></tr><tr><td>String</td><td>inVatAmt</td><td>12</td><td>부가세</td></tr><tr><td>String</td><td>inSvcAmt</td><td>12</td><td>봉사료</td></tr><tr><td>String</td><td>inTreeAmt</td><td>12</td><td>비과세금액</td></tr><tr><td>String</td><td>inExchangeAmt</td><td>14</td><td>환율적용금액</td></tr><tr><td>String</td><td>inExchangeInfo</td><td>8</td><td>환율정보</td></tr><tr><td>String</td><td>inOrgAuthDate</td><td>8</td><td>원승인일자</td></tr><tr><td>String</td><td>inOrgAuthNo</td><td>32</td><td>원승인번호(원주문번호)</td></tr><tr><td>String</td><td>inVanKey</td><td>16</td><td>VANKEY</td></tr><tr><td>String</td><td>inDeviceAuthValue</td><td>32</td><td>인증식별번호</td></tr><tr><td>String</td><td>inPinBlock</td><td>16</td><td>비밀번호</td></tr><tr><td>String</td><td>inAddInfo</td><td>100</td><td>부가정보</td></tr><tr><td>String</td><td>inReqFiller</td><td>93</td><td>FILLER</td></tr><tr><td>String</td><td>inDepositAmt</td><td>7</td><td>컵보증금</td></tr><tr><td>String</td><td>inAddInfo2</td><td>200</td><td>길이(4)+부가정보(MAX 196) *이디야 기프트카드정보 ( (카드번호(16)*10) + 구분자(9) = 최대169 ) -&gt; "0169"+DATA</td></tr><tr><td> </td><td> </td><td> </td><td> </td></tr></tbody></table>응답 데이터<table><thead><tr><th>Type</th><th>Name</th><th>Length</th><th>Description</th></tr></thead><tbody><tr><td>String</td><td>outStructVer</td><td>3</td><td>전문버전</td></tr><tr><td>String</td><td>outTranCode</td><td>2</td><td>전문구분</td></tr><tr><td>String</td><td>outCatId</td><td>10</td><td>단말기번호</td></tr><tr><td>String</td><td>outStoreCode</td><td>6</td><td>그룹코드</td></tr><tr><td>String</td><td>outAgenyCode</td><td>3</td><td>포스관리번호</td></tr><tr><td>String</td><td>outTranNo</td><td>20</td><td>거래고유번호</td></tr><tr><td>String</td><td>outTradeReqTime</td><td>14</td><td>요청일자시간</td></tr><tr><td>String</td><td>outTradeResTime</td><td>14</td><td>응답일자시간</td></tr><tr><td>String</td><td>outAppPayGubn</td><td>3</td><td>간편결제구분</td></tr><tr><td>String</td><td>outCardNo</td><td>256</td><td>인증코드번호</td></tr><tr><td>String</td><td>outReplyCode</td><td>4</td><td>응답코드</td></tr><tr><td>String</td><td>outDisplayMsg</td><td>50</td><td>응답메시지</td></tr><tr><td>String</td><td>outYNSign</td><td>1</td><td>서명여부</td></tr><tr><td>String</td><td>outHdrFiller</td><td>50</td><td>요청헤더필드</td></tr><tr><td>String</td><td>outAuthNo</td><td>32</td><td>승인번호</td></tr><tr><td>String</td><td>outOrderNo</td><td>32</td><td>주문번호(알리/위쳇) 취소시 필수 주문번호 (고객영수증에 출력하며 취소시 사용)</td></tr><tr><td>String</td><td>outAddedPoint</td><td>12</td><td>발생포인트(할인금액)</td></tr><tr><td>String</td><td>outUsablePoint</td><td>12</td><td>가용포인트(승인금액) 카카오페이 : 결제요청금액 - 카카오페이할인금액</td></tr><tr><td>String</td><td>outTotalPoint</td><td>12</td><td>누적포인트(잔액한도) SSGPAY : SSG MONEY 잔액</td></tr><tr><td>String</td><td>outPayMethod</td><td>5</td><td>결제수단 카카오 : ‘MONEY’ / ‘CARD’ SSGPAY : ‘MONEY’/ ‘CARD’ / 'ACCOT' TOSSPAY : ‘MONEY’/ ‘CARD’ / 'ACCOT' (머니/카드/계좌)</td></tr><tr><td>String</td><td>outUserID</td><td>16</td><td>USER ID</td></tr><tr><td>String</td><td>outMerchantRegNo</td><td>20</td><td>가맹점번호</td></tr><tr><td>String</td><td>outAccepterCode</td><td>4</td><td>매입사코드</td></tr><tr><td>String</td><td>outAccepterName</td><td>16</td><td>매입사명</td></tr><tr><td>String</td><td>outIssuerCode</td><td>4</td><td>발급사코드</td></tr><tr><td>String</td><td>outIssuerName</td><td>16</td><td>발급사명</td></tr><tr><td>String</td><td>outMemBarcodeNo</td><td>16</td><td>멤버쉽바코드</td></tr><tr><td>String</td><td>outMemMerchantNo</td><td>20</td><td>가맹점멤버쉽번호</td></tr><tr><td>String</td><td>outOTC</td><td>40</td><td>OTC정보카카오페이 : 카드 승인시 SSG페이 -SSG PAY 취소 바코드 번호: ‘취소바코드: ‘ + 바코드번호-OTC 번호 요청 시 : ‘실제 승인 OTC번호=유효기간’-SSG계좌 은행사명EMVQR결제시 : OTC</td></tr><tr><td>String</td><td>outCardBin</td><td>8</td><td>실카드BIN 카카오페이 : 카드 승인시LPAY</td></tr><tr><td>String</td><td>outVanKey</td><td>16</td><td>VANKEY</td></tr><tr><td>String</td><td>outAddInfo</td><td>100</td><td>부가정보 SSGPAYSSG PAY 마스킹 실카드번호: ‘실카드: ‘ + 0000---0000SSG계좌 가상계좌출력번호: ‘가상계좌: ’ + 123456789012345LPAYLPAY에 등록된 결제요청ID(20) : 가맹점에서 LPAY와 대사 필요시 가맹점저장신한은련MPM(정상일 경우)할인후금액(12)+할인금액(12)+결제금액(12)</td></tr><tr><td>String</td><td>outCardGubun</td><td>1</td><td>신용/체크 구분 0 : 신용, 1 : 체크, 2 : 기프트/선불</td></tr><tr><td>String</td><td>outPurchaseGubun</td><td>1</td><td>DDC구분 D : DDC, S : DESC, C : EDC</td></tr><tr><td>String</td><td>outFiller1</td><td>98</td><td>FILLER1</td></tr></tbody></table><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></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></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></tbody></table><h3>KisvanSpec 상세요청</h3><table><thead><tr><th> </th><th> </th><th> </th><th> </th></tr></thead><tbody><tr><td>Type</td><td>Name</td><td>Length</td><td>Description</td></tr><tr><td>String</td><td>inServerIP</td><td>21</td><td>테스트 : 210.112.100.97</td></tr><tr><td>String</td><td>inServerPort</td><td>6</td><td>테스트 : 60110</td></tr><tr><td>String</td><td>inSpecType</td><td>2</td><td>스펙구분 KisvanSpec.SPEC_TYPE_SIMPLEPAYMENT</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>전문구분코드 AC : 승인, RR:취소</td></tr><tr><td>String</td><td>inWCC</td><td>1</td><td>"S" : SWIPE, "K" : KEY_IN, "C" : IC, "B" : BarcodeNumber</td></tr><tr><td>String</td><td>inBarcodeNumber</td><td>256</td><td>길이(3)+인증번호(바코드번호) ex&gt;021111111111111111111111</td></tr><tr><td>String</td><td>inTotAmt</td><td>12</td><td>* 카카오페이 카드 취소 CARD일 경우 실승인금액 (할인전금액-할인금액)</td></tr><tr><td>String</td><td>inVatAmt</td><td>12</td><td>　부가세</td></tr><tr><td>String</td><td>inSvcAmt</td><td>12</td><td>　봉사료</td></tr><tr><td>String</td><td>inTaxFree</td><td>12</td><td>　면세금액</td></tr><tr><td>String</td><td>inInstallment</td><td>2</td><td>　할부</td></tr><tr><td>String</td><td>inCurrencyCode</td><td>3</td><td>　통화코드</td></tr><tr><td>String</td><td>inExchangeRateInformation</td><td>8</td><td>　통화정보</td></tr><tr><td>String</td><td>inExchangeRateAmt</td><td>14</td><td>　통화금액</td></tr><tr><td>String</td><td>inOrgAuthNo</td><td>32</td><td>* 취소시 원승인번호 * 알리/위챗페이 - 주문번호 사용</td></tr><tr><td>String</td><td>inOrgAuthDate</td><td>8</td><td>취소시 원거래일자 ( YYYYMMDD )</td></tr><tr><td>String</td><td>inVanKey</td><td>6</td><td>　밴키</td></tr><tr><td>String</td><td>inDeviceAuthValue</td><td>32</td><td>　인증식별번호</td></tr><tr><td>String</td><td>inPwd</td><td>16</td><td>　비밀번호</td></tr><tr><td>String</td><td>inAdditionalInfo</td><td>100</td><td>- 저장필요 정보 (ex. 병원정보) - 알리/위챗 : 승인시 구매상품명 (영문)</td></tr><tr><td>String</td><td>inFiller2</td><td>100</td><td>　여유필드</td></tr><tr><td>String</td><td>context</td><td>　</td><td>Context 안드로이드 11버전 이상에서 거래일련번호를 생성 할 수 없는 경우 Context 생성하여 전달</td></tr><tr><td>String</td><td>indepositAmt</td><td>7</td><td>컵보증금</td></tr><tr><td>String</td><td>inHospitalInfo</td><td>V(196)</td><td>병원정보 데이터(MAX(200))</td></tr></tbody></table><h3>KisvanSpec 상세응답</h3><table><thead><tr><th> </th><th> </th><th> </th><th> </th></tr></thead><tbody><tr><td>Type</td><td>Name</td><td>Length</td><td>Description</td></tr><tr><td>String</td><td>outReplyCode</td><td>4</td><td>응답코드</td></tr><tr><td>String</td><td>outReplyMsg1</td><td>50</td><td>응답메시지</td></tr><tr><td>String</td><td>outAuthNo</td><td>32</td><td>승인번호</td></tr><tr><td>String</td><td>outOrderNo</td><td>32</td><td>알리/위챗 : 주문번호 (고객영수증에 출력하며 취소시 사용)</td></tr><tr><td>String</td><td>outMerchantRegNo</td><td>20</td><td>카드사 가맹점번호</td></tr><tr><td>String</td><td>outMemberShipBarcodeNumber</td><td>16</td><td>　멤버쉽바코드</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>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>outAddedPoint</td><td>12</td><td>발생포인트(할인금액) 카카오페이 : 할인금액</td></tr><tr><td>String</td><td>outUsablePoint</td><td>12</td><td>가용포인트(승인금액) 카카오페이 : 결제요청금액 - 카카오페이할인금액</td></tr><tr><td>String</td><td>outTotalPoint</td><td>　12</td><td>누적포인트(잔액한도) SSGPAY : SSG MONEY 잔액</td></tr><tr><td>String</td><td>outPayGubun</td><td>5</td><td>결제수단 카카오 : ‘MONEY’ / ‘CARD’</td></tr><tr><td>String</td><td>outUserID</td><td>32</td><td>구매 USER ID 알리 : 사용자ID</td></tr><tr><td>String</td><td>outOTC</td><td>40</td><td>OTC정보 * 카카오페이 : 카드 승인시 * SSG페이 - SSG PAY 취소 바코드 번호: ‘취소바코드: ‘ + 바코드번호 - OTC 번호 요청 시 : ‘실제 승인 OTC번호=유효기간’ - SSG계좌 은행사명</td></tr><tr><td>String</td><td>outCardNo</td><td>8</td><td>실카드BIN 카카오페이 카드 승인시</td></tr><tr><td>String</td><td>outVanKey</td><td>16</td><td>VANKEY</td></tr><tr><td>String</td><td>outFiller</td><td>100</td><td>부가정보 * SSGPAY - SSG PAY 마스킹 실카드번호: ‘실카드: ‘ + 0000-****-****-0000 - SSG계좌 가상계좌출력번호: ‘가상계좌: ’ + 123456789012345</td></tr><tr><td>String</td><td>outFiller2</td><td>100</td><td>　FILLER1</td></tr><tr><td>String</td><td>outAuthDate</td><td>8</td><td>승인일자 승인일자(YYYYMMDD)</td></tr><tr><td>String</td><td>outPayType</td><td>3</td><td>간편결제구분 [응답] 결제구분 ‘KKO’ : 카카오페이 ‘SGP’ : SSGPAY ‘ZRP’ : 제로페이 ‘ALP’ : 알리페이 ‘WEP’ : 위챗페이 'LPY' : LPAY 'APP' : 앱카드 * 인증코드번호가 없는 요청시 반드시 세팅</td></tr></tbody></table>참고&gt;<ol><li>jarKisvan 개발가이드(별첨).xlsx 파일 참조</li></ol>

4.3.1.1. 결제 통신 API

4.3.1.3. 카드결제단말기 API

KIS정보통신(주)

개인정보처리방침