From acp-agentic-commerce
Implements ACP REST checkout API: create, update, retrieve, complete, cancel sessions with state machine, data models, and headers. For merchant endpoints and AI agent flows.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin acp-agentic-commerceThis skill is limited to using the following tools:
**Fetch live docs**:
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Automates semantic versioning and release workflow for Claude Code plugins: bumps versions in package.json, marketplace.json, plugin.json; verifies builds; creates git tags, GitHub releases, changelogs.
Fetch live docs:
https://developers.openai.com/commerce/specs/checkout/ for the canonical checkout specificationsite:github.com agentic-commerce-protocol spec openapi checkout for the latest OpenAPI YAMLhttps://developers.openai.com/commerce/guides/key-concepts/ for data model detailssite:docs.stripe.com agentic-commerce protocol specification for Stripe's merchant-side reference| Operation | Method | Path | Success |
|---|---|---|---|
| Create | POST | /checkout_sessions | 201 |
| Update | POST | /checkout_sessions/{id} | 200 |
| Retrieve | GET | /checkout_sessions/{id} | 200 |
| Complete | POST | /checkout_sessions/{id}/complete | 200 |
| Cancel | POST | /checkout_sessions/{id}/cancel | 200 |
not_ready_for_payment → ready_for_payment → completed
| | |
+──────────────────────+→ canceled ←────+
|
in_progress
|
authentication_required
The five core status enum values are: not_ready_for_payment, ready_for_payment, completed, canceled, in_progress. Note that authentication_required is a transitional/conditional state (returned during 3DS flows), not one of the five core status values.
The merchant controls status transitions. The agent reads the status and reacts.
Authorization: Bearer <token> — REQUIREDAPI-Version: YYYY-MM-DD — REQUIREDIdempotency-Key: <UUID> — REQUIRED on all POSTContent-Type: application/jsonid + quantity (sent by agent in create/update)items_base_amount, items_discount, subtotal, discount, fulfillment, tax, fee, totalAll amounts are integers in minor currency units (cents). $19.99 = 1999. Floating-point is prohibited.
The messages[] array allows merchant-to-agent communication:
The links[] array provides actionable URLs with spec-defined link types:
terms_of_use — Merchant terms of use pageprivacy_policy — Merchant privacy policy pageseller_shop_policies — Merchant shop policies pagenot_ready_for_payment or ready_for_paymentcompleted status + order detailsauthentication_required + authentication challengetype, code, message, paramparam (JSONPath) to indicate which field caused the errorFetch the OpenAPI spec for exact request/response schemas, field types, and all possible error codes before implementing.