x402 Agent Checkout for WooCommerce

Description

Let AI agents discover and buy your products directly — paid in USDC, settled on-chain.

---

Sell to AI agents, not just humans

AI shopping agents are starting to buy things on behalf of people and other systems — but almost no store is set up to sell to them.

x402 Agent Checkout for WooCommerce implements the emerging x402 protocol (built on the standard HTTP 402 Payment Required status code) so any compatible agent can:

1. Discover what you sell via a clean JSON catalog feed — the agent-commerce equivalent of an XML sitemap.
2. Request checkout for a product and get back exactly what payment is required: price, currency, network, and your wallet address.
3. Pay instantly by signing a USDC payment authorization with its own wallet — no card, no login, no OAuth flow.
4. Get a confirmed order in your store seconds later, indistinguishable from any other WooCommerce order in your admin.

All settlement runs through Coinbase’s hosted CDP facilitator — you never touch blockchain infrastructure, run a node, or manage gas. Configure one wallet address and one API key, and the plugin handles the rest.

---

Not just “a crypto gateway with extra steps”

This isn’t a checkout button for humans who happen to pay in crypto — it’s a machine-callable API built for autonomous buyers:

• No session, no cart, no cookies — every request is self-contained
• No signup or OAuth for the agent — payment is the authentication
• A discovery feed so agents don’t have to scrape your HTML
• Idempotent by design — a retried request can’t accidentally double-charge or create a duplicate order

---

Key Features

🛍️ Machine-Readable Product Catalog

A JSON feed (/wp-json/store/v1/x402/products) listing every agent-enabled product — price, SKU, image, stock status, and exactly how to check out, including whether it needs a shipping address.

⚡ Real x402 Payment Flow

Full 402 → verify → settle cycle against Coinbase’s CDP facilitator. EIP-3009 (transferWithAuthorization) signatures are verified and settled server-side — your store never handles private keys.

📦 Billing & Shipping Support

Physical products can require a real address before an agent is even allowed to pay — the plugin won’t issue a payment request for something it can’t ship. Digital products skip all of that automatically.

💰 Real Tax & Shipping Calculation (optional, off by default)

Turn it on and the price an agent is quoted includes your actual WooCommerce tax rates and the cheapest matching rate from your configured Shipping Zones — not a flat guess.

🎛️ Flexible Product Enablement

Enable agent checkout per product, or flip one switch to expose your entire catalog at once. New products are agent-ready by default — no per-product setup required unless you want it.

🔒 Built for Reliability

• Idempotent replay protection — a retried signed payment returns the existing order instead of creating a duplicate
• Every order is a normal WooCommerce order — stock decrements, vendor/admin emails fire, reporting just works
• Graceful handling of third-party plugin conflicts — a broken hook in another plugin returns a clean JSON error instead of crashing the request

📊 Full Order Visibility

A dedicated “x402 Payment Details” panel on every order — payer wallet address, network, transaction hash (linked straight to the block explorer), and the payment authorization nonce — plus a quick-glance column in your Orders list.

🌐 Testnet-First

Ships configured for Base Sepolia (testnet) by default. Build confidence with fake money before flipping one dropdown to Base Mainnet.

---

Requirements

• WordPress 6.0+
• WooCommerce 6.0+
• PHP 7.4+
• A free Coinbase Developer Platform account (no KYC or trading account needed — separate from Coinbase’s retail exchange)
• A wallet address to receive USDC (Base network)

What This Plugin Does NOT Do

Being upfront, since this is a genuinely new category:

• It does not add a “pay with crypto” button for human checkout — this is specifically for autonomous agent buyers
• It does not run its own blockchain node or handle private keys on your server — settlement is delegated to Coinbase’s facilitator
• It does not currently support multi-item cart checkout — one product + quantity per request (an agent can call it multiple times for multiple items)

Support & Documentation

Full setup walkthrough, a ready-to-run Node.js test buyer script, and troubleshooting notes are included in the documentation. [ support@ryanplugins.net / documentation page.]