< Gateway de pagamento />
Gateway de pagamentos construído do zero: o case Vennox Pay
Gateway de pagamentos completo: PIX, KYC de sellers, saques, checkout e API com webhooks.
Contexto do cliente
A Vennox Pay é o gateway de pagamentos que a VTA construiu do zero: o seller cria a conta, passa pelo KYC, cadastra produtos, gera links de pagamento ou integra pela API, recebe por PIX, cartão e boleto e saca o saldo pelo painel.
É o projeto que colocou a VTA dos dois lados do webhook. Além de integrar gateways de terceiros (BuckPay, Cakto, Paradise, Stripe e Mercado Pago), a equipe sabe o que acontece do lado de quem processa o pagamento.
O problema
Gateway de pagamento é o tipo de sistema em que cada erro custa dinheiro de verdade: pagamento confirmado duas vezes, saque liberado antes da compensação, webhook que o cliente nunca recebeu. A base precisa ser previsível antes de ser bonita.
O escopo era completo: onboarding com verificação de identidade dos sellers, processamento com PIX, cartão e boleto, saldo disponível e a liberar, saques, checkout hospedado, links de pagamento e uma API pública com webhooks para quem integra.
O que foi construído
01
Onboarding e KYC de sellers
Cadastro da empresa, envio de documentos e aprovação antes de operar. O seller só movimenta dinheiro depois de verificado.
02
Cobrança por PIX, cartão e boleto
Produtos, links de pagamento e checkout hospedado, com a divisão por método de pagamento visível no painel.
03
Saldo, liberação e saques
Saldo disponível para saque, valor a liberar, solicitação de saque e histórico financeiro. O seller sabe o que pode sacar hoje e o que ainda está em compensação.
04
API pública e webhooks
Chaves de API, eventos de pagamento enviados por webhook e painel de integrações. Quem integra a Vennox no próprio sistema recebe a confirmação sem consultar extrato.
05
Painel do seller
Faturamento bruto, ticket médio, transações, últimas vendas com status, notificações e tema claro ou escuro. A tela que o seller abre todo dia.
Stack, e por que cada peça
- Encore.ts
- Framework de backend em TypeScript com serviços tipados, infraestrutura declarada no código e observabilidade nativa.
- Neon Postgres
- Postgres serverless gerenciado, com branches de banco para ambientes de teste.
- Next.js
- Painel do seller e checkout.
- Fly.io
- Hospedagem dos serviços do backend em containers.
Perguntas sobre este projeto
Vocês integram o meu sistema com um gateway ou constroem um gateway próprio?
Os dois. Para a maioria das empresas, integrar um gateway existente é o caminho: mais rápido e sem carregar a operação de pagamento. Construir o próprio faz sentido para quem vai processar para terceiros, como a Vennox. A gente ajuda a decidir antes de orçar.
Como vocês evitam pagamento duplicado e webhook perdido?
Com idempotência em cada evento, reenvio com registro do que foi entregue e conciliação entre o que o gateway diz e o que o banco mostra. É o que aprendemos construindo o lado de quem processa.
Quanto custa integrar pagamentos no meu sistema?
Depende do gateway, dos métodos (PIX, cartão, boleto) e do que o seu sistema precisa fazer depois do pagamento. Projetos a partir de R$ 20 mil. O preço fechado vem na proposta, com o prazo.
Vocês trabalham com cobrança recorrente e assinatura?
Sim, por cartão e por PIX, conforme o que o gateway escolhido oferece. Assinatura, tentativa de nova cobrança e cancelamento entram no escopo desde o início.
Quanto tempo leva uma integração de pagamento?
O prazo é definido no escopo, antes de começar, e vem na proposta. Toda integração passa por sandbox testado antes de subir para produção.
Serviço relacionado
Integração de pagamentos
Também entra neste tipo de projeto
Tem um projeto parecido?
Conta pra gente o que você precisa. A resposta sai no mesmo dia, e a proposta diz o que entra, quanto custa e quando fica pronto.
Prefere formulário? Pedir orçamento por aqui.