Ferramentas para Integração de Dispositivos de Pagamento: UDemo

Desenvolvedores de aplicativos de pagamento que precisam agilizar a integração de leitores de cartão ID TECH em seus sistemas POS (ou outros) podem avançar rapidamente aproveitando o Universal SDK da ID TECH. O SDK fornece bibliotecas (e uma API comum) para operação de todos os leitores de cartão em produção atual da ID TECH, incluindo leitores de cartão com chip (EMV), de tarja magnética (MSR) e sem contato, em diversas linguagens (como C# para Windows, Java para Android, Swift para iOS e C para Linux).

No entanto, não é necessário instalar o SDK para executar o programa de demonstração associado, um aplicativo independente que chamamos de Universal Demo, ou UDemo (abreviado). Você pode obter o UDemo (versão independente para Windows) acessando aqui.

Recomendamos que todos os nossos clientes desenvolvedores se familiarizem com o aplicativo UDemo, pois ele ilustra (em detalhes) como são as requisições e respostas brutas (de e para o dispositivo), permite configurar um dispositivo com definições específicas e oferece um ambiente de testes onde os desenvolvedores podem experimentar facilmente diversos comandos com diferentes valores de argumento, em tempo real. O UDemo também é uma excelente forma de aprender mais sobre EMV.

Após executar o instalador do UDemo, inicie o aplicativo. Você verá uma janela semelhante à seguinte:

Tenha em mente que você pode conectar qualquer leitor de cartão ID TECH compatível à porta USB do seu computador a qualquer momento, e ele será detectado automaticamente pelo UDemo. Ao reconhecer o dispositivo, a árvore de comandos (consulte "COMMANDS," acima) será preenchida com os comandos específicos para o dispositivo em questão (exibindo, por exemplo, um grupo "CTLS" se o dispositivo suportar interações sem contato, "EMV" se o dispositivo suportar transações com cartão chip EMV por contato, e assim por diante).

O modo de uso básico é:

1. Conecte um dispositivo.
2. Navegue pela árvore de comandos até encontrar um comando de interesse.
3. Clique duas vezes no comando na árvore OU clique uma vez no botão verde Execute Command na parte inferior da janela.
4. Verifique o painel Log para visualizar as solicitações e respostas. (Os valores enviados ao dispositivo são indicados por "OUT", enquanto os valores recebidos do dispositivo são indicados por "IN".)
5. Verifique o painel Results (à direita) para ver a explicação em linguagem simples do que ocorreu.

Na captura de tela acima, o comando Start EMV Transaction foi executado (com um leitor de cartão ID TECH VP3300) utilizando o valor de transação padrão de US$ 1,00. O comando efetivamente executado é exibido na parte superior do Log. Quatro respostas "IN" foram recebidas do dispositivo. A primeira resposta foi um ACK, e as duas respostas "IN" seguintes contêm informações de status representando mensagens no display LCD (como "Processing…"), que podem precisar ser exibidas em um PDV enquanto a transação está em andamento. O quarto e último IN contém um bloco de dados TLV (tag-length-value) retornado pelo leitor. Algumas das interpretações TLV são exibidas no painel Results.

Dicas sobre o UDemo

O UDemo é uma ferramenta altamente interativa, e a melhor forma de aprendê-la é utilizando-a na prática. Para acelerar um pouco a curva de aprendizado, vale estar ciente do seguinte:

1. Muitos comandos aceitam valores como argumento ou podem ser configurados antes de serem executados. Basta clicar uma vez em um comando na lista de comandos. Se o comando em questão aceitar valores adicionais, os campos de formulário apropriados serão exibidos automaticamente logo acima do painel Log. Forneça os valores necessários e, em seguida, clique duas vezes no comando para executá-lo com esses valores.
2. O teclado virtual no canto superior direito é ativado quando o cartão inserido no leitor exige a inserção de PIN como um de seus Métodos de Verificação do Portador do Cartão.
3. Logo acima da lista de comandos há um botão chamado Decryption. Clique neste botão para abrir uma caixa de diálogo que permite descriptografar dados de transação.
4. Abaixo do painel de Log, você encontrará um botão Start Capture to Disk (junto com um botão Clear Logs e um botão Email Logs to Support). O botão Start Capture é útil quando você deseja registrar os dados de uma sessão para análise posterior. Você também pode nos enviar os resultados por e-mail (usando o botão Email Logs), caso decida abrir um chamado de Suporte Técnico.

Antes de Executar uma Transação EMV

É claro que o UDemo é apenas uma ferramenta de teste e não é capaz de processar uma transação real em um cartão de crédito, mas ele simulará todas as três fases (Início, Autenticação e Conclusão) de uma sessão EMV por contato. No entanto, antes de executar os comandos de transação, o leitor de cartão precisará passar por algumas configurações. (Caso contrário, a simulação falhará.)

Você pode configurar um dispositivo rapidamente (com valores padrão razoáveis) executando três comandos:

1. Primeiro, no nó AID da árvore de comandos, localize Load Default AID e execute-o. Trata-se, na verdade, de uma operação em lote que carregará cerca de meia dúzia de AIDs comuns no dispositivo. Aguarde aproximadamente dez segundos.
2. Em seguida, no nó CAPK da árvore de comandos, localize o comando Load Default CAPK e execute-o. Este também é um comando em lote que levará alguns segundos. Ele carrega chaves públicas de diversas bandeiras de cartão, utilizadas para validar os artefatos criptográficos gerados por um cartão com chip no momento da transação. (ATENÇÃO: As chaves são apenas para fins de teste e não devem ser utilizadas em ambiente de produção. Obtenha as chaves de produção junto ao seu gateway ou processador de pagamentos.)
3. Por fim, no nó Terminal Config da árvore de comandos, localize e execute Save Terminal Data. Isso carregará TLVs padrão razoáveis para o leitor, a fim de suportar diversas capacidades do terminal.

Após executar esses comandos, o leitor de cartão conterá os dados padrão adequados, e comandos como Start Transaction deverão funcionar sem erros.

Mais Informações

É evidente que o aplicativo UDemo oferece muitos recursos — mais do que é possível descrever aqui. A melhor forma de obter mais informações? Observe o canto inferior esquerdo da tela do UDemo (consulte a imagem acima) e localize o botão rosa Documentation . Ao clicar nesse botão, um PDF será aberto no Acrobat Reader (desde que esteja instalado em seu computador), exibindo o Guia de Início Rápido do UDemo.

Para compreender o significado de todos os bytes hexadecimais exibidos no UDemo, provavelmente será necessário obter o guia de API de baixo nível (firmware) do seu leitor. Geralmente, esse documento está disponível diretamente na seção Downloads da nossa Base de Conhecimento pública (sem necessidade de cadastro); no entanto, alguns documentos são disponibilizados apenas mediante solicitação. Nesse caso, entre em contato com seu representante ID TECH e os documentos pertinentes serão fornecidos gratuitamente.

Tem dúvidas sobre o Universal SDK ou sobre qualquer produto ID TECH? Entre em contato com nossos especialistas em 1-800-984-1010!