El Agente Llama a la API Protegida
`GET /v1/intelligence` llega sin un token de licencia ES256 `Authorization: Bearer` ni recibo de sesión pagada.
Convierta cualquier REST API o endpoint MCP en un muro de pago automonetizable.
Las tarjetas de crédito fallan por debajo de $1.00 y bloquean a los agentes de IA autónomos sin tarjetas corporativas. XPayr lleva HTTP `402 Payment Required` a producción: desafíe a los llamadores no autenticados con una sesión de stablecoin no custodial, liquide el 99.5% en Base, Solana, Arbitrum, TRON o Circle Arc y verifique tokens sin estado ES256 JWT de acceso en menos de un milisegundo en middleware de borde.
El Servidor Emite HTTP 402
El middleware crea o referencia un SKU de checkout/licencia de XPayr y devuelve `402 Payment Required` + metadatos `X-Payment-Required`.
El Agente Liquida en Stablecoin
El agente valida los guardarraíles vía `@xpayr/mcp-server` (`POST /api/mcp`), paga con USDC/USDT (99.5% directo a la billetera del comercio) y recibe un JWT ES256.
Verificación JWKS en Submilisegundos
El agente reintenta con `Authorization: Bearer <jwt>`. El middleware de borde verifica ES256 contra `/.well-known/jwks.json` sin conexión y responde `200 OK`.
1. Carga Útil Estándar del Desafío 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. Middleware Node.js / Edge (`@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'
});
}
Preguntas Frecuentes — HTTP 402 y Muros de Pago Agénticos
¿Cómo implementa XPayr HTTP 402 Payment Required para APIs y agentes de IA?
Cuando un cliente no autenticado o agente de IA llama a su endpoint protegido sin un token de licencia ES256 válido de XPayr o prueba de sesión pagada, su middleware devuelve HTTP 402 con un JSON de desafío de pago de XPayr (y cabeceras WWW-Authenticate / X-Payment-Required). Una vez pagado en Base, Solana, Arbitrum, TRON o Circle Arc, el cliente recibe un JWT ES256 firmado criptográficamente y verificable sin conexión vía https://xpayr.com/.well-known/jwks.json.
¿Añade latencia a cada llamada API la verificación de un token portador HTTP 402?
Se requieren cero viajes de red por solicitud. Su edge worker o backend almacena en caché la clave pública P-256 de XPayr desde /.well-known/jwks.json y verifica localmente la firma ES256 JWT en menos de 0.2 milisegundos.
¿Cómo pueden los agentes autónomos de IA pagar automáticamente un desafío HTTP 402?
Los agentes conectados a @xpayr/mcp-server (o POST https://xpayr.com/api/mcp) inspeccionan el desafío 402, comprueban su política de Guardarraíles de Agente Comercial (/tools/ai-agent-policy-simulator), ejecutan o solicitan aprobación para la intención de pago en stablecoin y reintentan la solicitud con la cabecera resultante Authorization: Bearer <es256_license_jwt>.
¿Dónde se aloja el manifiesto de descubrimiento x402 legible por máquina de XPayr?
Consulte https://xpayr.com/.well-known/x402.json junto con https://xpayr.com/.well-known/agents.json y https://xpayr.com/.well-known/mcp.json.