Available on crate feature
payments only.Expand description
Canonical commerce kernel contracts.
The kernel exposes protocol-neutral command types, state-transition errors,
cross-protocol correlation, and backend-facing service traits used by ACP
stable 2026-01-30 and AP2 v0.1-alpha (2026-03-22) adapters.
Modules§
- commands
- correlator
- Kernel-mediated cross-protocol correlation.
- errors
- service
Structs§
- Begin
Intervention Command - Canonical request to start an intervention flow.
- Cancel
Checkout Command - Canonical request to cancel a checkout or transaction.
- Commerce
Context - Shared metadata supplied with canonical commerce commands.
- Complete
Checkout Command - Canonical request to finalize checkout and produce an order.
- Continue
Intervention Command - Canonical request to resume or complete an intervention flow.
- Create
Checkout Command - Canonical request to create a checkout session or AP2 cart negotiation.
- Delegate
Payment Allowance - Canonical delegated-payment allowance preserved across protocol adapters.
- Delegate
Payment Command - Canonical request to tokenize or delegate a payment credential.
- Delegated
Payment Result - Canonical delegated-payment result returned by payment-token services.
- Delegated
Risk Signal - Canonical risk signal attached to delegated-payment requests.
- Evidence
Lookup - Canonical lookup for one stored evidence artifact.
- Execute
Payment Command - Canonical payment-execution request shared by ACP and AP2 adapters.
- List
Unresolved Transactions Request - Canonical request to list unresolved transactions.
- Lossy
Conversion Error - Describes an unsafe cross-protocol conversion that the kernel refuses.
- Order
Update Command - Canonical order-state update emitted after checkout completion.
- Payment
Execution Result - Canonical payment execution result returned by payment backends.
- Protocol
Correlator - Cross-protocol correlator that routes ACP and AP2 adapters through the same canonical transaction ID and journal model.
- Store
Evidence Command - Canonical request to persist one evidence artifact.
- Stored
Evidence - Stored evidence returned by the evidence store.
- Sync
Payment Outcome Command - Canonical request to sync asynchronous payment outcomes back into the kernel.
- Transaction
Lookup - Canonical lookup by transaction identifier and optional session identity.
- Update
Checkout Command - Canonical request to update checkout state before payment execution.
Enums§
- Payment
Execution Outcome - Canonical payment outcome type used by the execution service.
- Payments
Kernel Error - Local kernel errors that map into the ADK structured error envelope.
- Projection
Result - Result of a canonical projection attempt.
- Protocol
Origin - Describes the originating protocol for a correlation operation.
- Protocol
RefKind - Describes a specific protocol reference slot in
ProtocolRefs.
Traits§
- Delegated
Payment Service - Backend-facing delegated-payment tokenization operations.
- Evidence
Store - Raw evidence storage used to preserve immutable protocol artifacts.
- Intervention
Service - Backend-facing intervention lifecycle operations.
- Merchant
Checkout Service - Backend-facing checkout operations shared by ACP and AP2 adapters.
- Payment
Execution Service - Backend-facing payment execution operations shared by ACP and AP2 adapters.
- Transaction
Store - Durable structured transaction storage keyed by canonical transaction ID.