Saltar al contenido principal
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. Para Solana, use un facilitador que admita Solana.
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.

Recibir x402 en Solana

En Solana, el agente firma una transferencia de USDC y el facilitador paga la comisión de red. El pago llega de la misma forma: un webhook deposit.success con la billetera del agente como senderAddress, no el facilitador que pagó la comisión.
La dirección payTo necesita una cuenta de token USDC antes de su primer pago x402, y un pago x402 no puede crearla. Una dirección de Blockradar obtiene su cuenta de token la primera vez que recibe USDC, así que envíele primero cualquier monto de USDC. Habilitar USDC en la billetera no crea la cuenta por sí solo.

Cómo Funciona MPP

MPP (Machine Payments Protocol) es otro protocolo abierto para pagar por solicitud a través de HTTP. Su cargo EVM se liquida igual que x402: el agente firma una autorización de USDC de EIP-3009 a su dirección recipient, su servidor la envía en cadena y el USDC se mueve directamente de la billetera del agente a esa dirección. Los encabezados son distintos (WWW-Authenticate: Payment, Authorization: Payment y Payment-Receipt), pero el depósito que registra Blockradar es el mismo.

Cobrar con MPP

1

Establezca una dirección de Blockradar como recipient

MPP llama recipient a la dirección que recibe. Use una dirección de Blockradar exactamente como lo haría con payTo en x402, incluida la misma regla del Plan de Checkout.
2

Liquide a través de un facilitador

El servidor oficial mppx liquida los cargos EVM a través de un facilitador de x402, así que el facilitador que usa para x402 también funciona aquí.
3

Reciba el pago como un depósito

La transferencia liquidada dispara el habitual webhook deposit.success, con la billetera del agente como senderAddress.
JavaScript
El reference del Payment-Receipt que devuelve su servidor es el hash de la transacción en cadena, y coincide con el hash del depósito. El consejo sobre el barrido anterior también se aplica a los pagos MPP.

Cobrar con MPP en Tempo

Un cargo de MPP en Tempo es una transferencia directa de stablecoins a su dirección recipient, con un memo que la vincula al desafío. El agente o su servidor la transmite, así que no interviene ningún facilitador.
1

Habilite el token en su billetera de Tempo

Su billetera solo detecta depósitos de activos que haya agregado. Consulte Gestión de Activos.
2

Establezca una dirección de Blockradar en Tempo como recipient

Use la dirección de su billetera principal de Tempo o una dirección hija (la dirección de la billetera principal en el Plan de Checkout), y establezca currency en el token que desea recibir: OUSD, USDC.e o USDT. Sus direcciones están en el ejemplo de abajo. USDT aparece como USDT0 en la cadena.
3

Reciba el pago como un depósito

La transferencia dispara el habitual webhook deposit.success, con la billetera del agente como senderAddress.
JavaScript
Para pagar la comisión de transacción del agente en su nombre, pase un feePayer a tempo.charge(). Use una clave guardada en su propio servidor, no su dirección de Blockradar: el pagador de comisiones firma conjuntamente cada transacción de cargo, y Blockradar no puede firmar conjuntamente transacciones de Tempo con pagador de comisiones.

Limitaciones

  • Solo redes EVM y Solana. Los pagos en otras redes no son compatibles.
  • Las sesiones de MPP en Tempo llegarán pronto. Hasta entonces, las liquidaciones de sesiones no son compatibles.
  • Los nanopagos de Circle Gateway llegan a un saldo de Gateway. Circle liquida estos pagos por lotes de menos de un centavo en el saldo de Gateway del vendedor, no como una transferencia en cadena a payTo, así que no llegan como depósitos de Blockradar y quedan fuera del alcance de esta guía.

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 de PAYMENT-RESPONSE (x402) o el reference de Payment-Receipt (MPP).
  • 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