# 태블릿 카드결제 (KOVAN 안드로이드)

> 테이블오더 태블릿에서 주문과 동시에 카드 결제를 받습니다. 태블릿 전용 단말기번호가 필요합니다.

> **누가** 대리점 설치 기사 · **걸리는 시간** 20~30분
> **준비물** 대리점 계정(시스템 게시판) · VAN 사 단말기번호(KIS 8자리 · KOVAN 10자리) · 사업자번호 · 리더기 · 서명패드(USB 젠더 포함)

> [!INFO]
> 이 설명은 **KOVAN 에이전트 — 안드로이드(태블릿) 1.6.9** 기준입니다.

> [!WARNING]
> **순서 주의** — VPOS 앱을 먼저 설치한 뒤에 리더기 USB 젠더를 꽂습니다. 미리 꽂혀 있으면 장치 검색에서 리더기가 안 나옵니다.

1. **[VAN사 에이전트 → KOVAN → 안드로이드용]에서 APK를 받아 태블릿에 설치**
   '출처를 알 수 없는 앱' 허용, 앱 권한은 모두 허용.
2. **장치 설정 — 리더기 종류 · 연결 방식 · 서명패드 · 프린터 → [연결확인] → [저장]**
3. **검색 리스트에서 리더기 → **[기기확인]** → 리더기 SN이 보이면 [확인]**
4. **단말기 정보 — TID(태블릿용 단말기번호 10자리) · 사업자번호**
5. ****[가맹점 다운로드] → [KEY 다운로드]****
6. **환경설정(왼쪽 아래 톱니, 비밀번호 1234) → [무결성 점검] → [리더기 무결성 점검]**
7. **서버 [테이블오더 설정 → 주문] '태블릿 카드 결제' = KOVAN VPOS 앱 결제 → 저장 → 동기화**
8. **테이블오더 앱 관리자모드 [VPOS] → [가맹점 정보 조회] → 소액 결제 → 포스에서 반품까지 확인**

![KOVAN VPOS 앱 (설치 가이드 화면)](https://0.0.0.0:3100/files/8898ad28ef3df80e8deccc7eae6ec0d4)
3. 장치 설정 — 리더기 종류 · 연결 방식(USB/블루투스) · 구분을 고르고 **[연결확인]**. 서명패드(무서명 · 리더기 · 멀티패드 · 일반) · 프린터도 고른 뒤 [저장].
4. 검색 리스트에서 리더기를 골라 **[기기확인]** → 리더기 SN 이 보이면 [확인]. 목록이 비면 [재검색].
5. 단말기 정보 — **TID** 칸에 KOVAN 이 그 태블릿용으로 발급한 단말기번호 **10자리**, 사업자번호 10자리.
6. **[가맹점 다운로드]** → **[KEY 다운로드]** → 위 '<' 로 메인 화면.
7. 환경설정(메인 화면 왼쪽 아래 톱니, 비밀번호 1234) → **[무결성 점검]** → [리더기 무결성 점검] — 리더기 · 앱이 모두 정상이면 사용할 수 있습니다.

태블릿은 **일시불 신용 승인만** 받습니다(현금영수증 · 간편결제 · 할부 없음). 영수증은 포스 프린터로 나옵니다.

> [!WARNING]
> **자주 하는 실수** — 태블릿 승인은 **그 태블릿에서만 취소**됩니다. 포스에서 반품하면 태블릿 화면에 취소 요청이 뜨고, 카드를 넣어야 반품이 끝납니다.

<details>
<summary>리더기 목록이 비어요</summary>

USB 젠더가 FTDI 칩(USB To Serial)을 지원하는지, 포스 장비에 꽂혀 있지 않은지 보고, VPOS 앱 설치 뒤 젠더를 다시 꽂아 'USB 기기에 대한 앱 선택'에서 VPOS를 **'항상'**으로 고릅니다. 잘못 골랐으면 [설정 → 앱 → VPOS → 기본으로 열기]에서 지우고 다시 꽂습니다.
</details>

## 원본 매뉴얼 자세히

화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.

<details>
<summary>📘 KOVAN 에이전트 — 안드로이드(태블릿)</summary>

KOVAN VPOS 앱을 테이블오더 태블릿에 설치해 태블릿에서 카드 결제를 받습니다(주문과 동시 결제). 그 태블릿 전용 단말기번호가 필요합니다. 그림은 KOVAN VPOS 3.2 설치 가이드의 화면입니다.

**1.** [VAN사 에이전트 → KOVAN → 안드로이드용]에서 VPOSApp-release_….apk 를 받아 태블릿에 옮기고 설치합니다(설정에서 '출처를 알 수 없는 앱' 설치 허용).

**2.** **순서 주의** — VPOS 앱을 먼저 설치한 뒤에 리더기 USB 젠더를 꽂습니다. 미리 꽂혀 있으면 장치 검색에서 리더기가 안 나옵니다. 앱을 처음 열 때 묻는 권한은 모두 **허용**합니다.

**8.** 서버 [테이블오더 설정 → 주문] **'태블릿 카드 결제(주문과 동시 결제)' = KOVAN VPOS 앱 결제**, 세금 계산(부가세 포함 · 면세)을 고르고 저장 → 에이전트 동기화.

**9.** 테이블오더 앱 관리자모드 → [VPOS] 탭 → **[가맹점 정보 조회(VPOS)]**로 단말기번호가 읽히는지 확인 → 소액 결제 → 포스 매출조회에 '신용카드(테이블오더)' → 포스 [반품]으로 태블릿 취소까지 확인합니다.

**참고** — 현금영수증 · 간편결제 · 할부는 태블릿에서 받지 않습니다(일시불 신용 승인만). 영수증은 포스 프린터로 나옵니다.

**자주 하는 실수** — 리더기 목록이 비면 — USB 젠더가 FTDI 칩(USB To Serial)을 지원하는지, 포스 장비에 꽂혀 있지 않은지 보고, VPOS 앱 설치 뒤 젠더를 다시 꽂아 'USB 기기에 대한 앱 선택'에서 **VPOS 를 '항상'**으로 고릅니다.
USB 기기 앱을 잘못 골랐으면 — 안드로이드 [설정 → 앱 → VPOS(KOVAN) → 고급 → 기본으로 열기]에서 지우고 다시 꽂습니다.
태블릿 승인은 **그 태블릿에서만 취소**됩니다 — 포스에서 반품하면 태블릿 화면에 취소 요청이 뜨고, 카드를 넣어야 반품이 끝납니다.
</details>
