· URLGate News

HTTP 402 means Payment Required

Neon 402 typography on a dark grid, with the caption Payment Required and a link icon.

HTTP 402 means Payment Required. The status code has been reserved on the web for decades and barely used. Most sites that charge for a page still invent their own checkout flow, a new account, or an API key.

x402 puts 402 to work. The client requests a resource. The server replies 402 with a price. The client pays in USDC and retries the same request. If the payment verifies, the request goes through. People can do this from a wallet. AI agents can do it over plain HTTP, which is the point: a machine can pay per access without a human clicking a checkout form.

Urlgate wraps any URL in that flow. You get a shortlink on urlgate.xyz. A browser sees a paywall card. An agent sees a PAYMENT-REQUIRED header (x402 v2) and a legacy 402 JSON body. To open a paid link, the client signs two EIP-3009 USDC authorizations in one retry: one for the price (PAYMENT-SIGNATURE) and one for the platform fee (PAYMENT-SIGNATURE-FEE). Urlgate verifies and settles both itself; there is no payment facilitator in the path. New links start at 0.01 USDC by default.

That is a concrete way to monetize links and to paywall a file or an API URL for both people and agents, without building a storefront. It is a pay-per-link model, not a traditional pay-per-click ad.

Put a 402 on your link at urlgate.xyz

Create a paid linkRead as markdown

For agents

Machine-readable summary for AI agents and their builders. Always trust the live 402 challenge and GET https://urlgate.xyz/api/v2/config over any number on this page.

Example (a 0.05 USDC link at 0.3%: 49850 units to the creator, 150 units to URLGate):

GET https://urlgate.xyz/Gp1qJx
Accept: application/json

402 Payment Required
PAYMENT-REQUIRED: base64({ x402Version: 2,
  accepts: [{ scheme: "exact", network: "eip155:8453", amount: "49850", payTo: "0xCreator…", … }],
  extensions: { "platform-fee": { accepts: [{ scheme: "exact", network: "eip155:8453", amount: "150", payTo: "0xURLGate…", … }] } } })

GET https://urlgate.xyz/Gp1qJx
Accept: application/json
PAYMENT-SIGNATURE: base64(PaymentPayload for accepts[0])
PAYMENT-SIGNATURE-FEE: base64(PaymentPayload for extensions["platform-fee"].accepts[0])

200 OK
PAYMENT-RESPONSE: base64(settlement)
{ "destination": "https://…", "receiptUrl": "…" }

FAQ

What is URLGate?

A pay-to-open URL shortener: any URL becomes a short link that people and AI agents unlock by paying USDC over x402.

What does HTTP 402 mean?

HTTP 402 is Payment Required. x402 uses it: the server answers 402 with a price, the client pays in USDC and retries the same request.

Request the link with Accept: application/json and read the x402 v2 challenge in the PAYMENT-REQUIRED header. Sign two USDC authorizations with the same wallet on the same network (PAYMENT-SIGNATURE for the creator, PAYMENT-SIGNATURE-FEE for the 0.3% platform fee) and send both in one retry. URLGate verifies and settles the payment itself; there is no facilitator. A wallet that already paid gets back in with SIGN-IN-WITH-X or a Bearer token, without paying again.

0.01 USDC on this host (the default is 0.01 USDC). The live value is in GET https://urlgate.xyz/api/v2/config.

Which networks does URLGate accept?

USDC on Base (eip155:8453), Polygon (eip155:137), Arbitrum (eip155:42161) on this host. The code supports Base, Base Sepolia, Polygon, Arbitrum. Read accepts[] in the 402, /.well-known/x402 or /api/v2/config for the current list.

The website create form is free. Over the API or MCP, creating links is free within a daily quota when signed in or with an agent key; otherwise the 0.01 USDC creation fee is charged via x402.

All news · RSS