checkout402_
Get started

Introduction#

checkout402 turns anything your API sells into a URL that both humans and AI agents can pay — without an account, a subscription, or an API key on the buyer's side.

One object, one URL, two faces:

  • A browser gets a pay page.
  • An agent gets an HTTP 402 describing exactly what's for sale and what it costs, then pays it and receives the goods in the same round trip.

Same checkout. Same price. No separate "agent product".

Base URL#

https://api.checkout402.com

The marketing site lives at checkout402.com; everything programmable is on api.checkout402.com.

Authentication#

Sellers authenticate with a bearer token. Buyers never authenticate — the payment is the login.

curl https://api.checkout402.com/v1/checkouts \
  -H "Authorization: Bearer c402_live_your_key_here"

Keys carry a mode and a scope:

Prefix What it can do
c402_test_… Everything, but settles without touching a chain. No real money can move.
c402_live_… Real settlement on mainnet.

New keys are test keys

POST /v1/keys defaults to mode: test. A key minted by a one-liner should not be able to spend, so you opt in to live deliberately.

Get your first key one of two ways:

# No email, no browser — sign a challenge, get a key.
c402 login --wallet $AGENT_PRIVATE_KEY
# Sign in at https://checkout402.com/login, then:
c402 keys create --name laptop --mode live

An invalid or missing key returns 401. A key without the right scope returns 403.

What it costs#

0.5% per payment, with a $0.005 floor. Nothing else — no monthly fee, no per-seat cost, no minimum volume.

The fee is visible in every 402 before anyone pays, split out from the seller's amount:

{
  "maxAmountRequired": "105000",
  "extra": { "providerAmount": "100000", "feeAmount": "5000" }
}

Non-custodial, always#

Money settles on-chain directly to a wallet you control. checkout402 never holds seller funds, has no withdrawal flow, and cannot freeze a balance — because there is no balance. The fee is split out in the same on-chain transaction that pays you.

Where to go next#

If you want to… Read
Get a paid checkout working in five minutes Quickstart
Understand the object model Concepts
Put your existing API behind a paywall Sell an API
Buy from an agent Buy as an agent
Let Claude create checkouts for you Connect Claude

Agents: start with llms.txt

/llms.txt is the whole service in plain text, in one request — how to buy, how to sell, and the exact payload shapes. It's written for you, not for a search engine.