HandyCafe Docs
owner cashier

회원 카드

회원은 좌석에서 사용자 이름과 비밀번호를 입력하는 대신 카드를 대고 세션을 시작할 수 있습니다.

카드에는 아무것도 기록하지 않습니다. 리더기는 카드 자체의 공장 일련번호를 그대로 입력해 주고, HandyCafe는 그 번호를 회원 기록과 연결합니다. 그래서 카드를 분실해도 클릭 한 번으로 정지할 수 있으며, 회원의 잔액과 이용 내역은 그대로 유지됩니다.


준비물

리더기

키보드 에뮬레이션 모드의 USB 리더기입니다. HID keyboard wedge 또는 keyboard-out이라는 이름으로도 판매됩니다. 카드를 대면 일련번호를 입력하고 Enter를 누릅니다. 사람이 직접 타이핑한 것과 같습니다. 설치할 드라이버도, 설정할 포트도 없습니다.

PC/SC 리더기는 지원하지 않습니다. 드라이버와 카드에 말을 거는 응용 프로그램이 필요하기 때문입니다. 실수로 가장 많이 구매하는 제품이 공장 설정 상태의 ACR122U입니다. 일부 PC/SC 리더기는 키보드 모드로 전환해 주는 유틸리티를 함께 제공하며, 그 경우에는 사용할 수 있습니다.

테스트 하나면 판가름납니다. 메모장을 열고 카드를 대 보세요. 번호가 나타나면 HandyCafe도 봅니다. 아무것도 나타나지 않으면 HandyCafe 안의 어떤 설정도 도움이 되지 않습니다.

주파수

리더기와 카드는 같은 대역이어야 합니다. 125 kHz 리더기는 13.56 MHz 카드를 읽지 못합니다. 반대도 마찬가지입니다. 두 대역을 모두 지원하는 듀얼 밴드 리더기도 있습니다.

대역 흔한 카드
125 kHz EM4100, EM4102, T5577, HID Prox. 대량으로 판매되는 저렴한 흰색 카드와 키홀더
13.56 MHz MIFARE Classic 1K와 4K, MIFARE Ultralight, NTAG213, NTAG215, NTAG216, MIFARE DESFire, ISO 15693 / ICODE

두 대역 모두 동작합니다. 어느 쪽을 살지는 가격과 수급의 문제이지 HandyCafe의 문제가 아닙니다.

카드

리더기가 공장 일련번호를 읽을 수 있는 카드나 키홀더라면 무엇이든 됩니다. 기호를 제거한 뒤 번호는 8자에서 32자 사이여야 하며, 위의 카드는 모두 이를 충족합니다.

공카드로 충분합니다. 카드에는 아무것도 기록하지 않습니다. 인코딩 단계도, 구입해야 할 기록 장비도 없습니다. 인쇄된 카드도 똑같이 동작합니다.

휴대폰은 되지 않습니다. Android와 iOS는 댈 때마다 새로운 무작위 일련번호를 내놓습니다. 그래서 두 번 댄 휴대폰은 서로 다른 두 장의 카드처럼 보입니다.

리더기 설정

대부분의 리더기는 바로 쓸 수 있는 상태로 옵니다. 설정할 수 있는 경우 중요한 항목은 다음과 같습니다.

설정 무엇으로
출력 형식 16진수든 10진수든 모두 허용됩니다
접미 키 Enter 또는 Tab. 접미 키가 없으면 읽은 값이 전송되지 않습니다
구분 기호 바이트 사이의 콜론, 하이픈, 공백은 알아서 제거됩니다. 끌 필요가 없습니다
리더기의 자판 배열 US 또는 QWERTY로 두세요

마지막 항목은 한 문장 덧붙일 만합니다. PC의 Windows 자판 배열은 상관없습니다. HandyCafe는 키의 물리적 위치를 읽습니다. 터키어 F, AZERTY, QWERTZ 기기에서도 아무것도 바꾸지 않고 카드를 정확히 읽습니다. 중요한 것은 리더기 안에 저장된 배열입니다. 독일어 QWERTZ로 바뀐 리더기는 Z를 뜻하는 자리에서 Y를 보냅니다. 같은 카드가 그때는 다른 번호를 냅니다.

어디서나 같은 리더기 모델로

리더기 모델이 다르면 같은 카드를 다르게 보고할 수 있습니다. 한쪽이 16진수를 보내는 자리에서 다른 쪽은 10진수를 보냅니다. 바이트 순서를 뒤집는 모델도 있습니다. 카운터에서 한 모델로 등록한 카드가 다른 모델을 쓰는 좌석에서는 인식되지 않을 수 있습니다. 카드를 읽는 모든 기기에 같은 모델을 두세요.


카드 로그인 켜기

설정을 열고 클라이언트로 이동한 뒤 NFC 카드 로그인 블록을 찾으세요.

회원이 카드로 로그인할 수 있게 허용을 켠 다음 모드를 고릅니다.

모드 동작
모든 카드 카운터에서 손에 있는 아무 카드나 회원과 연결합니다. 미리 준비할 것이 없습니다
등록한 카드만 카드를 먼저 재고에 등록해야 합니다. 재고에 없는 카드는 회원에게 발급할 수 없습니다

