Configurações
Receber pela Cielo: passo a passo
Para quem é
Este roteiro é para a loja que tem (ou quer ter) a API E-commerce da Cielo e quer receber as vendas da loja virtual por ela. A Cielo pode cobrar o cartão de crédito (à vista e parcelado sem juros) e o Pix. O dinheiro cai na sua conta da Cielo, nas condições do seu contrato com ela.
Você pode ter a Cielo junto com outro provedor e escolher quem cobra cada meio. Por exemplo: o cartão pela Cielo e o Pix pelo Mercado Pago.
O detalhe de cada tela está em Pagamento. Este artigo é o roteiro completo, do contrato até a primeira venda.
Passo 1: o contrato de e-commerce na Cielo
- Contrate a API E-commerce no site da Cielo (cielo.com.br › E-commerce › API E-commerce › Contratar agora) ou com um gestor comercial da Cielo. O e-commerce ganha um número de estabelecimento (EC) próprio, separado do da maquininha.
- A Cielo manda um e-mail de boas-vindas com o número do EC. Guarde esse número.
- Se você tem mais de um EC, no site Cielo use meus estabelecimentos › ver mais e escolha o EC do e-commerce em todos os passos abaixo.
- Peça à Cielo as taxas por escrito do e-commerce (crédito à vista, parcelado e Pix). Elas podem ser diferentes das taxas da maquininha.
Quem faz os passos 2 a 5 e o 7 no site Cielo precisa ter o perfil Administrador ou Analista. Cada operação pede um código do aplicativo Cielo Gestão (ou enviado por e-mail).
Passo 2: MerchantId e MerchantKey
São as credenciais que deixam a loja cobrar.
- No site Cielo, selecione o EC do e-commerce e vá em E-commerce › Gestão API E-commerce › Credenciais.
- Ali aparece o MerchantId (no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
- Para ver a MerchantKey, gere uma nova: clique em Gerar nova Merchant Key, escolha Imediatamente como prazo da chave antiga e confirme com o código do Cielo Gestão. Mesmo no primeiro acesso é preciso gerar uma.
- Copie a MerchantKey na hora, com o botão Copiar. Guarde-a com cuidado: quem tem a MerchantKey consegue cobrar e estornar em nome da sua loja.
Passo 3: Silent Order Post (para receber cartão)
O Silent Order Post é o que leva o cartão do comprador direto à Cielo, sem passar pela loja. Sem ele, a Cielo cobra só o Pix.
- Em Gestão API E-commerce › Microsserviços, ative a chave do Silent Order Post, aceite o termo de uso e clique em Gerar chave.
- Confirme com o código do Cielo Gestão.
- Copie o Client ID e o Client Secret que aparecem.
Atenção: o 3DS tem outro Client ID e Client Secret (passo 4). Não troque um pelo outro.
Passo 4: 3DS, a confirmação do cartão pelo banco (recomendado)
Com o 3DS, o banco do comprador confirma a compra (às vezes sem o comprador perceber, às vezes com um código no aplicativo do banco). Ele traz duas coisas:
- se o dono do cartão contestar a compra (chargeback), quem responde é o banco, e não a loja;
- a loja passa a oferecer também o cartão de débito, que a Cielo só autoriza com 3DS.
Sem o 3DS, o cartão de crédito funciona, mas o chargeback fica com a loja e não há débito.
- Em Gestão API E-commerce › Microsserviços, ative a chave do 3DS, aceite o termo de uso e clique em Gerar chave.
- Confirme com o código do Cielo Gestão.
- Copie o Client ID e o Client Secret do 3DS.
- Tenha à mão o número do estabelecimento (EC) do e-commerce (10 dígitos) e o ramo da loja (MCC) (4 dígitos). Os dois estão no e-mail de boas-vindas da Cielo.
Passo 5: o Pix na Cielo (se a Cielo for cobrar o Pix)
- No site Cielo, vá em Meu cadastro › Autorizações › Pix › Iniciar habilitação.
- Escolha a modalidade Pix Cielo, aceite o Termo de Adesão e envie. A confirmação chega por e-mail ou SMS.
- Em Pix › Configurações do Pix › Visão Geral você acompanha a habilitação.
- Para poder devolver um Pix pela loja, a conta Pix na Cielo precisa ter saldo: escolha o modelo transferência automática programada ou Conta Cielo. Com a transferência automática por venda, a Cielo recusa a devolução por falta de saldo.
Passo 6: ligar na loja
Em Configurações › Pagamento, clique no cartão Cielo:
- Em Ambiente, deixe Produção para vender de verdade. Teste (sandbox) só serve com as credenciais do cadastro de testes da Cielo, e nada é cobrado nele.
- Cole o MerchantId e a MerchantKey (passo 2).
- Cole o Client ID e o Client Secret do Silent Order Post (passo 3).
- No bloco 3DS, cole o Client ID e o Client Secret do 3DS e preencha o EC e o MCC (passo 4).
- Se quiser, preencha o Nome na fatura do cartão: até 13 letras ou números, sem espaço nem acento. Ex.: UP3ESPORTES.
- Clique em Testar conexão. Nada é cobrado nem criado. O teste diz, item por item, o que está certo e o que falta. Ele avisa, por exemplo, quando uma credencial é do ambiente de testes e a loja está em produção, quando o Silent Order Post não está ativo ou quando o 3DS recusou a credencial, o EC ou o MCC.
- Marque o que a Cielo cobra: Cartão e/ou Pix. Com o 3DS, o cartão inclui o débito.
- Clique em Ligar. A MerchantKey e os Client Secret ficam cifrados e nunca mais aparecem inteiros: a tela mostra só o final.
Confira no quadro Quem cobra cada meio, no resumo de Configurações › Pagamento, que a Cielo ficou com o que você marcou.
Passo 7: o aviso de pagamento (URL de notificações)
É o que faz o Pix pago virar Pago na hora. Sem ele, a loja confere sozinha na Cielo, mas com alguns minutos de atraso.
- Depois de ligar, a página da Cielo mostra o quadro Aviso de pagamento, com três valores e um botão Copiar em cada: o Endereço (URL), o Header — Key e o Header — Value.
- No site Cielo, vá em E-commerce › Gestão API E-commerce › Configurações › URL de notificações.
- Cole o Endereço.
- Em Headers personalizados, cole o Key e o Value e clique em Adicionar.
- Marque todos os eventos (Marcar todos) e clique em Salvar alterações. A Cielo testa o endereço na hora e pede o código do Cielo Gestão.
O Value é um segredo da sua loja: é ele que prova que o aviso veio da Cielo. Se ele vazar, clique em Gerar outro valor e troque o Value no site Cielo.
Passo 8: a primeira venda
- Faça uma compra pequena de teste com cartão e confira que o pedido virou Pago no painel.
- Se a Cielo cobra o Pix, faça também um Pix pequeno e confira que o pedido virou Pago sozinho.
- No site Cielo, confira que as vendas apareceram no EC certo e com a taxa combinada. A taxa da Cielo não aparece no painel da loja.
- Para devolver o dinheiro, cancele o pedido pelo painel: a loja pede o estorno à Cielo. No cartão, a Cielo confirma na hora. A devolução do Pix é feita pela Cielo depois: se o painel disser que o estorno ainda não foi confirmado, espere e cancele de novo mais tarde.
Sobre a segurança do cartão
- O número do cartão vai do navegador do comprador direto para a Cielo. A loja recebe só um código de uso único para cobrar aquela compra.
- Com o 3DS (passo 4), o banco do comprador confirma a compra antes da cobrança. Quando o banco pede um código, a janela do banco aparece por cima da página da loja. - O banco confirmou: a compra é cobrada, e uma contestação fica com o banco. - O banco recusou a confirmação: a compra não é cobrada, e o comprador vê a mensagem para tentar outro cartão ou o Pix. - A confirmação está fora do ar ou o cartão não tem 3DS: o crédito segue sem a confirmação (e a contestação fica com a loja); o débito não segue. - O comprador desistiu, ou a janela do banco não apareceu: há um botão Cancelar e escolher outro cartão ou Pix, e nada é cobrado.
- Sem o 3DS, o crédito é cobrado sem a confirmação do banco. A Cielo aceita assim, mas a contestação (chargeback) fica com a loja, e o débito não é oferecido.
- Para reduzir ainda mais o risco, a Cielo oferece um antifraude (da Braspag), contratado à parte com a Cielo.
Quando algo não funciona
- "Esta MerchantId/MerchantKey é do ambiente de TESTE": as credenciais vieram do cadastro de testes da Cielo. Para vender, use as do site Cielo (passo 2), ou troque o Ambiente para Teste.
- "A Cielo recusou o MerchantId ou a MerchantKey": confira se as duas foram copiadas inteiras. Se a MerchantKey foi gerada de novo no site Cielo, a antiga parou de valer: cole a nova.
- O cartão não aparece na loja: falta o Silent Order Post (passo 3), ou o cartão está marcado para outro provedor no quadro Quem cobra cada meio. O Testar conexão diz qual dos dois.
- "A Cielo não liberou o Silent Order Post para este MerchantId": o Silent Order Post não está ativado em Microsserviços, ou o Client ID é de outro EC.
- O débito não aparece na loja: falta o 3DS completo (Client ID, Client Secret, EC e MCC, passo 4). O Testar conexão diz o que falta.
- "A Cielo recusou o Client ID ou o Client Secret do 3DS": confira se colou o par do 3DS (não o do Silent Order Post) e se ele não foi gerado de novo no site Cielo.
- O Pix pela Cielo não gera QR Code: o Pix não está habilitado no site Cielo (passo 5).
- O Pix foi pago, mas o pedido demorou a virar Pago: confira o aviso de pagamento (passo 7).
- Dúvidas sobre o contrato, as credenciais ou o site Cielo: fale com o suporte de e-commerce da Cielo: cieloecommerce@cielo.com.br (resposta em até 2 dias úteis), 4002-5472 (capitais) ou 0800 570 5472 (demais localidades), opção suporte e-commerce, ou WhatsApp (11) 3003-5525. Tenha o número do EC em mãos.
- Dúvidas sobre a loja: use o botão de suporte do painel, se a sua loja tiver, ou pergunte em Ajuda › Pergunte ao assistente.