결제 단말기 통합을 위한 도구: UDemo

POS 시스템(또는 기타 시스템)에 ID TECH 카드 리더기를 신속하게 통합해야 하는 결제 앱 개발자라면, ID TECH의 Universal SDK를 활용하여 빠르게 작업을 진행할 수 있습니다. 이 SDK는 ID TECH의 현재 생산 중인 모든 카드 리더기—칩 카드(EMV), 마그네틱 스트라이프(MSR), 비접촉식 리더기 등—를 제어할 수 있는 라이브러리와 공통 API를 제공하며, Windows용 C#, Android용 Java, iOS용 Swift, Linux용 C 등 다양한 언어를 지원합니다.

그러나 관련 데모 프로그램을 실행하기 위해 SDK를 반드시 설치할 필요는 없습니다. 이 독립 실행형 앱은 Universal Demo, 줄여서 UDemo라고 부릅니다. Windows용 독립 실행형 버전의 UDemo는 아래 링크에서 다운로드할 수 있습니다. 여기.

개발자 고객 여러분 모두가 UDemo 앱에 익숙해지시기를 권장합니다. UDemo는 디바이스와 주고받는 원시 요청 및 응답의 형태를 상세히 확인할 수 있고, 특정 설정으로 디바이스를 구성할 수 있으며, 다양한 인수 값을 사용하여 여러 명령을 실시간으로 손쉽게 테스트할 수 있는 실습 환경을 제공합니다. 또한 UDemo는 EMV에 대해 더 깊이 이해하는 데도 매우 유용한 도구입니다.

UDemo 설치 프로그램을 실행한 후 앱을 시작하면 다음과 유사한 창이 표시됩니다.

지원되는 ID TECH 카드 리더기는 언제든지 컴퓨터의 USB 포트에 연결하면 UDemo에서 자동으로 감지됩니다. 디바이스가 인식되면 명령 트리(위의 "COMMANDS" 참조)에 해당 디바이스에 특화된 명령이 채워집니다. 예를 들어, 디바이스가 비접촉식 상호작용을 지원하는 경우 "CTLS" 그룹이, 접촉식 EMV 칩 카드 거래를 지원하는 경우 "EMV" 그룹이 표시되는 방식입니다.

기본 사용 방법은 다음과 같습니다.

1. 디바이스를 연결합니다.
2. 명령 트리를 탐색하여 원하는 명령을 찾습니다.
3. 트리에서 명령을 더블 클릭하거나, 창 하단의 녹색 Execute Command 버튼을 한 번 클릭합니다.
4. Log 창에서 요청 및 응답 내용을 확인할 수 있습니다. (장치로 전송된 값은 "OUT"으로, 장치에서 수신된 값은 "IN"으로 표시됩니다.)
5. 오른쪽의 Results 창에서 발생한 내용에 대한 이해하기 쉬운 설명을 확인할 수 있습니다.

위 스크린샷은 ID TECH VP3300 카드 리더기를 대상으로 기본 거래 금액 $1.00을 사용하여 Start EMV Transaction 명령을 실행한 결과입니다. 실제 실행된 명령은 Log 상단에 표시됩니다. 장치로부터 네 개의 "IN" 응답이 수신되었습니다. 첫 번째 응답은 ACK이며, 이후 두 개의 "IN" 응답에는 거래 진행 중 POS에 표시해야 할 수 있는 LCD 메시지(예: "Processing…")를 나타내는 상태 정보가 포함되어 있습니다. 네 번째이자 마지막 IN에는 리더기에서 반환된 TLV(tag-length-value) 데이터 블록이 포함되어 있습니다. TLV 파싱 결과의 일부는 Result 창에 표시됩니다.

UDemo는 직접 사용하면서 익히는 것이 가장 효과적인 대화형 도구입니다. 학습 곡선을 조금 더 빠르게 극복하기 위해 다음 사항을 숙지해 두시기 바랍니다.

