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

​
Protocolos Suportados

Está construindo o agente que paga? Consulte Realizar Pagamentos com Agentes.

​
Pré-requisitos

1

Chave API

Obtenha sua chave API no Painel da Blockradar. Navegue até Developers para gerar uma.
2

Carteira Principal EVM

Crie uma carteira principal pelo painel na chain em que você cobra, como a Base (consulte Criar uma Carteira Principal).
3

USDC Habilitado

Habilite o USDC na carteira. Sua carteira só detecta depósitos dos ativos que você adicionou. Consulte Gestão de Ativos.
4

URL de Webhook

Configure um endpoint de webhook no seu painel em Developers → Webhooks para receber notificações de cada pagamento.

​
Como o x402 Funciona

O x402 é 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

1

Defina um endereço Blockradar como payTo

Use o endereço da carteira principal, ou gere um endereço filho por produto ou cliente e anexe metadata para que cada pagamento seja associado ao que foi comprado. No Plano de Checkout, os endereços filhos não estão disponíveis, então use o endereço da carteira principal.
2

Liquide por meio de um facilitador

Aponte seu middleware x402 para um facilitador que suporte sua rede. O Circle Facilitator Service liquida USDC na Arc, na Base e na Polygon PoS. Use uma chave API da Circle ao configurá-lo.
3

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

​
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 antes de entrar em produção.

​
Referência API