x402 para tu API: cobra a los agentes de IA por llamada, en USDC
Tu API ya funciona. Apunta Payzum hacia ella, pon un precio por llamada y los agentes podrán pagarla solos — sin abrir cuenta, sin factura que perseguir y sin código de protocolo en tu servicio.
USDC en Base · Liquida a tu propia dirección · Sin SDK · Live el mismo día
Lo esencial
- Sin código, sin SDK. Una ruta, tu URL HTTPS existente, un precio y una dirección de Base. Payzum publica la URL x402; tu servicio no se toca.
- Payzum es el proxy, no el facilitator. Emite el 402 y verifica el pago con un facilitator externo —hoy el de Coinbase— y luego reenvía la llamada.
- El dinero nunca es nuestro. El USDC liquida a la dirección que pongas, a través de tu propia cuenta de facilitator.
- Tu API key sigue siendo tuya. Guardas la credencial del origen una vez, cifrada; Payzum la inyecta en las llamadas pagadas y el agente nunca la ve.
- Los agentes pueden encontrarte. Marca un endpoint como descubrible para aparecer en el catálogo — y, vía el facilitator de Coinbase, en el x402 Bazaar.
Un agente de IA no puede darse de alta en tu API
Todo negocio de APIs está montado alrededor de un humano: alguien se registra, obtiene una key, elige un plan, mete una tarjeta y después discute una factura. Eso funcionaba cuando quien llamaba era un desarrollador. No funciona cuando quien llama es un agente que hace noventa segundos decidió que necesita una verificación de sanciones, una geolocalización y una consulta de mercado — y no va a volver a llamarte nunca.
Así que quien construye el agente hace lo único disponible: se preregistra en una docena de APIs, hardcodea una docena de keys y paga una docena de mínimos mensuales por capacidad que casi no usa. Y tú, del otro lado, nunca le vendes a la cola larga de quienes llaman una sola vez, porque tu unidad mínima de venta es una suscripción.
Lo que eso te cuesta
Demanda que no puedes cobrar. Un embudo de registro que filtra justo a los compradores con dinero y sin paciencia. Y una superficie de integración —keys, cuotas, tiers, cobranza— que existe solo porque no había manera de que quien llama simplemente pagara la llamada.
Qué es x402, de una pasada
HTTP tiene un código de estado reservado para esto desde 1997 y nadie podía usarlo, porque la web no tenía forma de adjuntarle dinero a una petición. Las stablecoins cerraron ese hueco; x402 es la convención que las pone a trabajar.
Llama al endpoint, sin pagar
Una petición HTTPS corriente a la URL donde está publicado tu endpoint. Todavía no tiene nada de especial.
Responde 402 Payment Required
El reto lleva el precio exacto en USDC de esa ruta, así que el agente sabe cuánto cuesta la llamada antes de decidir hacerla.
Firma y reintenta
Construye una autorización de transferencia EIP-3009 firmada y repite la petición con una cabecera X-PAYMENT. Firma una autorización en vez de transmitir él mismo una transacción — que es lo que hace viable una llamada de una fracción de centavo.
Verifica con el facilitator
La autorización se valida a través de un facilitator externo. Payzum no la liquida él mismo y nunca se queda con los fondos.
Hace de proxy de la llamada pagada
La petición llega a tu API —con tu propia credencial inyectada si la necesita— y la respuesta vuelve al agente. Tu servicio la atiende como cualquier otra.
Dónde está Payzum — y dónde no
El ecosistema x402 tiene dos trabajos muy distintos, y los proveedores los mezclan constantemente. Esta es la versión honesta.
Payzum es el middleware. No es el facilitator.
El facilitator es la pieza que verifica y liquida el pago on-chain. Payzum no hace ese trabajo: llama a uno externo, hoy el de Coinbase, usando credenciales que pones tú.
Payzum es el proxy delante de tu API. Mantiene el mapeo entre una URL x402 pública y tu endpoint privado, emite el 402 con tu precio, comprueba el pago con el facilitator y reenvía la petición pagada a tu origen con tu credencial adjunta. Ese es todo el rol, y es la razón por la que no tienes que implementar nada.
Ser facilitator es una ambición a futuro, no una afirmación sobre hoy. Si un proveedor te dice otra cosa sobre su propio stack, pregunta con qué claves se liquida el pago.
Por qué esa separación te importa
Porque determina quién tiene tu facturación. La liquidación corre por tu propia cuenta de facilitator, así que el USDC aterriza en la dirección que configuraste y el costo por transacción y el gas se cargan a esa misma cuenta. No hay un saldo de Payzum en el camino, lo que significa que no hay calendario de payouts de Payzum ni nada tuyo que podamos congelar.
Cinco campos y tu API es vendible
Todo lo de abajo es configuración de panel. No hay librería que instalar ni rama que mergear.
Mapea una ruta a la API que ya tienes
Dale a la ruta un path que llamarán los agentes, apúntala a tu URL de API por HTTPS, pon un precio por llamada en USDC y la dirección de Base que debe recibir el dinero. Activa Live cuando quieras que los agentes puedan pagarla.
- Precios distintos por ruta — un screening vale más que un lookup
- Apaga un endpoint sin tocar tu servicio
- Opcionalmente, lístalo en el catálogo de descubrimiento
Tu origen conserva su propia autenticación
Casi nadie quiere exponer un endpoint abierto. Guarda tu API key o bearer token asociado a la ruta —cifrado— y Payzum lo inyecta al reenviar una llamada pagada. Tu servicio autentica la petición exactamente igual que hoy, y el agente nunca ve el secreto con el que se autenticó.
Tu cuenta de facilitator, tu dirección
Elige cómo liquidan los pagos. En mainnet conectas tu propia key de Coinbase Developer Platform: USDC real sobre Base, con el costo por transacción y el gas cargados a esa misma cuenta — la que recibe el dinero. También hay un ajuste gratuito de testnet que liquida en Base Sepolia mediante un facilitator público, para dejar el cableado fino antes de mover nada real.
Una URL que le puedes pasar a un agente
Cada ruta activa recibe una URL x402 pública. Ese string es toda la integración del lado del comprador: un framework de agentes que hable x402 la llamará, recibirá el 402, pagará y obtendrá tu respuesta. Puedes tener varias rutas a distintos precios desde un mismo comercio: un lookup barato y un screening caro, uno al lado del otro.
- Un comercio, muchas rutas con precio
- Precio y origen editables sin desplegar
- Copias la URL, la publicas, listo
¿Quieres una segunda opinión sobre tu precio por llamada?
Cuéntanos qué hace tu API y cuánto vale una llamada para quien la pide, y repasamos qué rutas exponer, cuánto cobrar y si el catálogo de descubrimiento te conviene.
Sin compromiso · Si los agentes aún no son tu comprador, te lo decimos
USDC en Base, y nada en el medio
El activo de liquidación es USDC en Base mainnet: el contrato ERC-20 en 0x8335…2913, con seis decimales. Los seis decimales no son un dato curioso: son la razón por la que una ruta puede costar 0,001 USDC y seguir siendo un pago real y no un error de redondeo, que es toda la premisa económica del precio por llamada.
Los pagos van a la dirección que configuraste, a través de tu propia cuenta de facilitator. Payzum verifica y reenvía; no toma custodia, no agrupa tu facturación y no corre un calendario de payouts que tengas que esperar.
Que te encuentren: el catálogo de descubrimiento
Un endpoint del que nadie sabe no gana nada. Marca una ruta como descubrible y queda listada en el catálogo de descubrimiento; si liquidas con el facilitator de Coinbase, esos metadatos también se publican en el x402 Bazaar del ecosistema — que es donde quienes construyen agentes buscan servicios ya invocables y con precio.
Las APIs que tiene sentido vender por llamada
El patrón: una respuesta acotada, valiosa en el momento en que se pide, e inútil como suscripción para quien la necesita dos veces.
Sanciones y screening AML
Un agente que da de alta a una contraparte necesita un resultado de screening, ahora. Cobrar diez centavos por esa llamada es mejor negocio que intentar venderle una licencia anual de compliance a un software que jamás va a llenar un formulario de compras.
Geo, IP y consultas de identidad
Las respuestas diminutas y de alto volumen —el país desde una IP, la empresa desde un dominio— son la unidad natural de menos de un centavo. Ponles una fracción de centavo y deja que el volumen haga el trabajo en vez de los tiers.
Cotizaciones, tasas y snapshots
Un agente de trading o de research quiere un snapshot en un momento. El precio por llamada encaja con cómo consume datos de verdad mucho mejor que una licencia mensual dimensionada para su hora punta.
Modelos especializados y scoring
Si corres un modelo de nicho —un clasificador, un endpoint de scoring, un extractor afinado a un dominio— x402 lo convierte en algo que el agente de otro equipo puede probar en una sola llamada, sin ninguna relación previa que establecer.
Extracción, OCR y conversión
El trabajo por documento ya se cobra por unidad puertas adentro. Exponerlo por llamada simplemente hace que la facturación tenga la forma del trabajo.
Los clientes que hoy rechazas
Toda API tiene demanda que no puede atender porque la relación mínima viable es demasiado grande. Una ruta por llamada es la forma más barata de averiguar cuánta de esa demanda era real.
Payzum vs API keys y planes vs implementar x402 tú mismo
| Vender una llamada | Payzum x402 | API keys + planes | x402 hecho por ti |
|---|---|---|---|
| Trabajo de tu lado | Configuración en el panel, sin código | Registro, keys, cuotas, facturación, cobranza | Protocolo, integración con facilitator, verificación |
| Venta mínima | Una llamada, fracciones de centavo | Un plan, normalmente mensual | Una llamada, una vez que lo construiste |
| Alta del comprador | Ninguna — el agente simplemente paga | Cuenta, tarjeta, a veces una llamada de ventas | Ninguna |
| Quién liquida | Tu propia cuenta de facilitator | Tu PSP, y después un payout | Tu integración con el facilitator |
| Quién tiene el dinero | Tú — aterriza en tu dirección | El procesador, hasta el payout | Tú |
| Contracargos | Ninguno — el pago es final | Aplican las disputas de tarjeta | Ninguno |
| Tiempo hasta la primera llamada pagada | El mismo día | Lo que tarde tu facturación | Semanas de ingeniería |
Las objeciones que más nos hacen
«Todavía no hay suficientes agentes pagando.»
Puede que sea cierto en tu nicho hoy. Averiguarlo cuesta una entrada en el panel y cero código, y el endpoint que ya corres sigue atendiendo a sus clientes actuales igual que antes. Es una opción barata sobre un mercado que crece.
«No quiero un proxy delante de mi API.»
No estás moviendo tu API: estás publicando una puerta adicional y con precio hacia ella. Tu tráfico actual nunca toca Payzum, y apagar la ruta x402 es un interruptor, no un rollback.
«Tendría que tener cripto.»
Recibes USDC, que sigue al dólar, en una dirección que controlas en Base. Lo que hagas después con eso es tu decisión, y mientras tanto nada de eso lo tenemos nosotros.
«¿Qué impide que abusen del endpoint?»
Cada llamada se paga antes de llegar a tu origen: ese es el sentido del 402. Quien abusa es quien paga, que es un problema muy distinto del que tienes con un endpoint abierto.
x402: preguntas frecuentes
¿Qué es x402?
x402 es un protocolo abierto que revive el código de estado HTTP 402 Payment
Required, que llevaba décadas sin uso. Un cliente llama a un endpoint de pago, el
servidor responde 402 con el precio exacto, el cliente devuelve una autorización de pago
firmada en una cabecera X-PAYMENT y el servidor entrega la respuesta. Le da al
software —y por tanto a los agentes de IA— una forma de pagar una sola llamada sin cuenta,
sin factura y sin un humano en medio.
¿Payzum es el facilitator de x402?
No. Payzum es el middleware delante de tu API, no el facilitator. Emite el reto 402, valida la autorización de pago del agente a través de un facilitator externo —hoy el de Coinbase— y luego hace de proxy de la petición pagada hacia tu origen. Las credenciales del facilitator las pones tú, y la liquidación llega a tu propia dirección.
¿Cuánto código tengo que escribir?
Ninguno. Configuras una ruta, la URL HTTPS del endpoint que ya tienes, un precio por llamada en USDC y la dirección de Base que debe recibir el dinero. Payzum publica una URL x402 para ese mapeo. Tu servicio sigue respondiendo peticiones normales; nunca se entera de que el protocolo existe.
¿Con qué paga exactamente el agente?
Con USDC en Base. El activo de liquidación es el contrato ERC-20 de USDC en Base mainnet, con seis decimales, así que un precio de 0,01 USDC es exactamente un centavo de stablecoin. El agente firma una autorización de transferencia EIP-3009 en vez de enviar él mismo una transacción, que es lo que hace viable una llamada de menos de un centavo.
¿Payzum retiene el dinero?
No. Los pagos liquidan a través de tu propia cuenta de facilitator hacia la dirección que configuraste: la misma cuenta que recibe el USDC carga también el costo por transacción y el gas. Payzum verifica y hace de proxy; nunca toma custodia de los fondos.
Mi API necesita una API key. ¿Sigue funcionando?
Sí, y es el caso normal. Guardas la credencial de tu origen —una API key o un bearer token— asociada al endpoint, cifrada. Cuando entra una llamada pagada, Payzum la inyecta camino a tu origen, así que tu servicio autentica la petición igual que hoy y el agente nunca ve el secreto.
¿Cómo encuentran los agentes mi endpoint?
Puedes marcar un endpoint como descubrible y quedará listado en el catálogo de descubrimiento. Si liquidas con el facilitator de Coinbase, esos metadatos también se publican en el x402 Bazaar del ecosistema, que es donde quienes construyen agentes buscan servicios ya invocables y con precio.
¿Puedo probar antes de cobrar dinero real?
Sí. Junto a la opción de mainnet hay un ajuste gratuito de testnet que liquida en Base Sepolia mediante un facilitator público. Está pensado para desarrollo: el mismo handshake y el mismo cableado, sin USDC real moviéndose mientras dejas el endpoint fino.
Veamos tu API
Veinte minutos sobre lo que realmente corres: qué rutas vale la pena exponer a agentes, cuánto vale una llamada, cómo montar la cuenta de liquidación y si el catálogo de descubrimiento te ayuda. Si los agentes todavía no son tu comprador, te lo decimos.
USDC en Base · Liquida a tu propia dirección · Payzum nunca retiene los fondos