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 circunstâncias. Ter uma boa documentação ajuda. Ter boas ferramentas ajuda ainda mais.

ID TECH oferece uma série de ferramentas gratuitas para facilitar o processo de integração. Uma das nossas ferramentas mais populares, Parsomatic, está hospedada neste site (acesse aqui). Outra ferramenta muito 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 mais antigos), chamado UDemo (ou Universal SDK Demo). Ele está disponível, junto com muitas outras demos 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 possa 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 nem lógica de servidor) que pode ser utilizada em qualquer navegador web, em qualquer plataforma, com ou sem conexão à internet. Normalmente, ela é utilizada 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 consulta de tags no topo da página para fazer uma busca rápida. Na captura de tela acima, inserimos '5F20', que corresponde ao Nome do Titular do Cartão. Esta é uma tag padrão definida pelo setor pela EMVCo. No entanto, você também pode usar o Parsomatic 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), pode colar os dados na área de texto principal, marcar a caixa de seleção "TLVs only" (conforme mostrado acima; observe com atenção) e clicar no botão Analisar. O Parsomatic conta com um analisador de descida recursiva capaz de processar todos os TLVs, incluindo TLVs aninhados, e apresentar os resultados de duas maneiras diferentes (veja abaixo).
3. Se você tiver realizado uma transação em um dispositivo ID TECH (seja por MagStripe, EMV por contato ou sem contato), o dispositivo irá gerar um bloco considerável de dados encapsulados em um invólucro de protocolo. O Parsomatic pode analisar esses dados e exibi-los graficamente, permitindo que você visualize exatamente o que cada byte representa.

Após processar os dados, o Parsomatic os exibe de duas formas. A primeira seção da tela mostra várias linhas de dados hexadecimais em texto colorido: tags TLV em azul, valores de comprimento em laranja, dados em preto e qualquer elemento que não pôde ser interpretado em vermelho. Ao passar o cursor sobre qualquer item colorido, é exibido um tooltip estilizado em CSS que explica o que está sendo visualizado. Na captura de tela acima, o cursor está sobre a tag TLV 5F2A. O tooltip indica que se trata do Código de Moeda da Transação. (Nos dados exibidos acima, o código é 0840, correspondente ao dólar americano.)

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

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

Se você colou dados de transação na janela, e esses dados são do tipo EMV (tag), 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 ilustrados na captura de tela. Neste exemplo, o bit mais significativo do byte 3 está ativado, indicando "Verificação do titular do cartão não foi bem-sucedida"; além disso, o bit 5 está ativado, indicando "Entrada de PIN necessária, mas o leitor de PIN está ausente ou com defeito." O Parsomatic destaca automaticamente em amarelo todos os bits ativados, permitindo identificar rapidamente o que está ocorrendo.

A lógica do Parsomatic é desenvolvida em JavaScript puro, e todo o código está contido no arquivo HTML, o que permite visualizar facilmente o código-fonte em qualquer editor. Vale destacar que o parser foi projetado para operar de forma tolerante a falhas, ou seja, quaisquer bytes que não possam ser interpretados serão simplesmente ignorados (porém exibidos em vermelho na tela), em vez de interromper o processo de análise com uma exceção. O parser tentará desconsiderar os bytes desconhecidos e prosseguir com a análise, partindo do princípio de que você provavelmente desejará saber o que significa o restante dos seus dados, mesmo que parte deles não tenha sido interpretada corretamente.

O Parsomatic é uma excelente ferramenta de aprendizado para quem está começando a trabalhar com ID TECH Products ou a desenvolver aplicativos de pagamento EMV. É também um recurso valioso para diagnóstico e resoluçã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.