> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Accepter des Paiements par Agents

> Soyez paye par des agents IA en stablecoins, avec des paiements qui arrivent sur votre portefeuille Blockradar comme des depots ordinaires

<Note>
  En bref<br />
  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.
</Note>

## Protocoles pris en charge

| Protocole | Réseaux et tokens |
| - | - |
| [x402](https://www.x402.org) | Chaînes EVM, USDC (EIP-3009) |

<Tip>
  Vous développez l'agent qui paie ? Consultez [Effectuer des Paiements par Agents](/fr/use-cases/make-agent-payments).
</Tip>

## Prérequis

<Steps>
  <Step title="Clé API">
    Obtenez votre clé API depuis le [Tableau de bord Blockradar](https://dashboard.blockradar.co). Naviguez vers **Developers** pour en générer une.
  </Step>

  <Step title="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](/fr/guides/create-master-wallet)).
  </Step>

  <Step title="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](/fr/use-cases/asset-management).
  </Step>

  <Step title="URL de Webhook">
    Configurez un endpoint de webhook dans votre tableau de bord sous **Developers → Webhooks** pour être notifié de chaque paiement.
  </Step>
</Steps>

***

## Fonctionnement de x402

[x402](https://www.x402.org) 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

<Steps>
  <Step title="Définir une adresse Blockradar comme payTo">
    Utilisez l'adresse du portefeuille principal, ou [générez une adresse enfant](/fr/api-reference/addresses/generate-address) par produit ou par client et attachez des `metadata` afin que chaque paiement se rattache à ce qui a été acheté. Avec le [Plan Checkout](/fr/use-cases/checkout#plan-checkout), les adresses enfants ne sont pas disponibles : utilisez l'adresse du portefeuille principal.
  </Step>

  <Step title="Régler via un facilitateur">
    Pointez votre middleware x402 vers un facilitateur qui prend en charge votre réseau. Le [Circle Facilitator Service](https://developers.circle.com/facilitator-service) règle l'USDC sur Arc, Base et Polygon PoS. Utilisez une clé API Circle pour le configurer.
  </Step>

  <Step title="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`](/fr/use-cases/deposit-stablecoins#payload-de-webhook) habituel.
  </Step>
</Steps>

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.

<Tip>
  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](/fr/use-cases/asset-management) 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.
</Tip>

***

## 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](/fr/use-cases/supported-assets) avant de passer en production.

***

## Référence API

| Endpoint | Description |
| - | - |
| [Generate Address](/fr/api-reference/addresses/generate-address) | Crée une adresse `payTo` dédiée |
| [Update Address](/fr/api-reference/addresses/update-address) | Active ou désactive l'auto-sweep pour une adresse |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.