Integre as soluções Cielo E-Commerce para pagamentos via cartão de crédito/débito, boleto, PIX e GooglePay.
Oferecendo uma experiência de checkout simplificada, segura e transparente.
Utilizando ferramentas de anti fraude e autenticação como Velocity, ZeroAuth, Silent Order Post (PCI DSS 3.2) e Autenticação 3DS 2.2
para garantir segurança para clientes e comerciantes.
É obrigatório que o domínio do site implemente certificado TLS/SSL e utilize o protocolo
HTTPS para estabelecer uma comunicação segura com o servidor.
Atenção
Não oferecemos suporte a instalação do certificado no servidor.
Atenção
Entre em contato com o suporte o seu servidor para mais
informaçõoes.
Certificado TLS/SSL Cielo
Instalação no Servidor da loja virtual
Além utilizar o protocolo HTTPS instalando certificado TLS/SSL no endereço da sua loja
virtual, é necessário instalar os três arquivos a seguir na Trustedstore do servidor.
Caso não esteja seguro sobre como realizar a instalação do
certificado, entre em contado com o suporte do seu servidor.
Atenção
Não oferecemos suporte a instalação do certificado Cielo.
Atenção
A Cielo não oferece suporte para a instalação do certificado.
Acesso do Cliente à loja virtual
O navegador faz a atualização do certificado automaticamente. Os certificados da Cielo
serão exibidos no botão de informações do site no endereço da sua loja virtual. No
cadeado, será possível ver as informações do certificado, como a instituição emissora e
a data de validade.
Fonte: Cielo
Configuração
Acessando as configurações
Para acessar as configurações clique em Extensões > Extensões a
partir do Painel de Controle, selecione Pagamentos
em Tipo de extensão, encontre Cielo Checkout na tabela e clique em
Editar.
Configurações Gerais
Parâmetro
Descrição
Nome do método
Texto que será exibido na seleção de métodos de pagamento na finalização
do pedido.
Nome da opção
Texto que será exibido na opção de meios de pagamento na finalização do
pedido.
Ordem
Ordem em que o método de pagamento será exibido.
Zona geográfica
Região onde o método de pagamento estará dispponível.
Ambiente
Modo operação comum a todos os meios de pagamento.
Sandbox: Utilizadas para operação em ambiente de
testes.
Produção: Utilizadas para operação em ambiente
real.
Ocultar seleção de método de pagamento
Quando habilitando a opção Forma de pagamento ficará
oculta na finalização do pedido. O método de pagamento Cielo
Checkout será selecionado automaticamente.
Status
Habilita a extensão.
Log de erros
Grava um histórico de dados de erros ou falhas. Consulte o histórico
acessando Configurações > Manutenção > Log de
erros e clique na aba cielo.log
Credenciais
Credenciais de Sandbox
Utilizadas para operaçãoem ambiente de testes. Para obter as credenciais MerchantId e MerchantKey de testes crie
uma conta em Cadastro do Sandbox.
Credenciais de Produção
Utilizadas para operação em ambiente real. As credenciais MerchantId e MerchantKey são fornecidas
pela Cielo após a afiliação do estabelecimento.
Status Transacional
Correlacione os status do pedido e do resultado da transação de pagamento.
Status do pagamento
Descrição
Não concluído
Aguardando atualização de status.
Autorizado
Pagamento apto a ser capturado mas ainda não concluído.
Pagamento confirmado
Pagamento confirmado e finalizado.
Negado
Pagamento negado.
Anulado
Pagamento cancelado.
Reembolsado
Pagamento cancelado após 23h59 do dia de autorização.
Solicite ao Suporte Cielo que
habilite a consulta de BIN.
Pix
Parâmetro
Descrição
Desconto
Desconto que será aplicado ao valor final do pedido.
Valor mínimo
Valor mínimo que o pedido deve atingir para que o meio de pagamento seja
habilitado.
Tamanho do QRCode (px)
Tamanho em pixels que o QRCode será exibido.
Status
Habilita o meio de pagamento.
Nota
Para habilitar o Pix no ambiente sandbox entre em contato com Suporte Cielo.
Antes de usar em produção, certifique-se de que o Pix está liberado
em seu cadastro. Para confirmar basta acessar o Portal Cielo na área logada em Meu
Cadastro > Autorizações > PIX
Fonte: Cielo
Boleto
Bancos disponíveis
Parâmetro
Descrição
Identificação do cedente
Identificação (CPF ou CNPJ) do lojista junto ao banco emissor (Bradesco
ou Banco
do Brasil).
Dias de vencimento
Dias de vencimento a partir do dia corrente para novos boletos. Máximo
de 30
dias.
Desconto
Desconto que será aplicado ao valor final do pedido.
Demobstrativo
Texto que constará no campo Demonstrativo do boleto.
instruções
Texto que constará no campo Instruções do boleto.
Valor mínimo
Valor mínimo que o pedido deve atingir para que o meio de pagamento seja
habilitado.
Status
Habilita o meio de pagamento.
Atualizar boletos
Dias de vencimento
Dias de vencimento a partir da data atual. Máximo
de 30 dias.
O Velocity é um tipo de mecanismo de prevenção a tentativas de fraude, que
analisa a frequência que determinados dados são utilizados numa transação e se
esse dados estão inscritos em uma lista de comportamentos passíveis de ações de
segurança.
Importante
Para que suas transações sejam analisadas pelo Velocity,
solicite a inclusão desse serviço ao Suporte Cielo.
Zero Auth
O Zero Auth é uma ferramenta da Cielo que permite verificar se um cartão está
válido para realizar uma compra antes que o pedido seja finalizado. Simula uma
autorização sem afetar o limite de crédito ou alertar o portador do cartão sobre
o teste. Suporta as bandeiras Visa, Master e Elo tanto para cartões de crédito
quanto de débito.
Parâmetro
Descrição
Status
Habilita o uso da ferramenta.
Importante
Para habilitar o Zero Auth, entre em contato com a equipe de
Suporte Cielo.
Silent Order Post (PCI DSS 3.2)
Com o Silent Order Post, os dados do cartão são trafegados de forma segura diretamente para os sistemas da Cielo.
Esse processo garante a confidencialidade das informações pois dos não passam pelo servidor do e-commerce.
Parâmetro
Descrição
ClientId
Chave fornecida pela Cielo para utilização da ferramenta.
Client Secret
Chave fornecida pela Cielo para utilização da ferramenta.
Status
Habilita o uso da ferramenta.
Nota
Para obter o ClientID e o
ClientSecret, envie um e-mail para o Suporte Cielo contendo o
MerchantId e informando que deseja obter as credenciais
para o Silent Order Post.
Autenticação 3DS 2.2
Protocolo de autenticação que confirma se o comprador é de fato o portador do
cartão de crédito ou débito. O objetivo do 3DS é evitar fraudes em transações de
cartão.
Parâmetro
Descrição
ClientId
Chave fornecida pela Cielo para utilização da ferramenta.
Client Secret
Chave fornecida pela Cielo para utilização da ferramenta.
Status
Habilita o uso da ferramenta.
Nota
Para obter o ClientID e o
ClientSecret, envie um e-mail para o Suporte Cielo contendo o
MerchantId e informando que deseja obter as credenciais
para Autenticação 3DS 2.2.
Notificação
Url que a Cielo enviará notificações sobre criação ou mudanças no status da
transação.
Parâmetro
Descrição
Nome do parâmetro
Parâmetro que deverá ser enviado na notificação. Possui valor fixo:
notificationKey
Chave
Valor do parâmetro notificationKey
Url
Url/endpoint que receberá as notificações.
Nota
Durante seu cadastro na Cielo, você deve configurar a Url, parâmetro e a
chave corretamente para que Cielo envie as notificações.
Os eventos só são notificados quando você solicitar o
recebimento desse tipo de notificação ao Suporte Cielo.
Importante
Siga corretamente as orientações de configuração das
notificações. Elas permitem que seu e-commerce se mantenha informado sobre
as transações em tempo real, ajudando a monitorar o fluxo de pagamentos.
Cliente preenche o formulário e clica em para enviar os dados.
Após o pagamento, é exibido a mensagem de confirmação e redirecionado
para a página de sucesso.
Nota
O Número de telefone será exibido apenas quando a
Autenticação 3DS 2.2 estiver habilitado.
Pix
Fluxo de pagamento
Cliente preenche o formulário e clica em para obter o QRCode.
O QRCode é exibido na tela aguardando confirmação de pagamento através
da leitura do QRCode ou copiar e colar código.
Após o pagamento, é exibido a mensagem de confirmação e redirecionado
para a página de sucesso.
Boleto
Para transacionar por boleto, você precisa primeiro contratar esse serviço com o banco.
Fluxo de pagamento
O comprador preenche o formulário e clica em confirmar.
O comprador será redirecionado para a página de sucesso.
O documento será aberto em uma nova aba ou janela do seu navegador.
Nota
A seleção do Banco emissor do boleto será exibido
apenas quando houver dois bancos configurados e habilitados.
GooglePay
O comprador deve estar logado na sua conta do Google.
Fluxo de pagamento
O comprador seleciona o método de pagamento e parcelamento e clica no
botão GPay.
Será aberto um popup do GooglePay solicitando que o comprador selecione
o cartão deseja utilizar.
Após o confirmação, é exibido a mensagem de pagamento concluído e
redirecionado para a página de sucesso.
Dashboard
Detalhes da transação
No painel de controle acesse Vendas > Pedidos e clique em
Exibir
Na página de Informações do pedido, clique em Detalhes da
transação.
As informações da transação de pagamento serão exibidas em um popup.
Área do cliente
Alterando método de pagemento
Caso o pedido tenha sido realizado com pagamento via Boleto e o status
estiver como Pendente, é possível alterar o método de pagamento ou
reimprimir o boleto (reimpressão de boleto).
Acesse Minha conta > Histórico de pedidos e clique em
Exibir
Na página de Informações do pedido, clique em Alterar
pagamento.
O fluxo de pagamento via Cartão, Pix e Carteira Digital seguem os mesmos passos apresentados na seção Checkout.
Para Boleto é possível apenas reimprimir ou atualizar o boleto (reimpressão de boleto).
Será aberto um popup com as opções de pagamento.
Reimpressão de boleto
Acesse Minha conta > Histórico de pedidos e clique em
Exibir
Na página de Informações do pedido, clique em Alterar
pagamento.
Após abrir o popup com as opções de pagamento, selecione a opção de
Boleto. Em seguida, clique em Reimprimir boleto, o
documento será aberto em uma nova aba ou janela do seu navegador.
Nota
Novos boletos só são emitidos após o vencimento do último boleto
impresso. Se o último boleto ainda estiver dentro do prazo de validade, ele será
reimpresso. Esse processo ajuda a evitar a emissão de múltiplos boletos com a
mesma data de vencimento.
Detalhes da transação
Com o cliente logado, acesse Minha conta > Histórico de pedidos e
clique em Exibir
Na página de Informações do pedido, clique em Detalhes da
transação.
As informações da transação de pagamento serão exibidas em um popup.
Anexo
Configurando boleto Bradesco
Ambiente Bradesco
Atenção
Não oferecemos suporte para configuração de boletos no ambiente
Bradesco.
O lojista precisará realizar configurações dentro do ambiente bancário.
Painel de controle
O lojista deverá contatar o gerente de relacionamento do Banco Bradesco para
solicitar a contratação do Boleto Registrado via Gerenciador API/Painel de controle.
A equipe técnica do Banco enviará para o e-mail do solicitante os dados de acesso ao
Gerenciador API/Painel de controle.
No campo Chave de Segurança clique em
Gerar chave de segurança
Endereço de IP da loja (numérico)
Para os campos de URL de resposta, URL de falha e URL de
redirecionamento, inserir o seguinte link:
https://www.pagador.com.br/post/BoletoBradescoSps/ReceivePost
Fonte: Cielo
Em cada um dos parâmetros, preencher com o Parâmetro de Comunicação
abaixo:
Chave de segurança criada dentro do Painel
do Bradesco. Não é a senha de acesso ao Painel
Bradesco
qcnmFA-Y2rGm4meWLzrEzSpdPARBsmblZSqfKLwq7DM
Configurando boleto Banco do Brasil
Atenção
Não oferecemos suporte para configuração de boletos no ambiente
Banco do Brasil.
Ambiente Banco do Brasil
O lojista deverá contatar o gerente de relacionamento do Banco do Brasil para
solicitar a habilitação do produto Boleto Registrado. O formulário a seguir deve ser
preenchido e entregue ao gerente.
