# 🦆카드리더기 API

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

{% embed url="<https://www.crefia.or.kr/portal/board/boardDataList.do>" %}

KisPadOcx API 가이드.

가. 함수 목록

<table data-full-width="true"><thead><tr><th width="420">함수명</th><th>설명</th><th>비고</th><th data-hidden></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>

### 공통API

**Request**&#x20;

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

**Response**

<table><thead><tr><th width="324">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" %}
리더기 거절 응답 코드표

🤝 간략 요약>

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

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

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

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kisdevice.gitbook.io/web/kis-agent/kis/api/api-3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.