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.
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
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 HTTP402 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. Para a Solana, use um facilitador que suporte Solana.
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.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.
Receber x402 na Solana
Na Solana, o agente assina uma transferência de USDC e o facilitador paga a taxa de rede. O pagamento chega da mesma forma: um webhookdeposit.success com a carteira do agente como senderAddress, não o facilitador que pagou a taxa.
Como o MPP Funciona
O MPP (Machine Payments Protocol) é outro protocolo aberto para pagar por requisição via HTTP. O charge EVM dele é liquidado da mesma forma que o x402: o agente assina uma autorização de USDC EIP-3009 para o seu endereçorecipient, seu servidor a submete on-chain, e o USDC vai direto da carteira do agente para esse endereço. Os cabeçalhos são diferentes (WWW-Authenticate: Payment, Authorization: Payment e Payment-Receipt), mas o depósito que a Blockradar registra é o mesmo.
Receber com MPP
1
Defina um endereço Blockradar como recipient
O MPP chama o endereço de recebimento de
recipient. Use um endereço Blockradar exatamente como faria com o payTo do x402, incluindo a mesma regra do Plano de Checkout.2
Liquide por meio de um facilitador
O servidor oficial
mppx liquida charges EVM por meio de um facilitador x402, então o facilitador que você usa para o x402 também funciona aqui.3
Receba o pagamento como depósito
A transferência liquidada dispara o habitual webhook
deposit.success, com a carteira do agente como senderAddress.JavaScript
reference no Payment-Receipt que seu servidor retorna é o hash da transação on-chain e corresponde ao hash do depósito. A dica de varredura acima também se aplica a pagamentos MPP.
Receber com MPP na Tempo
Um charge MPP na Tempo é uma transferência direta de stablecoin para o seu endereçorecipient, com um memo que a vincula ao desafio. O agente ou o seu servidor a transmite, então nenhum facilitador está envolvido.
1
Habilite o token na sua carteira Tempo
Sua carteira só detecta depósitos dos ativos que você adicionou. Consulte Gestão de Ativos.
2
Defina um endereço Blockradar na Tempo como recipient
Use o endereço da sua carteira principal na Tempo ou um endereço filho (o endereço da carteira principal no Plano de Checkout), e defina
currency como o token que você quer receber: OUSD, USDC.e ou USDT. Os endereços estão no exemplo abaixo. O USDT aparece como USDT0 on-chain.3
Receba o pagamento como depósito
A transferência dispara o habitual webhook
deposit.success, com a carteira do agente como senderAddress.JavaScript
feePayer para tempo.charge(). Use uma chave mantida no seu próprio servidor, não o seu endereço Blockradar: o pagador de taxas coassina cada transação de charge, e a Blockradar não pode coassinar transações na Tempo com pagador de taxas.
Limitações
- Apenas redes EVM e Solana. Pagamentos em outras redes não são suportados.
- Sessões MPP na Tempo chegam em breve. Até lá, as liquidações de sessões não são suportadas.
- Nanopagamentos do Circle Gateway caem em um saldo do Gateway. A Circle liquida esses pagamentos em lote abaixo de um centavo no saldo do Gateway do vendedor, não como uma transferência on-chain para o
payTo, então eles não chegam como depósitos Blockradar e ficam fora do escopo deste guia.
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
hashde cada webhookdeposit.successaotransactionnoPAYMENT-RESPONSE(x402) ou aoreferencenoPayment-Receipt(MPP). - 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.

