결제 장치 통합을 위한 도구: UDemo

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

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

모든 개발자 고객 여러분께 UDemo 앱에 익숙해지실 것을 권장합니다. 이 앱은 장치와 주고받는 원시 요청 및 응답이 어떤 형태인지 상세히 보여주고, 특정 설정으로 장치를 구성할 수 있으며, 개발자가 다양한 인수 값을 사용하여 실시간으로 다양한 명령을 손쉽게 테스트할 수 있는 실습 환경을 제공합니다. 또한 UDemo는 EMV에 대해 더 깊이 이해할 수 있는 훌륭한 학습 도구이기도 합니다.

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

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

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

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

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

UDemo는 직접 사용하면서 익히는 것이 가장 효과적인 고도의 대화형 도구입니다. 보다 빠르게 익숙해지려면 다음 사항을 참고하시기 바랍니다.

1. 많은 명령에는 인수 값이 필요하거나, 실행 전에 설정을 구성할 수 있습니다. Commands 목록에서 명령을 한 번 클릭하면, 해당 명령에 추가 값을 입력할 수 있는 경우 Log 창 바로 위에 적절한 입력 필드가 자동으로 나타납니다. 필요한 값을 입력한 후, 명령을 더블 클릭하면 해당 값으로 명령이 실행됩니다.
2. 리더기에 삽입된 카드가 카드 소지자 인증 방법 중 하나로 PIN 입력을 요구하는 경우, 오른쪽 상단의 가상 키패드가 활성화됩니다.
3. Commands 목록 바로 위에는 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 버튼을 클릭하는 것입니다. 이 버튼을 클릭하면 컴퓨터에 Acrobat Reader가 설치되어 있는 경우 UDemo 빠른 시작 가이드 PDF가 열립니다.

UDemo에 표시되는 모든 헥스 바이트의 의미를 이해하려면 사용 중인 리더기의 저수준(펌웨어) API 가이드를 참고하시기 바랍니다. 해당 문서는 대부분 공개 Knowledge Base의 Downloads 섹션에서 별도의 회원 가입 없이 바로 다운로드하실 수 있습니다. 단, 일부 문서는 요청 시에만 제공되므로 해당하는 경우 담당 ID TECH 담당자에게 문의하시면 무료로 제공해 드립니다.

Universal SDK 또는 ID TECH Products에 관해 궁금한 점이 있으시면 아래 전문가에게 문의하시기 바랍니다. 1-800-984-1010!