Saltar para o conteúdo principal
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. 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.
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.

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 webhook deposit.success com a carteira do agente como senderAddress, não o facilitador que pagou a taxa.
O endereço payTo precisa de uma conta de token USDC antes do primeiro pagamento x402, e um pagamento x402 não consegue criá-la. Um endereço Blockradar ganha sua conta de token na primeira vez que recebe USDC, então envie qualquer valor de USDC para ele primeiro. Habilitar o USDC na carteira não cria a conta por si só.

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ço recipient, 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
O 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ço recipient, 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
Para pagar a taxa de transação do agente por ele, passe um 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 hash de cada webhook deposit.success ao transaction no PAYMENT-RESPONSE (x402) ou ao reference no Payment-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.

Referência API