Funcionalidades

O conector Cielo E-commerce oferece as seguintes funcionalidades:

Split de Pagamento

O Split de Pagamento permite dividir automaticamente o valor de uma compra entre diferentes participantes, usando regras personalizadas. Para o comprador, o débito é único e aparece como um único lançamento na fatura.

Essa funcionalidade está disponível para os meios de pagamento:

Cartão de crédito;
Cartão de débito;
Boleto;
Pix.

Na VTEX, o Split é pré-transacional, ou seja, a divisão é feita no momento da autorização da transação.

⚠️
Fluxo de análise de fraude no Split de Pagamento
Se a transação for capturada fora do fluxo padrão entre VTEX e o Conector (como de forma manual ou automática pelo antifraude), o valor não será dividido corretamente.

Como habilitar o Split de Pagamento

Cadastre sellers na VTEX;
Cadastre seus sellers conforme a documentação;

ℹ️
A plataforma VTEX permite apenas sellers com CNPJ.

Abra chamado no Suporte Cielo;
Após cadastrar os sellers, abra um chamado no suporte Cielo e envie os dados dos sellers cadastrados na VTEX;

ℹ️
Se houver alteração nos dados dos sellers na VTEX, informe a Cielo sobre as mudanças.

Autenticação 3DS

A autenticação 3DS (3-D Secure) é um protocolo usado para confirmar se o comprador é realmente o titular do cartão, reduzindo riscos de fraude em transações online.

ℹ️
A integração Cielo com VTEX usa a versão 2.2 da autenticação 3DS.

O processo ocorre em duas etapas:

Autenticação inicial: o cliente insere o OTP (one-time password) fornecido pelo emissor ou instituição financeira.
Validação durante a autorização: o emissor valida a autenticação feita no passo anterior. Essa validação pode ser aceita ou recusada.

Para gerenciar as falhas nas etapas o 3DS, existem dois parâmetros específicos na configuração do conector:

MpiCancelOnFailure: define o comportamento quando ocorre erro na primeira etapa (autenticação inicial do 3DS);
MpiCancelOnECIDowngrade: define o que fazer quando ocorre um downgrade na segunda etapa (validação durante a autorização).

Valores possíveis para os parâmetros:

True (padrão): transação será cancelada automaticamente em caso de falha;
False: transação continua mesmo em casa de falha no 3DS.

⚠️
Configurar esses parâmetros como False significa que o lojista assume a responsabilidade por eventuais chargebacks.

DataOnly

O tipo de autenticação Data Only faz parte do protocolo 3DS, mas não exige desafio de autenticação;
A transação segue no modo frictionless (sem desafio) e sem liability shift (o risco de chargeback permanece com a loja).

Soft Descriptor

O Soft Descriptor é uma funcionalidade que permite personalizar o nome exibido na fatura do cartão do portador. Essa personalização traz mais transparência para o consumidor e reduz as chances de chargeback, pois muitos clientes contestam compras quando não reconhecem o nome do estabelecimento na fatura.

Antifraude

O Antifraude encaminha os dados de cada transação para análise de um provedor especializado em detecção de fraude. Esses provedores utilizam tecnologias como:

Identificação de dispositivo;
Geolocalização de IP;
Análise de redes sociais;
Detecção de proxy;
Contadores de repetição.

Após a análise, a Cielo recebe uma recomendação em tempo real e pode tomar ações com base no risco de fraude identificado.

A Cielo oferece integração com os provedores de análise de fraude Cybersource e Clearsale.

Fluxos de análise de fraude

Existem dois fluxos possíveis para a análise de fraude:

Análise de fraude primeiro (AnalyzeFirst): todas as transações são primeiro submetidas à análise do Antifraude e, se aceitas, seguem para o processo de autorização da adquirente;
Autorização primeiro (AuthorizeFirst): todas as transações são primeiro submetidas à autorização na adquirente e, se autorizadas, são enviadas para a análise do Antifraude.

