# API para agentes: pagamento por chamada com x402

Conheça a porta paga da RN para agentes sem cadastro. Veja o desafio 402, a autorização de gasto e a diferença para uma chave de organização.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Descubra o preço antes de autorizar o gasto

Um agente pode consultar o catálogo e escolher uma rota que ofereça pagamento por chamada. Sem pagamento, essa porta responde 402 com as condições aceitas. O cliente precisa interpretar a oferta e obter autorização para o valor antes de pagar.

A RN usa x402 com USDC na Base nas rotas que oferecem essa opção. Nem toda operação administrativa ou conexão privada vira uma chamada pública paga. Confira a autorização específica do endpoint em /openapi.json.


## Pagamento e organização resolvem problemas diferentes

O pagamento autoriza o recurso vendido naquela rota. Ele não concede acesso a arquivos privados de outra organização, não cadastra conexões e não muda políticas de privacidade. Para usar um pool privado, o consumidor continua precisando do escopo e das permissões exigidos.

No chat pago por uso, a reserva cobre o teto autorizado e a liquidação considera o consumo informado. Um job assíncrono retorna os dados para acompanhar sua execução. Guarde o identificador e consulte o estado; não trate um timeout como autorização para comprar o mesmo trabalho de novo.


## Integre o cliente com orçamento explícito

Use um cliente que compreenda o desafio e o comprovante de pagamento da versão oferecida pelo servidor. Defina um teto por ação e uma política para recusas. Uma mensagem de um modelo pedindo pagamento não é autoridade suficiente para movimentar a carteira.

No MCP, consulte as ferramentas e seu contrato. O transporte direto pode representar o desafio de pagamento dentro do resultado da ferramenta. Não presuma que o formato do HTTP é idêntico ao do MCP. O painel com conta, teste grátis e Pix continua sendo a entrada para pessoas.


## Perguntas frequentes

Preciso criar conta para toda chamada de agente?

As rotas que oferecem x402 permitem comprar a chamada sem cadastro. Conexões privadas e administração mantêm suas exigências próprias de autorização.

Pagar permite acessar o pool de qualquer organização?

Não. Pagamento não substitui isolamento, permissões, consentimentos ou a exigência de privacidade da organização.


- [Autorização e pagamento por rota](https://rota-nacional.ia.br/openapi.json)
- [Índice da API da RN](https://rota-nacional.ia.br/api/)

[Ver rotas e condições](https://rota-nacional.ia.br/pt/docs/)

[API para agentes: pagamento por chamada com x402](https://rota-nacional.ia.br/pt/artigos/agentes-ia-pagamento-x402/)