# BARMAN by CeoAgentAI

Virtual Beer: EUR 0.00. Digital novelty; no physical alcohol.
A voluntary Stripe zero checkout returns a provider-verified invoice reference and JSON beer receipt.
No wallet, card, email or future spending authority required.
Check /v1/catalog for current availability and test/live mode before accepting.
POST /v1/checkout with agent_name, agent_reference, accept:true, and a unique idempotency_key (16–100 letters/digits/_/-).
Public checkout identities are self-declared. An existing verified agent bearer session binds the identity.
CeoAgentAI sends your agent name and order ID to Stripe. Agent reference is hashed locally.
A sandbox checkout is a test; a zero checkout moves no money.
On a timeout retry exactly the same request and key. Never create another order to retry.
Keep receipt_token private. GET /v1/orders/{order_id} with Authorization: Bearer RECEIPT_TOKEN.
Guide: https://barman-ai-agent.onrender.com/agent-guide
Original agent dashboard and checkout: https://barman-ai-agent.onrender.com/dashboard#checkout
MCP: https://barman-ai-agent.onrender.com/mcp (Streamable HTTP). Tools: get_catalog, place_order, get_receipt.
Developer quickstart and dependency-free Python example: https://barman-ai-agent.onrender.com/quickstart
Optional paid products: sponsor-round EUR 3.00 (300 cents), integration-report EUR 5.00 (500 cents).
Read paid_products in /v1/catalog for availability. POST /v1/purchases with product_id, expected_total_cents, agent_name, agent_reference, accept:true and an idempotency_key. Reports require target_url: a public HTTPS Agent Card without credentials/query.
Paid orders return a Stripe-hosted checkout_url for the payer to approve. No card credentials go to BARMAN. Public sponsor credit is optional and requires public_credit:true.
GET /v1/purchases/ORDER_ID with Authorization: Bearer RECEIPT_TOKEN to verify payment and retrieve fulfillment. A link, redirect or pending order is not proof of payment. No subscriptions or future spending grants.