--- title: 'HTTP 402 Payment Required: significado, história e x402 | RunAPI' description: O que significa o código de status HTTP 402 Payment Required, por que ficou sem uso por décadas, quando as APIs o retornam hoje, e como o x402 o transforma em um fluxo de pagamento. url: https://runapi.ai/pt-BR/http-402.md canonical: https://runapi.ai/pt-BR/http-402 locale: pt-BR updated: '2026-09-24' date: '2026-09-24' site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/http-402 zh-CN: https://runapi.ai/zh-CN/http-402 es: https://runapi.ai/es/http-402 ja: https://runapi.ai/ja/http-402 de: https://runapi.ai/de/http-402 fr: https://runapi.ai/fr/http-402 pt-BR: https://runapi.ai/pt-BR/http-402 ko: https://runapi.ai/ko/http-402 it: https://runapi.ai/it/http-402 nl: https://runapi.ai/nl/http-402 pl: https://runapi.ai/pl/http-402 tr: https://runapi.ai/tr/http-402 zh-TW: https://runapi.ai/zh-TW/http-402 zh-HK: https://runapi.ai/zh-HK/http-402 ar: https://runapi.ai/ar/http-402 x-default: https://runapi.ai/http-402 --- > HTML version: https://runapi.ai/pt-BR/http-402 > Site index for agents: https://runapi.ai/llms.txt # HTTP 402 Payment Required: o que significa e como o x402 o usa 402 é o código de status HTTP para uma requisição que precisa de pagamento antes que o servidor a atenda. Por boa parte de sua história, não teve um formato padrão. O x402 dá um a ele. _Atualizado September 24, 2026 · 5 min de leitura_ ## Key takeaways - 402 Payment Required é um erro de cliente: a requisição é válida, mas o servidor quer o pagamento primeiro. - O HTTP/1.1 reservou o 402 para uso futuro e nunca definiu como o pagamento deveria funcionar, então cada API o usou de um jeito diferente. - O x402 define as peças que faltavam: um cabeçalho PAYMENT-REQUIRED com termos legíveis por máquina e um pagamento assinado na nova tentativa. ## O que significa 402 Payment Required Uma resposta 402 informa ao cliente que a requisição em si está correta, mas não será atendida até que o pagamento seja feito. Ela pertence à família 4xx porque quem precisa agir em seguida é o cliente, não o servidor. 402 é diferente de 401 Unauthorized e 403 Forbidden. 401 pede credenciais, 403 recusa a requisição de imediato, e 402 pede pagamento. ## Por que o 402 ficou sem uso por tanto tempo O código foi reservado quando o HTTP/1.1 foi escrito, com a expectativa de que alguma forma de dinheiro digital surgiria depois. A especificação nunca disse o que um corpo 402 deveria conter nem como um cliente deveria pagar, então os navegadores nunca agiram sobre ele. Sem um formato compartilhado, as APIs que de fato retornavam 402 o usavam como um erro simples: uma conta sem créditos, um cartão recusado, ou um limite de plano atingido. ## Quando as APIs retornam 402 hoje Você vai encontrar o 402 em duas situações amplas. - Erros de cobrança da conta: a key é válida, mas o saldo, a cota ou a assinatura não cobrem a requisição. A solução é recarregar ou fazer upgrade. - Cotações de pagamento por requisição: o servidor retorna os termos de pagamento, e o cliente pode pagar e tentar novamente a mesma requisição. É assim que o x402 funciona. ## Como o x402 transforma o 402 em um fluxo de pagamento O x402 coloca termos legíveis por máquina em um cabeçalho PAYMENT-REQUIRED: valor, ativo, rede e destinatário. Um cliente assina uma autorização de stablecoin para esses termos, envia de volta em um cabeçalho PAYMENT-SIGNATURE, e recebe a resposta com um recibo PAYMENT-RESPONSE. Como toda a troca é HTTP puro, um agente de IA com uma wallet pode pagar uma chamada de API sem se cadastrar ou armazenar uma API key. ## Lidando com um 402 no seu cliente Verifique primeiro se há um cabeçalho PAYMENT-REQUIRED. Se houver, a resposta é uma cotação x402 que um cliente x402 pode pagar. Se não houver, leia o corpo do erro: geralmente significa que a conta precisa de mais créditos ou de um plano diferente. ## FAQ sobre HTTP 402 ### 402 Payment Required é um erro? É um erro de cliente na faixa 4xx, mas não significa que a requisição estava malformada. Significa que é preciso pagamento antes de o servidor continuar. ### Qual é a diferença entre 402 e 401? 401 significa que o servidor precisa de credenciais válidas. 402 significa que o servidor precisa de pagamento. Uma API pode retornar 401 para uma key inválida e 402 para uma key válida sem saldo. ### Os navegadores tratam o 402 automaticamente? Não. Os navegadores mostram um 402 como qualquer outra página de erro. O pagamento automático precisa de um cliente que entenda um protocolo como o x402. ### Quais APIs usam 402 com x402? Qualquer servidor que implemente o protocolo x402. A RunAPI retorna cotações x402 em seus endpoints de modelos de IA cobrados por chamada, permitindo que um agente pague em USDC pela geração de imagem, vídeo, música e áudio. ## Páginas relacionadas - [API x402 para modelos de IA](https://runapi.ai/pt-BR/x402.md) - Pague por requisição em USDC na Base, sem API key. - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - Todos os modelos e endpoints disponíveis na RunAPI. - [Documentação para desenvolvedores](https://runapi.ai/pt-BR/docs/guides) - Formatos de requisição, consulta de tarefas e códigos de erro. - [Preços](https://runapi.ai/pt-BR/pricing.md) - Créditos, preços por chamada e detalhes de cobrança. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## Experimente um 402 que você realmente consegue pagar Envie uma requisição a um endpoint da RunAPI cobrado por chamada sem uma key e examine a cotação x402 retornada. - [Explorar modelos](https://runapi.ai/pt-BR/models.md) - [Ler a documentação](https://runapi.ai/pt-BR/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/pt-BR/.md) ### Produto - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models#all-models) ### Desenvolvedores - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) ### Guias - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [API x402](https://runapi.ai/pt-BR/x402.md) ### Empresa - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) ### Legal - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Article", "headline": "HTTP 402 Payment Required: significado, história e x402", "description": "O que significa o código de status HTTP 402 Payment Required, por que ficou sem uso por décadas, quando as APIs o retornam hoje, e como o x402 o transforma em um fluxo de pagamento.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR" }, "mainEntityOfPage": "https://runapi.ai/pt-BR/http-402" }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "402 Payment Required é um erro?", "acceptedAnswer": { "@type": "Answer", "text": "É um erro de cliente na faixa 4xx, mas não significa que a requisição estava malformada. Significa que é preciso pagamento antes de o servidor continuar." } }, { "@type": "Question", "name": "Qual é a diferença entre 402 e 401?", "acceptedAnswer": { "@type": "Answer", "text": "401 significa que o servidor precisa de credenciais válidas. 402 significa que o servidor precisa de pagamento. Uma API pode retornar 401 para uma key inválida e 402 para uma key válida sem saldo." } }, { "@type": "Question", "name": "Os navegadores tratam o 402 automaticamente?", "acceptedAnswer": { "@type": "Answer", "text": "Não. Os navegadores mostram um 402 como qualquer outra página de erro. O pagamento automático precisa de um cliente que entenda um protocolo como o x402." } }, { "@type": "Question", "name": "Quais APIs usam 402 com x402?", "acceptedAnswer": { "@type": "Answer", "text": "Qualquer servidor que implemente o protocolo x402. A RunAPI retorna cotações x402 em seus endpoints de modelos de IA cobrados por chamada, permitindo que um agente pague em USDC pela geração de imagem, vídeo, música e áudio." } } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://runapi.ai/pt-BR" }, { "@type": "ListItem", "position": 2, "name": "HTTP 402", "item": "https://runapi.ai/pt-BR/http-402" } ] } ] ```