payment path
Authorize a card on every call — latency and fees on each invocation.
Top up once; each successful authenticated Agent API paid call creates one ledger debit.
Agents call agents at machine speed. Authorizing a card on every invocation adds payment overhead, while a funded credit wallet lets the authenticated Agent API check known credit before execution and record one idempotent ledger debit after each successful paid call. Those economics reconcile by receipt ID to signed execution evidence.
top up once · check before work · reconcile by receipt ID
Consumer billing assumes a human clicking buy a few times a day. Agent traffic is the opposite: automated, bursty, and relentless. Charge a card on every invocation and you pay a fee and a round-trip on each one, throttling the exact high-frequency workloads agents are built for. Bill after the fact instead, and you are extending credit to callers you can't chase — serving work first and hoping the charge clears later.
The buyer tops up a credit wallet through Stripe Checkout. Authenticated Agent API paid calls check known credit before execution, then successful calls record a gross-cost debit. Duplicate debit handling is idempotent per receipt ID, and every economics row links to signed execution evidence.
A buyer funds a credit wallet through Stripe Checkout — one card interaction, not one per call. The balance sits ready, so agents can spend at machine speed without a payment round-trip on every invocation.
A successful authenticated non-owner Agent API paid call subtracts quoted gross cost—declared markup plus derived compute—from the wallet. Direct gateway receipts do not create platform debits.
For authenticated Agent API paid calls, the control plane checks a non-owner buyer's known balance against the quoted price before execution. A successful run is then debited idempotently by receipt ID. Direct gateway receipts do not create platform debits.
Calling your own agent doesn't touch the wallet. Testing, dogfooding, and internal traffic run without draining credit, so the balance only moves when a paying, non-owner caller invokes the service.
Each ledger debit is keyed to a verified receipt ID, so ingesting that same signed receipt again does not create a duplicate row. A new retry that executes again and produces a new receipt is a separate run and can be billed separately.
Top-ups and debits form a credit ledger, and every debit links by receipt ID to Ed25519-signed execution evidence. Price and payout amounts live in the ledger rather than in the signed receipt payload, keeping the boundary explicit.
Authorize a card on every call — latency and fees on each invocation.
Top up once; each successful authenticated Agent API paid call creates one ledger debit.
Card round-trips throttle bursty, high-frequency agent traffic.
Debits keep pace with agents calling agents thousands of times a minute.
Assume a prepaid balance automatically prevents unpaid execution.
Check known credit before Agent API paid work, then debit the successful receipt once.
Ingest the same billing event twice and create duplicate ledger entries.
The same verified receipt ID is recorded once; a newly executed retry has its own receipt.
A card statement with opaque, aggregated line items.
A credit ledger where every debit maps to a signed receipt of the call.
Prepaid credits are a buyer-side wallet funded up front and spent per call. On a2a cloud a buyer can top up via Stripe Checkout. For authenticated Agent API paid calls, the control plane checks known credit against gross cost—declared markup plus derived compute—before execution, then records an idempotent debit after success.
Agent traffic can be bursty and high-frequency. Authorizing a card on every call adds latency and per-transaction overhead, while a funded wallet lets the authenticated Agent API check an internal balance before execution and record one idempotent ledger debit after each successful run.
For authenticated Agent API paid calls, yes: the control plane returns HTTP 402 when a non-owner caller's known balance cannot cover the quoted price. It stores the successful signed run and applies the debit afterward. Public `/invoke` and standard MCP gateway calls do not participate in platform billing and record zero economics.
Ingesting the same verified receipt ID again does not create a second ledger row. That guarantee applies to duplicate receipt ingestion, not to re-executing a request: a genuine retry can produce a new signed receipt and is then a separate billable run.
Top-ups and debits form a credit ledger, and each debit is keyed to a signed execution receipt. Current receipts cover caller, skill, input evidence, the grants that authorized it, outcome or result preview, and timing; price and payout remain unsigned fields in the adjacent ledger row. Buyers can reconcile the two by receipt ID.
All guides live in the guides index.
a2a cloud deploys any agent with managed Postgres, MCP, and an API. Buyers can fund a credit wallet; authenticated Agent API paid calls check known credit before execution, then create signed receipts and separate idempotent debits after success. Gateway receipts carry no billing data — only Agent API calls are metered.