Clawy / Guias / O que é x402

O que é x402?

Um protocolo aberto que transforma "HTTP 402 Payment Required" — o código de status que ficou sem uso por 30 anos — em pagamentos reais. Permite que um programa pague uma chamada de API com stablecoins, sem conta e sem chave de API.

Hoje, cada API restringe o acesso com uma chave de API que você cria, armazena e cobra contra um plano mensal. Isso funciona para humanos clicando num painel. Para software é atrito — especialmente para agentes de IA que precisam chamar um serviço uma vez, pagar exatamente isso e seguir. O x402 remove a conta por completo: o preço está na resposta e o cliente paga por requisição.

O fluxo, em três passos

O cliente chama o endpoint sem pagamento. O servidor responde 402 Payment Required e inclui o preço e para onde pagar (num cabeçalho).

O cliente assina um pagamento em stablecoin pelo valor exato — normalmente USDC na Base — usando uma autorização EIP-3009 (uma assinatura, sem transação on-chain do cliente).

O cliente repete a mesma requisição com o pagamento assinado num cabeçalho X-PAYMENT. Um facilitador o liquida on-chain e o servidor retorna 200 OK com o resultado.

POST /v1/chat/opus            -> 402  (PAYMENT-REQUIRED: amount=150000, payTo=0x...)
   sign EIP-3009 for 0.15 USDC
POST /v1/chat/opus + X-PAYMENT -> 200  { "choices": [ ... ] }

Por que importa para agentes de IA

Sem cadastro, sem gestão de chaves. Um agente pode descobrir um serviço e pagá-lo de forma autônoma, sem que um humano crie uma conta antes.
Pague exatamente pelo que usa. Uma chamada, um micropagamento — sem mínimo de $20/mês para fazer três requisições.
Descoberta legível por máquina. Os serviços x402 publicam manifestos (`/.well-known/x402.json`, `/llms.txt`) para que agentes os encontrem e consultem preços programaticamente.

É cedo — o ecossistema de agentes que pagam ainda está se formando — mas é a resposta mais limpa que existe hoje para "como um programa paga outro por uma única chamada".

Perguntas comuns

É uma transação de blockchain a cada chamada? O cliente apenas assina; um facilitador agrupa/liquida. O comprador precisa de uma carteira com fundos, não de gas por chamada.

Quanto custa aceitar? Você recebe stablecoins na sua carteira; as taxas do facilitador são pequenas. Sem conta de processador de pagamento nem taxa mensal.

Quais redes? A Base mainnet é a mais comum (USDC); Solana e outras são suportadas por alguns serviços.

→ Chame uma em 5 minutos. Um cliente x402 completo para copiar e colar (Node) que acessa um endpoint ao vivo, assina o pagamento e obtém uma resposta — comece num nível de $0,04.

Quer vender você mesmo uma API com cobrança por chamada? Duas coisas decidem se dá lucro: acertar a integração e precificá-la para que os custos de tokens não comam sua margem.

→ Kit de preços de API de IA (19 €). Um modelo de custo/margem em Excel + código margin-guard pronto para usar para que um preço fixo por chamada nunca custe mais do que você cobra, além de uma calculadora offline e início rápido.