Passar para o conteúdo principal

Como Configurar a Integração da Cielo com a Plataforma Moovin

A integração entre a Cielo e a plataforma Moovin permite que sua loja virtual processe pagamentos com cartão de crédito, Pix e boleto, utilizando toda a infraestrutura segura da Cielo como gateway de pagamento.


Com essa integração ativa, sua operação ganha mais automação no checkout, confirmação de pagamentos em tempo real e sincronização automática de status dos pedidos.

Neste tutorial, explicamos o passo a passo completo para configurar a Cielo na Moovin.

Pré-requisitos para integrar a Cielo com a Moovin

Antes de iniciar a configuração da integração, certifique-se de possuir:

  • Merchant ID fornecido pela Cielo

  • Merchant Key fornecido pela Cielo

  • Acesso administrativo à plataforma Moovin

  • Acesso ao painel da Cielo E-commerce para configurar a URL de notificação (Webhook/Callback)


Passo 1 — Acessar a configuração do Gateway Cielo

No painel administrativo da Moovin:

  1. Acesse Configurações

  2. Vá até Pagamento

  3. Clique em Gateways

  4. Selecione Cielo

Caminho no menu

Clique na imagem para ampliar.

Passo 2 — Configurar o ambiente

Na tela de configuração da Cielo, escolha o ambiente desejado:

  • Homologação → para testes

  • Produção → para vendas reais

Recomendamos realizar testes em homologação antes de ativar produção.


Passo 3 — Inserir credenciais da Cielo

Na seção Configurações de autenticação, preencha:

Merchant ID

Identificador único da sua conta Cielo.

Exemplo:

00000000-0000-000-0000-00000000

Merchant Key

Chave secreta usada para autenticação.

Exemplo:

XXXXXXXXXXXXXXXXXXXXXXXXX

Essas credenciais são fornecidas diretamente pela Cielo.


Passo 4 — Definir tipo de autorização

Escolha como a captura do pagamento será tratada:


Somente autoriza

A transação é autorizada, mas a captura precisa ser feita posteriormente


Autoriza e captura

A cobrança é capturada automaticamente após aprovação do crédito mas não passa por analise de risco.


Passo 5 — Configurar análise de risco (opcional)

Caso utilize antifraude, selecione o provedor correspondente.

Exemplo:

  • Cybersource

  • ClearSale

Caso não utilize análise externa, deixe desabilitado.


Passo 6 — Configurar URL de confirmação na Cielo

A Moovin gera uma URL de confirmação (callback/webhook) que deve ser cadastrada na Cielo.

Exemplo:

https://seudominio.com/api/confirmacao_transacao/cielo/1

Copie a URL exibida na tela.

Essa URL é responsável por:

  • Receber confirmação de pagamentos aprovados

  • Atualizar pedidos automaticamente

  • Sincronizar cancelamentos e estornos

No painel da Cielo, clique no menu E-commerce e clique em Gestão API E-commerce.

Clique na imagem para ampliar.

Após clique em URL de Notificação

Clique na imagem para ampliar.

Clique em Editar para alterar os dados.

Clique na imagem para ampliar.

Marque todas as opções relacionadas a Cartões, PIX, Boleto e Cancelamentos.

Clique na imagem para ampliar.

Passo 7 — Configurar mapa de status

A Moovin permite mapear os status retornados pela Cielo para os status internos do pedido.

Sugestão de mapeamento:

Status Cielo

Status na Moovin

Transação não finalizada

Cancelado Pagamento

Transação autorizada

Em Análise

Pagamento confirmado

Aprovado

Pagamento negado

Cancelado Pagamento

Pagamento cancelado

Cancelado Pagamento

Pagamento estornado

Cancelado Pagamento

Pagamento pendente

Aguardando Pagamento

Falha no processamento

Cancelado Pagamento


Se encontrar qualquer dificuldade ou tiver perguntas, estamos aqui para ajudar! Clique aqui para acessar nosso canal de suporte.

Nossas equipes estão prontas para atendê-lo através dos diversos canais de atendimento disponíveis.

Seu feedback é extremamente importante para nós!

Por gentileza, tire um momento para avaliar a documentação que acabou de ler. Suas opiniões são cruciais para aprimorarmos nossa plataforma e proporcionar a melhor experiência possível.

Clique no quadro abaixo para deixar sua avaliação.

Respondeu à sua pergunta?