Pagamentos e Comércio

adk-payments adiciona orquestração de comércio neutra em protocolo a ADK-Rust. Ele é projetado para fluxos de comércio agênticos que precisam de um modelo de transação durável em vários adaptadores de protocolo sem vazar artefatos de pagamento brutos para o histórico de conversas ou memória semântica.

Níveis de Suporte

• ACP stable 2026-01-30: a linha de base orientada para produção para finalização de compra, conclusão, cancelamento, pagamento delegado e acompanhamento de pedidos.
• ACP experimental: descoberta controlada por recurso, autenticação delegada e extensões de webhook. Trate essas rotas como superfícies de compatibilidade para rascunhos ACP em evolução.
• AP2 v0.1-alpha: suporte para mandato tipado, pagamento, recibo, intervenção, A2A e MCP-safe para o formato atual do protocolo alfa.

Jornadas Primárias

• ACP checkout com presença humana com pagamento delegado seguido por atualizações de pedido do comerciante ou webhook.
• Coordenação de comprador, comerciante, provedor de credenciais e processador de pagamentos com presença humana AP2.
• Execução de intenção sem presença humana AP2 com conclusão autônoma ou reconfirmação explícita do comprador.
• Implantações de comerciante de protocolo duplo onde ACP e AP2 se correlacionam no mesmo ID de transação canônico e diário.
• Recuperação pós-compactação onde o diário durável e a memória mascarada sobrevivem à perda de transcrição.

Segurança e Durabilidade

Mandatos brutos, assinaturas, credenciais delegadas e cargas de recibo permanecem no armazenamento de evidências apoiado por adk-artifact. O estado de transação durável reside em adk-session através do diário estruturado, não em um contexto frágil apenas de conversação. A recuperação semântica usa resumos mascarados através de adk-memory. adk-auth vincula a identidade da solicitação, o escopo do locatário e os metadados de auditoria. adk-guardrail aplica a quantia, o comerciante, a versão do protocolo, a intervenção e a política de redação antes que o estado seja persistido.

Caminho de Validação

Use os testes de integração como o caminho de validação ponta a ponta autoritativo:

cargo test -p adk-payments --features acp --test acp_integration_tests
cargo test -p adk-payments --features ap2,ap2-a2a,ap2-mcp --test ap2_integration_tests
cargo test -p adk-payments --test cross_protocol_correlation_tests
cargo test -p adk-payments --features acp-experimental --test acp_experimental_integration_tests

Arquivos de referência:

• adk-payments/tests/acp_integration_tests.rs
• adk-payments/tests/ap2_integration_tests.rs
• adk-payments/tests/cross_protocol_correlation_tests.rs
• examples/payments/README.md

O crate de exemplo em examples/payments/ é o índice de cenários para as jornadas suportadas, enquanto os testes de integração são a verdade fundamental executável para o comportamento do protocolo, diário e evidências.