> ## 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.

# Aceitar Pagamentos de Agentes

> Receba pagamentos de agentes de IA em stablecoins, que chegam à sua carteira Blockradar como depósitos comuns

<Note>
  Em resumo<br />
  Agentes de IA podem pagar por APIs e dados a cada requisição, em stablecoins, por meio de protocolos abertos de pagamento para agentes. Se você vende para agentes, um endereço Blockradar pode receber esses pagamentos. Eles chegam como depósitos comuns, com o webhook habitual e a carteira do agente pagador como remetente, então não há nada novo para integrar do lado da Blockradar.
</Note>

## Protocolos Suportados

| Protocolo | Redes e tokens |
| - | - |
| [x402](https://www.x402.org) | Chains EVM, USDC (EIP-3009) |

<Tip>
  Está construindo o agente que paga? Consulte [Realizar Pagamentos com Agentes](/pt/use-cases/make-agent-payments).
</Tip>

## Pré-requisitos

<Steps>
  <Step title="Chave API">
    Obtenha sua chave API no [Painel da Blockradar](https://dashboard.blockradar.co). Navegue até **Developers** para gerar uma.
  </Step>

  <Step title="Carteira Principal EVM">
    Crie uma carteira principal pelo painel na chain em que você cobra, como a Base (consulte [Criar uma Carteira Principal](/pt/guides/create-master-wallet)).
  </Step>

  <Step title="USDC Habilitado">
    Habilite o USDC na carteira. Sua carteira só detecta depósitos dos ativos que você adicionou. Consulte [Gestão de Ativos](/pt/use-cases/asset-management).
  </Step>

  <Step title="URL de Webhook">
    Configure um endpoint de webhook no seu painel em **Developers → Webhooks** para receber notificações de cada pagamento.
  </Step>
</Steps>

***

## Como o x402 Funciona

O [x402](https://www.x402.org) é um protocolo aberto que permite que uma API cobre por requisição. Sua API responde a uma requisição não paga com HTTP `402 Payment Required` e o preço, o agente repete a requisição com uma autorização de USDC assinada, e um **facilitador** verifica essa autorização e submete a transferência on-chain, pagando o gas. O USDC vai direto da carteira do agente para o seu endereço `payTo`.

Você executa o middleware de servidor do x402 e escolhe o facilitador. A Blockradar é onde o dinheiro chega.

## Receber com x402

<Steps>
  <Step title="Defina um endereço Blockradar como payTo">
    Use o endereço da carteira principal, ou [gere um endereço filho](/pt/api-reference/addresses/generate-address) por produto ou cliente e anexe `metadata` para que cada pagamento seja associado ao que foi comprado. No [Plano de Checkout](/pt/use-cases/checkout#plano-de-checkout), os endereços filhos não estão disponíveis, então use o endereço da carteira principal.
  </Step>

  <Step title="Liquide por meio de um facilitador">
    Aponte seu middleware x402 para um facilitador que suporte sua rede. O [Circle Facilitator Service](https://developers.circle.com/facilitator-service) liquida USDC na Arc, na Base e na Polygon PoS. Use uma chave API da Circle ao configurá-lo.
  </Step>

  <Step title="Receba o pagamento como depósito">
    Quando o facilitador liquida, a transferência de USDC para o seu endereço `payTo` é detectada como qualquer outro depósito e dispara o habitual [webhook `deposit.success`](/pt/use-cases/deposit-stablecoins#payload-do-webhook).
  </Step>
</Steps>

No webhook, `senderAddress` é a **carteira do comprador**, não o facilitador que submeteu a transação, para que você veja quem pagou. O `hash` corresponde ao `transaction` no `PAYMENT-RESPONSE` que seu servidor retornou.

<Tip>
  Pagamentos x402 costumam ser de um centavo ou menos. Se o `payTo` for um endereço filho com a varredura automática ativada, cada pagamento é varrido para a carteira principal separadamente. Defina um [limite de varredura](/pt/use-cases/asset-management) no USDC, ou use o endereço da carteira principal como `payTo`, para não pagar para varrer valores menores do que a taxa de varredura.
</Tip>

***

## Limitações do x402

* **Redes EVM.** Pagamentos em redes x402 não EVM, como Solana, não foram testados com endereços Blockradar.
* **Sem nanopagamentos do Circle Gateway.** A opção de pagamentos em lote abaixo de um centavo da Circle não foi testada com carteiras Blockradar.

***

## Melhores Práticas

* **Um endereço por produto ou cliente.** Gere um endereço filho por recurso pago ou por conta de comprador e marque-o com `metadata`, para que cada webhook de depósito diga o que foi comprado sem uma consulta adicional.
* **Concilie pelo hash.** Associe o `hash` de cada webhook `deposit.success` ao `transaction` que seu servidor retornou no `PAYMENT-RESPONSE`.
* **Teste primeiro na testnet.** Aponte seu middleware para uma rede de testnet, como a Base Sepolia (`eip155:84532`), e pague a si mesmo com USDC de testnet dos [faucets](/pt/use-cases/supported-assets) antes de entrar em produção.

***

## Referência API

| Endpoint | Descrição |
| - | - |
| [Generate Address](/pt/api-reference/addresses/generate-address) | Criar um endereço `payTo` dedicado |
| [Update Address](/pt/api-reference/addresses/update-address) | Ativar ou desativar a varredura automática de um endereço |


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