Atualizado em 17/08/2026 10:32

CIELO > Como habilitar a integração com a Cielo

Olá!

Neste artigo, vamos explicar como habilitar a integração da Cielo com o Tutor, permitindo utilizar a Cielo como gateway de pagamento na Loja Virtual.

A integração utiliza as credenciais Merchant ID e Merchant Key, que são disponibilizadas pela Cielo para identificação e autenticação da loja.

 

 

1. Obtenha as credenciais na Cielo

Para realizar a integração, é necessário possuir uma conta na Cielo e ter acesso às credenciais:

  • Merchant ID
  • Merchant Key

Esses dados são utilizados para identificar a loja e autenticar a integração com a API Cielo eCommerce.

Importante: as credenciais utilizadas devem corresponder ao ambiente configurado. Credenciais de produção devem ser utilizadas em produção, enquanto credenciais de Sandbox são destinadas aos testes.

 

 

2. Acesse a configuração da Loja no Tutor

Após obter as credenciais da Cielo, acesse o ambiente administrativo do Tutor.

No menu:Módulo Loja e Portal → Admin. dos Sites

Localize a Loja em que deseja habilitar a Cielo e clique em:Alterar

 

 

3. Acesse as configurações de pagamento

Dentro da configuração da Loja, acesse a aba:Checkout

Em seguida, clique em:Incluir uma Nova Forma de Pagamento

 

 

4. Selecione a Cielo

Na lista de formas de pagamento disponíveis, selecione:CIELO

Será apresentada a tela da configuração específica para a integração.

 

 

5. Preencha os dados da Cielo

Informe os dados fornecidos pela Cielo nos respectivos campos:

Merchant ID: informe o identificador da loja disponibilizado pela Cielo.

Merchant Key: informe a chave de autenticação disponibilizada pela Cielo.

Essas duas credenciais são obrigatórias para a comunicação com a API Cielo eCommerce.

Confira atentamente os dados antes de salvar a configuração.

 

 

6. Configure o ambiente de produção

Para realizar compras reais, tanto o Tutor quanto a conta da Cielo deverão estar configurados no ambiente de produção.

Atenção: se a conta da Cielo ou o Tutor estiverem configurados em ambiente de testes, não haverá validação das compras reais.

A Cielo possui ambientes distintos para testes e produção, e as credenciais precisam corresponder ao ambiente utilizado.

 

 

7. Salve e publique a Loja

Após preencher o Merchant ID e o Merchant Key, clique em:Salvar e Publicar a Loja

A publicação é necessária para que a configuração realizada fique disponível na Loja Virtual.

 

 

8. Habilite a Cielo nos cursos

Após configurar e publicar a Loja, é necessário selecionar a forma de pagamento Cielo nos cursos em que ela deverá estar disponível.

Acesse o cadastro dos Cursos  e selecione a opção de pagamento: Cielo

Dessa forma, a Cielo ficará disponível como forma de pagamento para os cursos configurados.

 

 

Pontos Importantes

  • Para a integração, são necessários os dados Merchant ID e Merchant Key.
  • As credenciais devem corresponder ao ambiente utilizado.
  • Para compras reais, utilize o ambiente de produção.
  • Se a conta da Cielo ou o Tutor estiverem em ambiente de testes, não haverá validação das compras reais.
  • A integração da Cielo no Tutor é destinada a pagamentos via cartão pela Loja Virtual.
  • Antes de configurar a Cielo na Loja, verifique se ela está criada em Módulo Administrativo → Formas de Pagamentos.
  • Após configurar a integração, é necessário Salvar e Publicar a Loja.
  • A Cielo deve ser selecionada nos cursos que deverão disponibilizar essa forma de pagamento.

Pré-requisito para habilitar a Cielo

Para que a Cielo possa ser habilitada na Loja Virtual, é necessário que ela esteja previamente criada no módulo administrativo.

Acesse:

Módulo Administrativo → Formas de Pagamentos

Verifique se a forma de pagamento Cielo está criada e disponível.

Caso a Cielo não esteja disponível para seleção na configuração da Loja, verifique primeiro esse cadastro.

 

 

Fluxo Resumido

Cielo → Obter Merchant ID e Merchant Key → Tutor → Módulo Loja e Portal → Admin. dos Sites → Alterar Loja → Checkout → Incluir Nova Forma de Pagamento → Cielo → Informar Merchant ID e Merchant Key → Salvar e Publicar a Loja → Selecionar Cielo nos Cursos.

Após essas etapas, a integração da Cielo estará habilitada na Loja Virtual para os cursos configurados.

 

 

 

Não encontrou o que estava procurando?