🦢서명패드 API

서명패드와 통신하는 모듈입니다.

케이아이에스정보통신(주) 서명패드만 사용이 가능합니다.

KisvanMS3 API 가이드

가. 함수 목록

함수명	설명	비고
SetPortNo	서명 패드가 연결된 통신 포트 번호 설정	0 :성공 1:실패
SetBaudRate	서명 패드가 연결된 통신 포트의 속도 설정	0 :성공 1:실패
KisElecSign	서명 요청	0 :성공 1:실패
KisElecSignMsg	서명 메시지요청	0 :성공 1:실패
KisDisplayPrint	서명 메시지 추가	0 :성공 1:실패
KisCancel	취소 또는 종료	0 :성공 1:실패
OnSignEnd	서명 완료 된 경우 발생하는 이벤트
KisGetSignData	서명 데이터 요청	1 :성공 0:실패
KisGetSignFile	서명 데이터 파일 저장요청	1 :성공 0:실패
KisGetSignBMP	서명에 대한 BMP파일 요청	1 :성공 0:실패
KisGetCustInfo	고객 정보 요청	0 :성공 1:실패
OnCustInfoEnd	고객 정보 입력이 완료 된 경우 발생하는 이벤트
KisGetCustInfoData	고객 정보 데이터 요청	1 :성공 0:실패
KisGetPin	비밀번호 요청	0 :성공 1:실패
OnPinEnd	비밀 번호 입력이 완료 된 경우 발생하는 이벤트
KisGetPinData	입력된 고객의 암호화된 비밀번호 데이터 요청	1 :성공 0:실패
KisGetDCC	DCC 자국화폐 선택(광고1-3)
KisGetDCC1	DCC 자국화폐 선택(광고1-4)
OnDCCEnd	DCC서비스 자국화폐선택 후 발생되는 이벤트
KisGetSerial	서명패드에 대한 제품 번호 요청	0 :성공 1:실패
OnSerialEnd	전자서명 패드에 대한 제품 번호 요청에 대한 이벤트
KisGetSerialData	전자서명 패드에 대한 제품 번호 요청	1 :성공 0:실패
KisConfig	환경 설정 요청
OnPadError	서명패드가 정상적인 응답이 없는 경우 발생하는 이벤트
KisGetAccount	결제계좌 선택 요청	0 :성공 1:실패
OnAccountEnd	결제계좌 선택 후 발생되는 이벤트
KisGetAccountlData	선택 된 결제계좌 요청	1 :성공 0:실패
KisGetNpgBarCode	카메라 바코드 스캔요청	1 :성공 0:실패
KisGetNpgBarCodeData	바코드 데이터 요청	1 :성공 0:실패
OnNpgBarCodeEnd	카메라바코드 스캔 후 발생되는 이벤트
KisGetCashIcPin	현금IC PIN요청	0 :성공 1:실패
OnCashIcPinEnd	번호 입력이 완료 된 경우 발생하는 이벤트
KisGetCashIcPinData	암호화된 비밀번호 데이터 요청	1 :성공 0:실패

API 가이드

1. SetPortNo 호출하여 패드가 연결된 포트번호 설정

2. SetBaudRate 호출하여 COM 포트의 속도 설정

3. 각 요청 함수(ex> KisElecSign, KisGetCustInfo) 을 요청 후 이벤트 함수(ex> OnSignEnd, OnCustInfoEnd)을 응답함수(ex> KisGetSignData, KisGetCustInfoData)호출하여 멤버변수(ex> strCustInfoData)로 데이터를 받습니다.

SetPortNo API

Request

Name	Type	Description
inComPortNo	short	포트번호

SetBaudRate API

Request

Name	Type	Description
inBaudRate	int	통신속도번호

KisElecSign API

Request

Name	Type	Description
inCardNo	String	카드번호(카드빈(6)+카드빈(6)+1234)(20)
inTrInfo	String	단말기ID(16)+거래일련번호(12)+승인일자(6:YYMMDD)+승인금액 (12:Leading_zero)+거래일련번호(15) 거래일련번호 구성 : ‘00’+거래일련번호(4)+스페이스(6 또는9)

KisElecSignMsg API

Request

