Skip to main content
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.

​
Protocoles pris en charge

Vous développez l’agent qui paie ? Consultez Effectuer des Paiements par Agents.

​
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 HTTP 402 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.
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.
Dans le webhook, 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.
Les paiements x402 sont souvent d’un centime ou moins. Si payTo est une adresse enfant avec l’auto-sweep activé, chaque paiement est consolidé séparément vers le portefeuille principal. Définissez un seuil de sweep sur USDC, ou utilisez l’adresse du portefeuille principal comme payTo, afin de ne pas payer pour consolider des montants inférieurs aux frais de sweep.

​
Limites de x402

  • Réseaux EVM. Les paiements sur les réseaux x402 non EVM, comme Solana, n’ont pas été testés avec les adresses Blockradar.
  • Pas de nanopaiements Circle Gateway. L’option de paiements groupés inférieurs au centime de Circle n’a pas été testée avec les portefeuilles Blockradar.

​
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 hash de chaque webhook deposit.success au transaction que votre serveur a renvoyé dans PAYMENT-RESPONSE.
  • 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.

​
Référence API