Agent ruft geschützte API auf
`GET /v1/intelligence` trifft ohne `Authorization: Bearer`-ES256-Lizenztoken oder bezahlten Sitzungsbeleg ein.
Verwandeln Sie jeden REST-API- oder MCP-Endpunkt in eine selbstmonetarisierende Paywall.
Kreditkarten scheitern unter $1.00 und blockieren autonome KI-Agenten ohne Firmenkarte. XPayr bringt HTTP `402 Payment Required` in den Produktivbetrieb: Fordern Sie nicht authentifizierte Aufrufer mit einer nicht-verwahrenden Stablecoin-Sitzung auf, rechnen Sie 99.5% auf Base, Solana, Arbitrum, TRON oder Circle Arc ab und prüfen Sie zustandslose ES256 JWT -Zugriffstoken im Sub-Millisekunden-Bereich direkt in der Edge-Middleware.
Server sendet HTTP 402
Die Middleware erstellt oder referenziert eine XPayr-Checkout-/Lizenz-SKU und liefert `402 Payment Required` + `X-Payment-Required`-Metadaten zurück.
Agent begleicht Stablecoin-Zahlung
Der Agent prüft die Guardrails über `@xpayr/mcp-server` (`POST /api/mcp`), zahlt in USDC/USDT (99.5% direkt an die Händler-Wallet) und erhält ein ES256-JWT.
Sub-ms JWKS-Verifizierung
Der Agent wiederholt den Aufruf mit `Authorization: Bearer <jwt>`. Die Edge-Middleware prüft ES256 offline gegen `/.well-known/jwks.json` und liefert `200 OK`.
1. Standard-Challenge-Payload für HTTP `402 Payment Required`
HTTP/1.1 402 Payment Required
Content-Type: application/json
WWW-Authenticate: XPayr402 realm="api.merchant.example", jwks="https://xpayr.com/.well-known/jwks.json"
X-Payment-Required: protocol="xpayr-x402-v1", amount="5.00", currency="USD", fee_bps="50"
{
"error": "payment_required",
"protocol": "xpayr-x402-v1",
"amount": "5.00",
"currency": "USD",
"accepted_rails": ["base:USDC", "solana:USDC", "arbitrum:USDT", "tron:USDT", "arc-testnet:USDC"],
"checkout_url": "https://xpayr.com/buy/pro-api-pass",
"mcp_endpoint": "https://xpayr.com/api/mcp",
"mcp_tool": "xpayr_create_payment_session",
"jwks_uri": "https://xpayr.com/.well-known/jwks.json"
}
2. Node.js- / Edge-Middleware (`@xpayr/extension-kit` v0.2.0)
import { createRemoteJWKSet, jwtVerify } from 'jose';
const XPAYR_JWKS = createRemoteJWKSet(
new URL('https://xpayr.com/.well-known/jwks.json')
);
export async function requireXpayr402(req, res, next) {
const token = (req.headers.authorization || '').replace(/^Bearer\s+/i, '');
if (token) {
try {
const { payload } = await jwtVerify(token, XPAYR_JWKS, { algorithms: ['ES256'] });
req.xpayrEntitlement = payload;
return next();
} catch (_) { /* expired or invalid token -> emit 402 below */ }
}
return res.status(402)
.set('WWW-Authenticate', 'XPayr402 jwks="https://xpayr.com/.well-known/jwks.json"')
.json({
error: 'payment_required',
protocol: 'xpayr-x402-v1',
checkout_url: 'https://xpayr.com/buy/api-credits-10k',
mcp_endpoint: 'https://xpayr.com/api/mcp'
});
}
Häufig gestellte Fragen — HTTP 402 & Agentic Paywalls
Wie implementiert XPayr HTTP 402 Payment Required für APIs und KI-Agenten?
Ruft ein nicht authentifizierter Client oder KI-Agent Ihren geschützten Endpunkt ohne gültiges XPayr-ES256-Lizenztoken oder bezahlten Sitzungsnachweis auf, gibt Ihre Middleware HTTP 402 samt XPayr-Zahlungs-Challenge-JSON (sowie WWW-Authenticate- / X-Payment-Required-Headern) zurück. Nach Zahlung auf Base, Solana, Arbitrum, TRON oder Circle Arc erhält der Client ein kryptografisch signiertes ES256-JWT, das offline über https://xpayr.com/.well-known/jwks.json verifizierbar ist.
Verursacht die Prüfung eines HTTP 402-Bearer-Tokens zusätzliche Latenz bei jedem API-Aufruf?
Pro Anfrage sind keinerlei Netzwerk-Roundtrips erforderlich. Ihr Edge-Worker oder Backend speichert XPayrs öffentlichen P-256-Schlüssel aus /.well-known/jwks.json im Cache und prüft die ES256-JWT-Signatur lokal in unter 0.2 Millisekunden.
Wie können autonome KI-Agenten eine HTTP 402-Challenge automatisch begleichen?
Mit @xpayr/mcp-server (oder POST https://xpayr.com/api/mcp) verbundene Agenten werten die 402-Challenge aus, prüfen ihre Händler-Guardrail-Richtlinie (/tools/ai-agent-policy-simulator), führen den Stablecoin-Zahlungsauftrag aus oder fordern eine Freigabe an und wiederholen die Anfrage mit dem resultierenden Header Authorization: Bearer <es256_license_jwt>.
Wo wird das maschinenlesbare x402-Discovery-Manifest von XPayr bereitgestellt?
Prüfen Sie https://xpayr.com/.well-known/x402.json zusammen mit https://xpayr.com/.well-known/agents.json und https://xpayr.com/.well-known/mcp.json.