Skip to main content
En resumen
Los agentes de IA pueden pagar APIs y datos por solicitud, en stablecoins, mediante protocolos abiertos de pago para agentes. Si vende a agentes, una dirección de Blockradar puede recibir esos pagos. Llegan como depósitos ordinarios, con el webhook habitual y la billetera del agente que paga como remitente, así que no hay nada nuevo que integrar del lado de Blockradar.

​
Protocolos Compatibles

¿Está creando el agente que paga? Consulte Realizar Pagos con Agentes.

​
Requisitos Previos

1

Clave API

Obtenga su clave API desde el Panel de Blockradar. Diríjase a Developers para generar una.
2

Billetera Principal EVM

Cree una billetera principal en el panel en la cadena en la que cobra, como Base (consulte Crear una Billetera Principal).
3

USDC Habilitado

Habilite USDC en la billetera. Su billetera solo detecta depósitos de activos que haya agregado. Consulte Gestión de Activos.
4

URL de Webhook

Configure un endpoint de webhook en su panel en Developers → Webhooks para recibir una notificación de cada pago.

​
Cómo Funciona x402

x402 es un protocolo abierto que permite a una API cobrar por solicitud. Su API responde a una solicitud no pagada con HTTP 402 Payment Required y el precio, el agente reintenta con una autorización de USDC firmada, y un facilitador verifica esa autorización y envía la transferencia en cadena, pagando el gas. El USDC se mueve directamente de la billetera del agente a su dirección payTo. Usted ejecuta el middleware de servidor de x402 y elige el facilitador. Blockradar es donde llega el dinero.

​
Cobrar con x402

1

Establezca una dirección de Blockradar como payTo

Use la dirección de la billetera principal, o genere una dirección hija por producto o cliente y adjunte metadata para que cada pago se asocie con lo que se compró. En el Plan de Checkout las direcciones hijas no están disponibles, así que use la dirección de la billetera principal.
2

Liquide a través de un facilitador

Apunte su middleware de x402 a un facilitador que admita su red. El Circle Facilitator Service liquida USDC en Arc, Base y Polygon PoS. Use una clave API de Circle al configurarlo.
3

Reciba el pago como un depósito

Cuando el facilitador liquida, la transferencia de USDC a su dirección payTo se detecta como cualquier otro depósito y dispara el habitual webhook deposit.success.
En el webhook, senderAddress es la billetera del comprador, no el facilitador que envió la transacción, para que pueda ver quién pagó. hash coincide con el transaction del PAYMENT-RESPONSE que devolvió su servidor.
Los pagos x402 suelen ser de un centavo o menos. Si payTo es una dirección hija con el barrido automático activado, cada pago se barre a la billetera principal por separado. Configure un umbral de barrido para USDC, o use la dirección de la billetera principal como payTo, para no pagar por barrer montos menores que la comisión de barrido.

​
Limitaciones de x402

  • Redes EVM. Los pagos en redes x402 no EVM, como Solana, no se han probado con direcciones de Blockradar.
  • Sin nanopagos de Circle Gateway. La opción de pagos por lotes de menos de un centavo de Circle no se ha probado con billeteras de Blockradar.

​
Mejores Prácticas

  • Una dirección por producto o cliente. Genere una dirección hija por recurso de pago o por cuenta de comprador y etiquétela con metadata, para que cada webhook de depósito le indique qué se compró sin necesidad de consultarlo.
  • Concilie por hash. Haga coincidir el hash de cada webhook deposit.success con el transaction que su servidor devolvió en PAYMENT-RESPONSE.
  • Pruebe primero en testnet. Apunte su middleware a una red de testnet, como Base Sepolia (eip155:84532), y páguese a sí mismo con USDC de testnet de los faucets antes de pasar a producción.

​
Referencia API