x402 Agent Checkout for WooCommerce

Let AI agents discover and buy your WooCommerce products directly, paid in USDC on Base.

The first WooCommerce plugin built for the emerging Agentic Commerce ecosystem. AI shopping assistants, autonomous buyers, and software agents discover your products through a machine-readable catalog, find your store on their own through built-in discovery, and complete purchases over standard HTTP using the x402 protocol — with payment settled on-chain in USDC.

No customer accounts. No API keys for buyers. No traditional checkout flow. A signed payment authorization automatically creates a real WooCommerce order within seconds — single item or full cart, digital or physical, priced in your store’s own currency.

Sell to AI Agents, Not Just Humans

AI-powered shopping agents are starting to purchase products on behalf of users and businesses. Most online stores are built only for human visitors clicking through a cart.

x402 Agent Checkout for WooCommerce implements the x402 protocol — built on the standard HTTP 402 Payment Required response — so compatible AI agents can:

• Find your store on their own, via a discovery manifest and catalog links published on every page — no URL needs to be handed to them out of band.
• Discover products using a machine-readable JSON catalog, filterable by search term, category, and price.
• Request checkout details for one product or a full multi-item cart, including price, currency, network, and payment destination.
• Authorize payment using their own USDC wallet.
• Automatically create a standard WooCommerce order the moment settlement succeeds.
• Check an order’s status afterward using nothing but the wallet address that paid for it.

Settlement runs through Coinbase Developer Platform (CDP). No blockchain node, private keys, or smart contract deployment required on your end.

Why x402 Instead of a Traditional Crypto Gateway?

This plugin is built specifically for autonomous machine-to-machine commerce, not human crypto checkout with a “Pay with Crypto” button bolted on.

• No shopping cart or browser session required.
• No customer login or OAuth authentication.
• Machine-readable discovery and product catalog, built for agents to find and read on their own.
• An HTTP API designed around how AI agents actually operate.
• Idempotent requests — a retried payment returns the existing order instead of creating a duplicate.

Key Features

Agent Discovery, Built In

• A discovery manifest and matching HTTP header published on every page, so an agent that simply visits your store already knows where the catalog and checkout endpoints are.
• Optional Bazaar discovery metadata on every checkout request — Coinbase’s own CDP Facilitator can automatically list your store in its free agent marketplace (Bazaar / Agentic.Market) after your first real sale. No signup, no extra cost.

Machine-Readable Product Catalog

• JSON catalog endpoint for AI discovery, filterable by search term, category, and min/max price.
• Product title, SKU, image, pricing, inventory status, and checkout requirements.
• Full support for variable products — every purchasable variation listed with its own price and stock.
• Indicates whether shipping information is required for a given product.

Native x402 Payment Flow

• Complete 402 → Verify → Settle workflow.
• Runs on the Coinbase CDP Facilitator.
• Supports EIP-3009 transferWithAuthorization.
• No private keys stored on your WordPress site — and your CDP secret itself never has to live in the database, via an optional wp-config.php constant.

Single Items or a Full Cart

• Pay for one product or several — including different variations of the same product — in a single order and a single settlement.
• Order totals are calculated fresh for every checkout, never estimated.

Automatic Currency Conversion

• Priced your store in EUR, GBP, or anything else? Agent checkout converts to USD automatically using a live exchange rate before an agent is ever charged, so what settles on-chain always matches your product’s real-world price.
• USD stores are unaffected — no conversion step, no added latency.
• Per-product USDC price overrides are supported for anything you’d rather price manually.

Billing & Shipping Validation

• Requires a valid shipping address for physical products before payment is even requested.
• Digital products skip address collection entirely.

WooCommerce Tax & Shipping Calculation

• Optional real-time tax calculation using your actual configured WooCommerce tax rates.
• Optional real shipping cost, calculated from your configured Shipping Zones.
• Returns accurate, live pricing instead of a flat estimate.

Flexible Product Enablement

• Enable Agent Checkout store-wide or per product.
• New products can automatically become agent-enabled — no extra configuration required per listing.

Built for Reliability

• Idempotent payment replay protection — a retried request never creates a duplicate order.
• Atomic stock reservation at settlement time, so two agents can never both walk away with the last unit of a low-stock item.
• Per-IP rate limiting on the checkout endpoint, on by default.
• Compatible with normal WooCommerce inventory management, emails, and order processing — nothing about the rest of your store changes.
• Graceful handling of third-party plugin conflicts.

Complete Order Tracking

• Dedicated x402 Payment Details panel on every order.
• Payer wallet address.
• Blockchain network.
• Transaction hash with explorer link.
• Authorization nonce.
• Quick order-list indicator inside WooCommerce.
• Order status lookup for agents, gated by the paying wallet address — no account system needed on either side.

Configuration You Can Trust

• Settings export/import, for backing up or moving your configuration between sites.
• Built-in license verification unlocks support and future updates — every checkout feature works identically whether or not you’ve verified yet.

Testnet Ready

• Configured for Base Sepolia testnet by default.
• Switch to Base Mainnet when you’re ready for production.

Requirements

• WordPress 6.0 or higher
• WooCommerce 6.0 or higher
• PHP 7.4 or higher
• A free Coinbase Developer Platform (CDP) account — no KYC or trading account needed
• An EVM-compatible wallet address to receive USDC

What This Plugin Does Not Do

• Does not add a traditional “Pay with Crypto” checkout button for human customers — this is agent-to-store checkout, not a human payment gateway.
• Does not operate its own blockchain node.
• Does not store or manage private keys.

Perfect For

• AI Shopping Platforms
• Autonomous Purchasing Agents
• Developer APIs
• Machine-to-Machine Commerce
• Digital Product Stores
• SaaS Providers
• Early Adopters of Agentic Commerce

Prepare your WooCommerce store for the future of AI-powered commerce — let autonomous agents discover, purchase, and pay using the open x402 protocol.

Online Docs

https://ryanplugins.net/x402-agent-checkout-setup-guide/