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

Integrar um periférico de pagamento em um aplicativo de PDV (ou outro aplicativo de pagamento) pode ser desafiador, mesmo nas melhores condições. Ter uma boa documentação ajuda. Ter boas ferramentas ajuda ainda mais.

ID TECH oferece diversas ferramentas gratuitas para facilitar o processo de integração. Uma das nossas ferramentas mais populares, o Parsomatic, está disponível neste site (acesse aqui). Outra ferramenta amplamente utilizada não apenas por clientes, mas também pela equipe interna de suporte da ID TECH, é a nossa Ferramenta de Criptografia/Descriptografia (acesse aqui). Também disponibilizamos um utilitário baseado em Windows (.NET), compatível com todos os ID TECH Products em produção atual (e alguns modelos mais antigos), chamado UDemo (ou Universal SDK Demo). Ele está disponível, junto com muitas outras demonstrações e utilitários, em nossa página de downloads.

Se você está iniciando uma integração ou é novo no universo EMV e precisa de um utilitário rápido de consulta de tags que também seja capaz de analisar blocos arbitrários de dados TLV, vale a pena conhecer o Parsomatic.

Parsomatic é uma das ferramentas mais populares da ID TECH. Trata-se de uma página HTML autossuficiente (sem dependências externas, sem lógica de servidor) que pode ser utilizada em qualquer navegador web, em qualquer plataforma, online ou offline. Normalmente, ela é usada em um dos três cenários a seguir.

1. Se você deseja saber para que serve uma determinada tag EMV, utilize o pequeno campo de busca de tags no topo da página para fazer uma consulta rápida. Na captura de tela acima, inserimos '5F20', que corresponde ao Nome do Portador do Cartão. Esta é uma tag padrão definida pela EMVCo para o setor. No entanto, o Parsomatic também pode ser usado para consultar tags proprietárias da ID TECH, das quais existem mais de 100.
2. Se você tiver um bloco de dados hexadecimais contendo dados TLV (tag-comprimento-valor), cole os dados na área de texto principal, marque a caixa de seleção "TLVs only" (conforme ilustrado acima; observe com atenção) e clique no botão Parse. O Parsomatic possui um analisador de descida recursiva capaz de processar todos os TLVs, incluindo TLVs aninhados, apresentando os resultados de duas formas distintas (veja abaixo).
3. Se você executou uma transação em um dispositivo ID TECH (seja por tarja magnética, EMV com contato ou sem contato), o dispositivo gerará um bloco considerável de dados, encapsulado em um protocolo wrapper. O Parsomatic pode analisar esses dados e exibi-los graficamente, de forma que você possa ver exatamente o que cada byte significa.

Após analisar os dados, o Parsomatic os exibe de duas maneiras. A primeira seção da tela mostra várias linhas de dados hexadecimais em texto colorido: as tags TLV aparecem em azul, os valores de comprimento em laranja, os dados em preto e qualquer item que não pôde ser interpretado em vermelho. Ao passar o cursor sobre qualquer um dos itens coloridos, você verá um tooltip estilizado em CSS explicando o que está sendo exibido. Na captura de tela acima, o cursor está sobre a tag TLV 5F2A. O tooltip indica que esta é a Tag de Código de Moeda da Transação. (Nos dados exibidos acima, o código é 0840, que corresponde ao dólar norte-americano.)

A segunda forma como o Parsomatic exibe os dados é em uma tabela ampla:

O texto é (novamente) codificado por cores, com os nomes das tags em azul, os comprimentos em laranja, entre outros.

Se você colou dados de transação na janela, e esses dados são do tipo EMV (baseados em tags), e se contiverem a Tag 95, todos os sinalizadores de bits da Tag 95 serão exibidos na parte inferior da página:

Observe que a Tag 95 contém cinco bytes de dados; apenas os três primeiros são mostrados no exemplo acima.

Em transações com cartão com chip, a Tag 95 é fundamental para determinar se uma transação será aprovada ou recusada. Alguns dos possíveis motivos de recusa são apresentados na captura de tela. Neste exemplo, o bit mais significativo do byte 3 está ativado, indicando "A verificação do portador do cartão não foi bem-sucedida"; o bit 5 também está ativado, indicando "Entrada de PIN necessária, mas o teclado PIN está ausente ou não está funcionando." O Parsomatic destaca automaticamente em amarelo todos os bits ativados, permitindo que você identifique rapidamente o que está ocorrendo.

A lógica do Parsomatic é escrita em JavaScript puro, e todo o código está contido no arquivo HTML, o que permite visualizar o código-fonte facilmente em qualquer editor. Vale destacar que o analisador foi desenvolvido para operar de forma tolerante a falhas, ou seja, qualquer byte que não puder ser interpretado será simplesmente ignorado (mas exibido na tela em vermelho), em vez de interromper a análise com uma exceção. O analisador tentará ignorar bytes desconhecidos e continuar o processamento, partindo do princípio de que você provavelmente desejará saber o que o restante dos seus dados significa, mesmo que parte deles não tenha sido interpretada corretamente.

O Parsomatic é uma excelente ferramenta de aprendizado para quem está começando a usar ID TECH Products ou a desenvolver aplicações de pagamento EMV. Também é um recurso valioso para solução de problemas. (E é gratuito! O que mais se pode pedir?)

Tem dúvidas sobre tecnologia de pagamentos? Fale com nossos especialistas: ligue para 1-800-984-1010 a qualquer hora.