Checkout transparente
Os dados do cartão são capturados no seu site e enviados via backend para a API eCommerce da Cielo — sem redirecionamento, sem quebra de experiência de compra.
Integrações / Gateways / Cielo
Integração com a
Cielo
para e-commerce
e sistemas
Desenvolvimento de integração com a API eCommerce da Cielo para checkout transparente, Pix, antifraude e sistemas que precisam de conexão direta com o gateway.
Sobre a Cielo
O gateway e sua API
A Cielo é uma das maiores adquirentes do Brasil, com ampla cobertura para cartão de crédito, débito, Pix e boleto. Sua API eCommerce — versão REST com autenticação por MerchantId e MerchantKey — é a interface principal para integrações customizadas em sistemas próprios, e-commerces e aplicativos.
Uma particularidade relevante da API da Cielo é a separação entre autorização e captura. Em muitos gateways a captura é automática na aprovação, mas a Cielo permite fazer autorização prévia e capturar posteriormente — o que é útil em fluxos com confirmação manual ou análise de estoque antes do faturamento.
Outro ponto de atenção: a análise de antifraude integrada exige o envio de campos de contexto adicionais na requisição — dados do cliente, endereço de entrega, fingerprint do navegador. A integração precisa mapear esses campos corretamente para que a análise seja eficaz e não gere falsos positivos em excesso.
O que a integração cobre Aspectos técnicos
Aspectos técnicos
do desenvolvimento
Antifraude integrado
A Cielo permite habilitar análise de antifraude junto à transação. A integração inclui o envio dos campos de contexto necessários para que a análise seja precisa e o retorno do status da análise seja tratado corretamente.
Pix com QR Code dinâmico
A API da Cielo suporta geração de QR Code dinâmico para Pix. A integração inclui a geração do código, a exibição no checkout e o recebimento da confirmação via webhook.
Webhooks de notificação
A Cielo notifica seu sistema via POST sempre que o status de uma transação muda. A integração desenvolve o endpoint receptor com validação de origem e atualização automática do pedido.
Sandbox completo
A Cielo disponibiliza um ambiente de sandbox com credenciais fixas de teste para simular aprovações, recusas, cancelamentos e Pix antes de qualquer transação real.
Tratamento de erros e retentativas
A API da Cielo retorna códigos de erro padronizados. A integração trata cada cenário — recusa por limite, dados inválidos, timeout — com mensagens adequadas e, quando pertinente, lógica de retentativa.
Integração via API Por que não usar
Por que não usar
um plugin pronto
Quando um plugin é suficiente
Para WooCommerce existem plugins da Cielo com manutenção ativa. Se o seu caso de uso é padrão e a plataforma tem suporte oficial, um plugin pode ser a solução mais rápida.
Quando a integração direta é necessária
- Sua plataforma não tem módulo oficial ou atualizado para a Cielo
- Você opera com sistema próprio, ERP ou app sem suporte a plugins
- Precisa de antifraude com campos de contexto personalizados
- Quer separar autorização e captura no fluxo de negócio
- Precisa de tokenização de cartão para cobrança recorrente
- O fluxo de Pix precisa de lógica customizada de expiração ou confirmação
- Quer controle total sobre logs, erros e retentativas
A API eCommerce da Cielo é bem documentada e oferece mais recursos do que a maioria dos plugins expõe. A integração direta permite usar esses recursos por completo.
Conversar sobre o projeto Cenários de uso Quando a integração
Plataforma sem suporte nativo Backend customizado Segurança na transação Troca de gateway
Quando a integração
com a Cielo faz sentido
E-commerce sem módulo ativo para a Cielo
Sua plataforma não possui módulo oficial para a Cielo ou o módulo existente está desatualizado em relação à versão atual da API eCommerce. O desenvolvimento cria essa conexão diretamente, com checkout transparente e suporte aos meios de pagamento que seu negócio precisa.
Sistema próprio com cobrança recorrente
Seu sistema precisa cobrar clientes de forma recorrente — assinaturas, mensalidades, contratos. A API da Cielo suporta tokenização de cartão, que permite cobrar novamente sem que o cliente precise redigitar os dados a cada ciclo.
Checkout com antifraude ativo
Para negócios com ticket médio mais alto ou perfil de risco elevado, o antifraude integrado da Cielo é um diferencial importante. A integração inclui o envio correto dos campos de contexto que alimentam a análise e o tratamento do retorno.
Migração de gateway anterior para a Cielo
Você está saindo de outro gateway e precisa migrar a integração para a Cielo sem interromper as vendas. O processo inclui o desenvolvimento da nova integração, testes em paralelo e a transição controlada para produção.
Processo
Como o projeto funciona
Análise do ambiente
Entender a plataforma, o backend e o fluxo de compra atual. Identificar se há integração anterior que precisa ser migrada ou substituída.
Levantamento de requisitos
Quais métodos de pagamento, se há necessidade de antifraude, recorrência, Pix, boleto, webhook e integração com outros sistemas.
Configuração do sandbox
Acesso às credenciais de teste da Cielo e leitura da documentação da API eCommerce para entender os endpoints e payloads específicos.
Desenvolvimento
Construção dos endpoints de cobrança, consulta, cancelamento e webhook, com tratamento correto de cada código de retorno da API.
Testes de homologação
Simulação de todos os cenários: aprovação, recusa, Pix confirmado, boleto gerado, cancelamento e estorno.
Publicação em produção
Migração das credenciais de produção, deploy e acompanhamento das primeiras transações reais para garantir que o fluxo está correto.
Plataformas e ambientes
WooCommerce
Módulo customizado com checkout transparente e Pix
OpenCart
Módulo de pagamento integrado à API eCommerce
Sistema próprio
Integração via API no backend existente
ERP
Cobrança automatizada com separação de autorização e captura
Aplicativo mobile
Backend intermediário que processa e não expõe credenciais
Checkout headless
Frontend desacoplado com tokenização via Cielo.js
Não viu sua plataforma? Fale sobre o projeto — o processo começa pelo entendimento do ambiente atual.
Perguntas frequentes
O que é a Cielo e como funciona sua API?
A Cielo é uma das maiores adquirentes do Brasil. Sua API REST (Cielo eCommerce API) permite processar pagamentos via cartão de crédito, débito, Pix e boleto bancário. A autenticação é feita com MerchantId e MerchantKey enviados no header de cada requisição.
A Cielo tem ambiente de sandbox para testes?
Sim. A Cielo disponibiliza o Sandbox da API eCommerce com credenciais fixas de teste, permitindo simular transações com diferentes status antes de publicar em produção.
É possível fazer checkout transparente com a Cielo?
Sim. A API eCommerce da Cielo suporta checkout transparente — o cliente preenche os dados do cartão dentro do seu próprio site, sem redirecionamento. Isso exige captura segura dos dados no frontend e envio via backend para a API.
A Cielo tem antifraude integrado?
Sim. A API permite habilitar análise de antifraude junto à transação. A integração inclui o envio dos campos necessários para que a análise funcione corretamente.
A integração suporta Pix?
Sim. A API eCommerce da Cielo suporta Pix com geração de QR Code dinâmico e notificação via webhook quando o pagamento é confirmado.
É possível integrar com WooCommerce ou OpenCart?
Sim. Para essas plataformas é possível desenvolver um módulo customizado que se comunica diretamente com a API eCommerce da Cielo, com checkout transparente funcionando dentro da plataforma.
Como funcionam os webhooks da Cielo?
A Cielo envia notificações via POST para um endpoint configurado no seu sistema sempre que o status de uma transação muda. A integração inclui o desenvolvimento desse endpoint com validação da origem e atualização automática do status no sistema.
Quanto custa e quanto tempo leva?
Depende do escopo: quais métodos de pagamento, se há antifraude, recorrência, webhook e integração com outros sistemas. O melhor caminho é conversar sobre o projeto.
Próximo passo Precisa integrar a Cielo
Precisa integrar a Cielo
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