Central de Ajuda Quaza Provedores

Homologação Cielo (Gateway) (PT)

Homologação Cielo (Gateway) — Quaza

Como conectar o Quaza à API da Cielo para cobrar por cartão de crédito e validar a integração — o que chamamos de homologar.

Nesta wiki:

O que é o gateway Cielo

O gateway Cielo liga o Quaza diretamente à API de pagamentos da Cielo. Com ele, as cobranças por cartão de crédito são autorizadas em tempo real e a confirmação volta automaticamente.

Homologar é validar suas credenciais (MerchantId e MerchantKey) com a Cielo: você informa as duas chaves, clica em Testar gateway e o Quaza confirma a conexão.

Gateway não é o mesmo que Remessa/Retorno. No gateway tudo acontece pela internet, em tempo real. Veja a diferença em Diferença entre Gateway (API) e Remessa/Retorno .

Como funciona a homologação

Você configura as duas chaves, o Quaza pede autorização à Cielo e, se as chaves estiverem corretas, a integração fica conectada:

Glossário

Termo	O que significa
Gateway	Integração via API: a cobrança e a confirmação acontecem em tempo real, pela internet.
Homologar	Validar suas credenciais com a Cielo. No Quaza, é o botão Testar gateway.
Ambiente	Homologação = ambiente de testes (Sandbox) da Cielo; Produção = valendo de verdade.
MerchantId	O identificador da sua loja na Cielo. Vai no campo Chave Principal.
MerchantKey	A chave secreta da sua loja na Cielo. Vai no campo Chave Secreta.
Tarefa "Financeiro - Gateway"	Rotina automática que sincroniza o status das cobranças do gateway.

Antes de começar

Você vai precisar de:

• Uma conta na Cielo com a API e-commerce habilitada.
• O MerchantId e o MerchantKey da sua loja (no cadastro da Cielo).

Passo a passo

Abra a configuração para cobrança e vá na aba Gateway:

Configuração para cobrança → aba Gateway

1 Em Integração gateway, selecione Gateway - Cielo.

2 Em Ambiente, escolha Homologação (Sandbox) para testar ou Produção.

3 Em Chave Principal, cole o MerchantId.

4 Em Chave Secreta, cole o MerchantKey.

Grave e clique em Testar gateway.

Aba Gateway: (1) Integração gateway = Gateway - Cielo, (2) Ambiente, (3) Chave Principal (MerchantId), (4) Chave Secreta (MerchantKey) e o botão Testar gateway.

O botão "Testar gateway"

O botão Testar gateway pede uma autorização à Cielo usando o MerchantId e o MerchantKey. Se as duas chaves estiverem corretas, aparece Conectado com sucesso — a integração está homologada.

Deu erro ao testar? Confira o MerchantId e o MerchantKey (sem espaços) e o Ambiente. Chaves de Sandbox não funcionam em Produção e vice-versa.

Tarefas automáticas

Depois de homologado, o Quaza acompanha as cobranças por tarefas que rodam sozinhas:

Tarefa	O que faz
Financeiro - Gateway	Sincroniza o status de pagamento das cobranças do gateway, dentro da janela de dias configurada (campos "Verificação das cobranças"). É a tarefa principal da integração.
Financeiro - Gateway (pagamento)	Processa os pagamentos por cartão das carteiras com cobrança recorrente — é a tarefa que efetiva a cobrança no cartão.
Financeiro - Gateway (aviso)	Gera os avisos e notificações relacionados às cobranças do gateway.

Pegadinhas frequentes

1. Sandbox não é Produção. As chaves de Homologação (Sandbox) da Cielo só funcionam no ambiente de testes. Troque para as chaves de Produção ao entrar no ar.

2. São duas chaves. A Cielo exige MerchantId (Chave Principal) e MerchantKey (Chave Secreta). Faltando uma, o teste falha.

3. Cielo é cartão de crédito. Este gateway processa cobranças por cartão (inclusive recorrentes), não boleto.

4. Chaves exatas. Cole o MerchantId e o MerchantKey exatamente como aparecem no painel da Cielo, sem espaços.

Perguntas frequentes

Quem pode configurar a homologação?

O operador do financeiro com acesso à Configuração para cobrança. Como envolve credenciais, costuma ser feito por quem cuida da cobrança da empresa.

Onde consigo o MerchantId e o MerchantKey?

No cadastro da sua loja na Cielo (API e-commerce). O Quaza não gera essas chaves.

A Cielo cobra boleto?

Não. Este gateway é para cartão de crédito. Para boleto, use um gateway bancário.

Posso testar antes de colocar para valer?

Sim. Use o ambiente Homologação (Sandbox) com as chaves de teste da Cielo.

"Testar gateway" deu erro. O que fazer?

Confira o MerchantId e o MerchantKey (sem espaços) e o ambiente. Corrija, grave e teste de novo.

A confirmação do pagamento é automática?

Sim. A tarefa Financeiro - Gateway sincroniza e a Financeiro - Gateway (pagamento) processa as cobranças no cartão.

Preciso importar arquivo de retorno?

Não. O gateway é em tempo real; não há arquivo de retorno.

Qual a diferença para Remessa/Retorno?

O gateway é via API, na hora; a remessa/retorno troca arquivos. Veja Diferença entre Gateway (API) e Remessa/Retorno .

Troquei as chaves. Preciso testar de novo?

Sim. Sempre que mudar o MerchantId, o MerchantKey ou o ambiente, grave e clique em Testar gateway.

As chaves de Sandbox servem em Produção?

Não. São credenciais diferentes; troque-as ao ir para Produção.