< 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.

Dashboard do seller na Vennox Pay com saldo, faturamento, métodos de pagamento e últimas vendas

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. Não trabalhamos com tabela pública: cada projeto recebe orçamento fechado em até 24 horas.

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?

A maioria dos projetos sai entre 1 e 15 dias, com sandbox testado antes de subir para produção. O prazo exato vem junto com o orçamento.

Serviço relacionado

Integração de pagamentos

Tem um projeto parecido?

Conta pra gente o que você precisa. Em até 24 horas você tem nosso contato e o orçamento fechado.