x402 paywalled API
HTTP already had a status code for "pay me". most of the industry ignored it and built another account system instead. x402 is the correction.
stack
- open standard: docs.x402.org
- seller responds
402with payment requirements - buyer (human or agent) returns a payment payload
- optional facilitator
/verify+/settle - paybox agents can pay x402 services via MCP (
pay_x402,use_service)
k4d tip links today are not x402. they are a USDC tip + unlock cookie. different rail. see tip-link-unlock.
steps (seller mental model)
- client
GETs a paid resource. - server replies
402 Payment Requiredwith machine-readable payment instructions. - client prepares payment (wallet / agent / facilitator path).
- server verifies + settles (locally or via facilitator).
- server returns the resource.
official quickstarts: sellers · buyers
agent path
wire paybox MCP, then let the agent use x402 tools against a seller that speaks the protocol. no custom "agent auth" fantasy required.
pitfalls
- keep docs vendor-neutral. facilitators are interchangeable plumbing, not religion.
- do not claim k4d paywall is x402 until it actually speaks 402 headers.
- micropayments still need gas/network reality. testnets are not optional cosplay.