Após escolher um fluxo, você pode ajustar o próximo passo:

Para AuthorizeFirst:
- Always: a análise de fraude é feita sempre, mesmo que a autorização seja negada;
- OnSuccess: a análise só ocorre quando a transação é autorizada;
Para AnalyzeFirst:
- Always: a autorização é feita sempre, mesmo que a análise ocorra com risco;
- OnSucess: a autorização só ocorre quando a análise de fraude é aprovada.

A Cielo também oferece as opções de cancelar a transação automaticamente caso a análise de fraude resulte em alto risco (VoidOnHighRisk) e capturar automaticamente caso a análise de fraude resulte em baixo risco (CaptureOnLowRisk).

Fingerprint

O Fingerprint é a identificação digital do dispositivo do comprador. Essa identificação é composta por uma série de dados coletados na página de checkout do site ou aplicativo como:

IP do dispositivo do comprador;
Versão do navegador;
Sistema operacional;
Compatibilidade entre idioma e país.

O Fingerprint identifica o dispositivo por sessão de navegação e permanece válido por aproximadamente 24 horas. Se a página for fechada e o comprador retornar ao site abrindo uma nova aba, ou se fechar o aplicativo e abri-lo novamente, é necessário gerar uma nova sessão e um novo identificador.

Para configurar o Fingerprint, consulte:

Velocity

O Velocity é uma funcionalidade que ajuda a identificar fraudes em compras online analisando a repetição de dados, como CPF, número do cartão, CEP e valor da compra. Essa ferramenta é eficiente para combater ataques em rajada (card testing ou testes de cartão), comuns em fraudes que afetam diretamente a taxa de conversão.

Os e-commerces podem usar o Velocity para:

Defender-se contra ataques de teste de cartão, um dos maiores ofensores da taxa de conversão;
Bloquear tentativas de fraude baseadas em comportamento repetitivo.

VerifyCard

O VerifyCard é composto por dois serviços: Zero Auth e Consulta BIN.

Zero Auth

O Zero Auth é um serviço que identifica se um cartão é válido por meio de uma operação semelhante à autorização, mas com valor R$ 0,00. Ele simula uma autorização sem impactar o limite de crédito nem alertar o portador do cartão sobre o teste.

Consulta BIN

O Consulta BIN é exclusivo para clientes Cielo e retorna informações do cartão a partir do BIN (seis primeiros dígitos do cartão).

Recorrência

O conector CieloEcommerce não oferece suporte para recorrência personalizada. No entanto, é possível configurar assinaturas ou cobranças recorrentes diretamente na VTEX.

Para saber como configurar e gerenciar recorrências, consulte a documentação oficial da VTEX.

Tokenização

Para facilitar o uso da recorrência na VTEX, é possível tokenizar os cartões usados nessas transações. A tokenização permite armazenar os dados do cartão em formato seguro, sem mantê-los expostos, garantindo:

Mais segurança no tráfego das informações;
Agilidade para o comprador, que precisa informar os dados do cartão apenas uma vez.

Para usar a tokenização, configure o campo SaveCard como true na configuração do conector CieloEcommerce.

Load Balance

O Load Balance é uma funcionalidade exclusiva da integração Gateway de Pagamento que permite roteamento condicionado de transações conforme regras configuradas. Com ele, é possível controlar quanto se deseja transacionar com cada adquirente, bandeira ou BIN.

Muitos estabelecimentos têm negociações de taxas com adquirentes atreladas a volume capturado ou até a bandeiras específicas. O Load Balance automatiza esse processo, eliminando a necessidade de gerenciamento manual.

O Load Balance sempre analisa a proporção do volume capturado definida na configuração. Por exemplo:

Se a loja foi configurada para direcionar 20% das transações para uma adquirente e 80% para outra, o sistema calcula qual opção mantém a proporção mais próxima no momento da transação.

Quando a transação chega ao Load Balance, ele avalia o destino que mais aproxima a distribuição configurada. Esse adquirente será usado para processar a transação.