Paiements et Commerce

adk-payments ajoute une orchestration de commerce agnostique au protocole à ADK-Rust. Il est conçu pour les flux de commerce agentiques qui nécessitent un modèle de transaction durable unique à travers plusieurs adaptateurs de protocole sans laisser s'échapper les artefacts de paiement bruts dans l'historique des conversations ou la mémoire sémantique.

Niveaux de Support

• ACP stable 2026-01-30 : la base orientée production pour le paiement, la finalisation, l'annulation, le paiement délégué et le suivi des commandes.
• ACP expérimental : découverte sous contrôle de fonctionnalité, authentification déléguée et extensions de webhook. Traitez ces routes comme des surfaces de compatibilité pour les ébauches ACP en évolution.
• AP2 v0.1-alpha : support sécurisé et typé pour les mandats, paiements, reçus, interventions, A2A et MCP pour la forme actuelle du protocole alpha.

Parcours Principaux

• Paiement ACP en présence humaine avec paiement délégué suivi des mises à jour de commande par le commerçant ou via webhook.
• Coordination AP2 en présence humaine entre l'acheteur, le commerçant, le fournisseur de justificatifs et le processeur de paiement.
• Exécution d'intention AP2 sans présence humaine avec soit une finalisation autonome, soit une reconfirmation explicite de l'acheteur.
• Déploiements commerciaux bi-protocoles où ACP et AP2 se corrèlent dans le même ID de transaction canonique et journal.
• Rappel post-compactage où le journal durable et la mémoire masquée survivent à la perte de transcription.

Sécurité et Durabilité

Les mandats bruts, les signatures, les informations d'identification déléguées et les charges utiles des reçus restent dans le stockage de preuves soutenu par adk-artifact. L'état de transaction durable réside dans adk-session via le journal structuré, et non dans un contexte fragile de conversation uniquement. Le rappel sémantique utilise des résumés masqués via adk-memory. adk-auth lie l'identité de la requête, la portée du locataire et les métadonnées d'audit. adk-guardrail applique la politique de montant, de commerçant, de version de protocole, d'intervention et de rédaction avant que l'état ne soit persisté.

Chemin de validation

Utilisez les tests d'intégration comme chemin de validation de bout en bout faisant autorité :

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

Fichiers de référence :

• 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

Le crate d'exemple sous examples/payments/ est l'index des scénarios pour les parcours pris en charge, tandis que les tests d'intégration constituent la vérité terrain exécutable pour le comportement du protocole, du journal et des preuves.