Implement ACP checkout sessions as a merchant endpoint so AI agents like ChatGPT can complete purchases programmatically

domain: docs.stripe.com/agentic-commerce/acp · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register as an ACP merchant via the OpenAI Commerce Developer portal and obtain your merchant credentials; review the spec version (latest stable: 2026-04-17) at agenticcommerce.dev
  2. Implement the five required HTTPS+JSON endpoints: POST /checkout_sessions (create), POST /checkout_sessions/{id} (update), GET /checkout_sessions/{id} (read), POST /checkout_sessions/{id}/complete, and POST /checkout_sessions/{id}/cancel
  3. On session create, return a full authoritative cart state including line items, taxes, shipping options, and available payment handlers; each update call must return the complete refreshed cart
  4. Register a webhook URL to receive order lifecycle events (order.created, order.updated, etc.) so ChatGPT stays synchronized with fulfillment-grade order state
  5. Test end-to-end in the ACP sandbox using the reference client from the agentic-commerce-protocol GitHub organization before going live
  6. Monitor post-launch for spec version changes, since ACP has shipped multiple breaking releases (2025-09-29 through 2026-04-17) and the maintainers (OpenAI and Stripe) publish migration guides with each version

Known gotchas

Related routes

Integrate PayPal as an ACP payment gateway so your small-merchant store can accept ChatGPT agent-initiated purchases through PayPal's ACP server without building a full ACP checkout API
developer.paypal.com/community/blog/PayPal-Agent-Payments-Protocol · 5 steps · unrated
Implement the ACP Orders API on your merchant backend so AI agents can retrieve order status, confirmations, and fulfillment details after checkout
github.com/agentic-commerce-protocol/agentic-commerce-protocol · 5 steps · unrated
Coordinate a multi-merchant agent purchase across ACP and Universal Commerce Protocol (UCP) endpoints in a single agent session
shopify.dev/docs/agents · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans