KIS정보통신 POSPORTAL

4.3. KIS 모듈 4.3.1. API 가이드 4.3.1.6. 서명패드 API

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.3.1.6. 서명패드 API

<p>서명패드와 통신하는 모듈입니다.</p><p><br></p><p>케이아이에스정보통신(주) 서명패드만 사용이 가능합니다.</p><p><br></p><p>KisvanMS3 API 가이드</p><p><br></p><p>가. 함수 목록</p><table><thead><tr><th><p>함수명</p></th><th><p>설명</p></th><th><p>비고</p></th><th><p><br></p></th></tr></thead><tbody><tr><td><p>SetPortNo</p></td><td><p>서명 패드가 연결된 통신 포트 번호 설정</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>SetBaudRate</p></td><td><p>서명 패드가 연결된 통신 포트의 속도 설정</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisElecSign</p></td><td><p>서명 요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisElecSignMsg</p></td><td><p>서명 메시지요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisDisplayPrint</p></td><td><p>서명 메시지 추가</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisCancel</p></td><td><p>취소 또는 종료</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnSignEnd</p></td><td><p>서명 완료 된 경우 발생하는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetSignData</p></td><td><p>서명 데이터 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetSignFile</p></td><td><p>서명 데이터 파일 저장요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetSignBMP</p></td><td><p>서명에 대한 BMP파일 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetCustInfo</p></td><td><p>고객 정보 요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnCustInfoEnd</p></td><td><p>고객 정보 입력이 완료 된 경우 발생하는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetCustInfoData</p></td><td><p>고객 정보 데이터 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetPin</p></td><td><p>비밀번호 요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnPinEnd</p></td><td><p>비밀 번호 입력이 완료 된 경우 발생하는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetPinData</p></td><td><p>입력된 고객의 암호화된 비밀번호 데이터 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetDCC</p></td><td><p>DCC 자국화폐 선택(광고1-3)</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetDCC1</p></td><td><p>DCC 자국화폐 선택(광고1-4)</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>OnDCCEnd</p></td><td><p>DCC서비스 자국화폐선택 후 발생되는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetSerial</p></td><td><p>서명패드에 대한 제품 번호 요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnSerialEnd</p></td><td><p>전자서명 패드에 대한 제품 번호 요청에 대한 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetSerialData</p></td><td><p>전자서명 패드에 대한 제품 번호 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisConfig</p></td><td><p>환경 설정 요청</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>OnPadError</p></td><td><p>서명패드가 정상적인 응답이 없는 경우 발생하는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetAccount</p></td><td><p>결제계좌 선택 요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnAccountEnd</p></td><td><p>결제계좌 선택 후 발생되는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetAccountlData</p></td><td><p>선택 된 결제계좌 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetNpgBarCode</p></td><td><p>카메라 바코드 스캔요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>KisGetNpgBarCodeData</p></td><td><p>바코드 데이터 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnNpgBarCodeEnd</p></td><td><p>카메라바코드 스캔 후 발생되는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetCashIcPin</p></td><td><p>현금IC PIN요청</p></td><td><p>0 :성공 1:실패</p></td><td><p><br></p></td></tr><tr><td><p>OnCashIcPinEnd</p></td><td><p>번호 입력이 완료 된 경우 발생하는 이벤트</p></td><td><p><br></p></td><td><p><br></p></td></tr><tr><td><p>KisGetCashIcPinData</p></td><td><p>암호화된 비밀번호 데이터 요청</p></td><td><p>1 :성공 0:실패</p></td><td><p><br></p></td></tr></tbody></table><h3>API 가이드</h3><ol><li><p>SetPortNo 호출하여 패드가 연결된 포트번호 설정</p></li><li><p>SetBaudRate 호출하여 COM 포트의 속도 설정</p></li><li><p>각 요청 함수(ex&gt; KisElecSign, KisGetCustInfo) 을 요청 후 이벤트 함수(ex&gt; OnSignEnd, OnCustInfoEnd)을 응답함수(ex&gt; KisGetSignData, KisGetCustInfoData)호출하여 멤버변수(ex&gt; strCustInfoData)로 데이터를 받습니다.</p></li></ol><h3>SetPortNo API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inComPortNo</p></td><td><p>short</p></td><td><p>포트번호</p></td></tr></tbody></table><h3>SetBaudRate API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inBaudRate</p></td><td><p>int</p></td><td><p>통신속도번호</p></td></tr></tbody></table><h3>KisElecSign API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inCardNo</p></td><td><p>String</p></td><td><p>카드번호(카드빈(6)+카드빈(6)+1234)(20)</p></td></tr><tr><td><p>inTrInfo</p></td><td><p>String</p></td><td><p><br></p></td></tr></tbody></table><h3>KisElecSignMsg API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inCardNo</p></td><td><p>String</p></td><td><p>카드번호(카드빈(6)+카드빈(6)+1234)(20)</p></td></tr><tr><td><p>inTrInfo</p></td><td><p>String</p></td><td><p><br></p></td></tr><tr><td><p>strMsg1</p></td><td><p>String</p></td><td><p>광고문구 (길이: 16 고정)</p></td></tr><tr><td><p>strMsg2</p></td><td><p>String</p></td><td><p>광고문구 (길이: 16 고정)</p></td></tr><tr><td><p>strMsg3</p></td><td><p>String</p></td><td><p>광고문구 (길이: 16 고정)</p></td></tr><tr><td><p>strMsg4</p></td><td><p>String</p></td><td><p>광고문구 (길이: 16 고정)</p></td></tr></tbody></table><h3><strong>OnSignEnd API</strong></h3><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>KisGetSignData API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr></tbody></table><p><strong>KisGetSignFile API</strong></p><p><br></p><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inFileName</p></td><td><p>String</p></td><td><p>서명 데이터 파일 저장위치(sign.bmp)</p></td></tr></tbody></table><h3><strong>KisGetSignBMP API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inCardNo</p></td><td><p>String</p></td><td><p>카드번호(카드빈(6)+카드빈(6)+1234)(20)</p></td></tr><tr><td><p>inTrInfo</p></td><td><p>String</p></td><td><p>단말기ID(16)+거래일련번호(12)+승인일자(6:YYMMDD)+승인금액</p><p>(12:Leading_zero)+거래일련번호(15)</p><p>거래일련번호 구성 : ‘00’+거래일련번호(4)+스페이스(6 또는9)</p></td></tr><tr><td><p>inFileName</p></td><td><p>String</p></td><td><p>서명 데이터 파일 저장위치(sign.bmp)</p></td></tr></tbody></table><h3><strong>KisDisplayPrint API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inTime</p></td><td><p>String</p></td><td><p>대기시간(ex&gt; 20)</p></td></tr><tr><td><p>inDisplayMsg1</p></td><td><p>String</p></td><td><p>화면문구1(16)</p></td></tr><tr><td><p>inDisplayMsg2</p></td><td><p>String</p></td><td><p>화면문구2(16)</p></td></tr><tr><td><p>inDisplayMsg3</p></td><td><p>String</p></td><td><p>화면문구3(16)</p></td></tr><tr><td><p>inDisplayMsg4</p></td><td><p>String</p></td><td><p>화면문구4(16)</p></td></tr></tbody></table><h3><strong>KisCanCel API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>KisGetCustInfo API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><p><strong>OnCustInfoEnd</strong> <strong>API</strong></p><p><br></p><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>strCustInfoData</p></td><td><p>String</p></td><td><p>response data</p></td></tr></tbody></table><h3><strong>KisGetCustInfoData API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr></tbody></table><h3><strong>KisGetPin API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inCardNo</p></td><td><p>String</p></td><td><p>카드번호(카드빈(6)+카드빈(6)+1234)</p></td></tr><tr><td><p>inAmt</p></td><td><p>String</p></td><td><p>금액(8 : Leading Space)</p></td></tr><tr><td><p>inWorkingKey</p></td><td><p>String</p></td><td><p>암호화를 위한 KEY (16)</p></td></tr></tbody></table><h3><strong>onPinEnd API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>KisGetPinData API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr><tr><td><p><br></p></td><td><p><br></p></td><td><p>ex&gt; axkisvanMS31.strPinData</p></td></tr></tbody></table><h3><strong>KisGetDCC API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inPositiveMsg</p></td><td><p>String</p></td><td><p>POSITIVE문구</p></td></tr><tr><td><p>inNegativeMsg</p></td><td><p>String</p></td><td><p>NEGATIVE문구</p></td></tr><tr><td><p>strMsg1</p></td><td><p>String</p></td><td><p>화면표시메시지1</p></td></tr><tr><td><p>strMsg2</p></td><td><p>String</p></td><td><p>화면표시메시지2</p></td></tr><tr><td><p>strMsg3</p></td><td><p>String</p></td><td><p>화면표시메시지3</p></td></tr></tbody></table><h3><strong>KisGetDCC1 API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inPositiveMsg</p></td><td><p>String</p></td><td><p>POSITIVE문구</p></td></tr><tr><td><p>inNegativeMsg</p></td><td><p>String</p></td><td><p>NEGATIVE문구</p></td></tr><tr><td><p>strMsg1</p></td><td><p>String</p></td><td><p>화면표시메시지1</p></td></tr><tr><td><p>strMsg2</p></td><td><p>String</p></td><td><p>화면표시메시지2</p></td></tr><tr><td><p>strMsg3</p></td><td><p>String</p></td><td><p>화면표시메시지3</p></td></tr><tr><td><p>strMsg4</p></td><td><p>String</p></td><td><p>화면표시메시지4</p></td></tr></tbody></table><h3><strong>onDCCEnd API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>strDCCResult</p></td><td><p>String</p></td><td><p>"POSITIVE" 또는 "NEGATIVE"</p></td></tr></tbody></table><h3><strong>KisGetSerial API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>KisGetSerial API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>OnSerialEnd API</strong></h3><p><strong>Resquest</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3><strong>KisGetSerialData API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr></tbody></table><h3>KisGetAccount API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inAccountCnt</p></td><td><p>String</p></td><td><p>계좌개수(2:"09")</p></td></tr><tr><td><p>inAccountArray</p></td><td><p>String</p></td><td><p>계좌번호 콤마(,)로 구분 ex&gt; "123456789012345,54321098756453"</p></td></tr></tbody></table><h3>OnAccountEnd API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3>KisGetAccountData API</h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr></tbody></table><h3>KisGetNpgBarCode API</h3><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inReqData</p></td><td><p>String</p></td><td><p>여유 필드 공백처리 예) "" "V": 옵션체크(카메라바코드 및 NFC 지원</p></td></tr></tbody></table><p><strong>OnNpgBarCodeEnd API</strong></p><p><br></p><p><strong>Request</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3>KisGetNpgBarCodeData API</h3><p>Response</p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr><tr><td><p>strNpgBarCodeData</p></td><td><p>String</p></td><td><p>response data</p></td></tr></tbody></table><h3><strong>KisGetCashIcPin API</strong></h3><p>Request</p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>inTime</p></td><td><p>String</p></td><td><p>거래일시(YYYYMMDDHHNNSS)+요일(2:01-07)(16)</p></td></tr><tr><td><p>inAmount</p></td><td><p>String</p></td><td><p>금액(00001004)(8)</p></td></tr><tr><td><p>inDefaultKey</p></td><td><p>String</p></td><td><p>암호화를 위한 디폴트 KEY (16)</p></td></tr><tr><td><p>inKeyIndex</p></td><td><p>String</p></td><td><p>"00":계좌선택 비밀번호,"01":계좌비밀번호</p></td></tr></tbody></table><h3><strong>OnCashIcPinEnd API</strong></h3><p><strong>Response</strong></p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p><br></p></td><td><p><br></p></td><td><p><br></p></td></tr></tbody></table><h3>KisGetPinData <strong>API</strong></h3><p>Response</p><table><thead><tr><th><p>Name</p></th><th><p>Type</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><p>returnVal</p></td><td><p>int</p></td><td><p>nSuccess : 1 :성공 0:실패</p></td></tr><tr><td><p>resData</p></td><td><p>char*</p></td><td><p>response data</p></td></tr><tr><td><p>strPinData</p></td><td><p>String</p></td><td><p>response data</p></td></tr></tbody></table>

4.3.1.5. 카드리더기 API

4.3.2. FAQ

KIS정보통신(주)

개인정보처리방침