A configuração da Cielo é feita no Admin (Administrador da plataforma) em 3 etapas:
- Formas de Pagamento
- Gestor de script
- Antifraude
- Grupos de Pagamento e Parcelamentos
1ª Etapa - Formas de Pagamento
No painel administrativo da plataforma acesse o menu Pagamentos >> Conectores de Pagamentos F-Gateway,como mostrado abaixo:
Depois se direcionar ao conector em >> Cielo>> "Adicionar Configuração".
Cadastre um nome para a configuração e selecione o tipo: Cartão
Descrições dos campos dos métodos de pagamentos disponíveis:
- Cartão de crédito sem antifraude integrado
- Cartão de crédito com antifraude integrado
Cartão de crédito:
Cartão de crédito :
É possível utilizar cartão de crédito sem Antifraude ou com as opções antifraude Personalizado, Clearsale Nativo ou Cybersource,que é integrado diretamente a Cielo.
Para as opções :Sem Antifraude, Personalizado ou Clearsale Nativo, realize a seguinte configuração:
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final)
Provider: Deverá ser preenchido de acordo com o provedor que o lojista tem contrato. Em caso de ajuda, solicite atendimento a equipe Cielo
Integration: Por padrão deverá ser preenchido sempre com Gateway
MerchantId: Chave disponibilizada pela Cielo
MerchantKey:Chave disponibilizada pela Cielo
SaveCard: True ou False, consulte a Cielo e valide as informações que constam em seu contrato
SOPClientId:Chave disponibilizada pela Cielo
SOPClientSecret: Chave disponibilizada pela Cielo
SoftDescriptor: É preenchido pelo próprio lojista e será o nome da loja que constará na fatura do cliente.
Aceita no máximo 13 caracteres e não aceita caracteres especiais.
UseVerifyCard: True ou False, consulte a Cielo antes do preenchimento
AcceptInternationalCard: True ou False, consulte a Cielo antes do preenchimento
AcceptPrePaidCard: True ou False, consulte a Cielo antes do preenchimento
Inserir tela do conector homologado Cielo com as configurações de antifraude:
Observação: manual/proprio é o mesmo que o personalizado, não deveria aparecer
Cartão de crédito com antifraude Cybersource|Clearsale via Cielo:
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final)
Provider: Deverá ser preenchido de acordo com o provedor que o lojista tem contrato. Em caso de ajuda, solicite atendimento a equipe Cielo
Integration: Por padrão deverá ser preenchido sempre com Gateway
MerchantId: Chave disponibilizada pela Cielo
MerchantKey:Chave disponibilizada pela Cielo
SaveCard: True ou False, consulte a Cielo e valide as informações que constam em seu contrato
SOPClientId:Chave disponibilizada pela Cielo
SOPClientSecret: Chave disponibilizada pela Cielo
SoftDescriptor: É preenchido pelo próprio lojista e será o nome da loja que constará na fatura do cliente.
Aceita no máximo 13 caracteres e não aceita caracteres especiais.
Antifraud: AuthorizeFirst ou AnalyseFirst, fluxo é definido pelo lojista
AntifraudSequenceCriteria: Always ou OnSuccess, fluxo é definido pelo lojis
AntifraudeProvider: Preencher com Cybersource ou Clearsale, sempre baseado no contrato do lojista
2ª Etapa - Gestor de script
Adicione o Script de fingerprint do provedor de antifraude. Para isso, no menu lateral esquerdo, vá em “Configurações” e em seguida selecione “Gestor de scripts”.
Clique em “+ Adicionar Script” e configure os campos conforme abaixo:
• Nome do script: DeviceFingerprintCybersource / DeviceFingerprintClearsale*
• Data inicial de exibição do Script: Deixar campo em branco
• Data Final de exibição do Script: Deixar campo em branco
• Status do script: {Selecionar “Script ativo”}
• Prioridade do script: 0
• Posição do Script na página: Header – Última Linha
• Páginas que o Script será inserido: Todas
• Identificador de página: *
Insira o script no campo “Conteúdo do Script”.
As informações de script serão disponibilizadas pela Cielo
Clique em “Adicionar Script”, depois clique em “Salvar”, e por fim clique em “Publicar”, ao final da página.
• *Para Clearsale, não se esqueça de incluir também o Script “functionFPClearSale”
Particularidades Script Cybersource:
Para o Script de fingerprint Cyber, é importante alterar o ORG_ID na
linha 10 a depender do ambiente utilizado:
- Para Sandbox: 1snn5n9w
- Para Produção: k8vif92e
• Lembre-se também de alterar a chave MERCHANT_ID na linha 11
para a chave Cybersource do cliente, modelo braspag_nome-da-loja.
• Não apagar as aspas
• Você também pode encontra-lo na Wiki de Conectores em
Plataformas > Wake > Passo a passo – Conector > Scripts
Particularidades Script Clearsale:
É necessário incluir os dois scripts abaixo para o AF Clearsale.
Na linha 2 do script de fingerprint, o APPKEYCLEAR deve ser:
- Sandbox: r3j6a9f10bmssayw2thp
- Produção: Chave Clearsale fornecida pela Cielo.
• Não apagar as aspas
• Você também pode encontrá-los na Wiki de Conectores em
Plataformas > Wake > Passo a passo – Conector > Scripts
3ª Etapa - Antifraude
O conector Cielo permite trabalhar com 3 antifraudes:
Antifraude Clearsale: Nossa plataforma tem integração direta com a Clearsale e permite que seus pedidos pagos com cartão de crédito passem pela análise de fraude. Para configurar, basta inserir o código App e a Chave da Clearsale na plataforma
Antifraude Manual/Personalizado: Funciona como um antifraude manual, permitindo que os pedidos pagos com cartão de crédito sejam processados em duas etapas: Autorização e Captura. Na primeira etapa, o pagamento é apenas autorizado junto à Cielo. Após a aprovação manual do pedido, o pagamento é então capturado.
Com esse antifraude, o pedido será atualizado para o status "Autorizado" na plataforma quando a Clearsale retornar com a autorização. Depois da análise manual, o pedido deve ser alterado via API Pública ou Admin para o status 14, "Pedido Aprovado Análise", para que a captura do pagamento seja finalizada na Cielo.
Lembrete: Você também pode definir um valor mínimo, fazendo com que somente os pedidos acima desse valor passem pelo Two-steps (Autorização e Captura). Pedidos abaixo sejam Capturados automaticamente.
Antifraude Cybersource/Clearsale via Cielo: O lojista possui a opção de ativar o antifraude diretamente com o parceiro através do painel da Cielo, conforme as condições estabelecidas em seu contrato.
4ª Etapa - Grupos de Pagamento e Parcelamentos
Após as primeiras configurações, você deverá clicar em Grupos e Parcelamentos >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.
Para criar o grupo de pagamentos para cartão de crédito, insira o nome de exibição incluindo "Cielo". Exemplo: "Cielo cartão".
Recomendações Gerais
- Realize um pedido teste com um cartão válido para verificar se o pagamento transacionará corretamente na Cielo;
- Cancelamento / Estorno de Pagamentos: A opção de Cancelamento do pedido está disponível em nossa API Pública, assim como a opção de Estorno total ou parcial. Essas ações devem ser feitas por uma aplicação externa usando nossa API Pública;
- Ao tentar realizar o pedido, o sistema de segurança da plataforma poderá bloquear as URLs externas da Cielo. Para orientações sobre o desbloqueio, confira o conteúdo Gerenciar Políticas de Segurança.
- Cancelar os pedidos manualmente na plataforma não estorna os pagamentos na Cielo. Sendo assim, cancele os pedidos também no painel da Cielo para que os pagamentos sejam realmente cancelados.