Servicios - x402: la capa de pago para API y agentes de IA

x402 convierte el código de estado HTTP 402, reservado desde hace tanto tiempo, en una vía de pago que funciona: cualquier endpoint de API puede cobrar stablecoins por solicitud, y cualquier cliente, sea una persona o un agente de IA, puede pagar en un solo viaje de ida y vuelta. Lo integramos de principio a fin, desde poner tus endpoints detrás de un pago hasta preparar a tus agentes para gastar.

El protocolo - Los pagos, como parte nativa de HTTP

El código de estado HTTP 402 Payment Required está reservado desde 1997 y nunca se había llegado a usar. x402 por fin lo activa: un estándar abierto, creado en Coinbase y gestionado hoy por la x402 Foundation dentro de la Linux Foundation, que permite a cualquier servidor HTTP cobrar por una solicitud y a cualquier cliente HTTP pagarla, en stablecoins, en un solo viaje de ida y vuelta.

Un servidor que quiere cobrar simplemente responde a una solicitud no pagada con 402 Payment Required y una lista legible por máquinas de los pagos aceptados: el precio, el token (normalmente USDC), la red y la dirección de recepción. El cliente firma una autorización de pago, repite la misma solicitud con un encabezado de pago y recibe el recurso junto con el hash de la transacción on-chain. Sin página de pago, sin crear cuentas, sin provisionar claves de API.

Como todo el intercambio es HTTP estándar, funciona para personas, backends y, sobre todo, para agentes de IA, que pueden tener una wallet y comprar exactamente los datos o el cómputo que necesitan, solicitud a solicitud, sin que una persona tenga que completar un formulario de tarjeta. La liquidación es on-chain (Base, Solana y otras redes), tarda segundos y no tiene ninguna comisión de protocolo.

Comisiones de protocolo en cada pago: $0
Cuentas, claves de API o formularios de tarjeta: 0
Viaje de ida y vuelta HTTP para cobrar en USDC: 1

Cómo funciona por dentro - Una solicitud, un pago, una respuesta

Intervienen tres partes: el comprador (un usuario, un backend o un agente de IA), tu servidor de API y un facilitador, un servicio sin estado que verifica los pagos firmados y los liquida on-chain, de modo que tu servidor nunca toca un nodo de blockchain ni custodia claves.

La firma del comprador es una autorización para mover exactamente la cantidad anunciada de USDC (mediante EIP-3009 transferWithAuthorization), así que los fondos solo se mueven si tu servidor entrega lo prometido, el comprador no paga gas y el facilitador nunca tiene la custodia de nada.

Casos de uso - Qué puedes construir con x402

x402 convierte cualquier llamada HTTP con precio en un producto. Destaca allí donde las suscripciones, la facturación o las comisiones de tarjeta hacen inviables las compras pequeñas o las que realizan máquinas.

Monetización de API. Cobra por llamada en lugar de vender licencias por usuario y cuotas. Una consulta meteorológica por 0,001 $, una llamada de inferencia por 0,01 $, sin infraestructura de facturación que mantener.
Comercio agéntico. Da una wallet a los agentes de IA y podrán comprar datos, herramientas y cómputo de forma autónoma. x402 es la vía de pago detrás de frameworks de agentes y de servidores de herramientas basados en MCP.
Contenido de pago. Vende un solo artículo, conjunto de datos o video por unos centavos a lectores anónimos de todo el mundo, sin obligarlos a crear una cuenta ni a contratar un plan mensual.
Servicios por consumo. Mide cómputo, almacenamiento o ancho de banda y cobra exactamente lo consumido con el esquema upto del protocolo.
Facturación entre máquinas. Microservicios que se pagan entre sí por solicitud, de una empresa a otra, con liquidación en segundos en lugar de facturas a 30 días.
Proxies y agregadores. Encapsula API de pago de terceros, suma tu margen y revéndelas a través de un único endpoint x402 que los agentes pueden descubrir y pagar de forma programática.

Por qué importa - Lo que cambia x402

Las vías de pago tradicionales se diseñaron para personas que compran pasando por un proceso de pago. x402 rediseña la transacción en torno a la propia solicitud.

Sin onboarding. Los compradores solo necesitan una wallet con fondos. Sin registro, sin formulario KYC para una compra de 0,005 $, sin claves de API que provisionar, rotar y acabar filtrando.
Micropagos de verdad. Con las redes de tarjetas, cualquier cobro por debajo de ~1 $ deja de ser rentable. Con transferencias de USDC sin comisiones, los precios de una fracción de centavo se convierten en modelos de negocio viables.
Liquidación instantánea y definitiva. Los fondos llegan a tu wallet en segundos y no admiten contracargos. Sin ciclos de pago de 30 días, sin reserva rotativa, sin la carga de gestionar disputas.
Global por defecto. Un pago en stablecoins funciona igual desde cualquier país, sin adquirentes locales, conversión de divisas ni proveedores de pago limitados por región.
Pensado para máquinas. La respuesta 402 es legible por máquinas, así que el software negocia y paga sin intervención humana. Es la primitiva que le faltaba a la economía de los agentes.
Abierto y neutral. Un estándar abierto de la Linux Foundation, con varios facilitadores, SDK en TypeScript, Go y Python, y sin dependencia de un proveedor ni peajes de protocolo.

Integración - Un vistazo a ambos lados

Vender consiste en añadir un middleware a tu servidor actual. Comprar, en envolver tu cliente HTTP con una wallet. Todo lo demás (el handshake 402, la firma, el reintento, la liquidación) lo gestionan los SDK del protocolo.

Vender: cobrar por un endpoint

server.ts

import express from 'express'
import { paymentMiddleware, x402ResourceServer } from '@x402/express'
import { ExactEvmScheme } from '@x402/evm/exact/server'
import { HTTPFacilitatorClient } from '@x402/core/server'

const app = express()
const facilitator = new HTTPFacilitatorClient({ url: 'https://x402.org/facilitator' })

app.use(
  paymentMiddleware(
    {
      'GET /api/report': {
        accepts: [
          { scheme: 'exact', price: '$0.01', network: 'eip155:8453', payTo: '0xYourAddress' },
        ],
        description: 'Market report, paid per request',
      },
    },
    new x402ResourceServer(facilitator).register('eip155:8453', new ExactEvmScheme()),
  ),
)

app.get('/api/report', (req, res) => res.json({ report: '...' }))

Comprar: pagar por solicitud

client.ts

import { wrapFetchWithPayment } from '@x402/fetch'
import { x402Client } from '@x402/core/client'
import { ExactEvmScheme } from '@x402/evm/exact/client'
import { privateKeyToAccount } from 'viem/accounts'

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY)
const client = new x402Client()
client.register('eip155:*', new ExactEvmScheme(signer))

const fetchWithPayment = wrapFetchWithPayment(fetch, client)

// The 402 response, USDC authorization, and retry are handled for you
const response = await fetchWithPayment('https://api.example.com/api/report')

Lee el tutorial completo: proteger una API de Node.js con x402 y USDC Encuentra tu precio por solicitud con la calculadora de precios x402 gratuita

¿Quieres llevar tu proyecto al siguiente nivel?

Contáctanos hoy para ver cómo podemos ayudarte a alcanzar tus objetivos en el sector blockchain.