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

Desenvolvedores de aplicações de pagamento que precisam acelerar 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 chip (EMV), tarja magnética (MSR) e sem contato, em diversas linguagens (como C# para Windows, Java para Android, Swift para iOS e C para Linux).

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

Recomendamos que todos os nossos clientes desenvolvedores se familiarizem com o aplicativo UDemo, pois ele ilustra detalhadamente como são as requisições e respostas brutas (enviadas e recebidas pelo dispositivo), permite configurar um dispositivo com ajustes específicos 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. Após o reconhecimento do 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 de chip por contato EMV, 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 requisiçõ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 (em um leitor de cartão ID TECH VP3300) utilizando o valor de transação padrão de $1,00. O comando efetivamente executado é exibido no topo do Log. Quatro respostas "IN" foram recebidas do dispositivo. A primeira resposta foi um ACK, e as duas "IN" seguintes contêm informações de status representando mensagens de LCD (como "Processing…"), que podem precisar ser exibidas em um PDV durante a execução da transação. 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 Result.

Dicas do UDemo

O UDemo é uma ferramenta altamente interativa, melhor aprendida na prática. Para acelerar um pouco a curva de aprendizado, vale ter em mente os pontos a seguir:

1. Muitos comandos aceitam valores como argumento ou podem ser configurados antes de sua execução. 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 aparecerão automaticamente logo acima do painel Log. Preencha 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 fica ativo quando o cartão inserido no leitor exige a digitação de PIN como um dos Métodos de Verificação do Portador do Cartão.
3. Logo acima da lista de Comandos há um botão com o rótulo Decryption. Clique neste botão para abrir uma caixa de diálogo que permite descriptografar os dados da transação.
4. Abaixo do painel de Log, você encontrará um botão Start Capture to Disk (juntamente com um botão Clear Logs e um botão Email Logs to Support). O botão Start Capture é útil quando você deseja capturar os dados de uma sessão para análise posterior. Você também pode nos enviar os resultados por e-mail (com o botão Email Logs), caso decida abrir um chamado de Suporte Técnico.

Antes de Executar uma Transação EMV

O UDemo é apenas uma ferramenta de teste e não é capaz de processar efetivamente uma transação (real e ativa) em um cartão de crédito, mas simulará as três fases (Início, Autenticação e Conclusão) de uma sessão EMV por contato. No entanto, antes de executar 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 padrões razoáveis) executando três comandos:

1. Primeiro, no nó AID da árvore de comandos, localize Load Default AID e execute-o. Esta é, na verdade, uma operação em lote que carregará meia dúzia de AIDs comuns no dispositivo. Aguarde cerca de dez segundos.
2. Em seguida, no nó CAPK da árvore de comandos, localize o comando Load Default CAPK e execute-o. Trata-se também de 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 pelo chip do cartão no momento da transação. (ATENÇÃO: As chaves são apenas para fins de teste e não devem ser utilizadas em 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 adequados para o leitor, habilitando diversas capacidades do terminal.

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

Mais Informações

O aplicativo UDemo oferece uma grande variedade de 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 estão disponíveis somente mediante solicitação; nesse caso, entre em contato com seu representante ID TECH, e os documentos correspondentes serão fornecidos gratuitamente.

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