1. 많은 명령은 인수 값을 입력받거나, 실행 전에 별도로 구성할 수 있습니다. Commands 목록에서 명령을 한 번 클릭하면, 해당 명령에 추가 값을 입력할 수 있는 경우 적절한 입력 필드가 Log 창 바로 위에 자동으로 나타납니다. 필요한 값을 입력한 후 명령을 더블클릭하면 해당 값으로 명령이 실행됩니다.
2. 리더기에 삽입된 카드가 카드 소지자 인증 방법(Cardholder Verification Methods) 중 하나로 PIN 입력을 요구하는 경우, 우측 상단의 가상 키패드가 활성화됩니다.
3. 명령 목록 바로 위에는 Decryption이라는 버튼이 있습니다. 이 버튼을 클릭하면 거래 데이터를 복호화할 수 있는 대화 상자가 열립니다.
4. 로그 창 아래에는 Start Capture to Disk 버튼이 있습니다( Clear Logs 버튼 및 Email Logs to Support버튼과 함께). Start Capture 버튼은 세션 데이터를 캡처하여 나중에 분석하고자 할 때 유용합니다. 기술 지원 케이스를 개설해야 한다고 판단되면 Email Logs 버튼을 통해 결과를 이메일로 보내실 수도 있습니다.

EMV 거래 실행 전 준비 사항

물론 UDemo는 테스트 전용 도구로, 실제 신용카드에 대한 실거래 청구는 불가능합니다. 다만 접촉식 EMV 세션의 세 단계(시작, 인증, 완료)를 모두 시뮬레이션할 수 있습니다. 단, 거래 명령을 실행하기 전에 카드 리더기에 몇 가지 설정이 필요합니다. (설정 없이 진행할 경우 시뮬레이션이 실패합니다.)

다음 세 가지 명령을 실행하면 적절한 기본값으로 기기를 빠르게 설정할 수 있습니다.

1. 먼저 명령 트리의 AID 노드에서 Load Default AID를 찾아 실행합니다. 이 명령은 일반적으로 사용되는 AID 여러 개를 기기에 일괄 로드하는 배치 작업입니다. 완료까지 약 10초 정도 소요됩니다.
2. 다음으로 명령 트리의 CAPK 노드에서 Load Default CAPK 명령을 찾아 실행합니다. 이 역시 배치 명령으로 몇 초가 소요됩니다. 이 명령은 거래 시 칩 카드가 생성하는 암호화 데이터를 검증하는 데 사용되는 각 카드 브랜드의 공개 키를 로드합니다. (주의: 해당 키는 테스트 전용이며 실 운영 환경에서는 사용할 수 없습니다. 실 운영용 키는 게이트웨이 또는 결제 처리 업체로부터 발급받으시기 바랍니다.)
3. 마지막으로, 명령 트리의 Terminal Config 노드에서 Save Terminal Data를 찾아 실행하십시오. 이 명령은 리더기의 다양한 단말기 기능을 지원하기 위한 적절한 기본 TLV 값을 로드합니다.

위 명령들을 실행하고 나면 카드 리더기에 적절한 기본 데이터가 저장되며, Start Transaction과 같은 명령이 오류 없이 작동합니다.

추가 정보

UDemo 앱에는 다양한 기능이 포함되어 있어 이 자리에서 모두 설명하기는 어렵습니다. 더 자세한 정보를 얻으려면 UDemo 화면 좌측 하단(위 이미지 참조)에 있는 분홍색 Documentation 버튼을 클릭하십시오. 해당 버튼을 클릭하면 UDemo 빠른 시작 가이드가 담긴 PDF 파일이 Acrobat Reader에서 열립니다(Acrobat Reader가 설치되어 있는 경우).

UDemo에 표시되는 16진수 바이트의 의미를 이해하려면, 사용 중인 리더기의 저수준(펌웨어) API 가이드를 참조하시기 바랍니다. 해당 문서는 일반적으로 공개 Downloads 섹션(별도 등록 불필요)에서 직접 내려받을 수 있으나, 일부 문서는 요청 시에만 제공됩니다. 그러한 경우에는 담당 ID TECH 담당자에게 문의하시면 해당 문서를 무상으로 제공해 드립니다.

Universal SDK 또는 ID TECH 제품에 대해 궁금한 사항이 있으시면, 전문 상담팀으로 문의하십시오. 1-800-984-1010!