المدفوعات والتجارة

adk-payments يضيف تنسيق التجارة المحايد للبروتوكول إلى ADK-Rust. وهو مصمم لتدفقات التجارة القائمة على الوكلاء التي تحتاج إلى نموذج معاملة واحد دائم عبر محولات بروتوكول متعددة دون تسريب عناصر الدفع الخام إلى سجل المحادثات أو الذاكرة الدلالية.

مستويات الدعم

ACP مستقر 2026-01-30: الأساس الموجه للإنتاج لإتمام الشراء، والإكمال، والإلغاء، والدفع المفوض، ومتابعة الطلبات.
ACP تجريبي: اكتشاف مقيد بالميزات، ومصادقة مفوضة، وملحقات webhook. تعامل مع هذه المسارات كأسطح توافق لتطوير مسودات ACP.
AP2 v0.1-alpha: دعم موجه للتفويض، والدفع، والإيصال، والتدخل، A2A، و MCP-آمن لشكل البروتوكول الأولي الحالي.

الرحلات الأساسية

ACP إتمام شراء بحضور بشري مع دفع مفوض يتبعه تحديثات الطلب من التاجر أو webhook.
AP2 تنسيق المتسوق، والتاجر، ومزود بيانات الاعتماد، ومعالج الدفع بحضور بشري.
AP2 تنفيذ النية بدون حضور بشري مع إما إكمال مستقل أو إعادة تأكيد صريحة من المشتري.
عمليات نشر التجار ثنائية البروتوكول حيث يرتبط ACP و AP2 بنفس معرف المعاملة والسجل القانوني.
استدعاء ما بعد الضغط حيث ينجو السجل الدائم والذاكرة المقنعة من فقدان النسخة.

الأمان والمتانة

تبقى التفويضات الخام، والتوقيعات، وبيانات الاعتماد المفوضة، وحمولات الإيصالات في تخزين الأدلة المدعوم بواسطة adk-artifact.
تعيش حالة المعاملة الدائمة في adk-session عبر السجل المنظم، وليس في سياق المحادثة الهش فقط.
يستخدم الاستدعاء الدلالي ملخصات مقنعة من خلال adk-memory.
adk-auth يربط هوية الطلب، ونطاق المستأجر، وبيانات التدقيق الوصفية.
adk-guardrail يطبق سياسة المبلغ، والتاجر، وإصدار البروتوكول، والتدخل، والتنقيح قبل استمرار الحالة.

مسار التحقق

استخدم اختبارات التكامل كمسار تحقق شامل وموثوق:

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

ملفات مرجعية:

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

المثال crate تحت examples/payments/ هو فهرس السيناريوهات للرحلات المدعومة، بينما اختبارات التكامل هي الحقيقة التنفيذية لسلوك البروتوكول، والسجل، والأدلة.