¿Qué es x402?
x402 es un protocolo de pagos máquina a máquina construido alrededor de HTTP402 Payment Required. Permite a los agentes de IA pagar automáticamente por el acceso a APIs sin intervención humana. AgentWallex implementa x402 v2 con payloads de autorización EIP-3009.
Encabezados x402 v2
El protocolo utiliza tres encabezados HTTP:Flujo de pago
1
El agente solicita un recurso
El agente envía una solicitud HTTP estándar a un endpoint de API de pago.
2
El servidor devuelve 402
La API responde con HTTP 402 y un encabezado
PAYMENT-REQUIRED que contiene detalles de precios (monto, token, cadena, dirección payTo).3
El agente paga mediante AgentWallex
El agente envía los detalles del pago a
POST /x402/pay. AgentWallex evalúa las políticas y firma el pago.4
El agente reintenta con prueba de pago
El agente reintenta la solicitud original con el encabezado
PAYMENT-SIGNATURE adjunto.5
El servidor verifica y responde
La API verifica la firma de pago (mediante el facilitador de AgentWallex) y devuelve el recurso.
Uso de APIs x402
Verificar si una URL soporta x402
Crear un presupuesto de sesión
Las sesiones le permiten preautorizar un presupuesto de gasto para llamadas repetidas a la API:Activar negociación de pago
payment_info con:
Integración con SDK
Interceptor HTTP automático
El SDK de TypeScript proporciona un interceptor que maneja el flujo completo x402 automáticamente:Flujo manual
Para proveedores de servicios
Si usted expone APIs de pago, su servidor debe devolver un desafío x402 v2 cuando falte el pago.Devolver 402 con PAYMENT-REQUIRED
Codifique un desafío JSON (base64) en el encabezadoPAYMENT-REQUIRED: