En bref
Les agents IA peuvent payer des API et des données à la requête, en stablecoins, grâce à des protocoles ouverts de paiement par agents. Si vous vendez à des agents, une adresse Blockradar peut recevoir ces paiements. Ils arrivent comme des dépôts ordinaires, avec le webhook habituel et le portefeuille de l’agent payeur comme expéditeur : il n’y a donc rien de nouveau à intégrer côté Blockradar.
Les agents IA peuvent payer des API et des données à la requête, en stablecoins, grâce à des protocoles ouverts de paiement par agents. Si vous vendez à des agents, une adresse Blockradar peut recevoir ces paiements. Ils arrivent comme des dépôts ordinaires, avec le webhook habituel et le portefeuille de l’agent payeur comme expéditeur : il n’y a donc rien de nouveau à intégrer côté Blockradar.
Protocoles pris en charge
Prérequis
1
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Naviguez vers Developers pour en générer une.
2
Portefeuille Principal EVM
Créez un portefeuille principal dans le tableau de bord sur la chaîne sur laquelle vous facturez, comme Base (voir Créer un Portefeuille Principal).
3
USDC Activé
Activez USDC sur le portefeuille. Votre portefeuille ne détecte les dépôts que pour les actifs que vous avez ajoutés. Voir Gestion des Actifs.
4
URL de Webhook
Configurez un endpoint de webhook dans votre tableau de bord sous Developers → Webhooks pour être notifié de chaque paiement.
Fonctionnement de x402
x402 est un protocole ouvert qui permet à une API de facturer à la requête. Votre API répond à une requête non payée avec un HTTP402 Payment Required et le prix, l’agent réessaie avec une autorisation USDC signée, et un facilitateur vérifie cette autorisation et soumet le transfert on-chain, en payant le gas. L’USDC passe directement du portefeuille de l’agent à votre adresse payTo.
Vous exécutez le middleware serveur x402 et choisissez le facilitateur. Blockradar est l’endroit où l’argent arrive.
Être payé avec x402
1
Définir une adresse Blockradar comme payTo
Utilisez l’adresse du portefeuille principal, ou générez une adresse enfant par produit ou par client et attachez des
metadata afin que chaque paiement se rattache à ce qui a été acheté. Avec le Plan Checkout, les adresses enfants ne sont pas disponibles : utilisez l’adresse du portefeuille principal.2
Régler via un facilitateur
Pointez votre middleware x402 vers un facilitateur qui prend en charge votre réseau. Le Circle Facilitator Service règle l’USDC sur Arc, Base et Polygon PoS. Utilisez une clé API Circle pour le configurer. Pour Solana, utilisez un facilitateur qui prend en charge Solana.
3
Recevoir le paiement comme un dépôt
Lorsque le facilitateur règle le paiement, le transfert USDC vers votre adresse
payTo est détecté comme n’importe quel autre dépôt et déclenche le webhook deposit.success habituel.senderAddress est le portefeuille de l’acheteur, et non le facilitateur qui a soumis la transaction, ce qui vous permet de voir qui a payé. hash correspond au transaction du PAYMENT-RESPONSE renvoyé par votre serveur.
Recevoir des paiements x402 sur Solana
Sur Solana, l’agent signe un transfert USDC et le facilitateur paie les frais de réseau. Le paiement arrive de la même manière : un webhookdeposit.success avec le portefeuille de l’agent comme senderAddress, et non le facilitateur qui a payé les frais.
Fonctionnement de MPP
MPP (Machine Payments Protocol) est un autre protocole ouvert de paiement à la requête sur HTTP. Sa charge EVM se règle de la même manière que x402 : l’agent signe une autorisation USDC EIP-3009 vers votre adresserecipient, votre serveur la soumet on-chain, et l’USDC passe directement du portefeuille de l’agent à cette adresse. Les en-têtes diffèrent (WWW-Authenticate: Payment, Authorization: Payment et Payment-Receipt), mais le dépôt enregistré par Blockradar est le même.
Être payé avec MPP
1
Définir une adresse Blockradar comme recipient
MPP appelle l’adresse de réception
recipient. Utilisez une adresse Blockradar exactement comme vous le feriez pour le payTo de x402, y compris avec la même règle du Plan Checkout.2
Régler via un facilitateur
Le serveur officiel
mppx règle les charges EVM via un facilitateur x402 : le facilitateur que vous utilisez pour x402 fonctionne donc ici aussi.3
Recevoir le paiement comme un dépôt
Le transfert réglé déclenche le webhook
deposit.success habituel, avec le portefeuille de l’agent comme senderAddress.JavaScript
reference du Payment-Receipt renvoyé par votre serveur est le hash de la transaction on-chain, et elle correspond au hash du dépôt. L’astuce sur le sweep ci-dessus s’applique aussi aux paiements MPP.
Être payé avec MPP sur Tempo
Une charge MPP sur Tempo est un transfert direct de stablecoins vers votre adresserecipient, accompagné d’un mémo qui le rattache au challenge. L’agent ou votre serveur le diffuse : aucun facilitateur n’intervient donc.
1
Activer le jeton sur votre portefeuille Tempo
Votre portefeuille ne détecte les dépôts que pour les actifs que vous avez ajoutés. Voir Gestion des Actifs.
2
Définir une adresse Blockradar Tempo comme recipient
Utilisez l’adresse de votre portefeuille principal Tempo ou une adresse enfant (l’adresse du portefeuille principal avec le Plan Checkout), et définissez
currency sur le jeton que vous souhaitez recevoir : OUSD, USDC.e ou USDT. Leurs adresses figurent dans l’exemple ci-dessous. USDT apparaît comme USDT0 on-chain.3
Recevoir le paiement comme un dépôt
Le transfert déclenche le webhook
deposit.success habituel, avec le portefeuille de l’agent comme senderAddress.JavaScript
feePayer à tempo.charge(). Utilisez une clé conservée sur votre propre serveur, et non votre adresse Blockradar : le payeur des frais cosigne chaque transaction de charge, et Blockradar ne peut pas cosigner de transactions Tempo avec payeur des frais.
Limites
- Réseaux EVM et Solana uniquement. Les paiements sur les autres réseaux ne sont pas pris en charge.
- Les sessions MPP sur Tempo arrivent bientôt. D’ici là, les règlements de sessions ne sont pas pris en charge.
- Les nanopaiements Circle Gateway arrivent sur un solde Gateway. Circle règle ces paiements groupés inférieurs au centime sur le solde Gateway du vendeur, et non par un transfert on-chain vers
payTo: ils n’arrivent donc pas comme des dépôts Blockradar et sortent du cadre de ce guide.
Bonnes Pratiques
- Une adresse par produit ou par client. Générez une adresse enfant par ressource payante ou par compte acheteur et taguez-la avec
metadata, afin que chaque webhook de dépôt vous indique ce qui a été acheté sans recherche supplémentaire. - Rapprochez par hash. Associez le
hashde chaque webhookdeposit.successautransactiondePAYMENT-RESPONSE(x402) ou à lareferencedePayment-Receipt(MPP). - Testez d’abord sur testnet. Pointez votre middleware vers un réseau testnet, comme Base Sepolia (
eip155:84532), et payez-vous avec de l’USDC testnet provenant des faucets avant de passer en production.

