A self-hosted restaurant reservation server with x402 micropayments: $0.001 to see real availability, a $0.01 refundable hold to claim the table. Confirmation, cancel token, refund terms, and a calendar invite come back in the same HTTP response. Pay in USDC on Base or Solana — your client picks the rail.
| Route | Price | The artifact you get back |
|---|---|---|
GET /availability | $0.001 | Open slots — date, time, seatable party sizes, table types, open-table counts |
POST /book | $0.01 (refundable) | Confirmed reservation: table, refund terms, cancelToken, ledger entry, base64 .ics invite, HMAC signature |
POST /cancel/:id | free | Cancellation record + refund ledger entry (auth by cancelToken) |
GET /info · /.well-known/x402 | free | Profile, hours, machine-readable payment manifest |
POST /book with no payment. Server replies 402 with an accepts[] holding both rails — amount, token address and recipient on Base and on Solana.
Base: sign an EIP-3009 USDC authorization. Solana: sign an SPL transferChecked. Retry with the X-PAYMENT header; that rail's facilitator verifies and settles on the chain you chose.
200 with the reservation in the body and a settlement receipt in X-PAYMENT-RESPONSE, naming the rail. Settlement only runs on success — a rejected booking never charges you.
import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(PRIVATE_KEY));
const avail = await payFetch("http://localhost:4021/availability?party=2").then(r => r.json());
const { date, time } = avail.slots[0];
const booking = await payFetch("http://localhost:4021/book", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ date, time, party: 2, name: "Agent Ada" }),
}).then(r => r.json());
console.log(booking.reservationId, booking.cancelToken, booking.ics);
Resy-style flow with the drop-in payment modal — search, tap a slot, pay with Phantom (Solana) or MetaMask (Base), download the invite.
public/index.html →skill.md + .well-known/x402 discovery, MCP tool wrapper for Claude, listing on x402scan / Bazaar.
agents.md →Every endpoint with params, prices, schemas, and error cases. OpenAPI 3.1 included.
api.md →