Pular para o conteúdo
jsonW Paper GitHub

Protocolos de comércio com agentes

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.

· jsonW 1.3.11

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.

Repositório oficial do TAP (GitHub, Visa) →