Saltar al contenido principal

Pagos x402

HTTP tiene un código de estado para pagos desde 1997: 402 Payment Required. Nadie lo usaba porque no existía una forma estándar de pagar de verdad. x402 lo vuelve real: un recurso declara un precio, el cliente paga en USDC on-chain firmando una carga de pago, y el servidor la verifica y la liquida, todo dentro de peticiones HTTP normales. Qopper lo implementa de forma nativa.

El flujo

Cómo se ve un 402

maxAmountRequired va en unidades base de USDC (6 decimales): 10000 = $0.01.

Dónde lo vas a encontrar en Qopper

Por qué le importa a los negocios

  • El pagador no necesita cuenta de Qopper. Cualquier billetera sirve.
  • Sin contracargos. La liquidación es final.
  • Un solo camino de código para humanos y agentes: al final es HTTP y ya.
La ruta de demostración liquida contra el facilitador público de CDP en Base Sepolia. Para producción, configura tu propia dirección de tesorería (X402_PAY_TO) y la red mediante las variables de entorno que te dé tu operador de Qopper.

Redes soportadas

Qopper puede mantener, pagar y liquidar USDC en estas cadenas. Los depósitos y los retiros funcionan en cualquiera de ellas: Cada cadena tiene su propia dirección de contrato de USDC, así que los fondos deben enviarse en la misma red que la dirección que estás usando — enviar USDC a la cadena equivocada lo pierde y no se puede recuperar. Los flujos de depósito y retiro de la consola muestran estas redes y te dejan elegir. Para la liquidación x402 la red no se elige por petición: cada despliegue liquida en la única red para la que está configurado (X402_NETWORK, o la que implique su entorno de cadena), y el facilitator que uses tiene que soportar esa cadena. El campo network de la respuesta 402 es lo que le dice al pagador dónde liquidar: léelo siempre en vez de darlo por supuesto.