Um projeto robusto, moderno e fácil de entender para integrar Node.js com a API do Mercado Pago!
Este repositório serve como um template completo para integração com a API do Mercado Pago usando Node.js, TypeScript e Fastify. O objetivo é simplificar a vida de quem precisa lidar com pagamentos, webhooks e preferências, entregando uma base sólida, extensível e bem documentada.
💡 Por que Node.js?
Apesar de usar Next.js em muitos projetos, a complexidade da API do Mercado Pago e a necessidade de controle total do backend me fizeram optar por Node.js puro.
A maioria dos tutoriais disponíveis são para Next.js e deixam a desejar em arquitetura e clareza.
<style> .stack-list { list-style: none; padding: 0; margin-top: 10px; } .stack-list li { display: flex; align-items: center; margin-bottom: 8px; } .stack-list img { margin-right: 8px; } </style>
Stack principal
-
Node.js — Backend rápido e eficiente
-
TypeScript — Tipagem estática
-
Fastify — Framework web performático
-
Zod — Validação de dados
-
Swagger — Documentação automática
-
Mercado Pago API — Integração completa
-
Docker — Ambientes isolados
-
Ngrok — Testes de webhooks
.svg){kind=small}
src/
routes/ # Rotas da API (pagamento, preferência, etc.)
services/ # Integração e regras de negócio
schemas/ # Validação com Zod
middlewares/ # Middlewares customizados
lib/ # Bibliotecas auxiliares (Mercado Pago, Ngrok)
config/ # Configurações
errors/ # Tratamento de erros
types/ # Tipagens
utils/ # Funções utilitárias
docker-compose.yaml & dockerfile # Containers
README.md # Instruções gerais
Fornecer uma base clara, moderna e extensível para projetos que utilizam a API do Mercado Pago, facilitando a integração e o entendimento da arquitetura para devs de todos os níveis.
Tutoriais detalhados estarão disponíveis em arquivos README específicos para cada funcionalidade.
Contribuições são super bem-vindas! Abra uma issue ou pull request para sugerir melhorias.
|
Feito com ❤️ por Victor Lis Bronzo
Meu LinkedIn |