# TAP da Visa: a chave Ed25519, a janela de tempo e o que o registro do comerciante guarda O TAP da Visa reconhece o agente pela assinatura do pedido, com chave Ed25519 e uma janela de tempo curta. Ele usa a mesma base de assinatura do Web Bot Auth, mas com regras diferentes. Veja os elementos, o que um registro precisaria guardar e o estado do protocolo na Wortic. 15 de novembro de 2026 · jsonW 1.3.11 · https://jsonw.org/newsroom/tap-visa-chave-ed25519-e-janela-de-tempo ## O protocolo O TAP (Trusted Agent Protocol) é um protocolo da Visa para o comerciante reconhecer o agente e o consumidor numa compra. O agente assina o pedido. A assinatura segue a RFC 9421 e usa chaves Ed25519, um tipo de chave pública muito usado em assinaturas. A documentação oficial está na página de desenvolvedores da Visa, e o código do projeto, no repositório da Visa no GitHub. ## Os elementos O protocolo tem três partes que importam para o registro: a chave pública do agente, a diretoria onde a chave é publicada e a janela de tempo do pedido. A janela existe para que um pedido antigo não seja reenviado depois. ``` [identificador do agente, chave pública, instante da assinatura, instante limite]``` ## O que um registro do comerciante guardaria Para cada compra com TAP, o registro precisaria guardar o identificador do agente, o resultado da verificação e o instante do pedido. Se a verificação falhar, o motivo também precisa ficar guardado, para o suporte entender a recusa. ## Onde o jsonW entraria O jsonW da casa não guarda hoje registros de verificação TAP. O registro de tarefas e de negociações é outro. Um registro de verificação seria novo, com regra própria de guarda e de retenção. ## O estado na Wortic A Wortic não usa TAP. O protocolo não faz parte do que a casa tem no ar. A publicação deve ser atualizada se isso mudar. ## Diferença para o Web Bot Auth Os dois protocolos usam assinaturas RFC 9421, mas diferem em etiquetas, em gestão de chaves e em janelas de tempo. Um verificador feito só para um deles pode recusar o outro. Por isso, não trate os dois como intercambiáveis. ## Como conferir Use o exemplo do repositório oficial para gerar uma assinatura de teste. Confira se a verificação passa e se um pedido fora da janela de tempo é recusado. Esses dois testes cobrem o caso mais comum de erro. ## Cuidados A verificação do agente não prova que a compra foi autorizada pela pessoa. Essa prova vem de outro registro, como o mandato. Vale manter os dois separados, para que cada um responda à sua pergunta. ## O que a assinatura cobre A assinatura cobre partes escolhidas do pedido. Ela precisa cobrir o método, o endereço e o instante. Se a assinatura não cobrir o valor da compra, quem a recebe não sabe se o valor foi alterado depois de assinado. ## A janela de tempo Um pedido só vale dentro de uma janela curta de tempo. Fora dela, o pedido é recusado, mesmo com a assinatura certa. Assim, um pedido copiado e enviado de novo não passa. O registro deve guardar o instante da assinatura e o instante da verificação. ## O que a verificação devolve A verificação devolve sim ou não, com o motivo. Um motivo como chave desconhecida, assinatura inválida ou janela vencida ajuda o suporte. Um não sem motivo deixa o atendimento sem resposta. Fonte: https://github.com/visa/trusted-agent-protocol