KIS정보통신 POSPORTAL

4.3. KIS 모듈 4.3.1. API 가이드 4.3.1.5. 카드리더기 API

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.3.1.5. 카드리더기 API

카드리더기와 통신하는 모듈입니다. 여신금융협회 신용카드 단말기 보안인증을 받을 업체인 경우 사용 가능합니다."<a href="https://www.crefia.or.kr/portal/board/boardDataList.do">https://www.crefia.or.kr/portal/board/boardDataList.do</a>" KisPadOcx API 가이드. 가. 함수 목록<table><thead><tr><th>함수명</th><th>설명</th><th>비고</th><th> </th></tr></thead><tbody><tr><td>SCR_init</td><td>정보조회, 상호인증, 무결성검증 통합 수행</td><td>[0] 정상, Get System Information (0x31) 응답결과</td><td> </td></tr><tr><td>SCR_GetSystemInformation</td><td>정보 조회</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_Reset</td><td>상호인증을 위한 MSK생성</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_MakeMSK</td><td>상호인증을 위한 초기화</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_InitMutualAuth</td><td>상호인증 완료</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_CompleteMutualAuth</td><td> </td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SelfIntegrity</td><td>무결성 검증</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_GetKeyInformation</td><td>키 정보 요청</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_KeyDownload</td><td>키 다운로드</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SafeCardICData</td><td>IC 데이터 요청</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SafeCardFallbackData</td><td>Fallback 데이터 요청</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SafeCardICData_9C</td><td>IC 데이터 요청(카드빈8)</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SafeCardFallbackData_9E</td><td>Fallback 데이터 요청</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>SCR_SetEMVData</td><td>IC 응답 데이터 전송</td><td>[1] 실패, 그외 정상(참고, Secure Reader 전문 사양서)</td><td> </td></tr><tr><td>OnSCREnd</td><td>응답데이터</td><td>참고, Secure Reader 전문 사양서</td><td> </td></tr><tr><td>OnSCRError</td><td>NAK 수신시 생성되는 이벤트</td><td> </td><td> </td></tr></tbody></table><h3>공통API</h3>Request <table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code data-backticks="1">inPadPortNo</code></td><td>short</td><td>포트번호</td></tr><tr><td><code data-backticks="1">inBaudRate</code></td><td>long</td><td>통신속도</td></tr><tr><td>inSCRDate</td><td>string</td><td>요청데이터</td></tr></tbody></table>Response<table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>outSCRData</td><td>string</td><td>응답데이터(참고, Secure Reader 전문 사양서)</td></tr></tbody></table>{% hint style="info" %}리더기 거절 응답 코드표 ？？ 간략 요약&gt; ① 8C 인 경우 NFC 기능이 있는 고객카드 또는 동글 펌웨어 업데이트 확인 필요 ② E8 인 경우 IC카드를 꽂지 않고 MSR 로 먼저 읽히 경우로 고객 사용방이법 잘못 된 경우 ③ CF 인 경우 MSR 로 읽혀야되는 경우 ④ D1, E4 인 경우에는 최초키 다운로드를 먼저 받으셔야 되는 경우 ⑤ D2인 경우에는 최초키 다운로드할 때, TID와 카드리딩할 때 TID가 다른 경우로 결제하고자 하는 TID로 최초키 다운로드를 다시 받고 카드리딩을 해야 되는 경우 ⑥ F3인 경우에는 카드를 여러장 리더기에 댄 경우로 한 장의 카드만 리딩해 주세요{% endhint %}<table><thead><tr><th> </th><th> </th><th> </th></tr></thead><tbody><tr><td>Code</td><td>value</td><td>Reason</td></tr><tr><td>RC_SUCCESS</td><td>00</td><td>성공</td></tr><tr><td>RC_CARD_END</td><td>70</td><td>사용불가카드</td></tr><tr><td>RC_APDU_ERROR</td><td>8C</td><td>IC 카드 APDU 응답 오류</td></tr><tr><td>RC_INVALID_CONDITION</td><td>8D</td><td>거래 조건이 맞지 않음</td></tr><tr><td>RC_REQ_REPURCHASE</td><td>90</td><td>재거래 요청</td></tr><tr><td>RC_REQ_RECOVERY</td><td>91</td><td>취소(오류복구) 요청</td></tr><tr><td>RC_INVALID_ISSUER_ID</td><td>92</td><td>거래 불가능 발행사 ID</td></tr><tr><td>RC_INVALID_CA_KEY</td><td>94</td><td>CA Key 오류</td></tr><tr><td>RC_INVALID_PARAM</td><td>95</td><td>명령/파라미터 오류</td></tr><tr><td>RC_INVALID_CARD</td><td>96</td><td>지원되지 않는 카드</td></tr><tr><td>RC_SAMBAL_ERROR</td><td>99</td><td>SAM 잔액 부족 오류</td></tr><tr><td>RC_BAL_ERROR</td><td>9A</td><td>잔액 부족 오류</td></tr><tr><td>RC_CARD_ERROR</td><td>9B</td><td>카드 인식 오류</td></tr><tr><td>RC_NOEXIST_LOG</td><td>9C</td><td>마지막 거래 내역 없음</td></tr><tr><td>RC_SAM_ERROR</td><td>9D</td><td>SAM 카드 응답 오류</td></tr><tr><td>RC_SAM_ERROR</td><td>9E</td><td>거래 내역 및 개수 조회 오류</td></tr><tr><td>RC_CARD_NOTLOG</td><td>9F</td><td>처리 불가 기능</td></tr><tr><td>RC_BC_NOT_SELECT</td><td>B0</td><td>거래에 사용할 수 있는 카드가 없음</td></tr><tr><td>RC_BC_NOT_CHOICE</td><td>B1</td><td>사용할 카드가 선택되지 않았습니다</td></tr><tr><td>RC_CARD_NOTCOMMAND</td><td>C0</td><td>TMK 처리 에러</td></tr><tr><td>RC_REGIST_DIFF</td><td>C1</td><td>TMK 버전 오류(개시거래 요청)</td></tr><tr><td>RC_CASH_INVALID_PIN</td><td>C3</td><td>비밀번호 오류</td></tr><tr><td>RC_PIN_BLOCK</td><td>C4</td><td>비밀번호 잠김</td></tr><tr><td>RC_CASH_ACCOUNT_ERROR</td><td>C6</td><td>계좌 정보 오류</td></tr><tr><td>RC_REVERSAL</td><td>CC</td><td>망 취소 (호스트 승인 후 카드 거절)</td></tr><tr><td>RC_CANCEL</td><td>CD</td><td>단말기나 POS가 취소 시</td></tr><tr><td>RC_DECLINE</td><td>CE</td><td>카드 거래 거절</td></tr><tr><td>RC_FALLBACK</td><td>CF</td><td>IC EMV 거래 FALLBACK</td></tr><tr><td>RC_NO_SIGNATURE</td><td>D0</td><td>서명 값이 존재 하지 않음</td></tr><tr><td>RC_NO_SafeMSR_KEY</td><td>D1</td><td>암호화 KEY가 존재하지 않음</td></tr><tr><td>RC_NO_ID</td><td>D2</td><td>단말기 ID가 일치하지 않음</td></tr><tr><td>RC_ERR_DEVICE_MSR</td><td>E1</td><td>MSR 동작 오류</td></tr><tr><td>RC_ERR_DEVICE_IFM</td><td>E2</td><td>IFM 동작 오류</td></tr><tr><td>RC_INVALID_KEY_PMK</td><td>E4</td><td>PMF 검증 오류</td></tr><tr><td>RC_DIFF_SAFECARD_KEY</td><td>E6</td><td>Safecard Key 일련번호 불일치(최초)PMF Index불일치(갱신)</td></tr><tr><td>RC_FIRST_IC_INSERT</td><td>E8</td><td>IC 거래 우선 요망</td></tr><tr><td>RC_FIRST_NOT_FALLBACK</td><td>E9</td><td>FALLBACK 거래 아님</td></tr><tr><td>RC_ERR_DEVICE_INIT</td><td>EC</td><td>Safecard Key 일련번호가 없음(공장초기화 안됨)</td></tr><tr><td>RC_OTHER_CARD</td><td>EE</td><td>다른 Application 카드</td></tr><tr><td>RC_NO_CARD</td><td>F2</td><td>카드가 존재하지 않음</td></tr><tr><td>RC_MORE_CARDS</td><td>F3</td><td>여러장의 카드가 입력됨</td></tr><tr><td>RC_NOT_ACCEPT</td><td>F5</td><td>지원되지 않는 카드</td></tr><tr><td>RC_NO_SAM</td><td>F6</td><td>동글에 sam 없음</td></tr><tr><td>RC_PAYONSAM_AUTH_ERROR</td><td>F7</td><td>PayOn SAM 등록 오류</td></tr><tr><td>RC_INVALID_DATA</td><td>F8</td><td>요청 Message의 Data 오류</td></tr><tr><td>RC_PAYONSAM_DIFF_ERROR</td><td>F9</td><td>등록된 PayOn Sam과 서로 상이</td></tr><tr><td>RC_AUTH_ERROR</td><td>FA</td><td>Reader 인증 오류</td></tr><tr><td>RC_AUTH_NOT_PERFORMED</td><td>FB</td><td>Reader 인증이 되지 않음</td></tr><tr><td>RC_APP_INTEGRITY_FAILURE</td><td>FC</td><td>다운로드 프로그램 무결성 훼손</td></tr><tr><td>RC_KEY_INTEGRITY_FAILURE</td><td>FD</td><td>암호화 키 무결성 훼손</td></tr><tr><td>RC_FAILURE</td><td>FF</td><td>실패 Fallback 미처리</td></tr></tbody></table>

4.3.1.4. POSKIS API

4.3.1.6. 서명패드 API

KIS정보통신(주)

개인정보처리방침