등록한 카드만은 손님이 들고 다니는 교통 카드나 건물 출입 카드가 로그인 수단이 되는 것을 막기 위한 모드입니다. 매장에서 카드를 직접 구입해 발급한다면 이쪽을 고르세요.


카드 재고

카드 재고는 매장이 보유한 카드 목록입니다. 설정 블록이나 회원 페이지의 카드 재고로 들어갑니다.

카드를 등록하려면 카드 재고를 선택하고 카드를 계속 대면 됩니다. 읽힌 카드는 곧바로 재고에 들어갑니다. 쌓아 둔 카드를 한 번에 전부 등록할 수 있습니다. 작업하는 동안 등록 수량이 실시간으로 표시됩니다. 스캔을 시작하기 전에 묶음 메모를 입력해 그룹을 구분할 수도 있습니다.

재고에 있는 카드에는 각각 상태가 있습니다.

상태 의미
재고 등록되어 있고 발급할 수 있는 카드
회원 보유 회원에게 발급되어 세션을 시작할 수 있는 카드
분실 분실 신고된 카드. 즉시 사용이 막힙니다
사용 중지 손상 등의 이유로 사용을 그만둔 카드

목록에는 카드 번호, 상태, 회원, 메모, 등록일, 마지막 사용이 표시됩니다. 최근 카드까지만 표시되므로 오래된 카드는 검색으로 찾으세요.


회원에게 카드 발급

회원 페이지에서 해당 회원을 열고 카드 발급을 선택합니다. 리더기에 카드를 대면 읽히는 즉시 연결됩니다.

한 회원이 카드를 여러 장 보유할 수 있습니다. 회원이 보유한 카드는 회원 패널에 발급일과 함께 표시됩니다.

카드 로그인이 꺼져 있어도 발급 자체는 됩니다. 기능을 켜기 전까지는 그 카드로 세션을 시작할 수 없다는 경고가 함께 표시됩니다.


카드 회수

발급된 카드에는 세 가지 작업을 쓸 수 있습니다.

  • 재고로 회수: 카드가 재고로 돌아가고 더 이상 세션을 시작할 수 없게 됩니다. 회원의 잔액과 이용 내역은 그대로 유지됩니다.
  • 분실 신고: 카드가 즉시 사용 정지됩니다. 회원이 준비되면 새 카드를 발급하세요.
  • 사용 중지: 카드로 세션을 시작할 수 없게 되고 카드가 운용에서 빠집니다. 손상된 카드에 사용하세요.

사용 중지되었거나 분실 신고된 카드는 카드를 재고로 되돌리기로 다시 재고에 넣을 수 있습니다. 카드가 실제로 손에 돌아왔을 때만 사용하세요.

카드 삭제는 한 번도 발급하지 않은 카드에만 가능합니다. 이미 발급되어 돌아다닌 카드는 삭제 대신 사용 중지로 처리해야 합니다.


권한

카드를 발급하고 회수하고 정지하려면 회원 비밀번호 변경 권한이 필요합니다. 계정을 열어 주는 카드를 건네는 일은 비밀번호를 재설정해 주는 일과 무게가 같습니다.

기본 캐셔 역할에는 이 권한이 들어 있지 않습니다. 이미 운영 중인 설치본에서는 권한을 부여하기 전까지 캐셔가 카드를 발급할 수 없습니다. 캐셔 역할 및 권한을 참조하세요.


좌석에서 카드 로그인이 동작하는 방식

카드 로그인은 비밀번호 로그인과 똑같은 검사를 거칩니다. 안티치트 상태, 기기 잠금, 회원 활성 여부, 잔액 보유 여부, 동시 이용 좌석 제한이 모두 그대로 적용됩니다. 비밀번호로 열 수 없는 세션은 카드로도 열 수 없습니다.

카드 경로에는 좌석당 분당 12회 실패라는 자체 제한이 걸려 있습니다. 카드 거절은 비밀번호 시도 횟수에 합산되지 않습니다. 카드를 몇 번 잘못 댔다고 좌석 전체가 잠기는 일이 있었기 때문입니다.


자주 나오는 메시지

메시지 의미
이 카드는 이미 회원에게 발급되어 있습니다 다른 사람에게 주기 전에 먼저 재고로 회수하세요
이 카드는 재고에 없습니다 "등록한 카드만" 모드입니다. 카드 재고에서 먼저 등록하세요
이 카드는 분실 신고된 카드입니다 정지된 카드입니다. 새 카드를 발급하세요
이 카드는 사용이 중지된 카드입니다 카드가 손에 있다면 재고로 되돌리세요
리더기가 읽을 수 없는 카드 번호를 보냈습니다 리더기가 카드 일련번호가 아닌 것을 입력하고 있습니다. 리더기 자체의 자판 배열과 출력 형식을 확인하세요
아직 읽힌 카드가 없습니다 리더기가 연결되지 않았거나 키보드 에뮬레이션 모드가 아닙니다. 메모장에서 카드를 대 확인해 보세요
같은 카드가 다른 좌석에서 인식되지 않습니다 그 좌석의 리더기는 모델이 다릅니다. 모든 리더기가 카드를 같은 방식으로 보고하지는 않습니다
이 카드는 전에 발급된 적이 있어 삭제할 수 없습니다 삭제 대신 사용 중지로 처리하세요

관련 페이지