Name	Type	Description
inCardNo	String	카드번호(카드빈(6)+카드빈(6)+1234)(20)
inTrInfo	String	단말기ID(16)+거래일련번호(12)+승인일자(6:YYMMDD)+승인금액 (12:Leading_zero)+거래일련번호(15) 거래일련번호 구성 : ‘00’+거래일련번호(4)+스페이스(6 또는9)
strMsg1	String	광고문구 (길이: 16 고정)
strMsg2	String	광고문구 (길이: 16 고정)
strMsg3	String	광고문구 (길이: 16 고정)
strMsg4	String	광고문구 (길이: 16 고정)

OnSignEnd API

Name	Type	Description

KisGetSignData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패

KisGetSignFile API

Resquest

Name	Type	Description
inFileName	String	서명 데이터 파일 저장위치(sign.bmp)

KisGetSignBMP API

Resquest

Name	Type	Description
inCardNo	String	카드번호(카드빈(6)+카드빈(6)+1234)(20)
inTrInfo	String	단말기ID(16)+거래일련번호(12)+승인일자(6:YYMMDD)+승인금액 (12:Leading_zero)+거래일련번호(15) 거래일련번호 구성 : ‘00’+거래일련번호(4)+스페이스(6 또는9)
inFileName	String	서명 데이터 파일 저장위치(sign.bmp)

KisDisplayPrint API

Resquest

Name	Type	Description
inTime	String	대기시간(ex> 20)
inDisplayMsg1	String	화면문구1(16)
inDisplayMsg2	String	화면문구2(16)
inDisplayMsg3	String	화면문구3(16)
inDisplayMsg4	String	화면문구4(16)

KisCanCel API

Resquest

Name	Type	Description

KisGetCustInfo API

Resquest

Name	Type	Description

OnCustInfoEnd API

Resquest

Name	Type	Description
strCustInfoData	String	response data

KisGetCustInfoData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data

KisGetPin API

Resquest

Name	Type	Description
inCardNo	String	카드번호(카드빈(6)+카드빈(6)+1234)
inAmt	String	금액(8 : Leading Space)
inWorkingKey	String	암호화를 위한 KEY (16)

onPinEnd API

Resquest

Name	Type	Description

KisGetPinData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data
		ex> axkisvanMS31.strPinData

KisGetDCC API

Resquest

Name	Type	Description
inPositiveMsg	String	POSITIVE문구
inNegativeMsg	String	NEGATIVE문구
strMsg1	String	화면표시메시지1
strMsg2	String	화면표시메시지2
strMsg3	String	화면표시메시지3

KisGetDCC1 API

Resquest

Name	Type	Description
inPositiveMsg	String	POSITIVE문구
inNegativeMsg	String	NEGATIVE문구
strMsg1	String	화면표시메시지1
strMsg2	String	화면표시메시지2
strMsg3	String	화면표시메시지3
strMsg4	String	화면표시메시지4

onDCCEnd API

Response

Name	Type	Description
strDCCResult	String	"POSITIVE" 또는 "NEGATIVE"

KisGetSerial API

Resquest

Name	Type	Description

KisGetSerial API

Resquest

Name	Type	Description

OnSerialEnd API

Resquest

Name	Type	Description

KisGetSerialData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data

KisGetAccount API

Request

Name	Type	Description
inAccountCnt	String	계좌개수(2:"09")
inAccountArray	String	계좌번호 콤마(,)로 구분 ex> "123456789012345,54321098756453"

OnAccountEnd API

Request

Name	Type	Description

KisGetAccountData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data

KisGetNpgBarCode API

Request

Name	Type	Description
inReqData	String	여유 필드 공백처리 예) "" "V": 옵션체크(카메라바코드 및 NFC 지원

OnNpgBarCodeEnd API

Request

Name	Type	Description

KisGetNpgBarCodeData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data
strNpgBarCodeData	String	response data

KisGetCashIcPin API

Request

Name	Type	Description
inTime	String	거래일시(YYYYMMDDHHNNSS)+요일(2:01-07)(16)
inAmount	String	금액(00001004)(8)
inDefaultKey	String	암호화를 위한 디폴트 KEY (16)
inKeyIndex	String	"00":계좌선택 비밀번호,"01":계좌비밀번호

OnCashIcPinEnd API

Response

Name	Type	Description

KisGetPinData API

Response

Name	Type	Description
returnVal	int	nSuccess : 1 :성공 0:실패
resData	char*	response data
strPinData	String	response data