Sistemas de agentes e padrões · Capítulo 4 de 8
Agentes que pagam: UCP e AP2
Como um agente faz o checkout com um comerciante via UCP, e como os mandatos AP2 vinculam o pagamento ao que a pessoa assinou.
Objetivos
- Crie e conclua uma sessão de checkout.A fazer
- Assine os mandatos no celular.A fazer
- Mude o valor depois da assinatura e veja a verificação falhar.A fazer
- Passe na verificação.A fazer
Passo 1 de 4: A leitura
UCP: o checkout
O UCP (Universal Commerce Protocol, versão 2026-08-25) é como um agente de compras, a plataforma, compra de um comerciante, o negócio. O negócio publica um perfil em /.well-known/ucp: sua versão, suas capacidades, como checkout, seus handlers de pagamento e seu endpoint REST. O agente o lê, depois cria uma sessão de checkout com POST /checkout-sessions, a atualiza com PUT até o status ser ready_for_complete e termina com POST …/complete.
Cada chamada leva um cabeçalho UCP-Agent que aponta para o perfil da própria plataforma, para que o negócio possa conferir o que a plataforma suporta. Cada escrita leva uma Idempotency-Key: se um timeout faz o agente enviar a mesma requisição de novo, o negócio responde com o primeiro resultado em vez de agir duas vezes. Uma cobrança em dobro como a do pedido 48213 da Halden é exatamente o que ela evita.
AP2: a assinatura da pessoa
O UCP sozinho confia em quem tiver a sessão. O AP2 (Agent Payments Protocol) acrescenta a prova de consentimento. O provedor do agente emite dois mandatos como credenciais verificáveis SD-JWT: um mandato de checkout com um hash do checkout exato que a Halden assinou, e um mandato de pagamento com o valor, o beneficiário e o cartão. A pessoa os revisa em uma tela na qual o agente não pode desenhar, a carteira do seu celular, e a chave do celular assina um JWT de key binding em cada um.
A Halden confere o mandato de checkout com o checkout que assinou. A carteira de cartões confere o mandato de pagamento antes de emitir um token de pagamento para aquele valor, e o processador confere o token antes de cobrar. Mude o carrinho ou o valor depois que a pessoa assinou e um hash ou uma assinatura deixa de corresponder, diga o agente o que disser.
Aqui a pessoa está presente. No modo autônomo do AP2, não está: ela aprova antes mandatos abertos, com limites como um preço máximo, e o agente assina os mandatos finais dentro deles.
ANP, em duas frases
O ANP (Agent Network Protocol) é para agentes que se encontram na web aberta: cada agente tem um identificador did:wba cujo documento DID, servido pelo seu próprio domínio, lista suas chaves públicas. Cada requisição é assinada com HTTP Message Signatures, então o outro lado sabe qual agente a enviou sem precisar de uma conta. Os labs de ANP do passo Vá além o executam.
O que você faz aqui
Um agente de compras compra a barraca Ridge 2 da Halden. Acompanhe o checkout, aprove no celular, depois execute de novo com Interceptar ativado e aumente o valor depois da assinatura.
Passo 2 de 4: Experimente: Uma cadeia de assinaturas
Uma cadeia de assinaturas
Cinco passos, depois dois opcionais. Abaixo dos passos, a cadeia acrescenta cada elo da compra quando a compra chega a ele, com quem o confere. Abaixo da cadeia, o lab desenha cada mensagem como uma linha, de cima para baixo.
Modo:RealSimuladoReal: o binding REST do UCP (escrito a partir da especificação, sem SDK), os mandatos SD-JWT do AP2 (@sd-jwt/sd-jwt-vc 0.21.1) e as assinaturas ES256 com chaves WebCrypto criadas nesta página, e as requisições assinadas do ANP nos labs do Vá além. Simulado: a liquidação, e as decisões do agente, a menos que você conecte um modelo. A loja e os cartões são fictícios.
Passo 3 de 4: Verificação
Verificação
Próximo: Pergunta 2 de 4
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Acompanhar uma sessão de checkout UCP do perfil até completed.
- Explicar como os mandatos AP2 vinculam um pagamento ao consentimento assinado de uma pessoa.
- Usar chaves de idempotência para tornar as novas tentativas seguras.
- Dizer em duas frases o que o did:wba e as requisições assinadas do ANP acrescentam.