Passar para o conteúdo principal

Como Integrar Cielo Checkout ao WooCommerce

Aprenda a integrar o gateway de pagamento Cielo ao WooCommerce, ativando pagamentos por cartão de crédito e débito. Instale o plugin oficial, configure as chaves Merchant ID e Key da Cielo e ative opções de parcelamento e testes.

🧭 Quando usar

  • Ao configurar pagamentos com cartão de crédito e débito

  • Ao substituir gateways genéricos por um gateway nacional aprovado pela Cielo

  • Ao buscar parcelamento direto no checkout WooCommerce

✅ Pré-requisitos

  • Conta ativa e aprovada pela Cielo (com Merchant ID e Key)

  • Loja WooCommerce instalada e configurada

  • Acesso de administrador ao WordPress

🛠️ Passo a passo

Passo 1 – Criar e aprovar a conta Cielo

  1. Acesse o portal da Cielo (cielo.com.br) e clique em “Crie sua conta”.

  2. Preencha os dados da sua empresa (CNPJ, faturamento, dados bancários e documentação).

  3. Aguarde a aprovação da loja, que normalmente leva alguns minutos ou horas.

  4. Após aprovado, acesse o painel Cielo e anote:

    • Merchant ID

    • Merchant Key
      Essas credenciais serão usadas para autenticação no WooCommerce.

Passo 2 – Instalar o plugin Cielo no WooCommerce

  1. No painel do WordPress, acesse Plugins » Adicionar novo.

  2. Pesquise por Cielo – API de pagamento para WooCommerce (desenvolvido pela Link Nacional).

  3. Clique em Instalar agora e depois em Ativar.

  4. O plugin adicionará automaticamente a opção Cielo às configurações de pagamento.

Passo 3 – Configurar a Cielo no WooCommerce

  1. Vá em WooCommerce » Configurações » Pagamentos.

  2. Encontre as opções Cielo Cartão de Crédito e Cielo Cartão de Débito.

  3. Clique em Gerenciar.

  4. Preencha os campos:

    • Título: texto exibido no checkout (ex.: “Pagar com Cielo”).

    • Descrição: mensagem opcional para o cliente.

    • Merchant ID e Key: insira as credenciais do painel da Cielo.

    • Ambiente: escolha Produção (real) ou Teste (sandbox).

Passo 4 – Ativar parcelamento e validação de valores

  1. Na aba de configuração da Cielo, habilite Pagamentos parcelados.

  2. Defina o valor mínimo para parcelamento (ex.: apenas acima de R$10).

  3. Repita a configuração para cartões de débito, se desejar aceitar essa modalidade.

  4. Clique em Salvar alterações.

Passo 5 – Testar o checkout

  1. No painel Cielo, altere o ambiente para Sandbox (teste).

  2. Realize uma compra de teste na sua loja.

  3. Se o pedido for processado corretamente, retorne ao ambiente Produção.

🧩 Exemplos práticos

  • Exemplo 1: Loja de eletrônicos → ativa a Cielo com parcelamento em até 12x para compras acima de R$100.

  • Exemplo 2: Loja de roupas → usa modo sandbox para testar o checkout antes de lançar a loja oficialmente.

🧪 Solução de problemas

  • Erro/Sintoma: “Transação não autorizada.”
    ​Causa provável: Merchant Key incorreta ou ambiente de teste ativo.
    ​Como resolver: Revise as credenciais e altere para Produção.

  • Erro/Sintoma: Opção de parcelamento não aparece.
    ​Causa provável: Valor mínimo não configurado corretamente.
    ​Como resolver: Ajuste o valor mínimo em “Pagamentos parcelados”.

  • Erro/Sintoma: Checkout não mostra a opção da Cielo.
    ​Causa provável: Plugin não habilitado.
    ​Como resolver: Vá em WooCommerce » Pagamentos e ative o método Cielo.

🔎 Referências e links úteis

🗂️ Metadados

  • Categoria: Pagamentos e Integrações

  • Subcategoria: WooCommerce + Cielo

  • Tags: WooCommerce, Cielo, checkout, gateway, cartão de crédito, API, parcelamento

  • Nível: intermediário

  • Atualizado em: 2025-11-09

Artigos relacionados
Respondeu à sua pergunta?