결제 및 상거래

adk-payments는 ADK-Rust에 프로토콜 중립적인 상거래 오케스트레이션을 추가합니다. 이는 여러 프로토콜 어댑터에 걸쳐 하나의 영구적인 트랜잭션 모델이 필요하며, 원시 결제 아티팩트가 대화 기록이나 의미론적 메모리로 유출되지 않도록 설계된 에이전트 기반 상거래 흐름을 위해 고안되었습니다.

지원 수준

ACP 안정 2026-01-30: 결제, 완료, 취소, 위임된 결제 및 주문 후속 조치를 위한 생산 지향적 기준선입니다.
ACP 실험적: 기능 게이트된 검색, 위임 인증 및 웹훅 확장입니다. 이 경로들을 진화하는 ACP 초안을 위한 호환성 표면으로 취급하십시오.
AP2 v0.1-alpha: 현재 알파 프로토콜 형태에 대한 유형화된 위임, 결제, 영수증, 개입, A2A 및 MCP-안전 지원입니다.

주요 여정

ACP 판매자 또는 웹훅 주문 업데이트가 뒤따르는 위임된 결제를 통한 사용자 참여 결제.
AP2 사용자 참여 구매자, 판매자, 자격 증명 제공자 및 결제 처리자 조정.
AP2 사용자 비참여 의도 실행 (자율 완료 또는 명시적 구매자 재확인 중 하나).
ACP와 AP2가 동일한 정식 트랜잭션 ID 및 저널로 상호 연관되는 이중 프로토콜 판매자 배포.
압축 후 회수 (영구 저널 및 마스킹된 메모리가 기록 손실 후에도 유지되는 경우).

보안 및 내구성

원시 위임, 서명, 위임된 자격 증명 및 영수증 페이로드는 adk-artifact에 의해 지원되는 증거 저장소에 유지됩니다.
영구 트랜잭션 상태는 취약한 대화 전용 컨텍스트가 아닌 구조화된 저널을 통해 adk-session에 존재합니다.
의미론적 회수는 adk-memory을 통해 마스킹된 요약을 사용합니다.
adk-auth는 요청 ID, 테넌트 범위 및 감사 메타데이터를 바인딩합니다.
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

examples/payments/ 아래의 예제 크레이트는 지원되는 여정에 대한 시나리오 인덱스이며, 통합 테스트는 프로토콜, 저널 및 증거 동작에 대한 실행 가능한 실제 정보입니다.