intelicommerce

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

  1. 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.
  2. A Cielo manda um e-mail de boas-vindas com o número do EC. Guarde esse número.
  3. 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.
  4. 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.

  1. No site Cielo, selecione o EC do e-commerce e vá em E-commerce › Gestão API E-commerce › Credenciais.
  2. Ali aparece o MerchantId (no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
  3. 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.
  4. 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.

  1. 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.
  2. Confirme com o código do Cielo Gestão.
  3. 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.

  1. Em Gestão API E-commerce › Microsserviços, ative a chave do 3DS, aceite o termo de uso e clique em Gerar chave.
  2. Confirme com o código do Cielo Gestão.
  3. Copie o Client ID e o Client Secret do 3DS.
  4. 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)

  1. No site Cielo, vá em Meu cadastro › Autorizações › Pix › Iniciar habilitação.
  2. Escolha a modalidade Pix Cielo, aceite o Termo de Adesão e envie. A confirmação chega por e-mail ou SMS.
  3. Em Pix › Configurações do Pix › Visão Geral você acompanha a habilitação.
  4. 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:

  1. 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.
  2. Cole o MerchantId e a MerchantKey (passo 2).
  3. Cole o Client ID e o Client Secret do Silent Order Post (passo 3).
  4. No bloco 3DS, cole o Client ID e o Client Secret do 3DS e preencha o EC e o MCC (passo 4).
  5. Se quiser, preencha o Nome na fatura do cartão: até 13 letras ou números, sem espaço nem acento. Ex.: UP3ESPORTES.
  6. 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.
  7. Marque o que a Cielo cobra: Cartão e/ou Pix. Com o 3DS, o cartão inclui o débito.
  8. 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.

  1. 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.
  2. No site Cielo, vá em E-commerce › Gestão API E-commerce › Configurações › URL de notificações.
  3. Cole o Endereço.
  4. Em Headers personalizados, cole o Key e o Value e clique em Adicionar.
  5. 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.