Skip to main content

¿Qué es x402?

x402 es un protocolo de pagos máquina a máquina construido alrededor de HTTP 402 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

La respuesta incluye 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 encabezado PAYMENT-REQUIRED:

Verificar y liquidar

Use los endpoints del facilitador de AgentWallex:

Valores operativos predeterminados