🦆카드리더기 API

카드리더기와 통신하는 모듈입니다.

여신금융협회 신용카드 단말기 보안인증을 받을 업체인 경우 사용 가능합니다.

여신금융협회

KisPadOcx API 가이드.

가. 함수 목록

함수명	설명	비고
SCR_init	정보조회, 상호인증, 무결성검증 통합 수행	[0] 정상, Get System Information (0x31) 응답결과
SCR_GetSystemInformation	정보 조회	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_Reset	상호인증을 위한 MSK생성	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_MakeMSK	상호인증을 위한 초기화	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_InitMutualAuth	상호인증 완료	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_CompleteMutualAuth		[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SelfIntegrity	무결성 검증	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_GetKeyInformation	키 정보 요청	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_KeyDownload	키 다운로드	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SafeCardICData	IC 데이터 요청	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SafeCardFallbackData	Fallback 데이터 요청	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SafeCardICData_9C	IC 데이터 요청(카드빈8)	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SafeCardFallbackData_9C	Fallback 데이터 요청	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
SCR_SetEMVData	IC 응답 데이터 전송	[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)
OnSCREnd	응답데이터	참고, Secure Reader 전문 사양서
OnSCRError	NAK 수신시 생성되는 이벤트

공통API

Request

Name	Type	Description
inPadPortNo	short	포트번호
inBaudRate	long	통신속도
inSCRDate	string	요청데이터

Response

Name	Type	Description
outSCRData	string	응답데이터(참고, Secure Reader 전문 사양서)

리더기 거절 응답 코드표

🤝 간략 요약>

① 8C 인 경우 NFC 기능이 있는 고객카드 또는 동글 펌웨어 업데이트 확인 필요

② E8 인 경우 IC카드를 꽂지 않고 MSR 로 먼저 읽히 경우로 고객 사용방이법 잘못 된 경우

③ CF 인 경우 MSR 로 읽혀야되는 경우

④ D1, E4 인 경우에는 최초키 다운로드를 먼저 받으셔야 되는 경우

⑤ D2인 경우에는 최초키 다운로드할 때, TID와 카드리딩할 때 TID가 다른 경우로 결제하고자 하는 TID로 최초키 다운로드를 다시 받고 카드리딩을 해야 되는 경우

⑥ F3인 경우에는 카드를 여러장 리더기에 댄 경우로 한 장의 카드만 리딩해 주세요

Code	value	Reason
RC_SUCCESS	00	성공
RC_CARD_END	70	사용불가카드
RC_APDU_ERROR	8C	IC 카드 APDU 응답 오류
RC_INVALID_CONDITION	8D	거래 조건이 맞지 않음
RC_REQ_REPURCHASE	90	재거래 요청
RC_REQ_RECOVERY	91	취소(오류복구) 요청
RC_INVALID_ISSUER_ID	92	거래 불가능 발행사 ID
RC_INVALID_CA_KEY	94	CA Key 오류
RC_INVALID_PARAM	95	명령/파라미터 오류
RC_INVALID_CARD	96	지원되지 않는 카드
RC_SAMBAL_ERROR	99	SAM 잔액 부족 오류
RC_BAL_ERROR	9A	잔액 부족 오류
RC_CARD_ERROR	9B	카드 인식 오류
RC_NOEXIST_LOG	9C	마지막 거래 내역 없음
RC_SAM_ERROR	9D	SAM 카드 응답 오류
RC_SAM_ERROR	9E	거래 내역 및 개수 조회 오류
RC_CARD_NOTLOG	9F	처리 불가 기능
RC_BC_NOT_SELECT	B0	거래에 사용할 수 있는 카드가 없음
RC_BC_NOT_CHOICE	B1	사용할 카드가 선택되지 않았습니다
RC_CARD_NOTCOMMAND	C0	TMK 처리 에러
RC_REGIST_DIFF	C1	TMK 버전 오류(개시거래 요청)
RC_CASH_INVALID_PIN	C3	비밀번호 오류
RC_PIN_BLOCK	C4	비밀번호 잠김
RC_CASH_ACCOUNT_ERROR	C6	계좌 정보 오류
RC_REVERSAL	CC	망 취소 (호스트 승인 후 카드 거절)
RC_CANCEL	CD	단말기나 POS가 취소 시
RC_DECLINE	CE	카드 거래 거절
RC_FALLBACK	CF	IC EMV 거래 FALLBACK
RC_NO_SIGNATURE	D0	서명 값이 존재 하지 않음
RC_NO_SafeMSR_KEY	D1	암호화 KEY가 존재하지 않음
RC_NO_ID	D2	단말기 ID가 일치하지 않음
RC_ERR_DEVICE_MSR	E1	MSR 동작 오류
RC_ERR_DEVICE_IFM	E2	IFM 동작 오류
RC_INVALID_KEY_PMK	E4	PMF 검증 오류
RC_DIFF_SAFECARD_KEY	E6	Safecard Key 일련번호 불일치(최초) PMF Index불일치(갱신)
RC_FIRST_IC_INSERT	E8	IC 거래 우선 요망
RC_FIRST_NOT_FALLBACK	E9	FALLBACK 거래 아님
RC_ERR_DEVICE_INIT	EC	Safecard Key 일련번호가 없음 (공장초기화 안됨)
RC_OTHER_CARD	EE	다른 Application 카드
RC_NO_CARD	F2	카드가 존재하지 않음
RC_MORE_CARDS	F3	여러장의 카드가 입력됨
RC_NOT_ACCEPT	F5	지원되지 않는 카드
RC_NO_SAM	F6	동글에 sam 없음
RC_PAYONSAM_AUTH_ERROR	F7	PayOn SAM 등록 오류
RC_INVALID_DATA	F8	요청 Message의 Data 오류
RC_PAYONSAM_DIFF_ERROR	F9	등록된 PayOn Sam과 서로 상이
RC_AUTH_ERROR	FA	Reader 인증 오류
RC_AUTH_NOT_PERFORMED	FB	Reader 인증이 되지 않음
RC_APP_INTEGRITY_FAILURE	FC	다운로드 프로그램 무결성 훼손
RC_KEY_INTEGRITY_FAILURE	FD	암호화 키 무결성 훼손
RC_FAILURE	FF	실패 Fallback 미처리