Back to Browse
Butiful Agent Commerce – Purchase
x402
Butiful Agent Commerce – Purchase is a paid API for AI agents from agent.butiful.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).
Executes a physical product purchase on Butiful's Shopify-backed store using a pre-quoted purchase token, paying via x402/USDC on Base, and triggering Shopify fulfillment.
Price / call$0.01
Success—
StatusUnknown
How this service works
Agent-ready commerce for Butiful. Discover available products, get Shopify-priced quotes, and purchase physical products using x402/USDC with Shopify handling inventory, orders, shipping, and fulfillment.
Output
Returns a Butiful order reference (e.g. BAX-7K3M9QW2XZ), Shopify order ID and name, payment details (USDC amount, transaction hash, payer address, Base network), a receipt token with a status URL for tracking, and shipping method and destination country. Order status is 'completed' on success and Shopify handles subsequent fulfillment and shipping notifications.
Example use cases
Automated crypto checkout for physical goods
“Go ahead and finalize my Butiful order — use purchase token 'tok_xyz789', send confirmation to mike@example.com, and generate a new idempotency key so we don't accidentally double-order.”
Agent-driven gift purchase with retry safety
“Complete the Butiful purchase for the gift I quoted earlier — the purchase token is 'tok_gift456', confirm to sarah@example.com, and make sure you use a unique idempotency key so if it fails we can safely retry.”
Headless storefront order fulfillment
“Trigger the final checkout step on Butiful for purchase token 'tok_shop321' — ship to the US address I confirmed, send order updates to orders@myshop.com, and return the Shopify order number and receipt URL once it's done.”
Technical details
Endpoint
POSThttps://agent.butiful.org/api/agent/purchaseWhen to prefer
Use this endpoint when you have already obtained a purchaseToken from the Butiful /api/agent/quote endpoint and are ready to commit the order. This is the final checkout step — not for browsing products or getting prices. Prefer this over generic Shopify APIs when operating in an x402/USDC agent payment context, as it handles crypto payment settlement and Shopify order creation atomically. The idempotencyKey makes it safe to retry on transient failures.
Side effects
- Invalid or expired purchaseToken — quote must be re-fetched from /api/agent/quote
- Duplicate idempotencyKey with different parameters — returns existing order rather than creating new one
- Payment failure — USDC transfer on Base rejected or insufficient balance
- Invalid email format — order cannot be created without valid shopper email
- Item out of stock after quote was generated — Shopify inventory conflict
- Network or Shopify API error — returns error with 5xx status
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| emailrequired | string | Shopper email for order confirmation and shipping updates. |
| phone | string | |
| purchaseTokenrequired | string | The purchaseToken of the chosen shippingOption from POST /api/agent/quote. It binds items, destination, shipping method and the exact total. |
| idempotencyKeyrequired | string | Client-generated unique key (UUID recommended). Retrying with the same key never creates a second order. |
Output
Schema · Response
{
"ok": true,
"ref": "BAX-7K3M9QW2XZ",
"order": {
"id": "gid://shopify/Order/6001234567890",
"name": "#1234"
},
"status": "completed",
"message": "Order placed with Butiful. Fulfillment and shipping notifications follow the store's normal process.",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payer": "0xabc...",
"amount": "20400000",
"network": "eip155:8453",
"amountUsd": "20.40",
"transaction": "0x123..."
},
"receipt": {
"token": "a1b2c3...",
"statusUrl": "https://agent.butiful.org/api/agent/orders/BAX-7K3M9QW2XZ?receipt=a1b2c3..."
},
"shipping": {
"method": "Economy",
"destinationCountry": "US"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"