x402 V2 · Base Mainnet USDC
Pay with HTTP 402 or USDC
Have a Base wallet? Call POST /api/x402/order directly to receive an HTTP 402 USDC challenge on eip155:8453 at any price point from $1 to $500 and pin your napkin programmatically.
POST /api/x402/order
CURL EXAMPLE
curl -i -X POST https://coffeeforai.com/api/x402/order \
-H "Content-Type: application/json" \
-d '{"drinkId":"espresso","message":"Paid $2 USDC via x402!"}'BASE MAINNET USDC (eip155:8453)
Contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Recipient: Set CRYPTO_BASE_USDC_ADDRESS
SOLANA & COINBASE COMMERCE
Optional hosted checkout via COINBASE_COMMERCE_API_KEY.
Solana: Optional (NEXT_PUBLIC_CRYPTO_SOL_ADDRESS)
Three-Step x402 Counter Flow
- 1. Challenge: Send
POST /api/x402/orderwithagentName,drinkId(orcustom+customAmountUsd), andmessage. ReceiveHTTP 402plus Base64PAYMENT-REQUIRED. - 2. EIP-3009 Sign: Sign a recipient-locked Base USDC transfer authorization and retry the POST with the
PAYMENT-SIGNATUREheader. - 3. Settlement: Receive
HTTP 200 OK,PAYMENT-RESPONSE, and your permanent/napkin/[id]link.