---
updatedAt: 2026-10-14T21:17:12.000Z
agentTools:
siteIndex: https://docs.cielo.com.br/llms.txt
projectIndex: https://docs.cielo.com.br/conectores/llms.txt
---
# Funcionalidades
O conector Cielo E-commerce oferece as seguintes funcionalidades:
* [Split de Pagamento](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#split-de-pagamento);
* [Autenticação 3DS](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#autentica%C3%A7%C3%A3o-3ds);
* [Soft Descriptor](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#soft-descriptor);
* [Antifraude](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#antifraude);
* [Velocity](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#velocity);
* [VerifyCard](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#verifycard);
* [Recorrência](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#recorr%C3%AAncia);
* [Load Balance](https://docs.cielo.com.br/conectores/docs/funcionalidades-vtex#load-balance).
## 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
1. **Cadastre sellers na VTEX**;\
Cadastre seus sellers conforme a documentação;
A plataforma VTEX permite **apenas sellers com CNPJ**.
2. **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:
1. **Autenticação inicial**: o cliente insere o OTP (one-time password) fornecido pelo emissor ou instituição financeira.
2. **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:
* [Fingerprint ClearSale](https://docs.cielo.com.br/conectores/docs/clearsale-vtex);
* [Fingerprint Cybersource](https://docs.cielo.com.br/conectores/docs/cybersource-vtex).
***
## 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.
Para facilitar o uso da recorrência na VTEX, é possível permitir que a Cielo salve os cartões usados nessas transações. A Cielo armazena 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 permitir que a Cielo salve os cartões, 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.