HTTP 402 — Payment Required
x402 protocol

Gift cards & top-ups, paid with USDC on Base.

10,001+ brands, 180 countries. One API call. No accounts, no OAuth, no friction.


How it works
STEP 1 — place order, no payment yet
$ curl -s -D - -X POST https://x402.cryptorefills.com/v1/orders \
    -H "Content-Type: application/json" \
    -d '{
      "email": "shopper@my-ai-agent.xyz",
      "items": [{
        "product_id": "amazon-us-25",
        "beneficiary_account": "gift@recipient.com"
      }]
    }'

< HTTP/1.1 402 Payment Required
< PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJtYXhBbW91bnRSZXF1aXJlZCI6IjI1MDAwMDAwIiwiYXNzZXQiOiIweDgzMzU4OWZDRDZlRGI2RTA4ZjRjN0MzMkQ0ZjcxYjU0YkRBMDI5MTMiLCJleHRyYSI6eyJuYW1lIjoiVVNEQyIsImRlY2ltYWxzIjo2fSwicGF5VG8iOiIweGNyLXdhbGxldC4uLiIsImRlc2NyaXB0aW9uIjoiJDI1LjAwIOKAlCBQdXJjaGFzZTogYW1hem9uLXVzLTI1In1dLCJyZXNvdXJjZSI6IlBPU1QgL3YxL29yZGVycyJ9

# decoded:
{
  "x402Version": 2,
  "accepts": [{
    "scheme":            "exact",
    "network":           "eip155:8453",
    "maxAmountRequired": "25000000",  // $25.00 USDC (6 decimals)
    "asset":             "0x833589fCD6eDb6E08f4c7C32D4f71b54bDA02913",
    "extra":             { "name": "USD Coin", "version": "2", "decimals": 6 },
    "payTo":             "0xcr-wallet-address...",
    "description":      "$25.00 — Purchase: amazon-us-25"
  }],
  "resource": "POST /v1/orders"
}
STEP 2 — sign EIP-712 payload, retry with signature
$ curl -s -X POST https://x402.cryptorefills.com/v1/orders \
    -H "Content-Type: application/json" \
    -H "PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6Miwic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJwYXlsb2FkIjp7ImF1dGhvcml6YXRpb24iOnsidG8iOiIweGNyLXdhbGxldC4uLiIsInZhbHVlIjoiMjUwMDAwMDAifSwic2lnbmF0dXJlIjoiMHhhYmMxMjMuLi4ifX0" \
    -d '{ ...same body... }'

< HTTP/1.1 200 OK
{
  "order_id":                    "cr-8f2a91",
  "status":                      "processing",
  "estimated_delivery_seconds":  60,
  "poll_url":                    "/v1/orders/cr-8f2a91"
}