Seu guia completo para o protocolo HTTP 402 e x402: documentação, tutoriais, whitepapers e recursos para desenvolvedores.
Seja você um desenvolvedor que deseja implementar APIs de pagamento por uso, um criador de conteúdo que deseja monetizar seu trabalho ou um desenvolvedor de agentes de IA criando recursos de pagamento autônomos, este hub de recursos tem tudo o que você precisa para começar com o x402 e HTTP 402.
O protocolo x402 transforma o código de status HTTP 402, há muito tempo inativo, em um mecanismo de pagamento poderoso e prático. Abaixo, você encontrará documentação oficial, amostras de código, guias de integração e recursos da comunidade organizados por tópico e nível de proficiência.
Novo no x402? Comece aqui para entender o básico e ter sua primeira integração funcionando em minutos.
Uma introdução abrangente ao protocolo x402, incluindo recursos da V2, autenticação de carteira e suporte multi-chain.
Uma análise profunda da história do código de status HTTP 402, como ele se compara a outros códigos e por que ele é finalmente útil.
Guia passo a passo para usuários: configurar sua carteira, obter USDC e fazer seu primeiro pagamento x402.
Recursos autorizados da equipe do protocolo x402 e de órgãos de padrões web.
Visão geral do protocolo, atualizações do ecossistema, demonstrações ao vivo e guias de integração. Sua principal fonte de notícias e anúncios do x402.
Especificação técnica completa cobrindo o design do protocolo, detalhes do fluxo de trabalho, considerações de segurança e diretrizes de implementação.
Implementações de referência de código aberto, código SDK, aplicativos de exemplo e diretrizes de contribuição.
Bibliotecas e ferramentas para ajudá-lo a integrar o x402 em seus aplicativos de forma rápida e segura.
| Linguagem | Nome do Pacote | Descrição |
|---|---|---|
| Node.js | @x402/server |
Middleware Express/Fastify para proteger endpoints com um gateway de pagamento 402. |
| Python | x402-python |
Decoradores Django/Flask para adicionar requisitos de pagamento às suas views. |
| Go | x402-go |
Middleware HTTP para frameworks web Go. |
| Rust | x402-rs |
Middleware Actix/Axum com validação de pagamento assíncrona. |
| Plataforma | Nome do Pacote | Descrição |
|---|---|---|
| JavaScript/TypeScript | @x402/client |
Cliente de navegador e Node.js para lidar com respostas 402 e assinaturas de carteira. |
| React | @x402/react |
React hooks e componentes para fluxos de pagamento. |
| Python | x402-requests |
Extensão da biblioteca Requests com tratamento automático do 402. |
Tutoriais passo a passo para cenários comuns de integração.
Aprenda como adicionar preços pay-per-call à sua API REST ou GraphQL. Abrange limites de taxa, níveis de preços e análise de uso.
Implemente micropagamentos para artigos, vídeos ou downloads sem a necessidade de assinaturas.
Permita que agentes autônomos acessem recursos pagos e façam pagamentos sem intervenção humana.
Aceite pagamentos em várias blockchains, incluindo Ethereum, Base, Polygon e Arbitrum.
Documentação oficial de padrões web sobre códigos de status HTTP e protocolos de pagamento.
Referência completa da Mozilla Developer Network sobre o código de status 402, incluindo compatibilidade de navegador e notas de uso.
A especificação IETF oficial para HTTP, incluindo a definição do 402 como um código de status reservado.
Contexto histórico, cronograma de desenvolvimento do 402 e visão geral das tentativas de implementação ao longo dos anos.
Um site de referência rápida para todos os códigos de status HTTP com explicações e códigos relacionados.
Entenda a camada de pagamento que impulsiona as transações x402.
Documentação oficial do USDC, a stablecoin atrelada ao dólar usada no pagamento x402. Saiba mais sobre reservas, auditorias e chains suportadas.
Documentação técnica para integrar o USDC, incluindo referências de API, SDKs e melhores práticas.
O x402 suporta USDC em várias redes para máxima flexibilidade.
Jornadas de aprendizado estruturadas com base em seu papel e objetivos.
Conecte-se com a comunidade x402 e obtenha ajuda quando precisar.
Faça perguntas, compartilhe suas implementações e discuta melhorias no protocolo com a comunidade.
Perguntas e respostas técnicas sobre problemas de implementação do x402. Use a tag [x402] para
visibilidade.
Siga @x402protocol para anúncios, dicas e notícias do ecossistema.
Tem perguntas sobre esta documentação? Envie-nos um e-mail para [email protected].
Entenda como o x402 se compara às opções de integração de pagamento existentes.
| Recurso | x402 | Stripe/PayPal | Pagamentos Cripto Manuais |
|---|---|---|---|
| Micropagamentos (menos de US$ 1) | ✅ Eficiente | ❌ Taxas altas | ⚠️ Gas variável |
| Sem necessidade de conta | ✅ Apenas carteira | ❌ Conta obrigatória | ✅ Apenas carteira |
| Máquina a Máquina (M2M) | ✅ Suporte nativo | ❌ Não suportado | ⚠️ Complexo |
| Nativo de HTTP | ✅ Código de status 402 | ❌ Redirecionamentos | ❌ Fluxos personalizados |
| Acesso Global | ✅ Permissionless | ⚠️ Restrições regionais | ✅ Permissionless |
| Liquidação Imediata | ✅ Blockchain | ❌ Dias de atraso | ✅ Blockchain |
Considerações essenciais de segurança ao implementar o x402.
Acompanhe e otimize sua implementação de pagamento x402.
Sim, o x402 V2 está pronto para produção e sendo usado por vários aplicativos. O protocolo é apoiado pela Coinbase e passou por testes extensivos.
As taxas dependem da blockchain usada. Base e Polygon oferecem taxas de menos de um centavo, enquanto a Mainnet Ethereum pode custar vários dólares por transação.
Atualmente, o x402 foca no USDC por simplicidade e conformidade. O suporte a várias moedas está no roadmap.
Os reembolsos são gerenciados no nível do aplicativo. Como os pagamentos são on-chain, você enviaria uma transação separada para reembolsar a carteira do usuário.
O x402 é um protocolo permissionless; nenhum KYC é necessário para os usuários. No entanto, como comerciante, você pode ter obrigações de conformidade dependendo da sua jurisdição.