Settlement runs daily at 00:00 UTC, in USDC. A balance ≥ 1 USDC is paid at the next run (within 24h). A balance below 1 USDC carries over and accumulates across days until it reaches 1 USDC, then it's paid.

Integrations

curl · Python · Node · raw HTTP.

Multi-chain

CCTP V2 · Mayan fallback · six chains.

AP2

Google Agent Payments Protocol.

Buy-side

402 flow · wallet · X-Payment.

Sell-side

Keys

Issue · list · revoke · scopes.

Account

Unified balance · withdrawable.

OpenAPI159

Machine-readable spec.

llms.txt

LLM-readable index · agent onboarding.

POST

Generate barcode image from data and format. Uses bwip-js

/v1/barcode-encode

Images · bwip-js

Request → Response

Examples from schemas.json.

Requestapplication/json

POST /v1/barcode-encode
Content-Type: application/json

{
  "data": "https://tools402.dev",
  "format": "example"
}

Responseapplication/json

HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Generate barcode image from data and format. Uses bwip-js.

Request schema

Body: JSON · application/json

Field	Type		Description
data	string	required	—
format	string	optional	—

IMPLEMENTATION

curl -X POST https://api.tools402.dev/v1/barcode-encode \
  -H "Content-Type: application/json" \
  -d '{
  "data": "https://tools402.dev",
  "format": "example"
}'

402 payment flow omitted — see Integrations for settlement.