Checkout transparente
O cliente não sai do seu site para pagar. Os dados do cartão são capturados dentro do seu checkout e enviados diretamente para a API da Rede — sem redirecionamento, sem quebra de experiência.
Integrações / Gateways / Rede
Integração com a
Rede
para e-commerce
e sistemas
Desenvolvimento de integração com o gateway Rede via API REST para e-commerce sem módulo disponível, sistemas próprios, ERPs e checkouts personalizados.
Sobre a Rede
O gateway e sua API
A Rede é uma adquirente do grupo Itaú, com ampla cobertura no mercado brasileiro para processamento de cartão de crédito e débito. Sua API REST permite que empresas integrem o processamento de pagamentos diretamente em sistemas próprios, sem depender de checkout externo ou redirecionamento.
A integração com a Rede envolve autenticação via credenciais de API (affiliation number e token), construção do payload de transação com os dados corretos para cada método de pagamento e tratamento das respostas — tanto síncronas quanto assíncronas via webhook.
Onde a integração costuma ter mais nuances: o protocolo 3DS2 para autenticação adicional do portador, a lógica de parcelamento que varia conforme o contrato, e o tratamento consistente dos webhooks de mudança de status — que chegam de forma assíncrona e precisam ser processados de forma idempotente.
O que a integração cobre
Aspectos técnicos
Aspectos técnicos
do desenvolvimento
Webhooks de status
A Rede notifica seu sistema sobre mudanças de status de transação via webhook. A integração inclui o endpoint que recebe, valida e processa essas notificações para manter o sistema sempre atualizado.
Homologação antes da produção
Todo o desenvolvimento é testado no ambiente de sandbox da Rede com cenários de aprovação, recusa, timeout e cancelamento — antes de qualquer transação real.
Tratamento de erros
A integração cobre os códigos de resposta da Rede e trata cada cenário: cartão recusado, saldo insuficiente, dados inválidos, timeout de comunicação — com mensagens coerentes para o usuário e log para o sistema.
Parcelamento configurável
O número de parcelas e a política de juros seguem o contrato que você tem com a Rede. A integração aplica essas regras no checkout e apresenta as opções ao cliente de forma clara.
Compatibilidade com múltiplos ambientes
A integração é desenvolvida desde o início considerando a separação entre os ambientes de desenvolvimento, homologação e produção, evitando confusões de credenciais e dados.
Integração via API
Por que não usar
Por que não usar
um plugin pronto
Quando um plugin é suficiente
Se você usa WooCommerce, há plugins da Rede com manutenção ativa. Se o seu caso de uso é padrão — checkout em uma plataforma suportada, sem lógica adicional — um plugin pode ser a solução mais rápida e econômica.
Quando um plugin não resolve
- Sua plataforma não tem módulo oficial para a Rede
- O plugin existente não é mantido ou tem bugs não corrigidos
- Você usa sistema próprio ou ERP sem suporte a plugins
- Seu checkout tem uma lógica diferente do fluxo padrão
- Você precisa de integração com outros sistemas após o pagamento
- A Rede atualizou a API e o plugin não acompanhou
- Você quer controle total sobre o tratamento de erros e logs
A integração via API não é mais complexa do que um plugin — ela é mais precisa. Você sabe exatamente o que acontece em cada etapa do processo.
Conversar sobre o projeto Cenários de uso
Quando a integração
Plataforma sem suporte nativo Backend próprio Experiência de compra sob medida Manutenção e migração
Quando a integração
com a Rede faz sentido
E-commerce sem módulo oficial para a Rede
Você usa uma plataforma de e-commerce que não possui módulo oficial para a Rede — seja por ser uma plataforma de nicho, uma versão customizada ou uma solução própria. O desenvolvimento cria essa ponte diretamente via API, com checkout transparente funcionando dentro da sua loja.
Sistema de gestão ou ERP com cobrança integrada
Sua empresa opera com um sistema desenvolvido internamente ou um ERP que precisa processar cobranças automaticamente — na emissão de um contrato, no fechamento de um pedido, na renovação de uma assinatura. A integração com a API da Rede traz o processamento de pagamentos para dentro desse fluxo.
Checkout personalizado no e-commerce
Você quer um checkout com identidade visual própria, campos específicos, etapas definidas por você e uma experiência de compra diferente do padrão. A integração direta com a API da Rede permite construir esse checkout sem depender de redirect ou iframe de terceiro.
Plugin existente que parou de funcionar
A Rede atualizou a API e o plugin que você usava ficou desatualizado. Ou simplesmente o módulo tem um bug que nunca foi corrigido. A integração personalizada resolve isso de forma definitiva, com código que você controla e pode manter.
Processo
Como o projeto funciona
Análise do ambiente
Entender a plataforma atual, o backend, o banco de dados e o fluxo de compra existente. Verificar se há integração parcial que precisa ser migrada.
Levantamento de requisitos
Quais métodos de pagamento, parcelamento, se precisa de webhook, estorno, consulta de transação, 3DS2 — tudo mapeado antes de escrever código.
Credenciais e documentação
Acesso às credenciais de sandbox da Rede e leitura da documentação técnica atual para entender os endpoints, payloads e comportamentos esperados.
Desenvolvimento da integração
Construção dos endpoints de cobrança, consulta e webhook, com tratamento de cada código de resposta da API da Rede.
Testes em homologação
Bateria de testes com os cartões de teste da Rede: aprovação, recusa por limite, dados inválidos, timeout e estorno.
Publicação em produção
Migração das credenciais de produção, deploy e monitoramento inicial das primeiras transações reais para garantir que o fluxo está funcionando corretamente.
Plataformas e ambientes
WooCommerce
Módulo customizado integrado ao checkout nativo
OpenCart
Módulo de pagamento com suporte a crédito e débito
Sistema próprio
Integração via API no backend existente
ERP
Cobrança automatizada a partir de pedidos ou contratos
Aplicativo mobile
API chamada do backend do app, nunca exposta no cliente
Checkout headless
Frontend desacoplado com chamadas via backend próprio
Não viu sua plataforma aqui? Fale sobre o projeto — o processo começa pelo entendimento do ambiente atual.
Perguntas frequentes
O que é o gateway Rede e como funciona sua API?
A Rede é uma adquirente do grupo Itaú com gateway de pagamento próprio. Sua API REST permite realizar cobranças via cartão de crédito e débito, consultar transações, processar estornos e receber notificações via webhook. A autenticação é feita via chaves de API no header de cada requisição.
A Rede tem ambiente de homologação para testes?
Sim. A Rede disponibiliza ambiente de sandbox onde é possível simular transações com cartões e valores fictícios antes de publicar em produção. Toda integração passa obrigatoriamente por essa etapa.
É possível integrar a Rede com WooCommerce ou OpenCart?
Sim. Para WooCommerce e OpenCart o desenvolvimento cria um módulo customizado que se comunica diretamente com a API da Rede, com checkout transparente dentro da plataforma.
A integração suporta parcelamento e juros?
Sim. A API da Rede suporta parcelamento com e sem juros. O número de parcelas e a política de juros são configurados de acordo com o contrato comercial que você tem com a Rede.
Como funcionam os webhooks da Rede?
Os webhooks são chamadas HTTP que a Rede realiza para um endpoint do seu sistema quando o status de uma transação muda. A integração inclui o desenvolvimento do endpoint que recebe e processa essas notificações, garantindo que o sistema seja atualizado mesmo quando o cliente fecha o navegador.
A Rede suporta 3DS2?
Sim, a Rede suporta o protocolo 3DS2 para autenticação adicional do portador do cartão. A implementação adiciona uma camada de segurança para transações de alto valor ou alto risco e precisa ser considerada no escopo da integração.
Qual é a diferença entre integrar a Rede via API e usar um plugin pronto?
Um plugin pronto resolve o caso de uso padrão. A integração via API resolve os demais — sistemas próprios, fluxos customizados, comunicação com ERP, lógicas de negócio específicas. Além disso, com a integração direta você tem controle total sobre o tratamento de erros e sobre como os dados trafegam.
Quanto tempo leva e quanto custa?
Depende do escopo: plataforma, métodos de pagamento, webhook, estorno, integração com outros sistemas. O melhor caminho é conversar sobre o projeto para um levantamento preciso.
Próximo passo
Precisa integrar a Rede
Precisa integrar a Rede
ao seu sistema?
O primeiro passo é entender o cenário atual — plataforma, backend e quais meios de pagamento fazem sentido para o seu negócio. Sem compromisso.
Solicitar orçamento
Atendimento para todo o Brasil · Projetos remotos