Create crypto-powered e-commerce orders on Amazon/Shopify, paid with USDC on Solana via x402.
What it does
Purch API is an x402-enabled e-commerce endpoint that lets agents and applications create product orders on platforms like Amazon, Shopify, and other browser-automation-supported sites. The primary endpoint (`POST /orders/solana`) accepts a product URL, shipping address, email, and Solana payer address, then returns a serialized Solana transaction for the caller to sign. Payment for the API call itself costs $0.01 USDC on Solana, enforced via the x402 protocol.
The API also exposes a `GET /orders/:orderId` endpoint (authenticated with a client secret returned at order creation) to poll order status through its lifecycle: pending → processing → completed → failed. A full OpenAPI 3.0 spec is served at `/docs`, and a health-check endpoint is available at `/health`.
The service is designed for AI agents that need to autonomously purchase physical goods online. It bridges crypto payments to traditional e-commerce fulfillment. Note that during probing the `POST /orders/solana` endpoint returned HTTP 500 rather than the expected 402 payment challenge, which may indicate a transient server issue or a deployment problem at the time of testing.
Capabilities
Use cases
- —AI agent autonomously purchasing a product from Amazon using USDC on Solana
- —Programmatic order placement on Shopify stores with crypto payment
- —Building a chatbot that can buy and ship physical goods on behalf of users
- —Automating gift or supply procurement workflows with cryptocurrency
- —Monitoring order fulfillment status after crypto-powered purchase
Fit
Best for
- —AI agents that need to purchase physical goods autonomously
- —Developers building crypto-native e-commerce integrations
- —Solana/USDC-based purchasing workflows
Not for
- —Users who need fiat payment processing without crypto
- —High-volume bulk ordering (no batch endpoint documented)
- —Digital-only or non-shippable product purchases (requires physical address)
Quick start
curl -X POST https://x402.purch.xyz/orders/solana \
-H 'Content-Type: application/json' \
-d '{
"email": "customer@example.com",
"payerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"productUrl": "https://www.amazon.com/dp/B08N5WRWNW",
"physicalAddress": {
"name": "John Doe",
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94102",
"country": "US"
}
}'Example
Request
{
"email": "customer@example.com",
"locale": "en-US",
"productUrl": "https://www.amazon.com/dp/B08N5WRWNW",
"payerAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"physicalAddress": {
"city": "San Francisco",
"name": "John Doe",
"line1": "123 Main St",
"line2": "Apt 4B",
"state": "CA",
"country": "US",
"postalCode": "94102"
}
}Response
{
"orderId": "550e8400-e29b-41d4-a716-446655440000",
"clientSecret": "$2b$10$...",
"serializedTransaction": "AQAAAA...base64..."
}Endpoint
Quality
Full OpenAPI 3.0 spec and detailed endpoint documentation are available, which is excellent. However, the probe returned HTTP 500 on POST and 400 on GET instead of the expected 402 payment challenge, raising concerns about current liveness. No external documentation or community references were found beyond the self-hosted spec.
Warnings
- —Probe returned HTTP 500 on POST /orders/solana instead of expected 402 payment challenge — endpoint may be experiencing issues
- —No x402 payment challenge header was captured during probing
- —No external pricing page found; only the $0.01 USDC per order call is documented in the OpenAPI spec
- —Service reliability and uptime guarantees are unknown
Citations
- —POST /orders/solana requires x402 payment of $0.01 USDC on Solanahttps://x402.purch.xyz/docs
- —Supports Amazon, Shopify, and browser automation platformshttps://x402.purch.xyz/docs
- —Response includes orderId, clientSecret, and serializedTransactionhttps://x402.purch.xyz/docs
- —Order status can be polled via GET /orders/:orderId with client secret authorizationhttps://x402.purch.xyz/docs
- —API metadata and endpoint listing available at roothttps://x402.purch.xyz
- —Probe returned 500 on POST and 400 on GET for /orders/solanahttps://x402.purch.xyz/orders/solana