ADK-Rust

Pagos y Comercio

adk-payments añade orquestación de comercio independiente del protocolo a ADK-Rust. Está diseñado para flujos de comercio agénticos que necesitan un modelo de transacción duradero a través de múltiples adaptadores de protocolo sin filtrar artefactos de pago brutos en el historial de conversaciones o la memoria semántica.

Niveles de Soporte

  • ACP stable 2026-01-30: la base orientada a la producción para el pago, la finalización, la cancelación, el pago delegado y el seguimiento de pedidos.
  • ACP experimental: descubrimiento con puertas de funciones, autenticación delegada y extensiones de webhook. Trate estas rutas como superficies de compatibilidad para borradores de ACP en evolución.
  • AP2 v0.1-alpha: mandato tipado, pago, recibo, intervención, A2A y soporte seguro para MCP para la forma actual del protocolo alfa.

Recorridos Principales

  • Proceso de compra presencial de ACP con pago delegado, seguido de actualizaciones de pedidos por parte del comerciante o webhook.
  • Coordinación de AP2 presencial entre comprador, comerciante, proveedor de credenciales y procesador de pagos.
  • Ejecución de intención no presencial de AP2 con completado autónomo o reconfirmación explícita del comprador.
  • Implementaciones de comerciantes de protocolo dual donde ACP y AP2 se correlacionan con el mismo ID de transacción canónico y diario.
  • Recuperación post-compactación donde el diario duradero y la memoria enmascarada sobreviven a la pérdida de transcripciones.

Seguridad y Durabilidad

  • Los mandatos sin procesar, firmas, credenciales delegadas y cargas útiles de recibo permanecen en el almacenamiento de evidencia respaldado por adk-artifact.
  • El estado de transacción duradero reside en adk-session a través del diario estructurado, no en un contexto frágil solo de conversación.
  • La recuperación semántica utiliza resúmenes enmascarados a través de adk-memory.
  • adk-auth vincula la identidad de la solicitud, el alcance del inquilino y los metadatos de auditoría.
  • adk-guardrail aplica la política de cantidad, comerciante, versión de protocolo, intervención y redacción antes de que se persista el estado.

Ruta de Validación

Utilice las pruebas de integración como la ruta de validación autorizada de extremo a extremo:

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

Archivos de referencia:

  • 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

El crate de ejemplo bajo examples/payments/ es el índice de escenarios para los recorridos soportados, mientras que las pruebas de integración son la verdad fundamental ejecutable para el comportamiento del protocolo, el diario y la evidencia.

Pagos y Comercio - Documentación ADK-Rust | ADK-Rust