Ajan Korumalı API'yi Çağırır
`GET /v1/intelligence` isteği bir `Authorization: Bearer` ES256 lisans belirteci veya ödenmiş oturum makbuzu olmadan ulaşır.
Herhangi bir REST API veya MCP uç noktasını kendi kendini gelirleştiren bir ödeme duvarına dönüştürün.
Kredi kartları $1.00 altında başarısız olur ve kurumsal kartı olmayan otonom AI ajanlarını engeller. XPayr, HTTP `402 Payment Required` standardını canlı üretime taşır: kimliği doğrulanmamış çağrılara gözetimsiz stablecoin oturumu sunun, 99.5% payı Base, Solana, Arbitrum, TRON veya Circle Arc üzerinde kesinleştirin ve durumsuz (stateless) ES256 JWT erişim belirteçlerini milisaniye altı uç (edge) ara katmanında doğrulayın.
Sunucu HTTP 402 Döndürür
Ara katman bir XPayr ödeme/lisans SKU'su oluşturur veya referans verir ve `402 Payment Required` + `X-Payment-Required` üst verisini döndürür.
Ajan Stablecoin Ödemesini Tamamlar
Ajan, korkuluk kurallarını `@xpayr/mcp-server` (`POST /api/mcp`) üzerinden doğrular, USDC/USDT öder (99.5% doğrudan üye iş yeri cüzdanına) ve bir ES256 JWT alır.
Milisaniye Altı JWKS Doğrulaması
Ajan isteği `Authorization: Bearer <jwt>` ile yeniden dener. Uç (edge) ara katmanı ES256 imzasını `/.well-known/jwks.json` karşısında çevrimdışı doğrular ve `200 OK` sunar.
1. Standart HTTP `402 Payment Required` Ödeme İsteği Yükü
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 Ara Katmanı (`@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'
});
}
Sıkça Sorulan Sorular — HTTP 402 ve Ajan Ödeme Duvarları
XPayr, API'ler ve AI ajanları için HTTP 402 Payment Required akışını nasıl uygular?
Kimliği doğrulanmamış bir istemci veya AI ajanı geçerli bir XPayr ES256 lisans belirteci ya da ödenmiş oturum kanıtı olmadan korumalı uç noktanızı çağırdığında, ara katmanınız (middleware) XPayr ödeme meydan okuma JSON yüküyle (ve WWW-Authenticate / X-Payment-Required başlıklarıyla) HTTP 402 döndürür. Base, Solana, Arbitrum, TRON veya Circle Arc üzerinde ödeme yapıldığında istemci, https://xpayr.com/.well-known/jwks.json üzerinden çevrimdışı doğrulanabilen kriptografik imzalı bir ES256 JWT alır.
Bir HTTP 402 taşıyıcı (bearer) belirtecini doğrulamak her API çağrısına gecikme ekler mi?
İstek başına sıfır ağ gidiş-dönüşü gerekir. Uç çalışanınız (edge worker) veya arka ucunuz, XPayr'ın açık P-256 anahtarını /.well-known/jwks.json adresinden önbelleğe alır ve ES256 JWT imzasını yerel olarak 0,2 milisaniyenin altında doğrular.
Otonom AI ajanları bir HTTP 402 ödeme isteğini otomatik olarak nasıl ödeyebilir?
@xpayr/mcp-server paketine (veya POST https://xpayr.com/api/mcp uç noktasına) bağlı ajanlar 402 yanıtını inceler, Üye İş Yeri Ajan Korkuluk politikasını (/tools/ai-agent-policy-simulator) kontrol eder, stablecoin ödeme niyetini yürütür ya da onaya sunar ve elde edilen Authorization: Bearer <es256_license_jwt> başlığıyla isteği yeniden dener.
XPayr'ın makine tarafından okunabilir x402 keşif bildirimi (manifest) nerede barındırılır?
https://xpayr.com/.well-known/agents.json ve https://xpayr.com/.well-known/mcp.json ile birlikte https://xpayr.com/.well-known/x402.json adresini inceleyebilirsiniz.