Sobre o Checkout Cielo
O Checkout Cielo é uma solução que agrega vários serviços de processamento de pagamento, no qual o consumidor é direcionado para uma página de pagamento online segura da Cielo. A página de pagamentos Cielo proporciona um alto nível de confiança, seguindo as normas de segurança PCI.
O grande diferencial do Checkout Cielo é a gama de serviços agregados em uma tela transacional segura e com apenas uma integração técnica via API REST.
O Checkout possui as seguintes Funcionalidades:
Funcionalidade | Descrição |
---|---|
Tela transacional | O Checkout Cielo possui uma tela transacional própria, com um layout otimizado, encurtando os passos no pagamento de suas transações. |
Recorrência | O Checkout Cielo possui a Recorrência Programada disponível na API Cielo Ecommerce. Basta que o lojista defina que uma transação deve se repetir, que o Checkout vai executa-la novamente no intervalo definido |
Antifraude | O Checkout já possui uma integração com o Antifraude da CyberSource, permitindo a análise de transações de crédito sem uma integração adicional |
Meios de pagamentos | O Checkout Cielo possui uma variada gama de meios de pagamento: Cartões de crédito Cartão de Débito Débito Online Boleto Bradesco e Banco do Brasil |
Backoffice Simplificado | O Backoffice do Checkout Cielo possui um layout simplificado e dinâmico que permite uma navegação rápida e confortável para que o Lojista possa acompanhar as vendas sem dificuldade |
Integração com Botão e QR Code | Sem integração técnica ou o programação, o Checkout disponibiliza uma integração que torna possível realizar a criação de um link gerador de pedidos apenas com um cadastro de produtos dentro do Backoffice Checkout. |
Relatórios transacionais | Dentro do Backoffice, é possível gerar relatórios transnacionais que facilitam a administração de suas vendas: Relatório de Recorrências Relatório de compradores Extrato de vendas Relatório de vendas |
O Checkout Cielo é uma funcionalidade indicada para:
- Sites com Carrinhos de compra: quando houver um “carrinho de compras” a ser enviado, ou seja, no caso do consumidor navegar pelo site e escolher 1 ou mais produtos a fim de finalizar a compra.
- Vendas via Redes sociais: Com a capacidade de gerar um link ou QR Code para levar o comprador a tela transacional, o Checkout é indicado para realizar vendas via redes sociais de modo simplificado, sem a necessidade de integração técnica.
Meios de pagamento do Checkout Cielo
A versão atual do Checkout Cielo possui suporte aos seguintes meios de pagamento:
Cartão de Crédito
Bandeira | Crédito à vista | Crédito parcelado Loja | Débito | Voucher |
---|---|---|---|---|
Visa | Sim | Sim | Sim | Não |
MasterCard | Sim | Sim | Sim | Não |
American Express | Sim | Sim | Não | Não |
Elo | Sim | Sim | Sim* | Não |
Diners Club | Sim | Sim | Não | Não |
Discover | Sim | Não | Não | Não |
JCB | Sim | Sim | Não | Não |
Aura | Sim | Sim | Não | Não |
Hipercard | Sim | Sim | Não | Não |
OBS: Limite máximo de parcelas do Checkout Cielo é 12X.
Cartão de Débito
Bandeira | Banco |
---|---|
Visa | Bradesco Banco do Brasil HSBC Santander Itaú BRB Safra Banco da Amazônia Sicredi Banco do Espirito Santo Banco do Nordeste Mercantil |
Mastercard | Banco do Brasil Santander Itaú BRB Sicredi Bancoob CitiBank |
Elo* | Caixa Ecônomica Federal |
Boleto
Banco | Tipo |
---|---|
Bradesco | Não registrado |
Bradesco | Registrado SPS |
Banco do Brasil | Registrado |
Débito Online
Banco |
---|
Bradesco |
Banco do Brasil |
Pré-requisitos para Integração
O Checkout Cielo possui uma lista de requisitos básicos para que o processo de integração seja bem sucedido. Abaixo listamos pontos que devem estar prontos antes da integração:
-
O cadastro da loja deve estar ativo junto à Cielo, possuindo ao menos um tipo de PLANO de pagamento atrelado a conta.
-
Deve-se definir um timeout adequado nas requisições HTTP à Cielo; recomendamos 30 segundos.
-
O certificado Root da entidade certificadora (CA) de nosso Web Service deve estar cadastrado na Truststore a ser utilizada. Como nossa certificadora é de ampla aceitação no mercado, é provável que ela já esteja registrada na Truststore do próprio sistema operacional. Veja a seção Certificado Extended Validation para mais informações.
-
O Checkout funciona de forma eficiente apenas nos navegadores suportados:
Navegador | Versão |
---|---|
Chrome | V40.0 ou posterior |
FireFox | V34.0.5 ou posterior |
Internet Explorer | 10 ou superior |
Safari (MAC/iOS) | 7 ou posterior |
Opera | V26 ou posterior |
OBS: Para que compradores e lojistas obtenham a melhor experiência do Checkout Cielo, recomendamos baixar a última versão dos navegadores mencionados acima.
Confira este site para visualizar as últimas versões dos navegadores.
Observação: navegadores antigos podem negar acesso ao Checkout Cielo e alguns recursos não funcionarão como desejado. Navegadores mais recentes também oferecem melhores recursos de encriptação e privacidade.
Se um recurso ainda não funcionar como esperado:
- Tente utilizar outro navegador como solução temporária para o problema.
- Se você utiliza o Internet Explorer, tente desativar o modo de compatibilidade.
Se você já tentou essas soluções, mas continua a ter problemas, entre em contato conosco pelo Suporte Cielo e forneça as seguintes informações:
- Uma explicação geral do problema.
- O navegador e a versão que estão sendo utilizados.
- O sistema operacional e a versão utilizada no computador.
- Uma captura de tela do problema.
Certificado Extended Validation
O que é Certificado SSL?
O Certificado SSL para servidor web oferece autenticidade e integridade dos dados de um web site, proporcionando aos clientes das lojas virtuais a garantia de que estão realmente acessando o site que desejam, e não uma um site fraudador.
Empresas especializadas são responsáveis por fazer a validação do domínio e, dependendo do tipo de certificado, também da entidade detentora do domínio.
Internet Explorer:
Firefox
Google Chrome
O que é Certificado EV SSL?
O Certificado EV foi lançado no mercado recentemente e garante um nível de segurança maior para os clientes das lojas virtuais.
Trata-se de um certificado de maior confiança e quando o https for acessado a barra de endereço ficará verde, dando mais confiabilidade aos visitantes do site.
Como instalar o Certificado Extended Validation no servidor da Loja?
Basta instalar os três arquivos a seguir na Trustedstore do servidor. A Cielo não oferece suporte para a instalação do Certificado. Caso não esteja seguro sobre como realizar a instalação do Certificado EV, então você deverá ser contatado o suporte do fornecedor do seu servidor.
- Certificado Raiz
- Certificado Intermediária 1
- Certificado Intermediária 2
- Certificado E-Commerce Cielo
Passo a Passo para a Instalação
Instalação no Servidor da Loja Virtual
O passo a passo para a instalação do Certificado EV deverá ser contatado o suporte do fornecedor do seu servidor.
Acesso do Cliente à Loja Virtual
Normalmente, o browser faz a atualização do Certificado automaticamente, caso não o faça e o cliente entre em contato deverá ser informado os seguintes passos:
1º Passo
Salvar os três arquivos abaixo em uma pasta nova, ou que relembre facilmente, pois será utilizada posteriormente:
- Certificado Raiz
- Certificado Intermediária 1
- Certificado Intermediária 2
- Certificado E-Commerce Cielo
2º Passo
No “Internet Explorer”, clique no menu “Ferramentas” e acesse as “Opções da Internet”:
No “Firefox”, clique no menu “Abrir Menu” e acesse “Avançado” e “Opções”:
No “Chrome”, clique no “Personalizar e Controlar o Google Chrome” e acesse “Configurações” e “Mostrar configurações avançadas… “Alterar Configurações de Proxy e “Conteúdo” e Certificados:
3º Passo
No Internet Explorer, em “Certificados”, clique em “Importar”.
No Firefox clique em “Ver Certificados”, clique em “Importar”
No Chrome clique em “Gerenciar Certificados”, clique em “Importar”
4º Passo
No Internet Explorer e Chrome “Assistente para Importação de Certificados”, clique em “Avançar”.
No Firefox “Aba Servidores ”, clique em “Importar”
5º Passo
No Chrome e Internet Explorer “Assistente para Importação de Certificados”, clique em “Procurar”, procure a pasta onde estão os arquivos e selecione o arquivo “cieloecommerce.cielo.com.br.crt, clique em “Abrir” e em seguida “Avançar”.
6º Passo
Selecionar a opção desejada: adicionar o Certificado em uma pasta padrão ou procurar a pasta de sua escolha.
7º Passo
Clique em “Concluir”.
8º Passo
Clique em “Ok” para concluir a importação.
O Certificado poderá ser visualizado na aba padrão “Outras Pessoas” ou na escolhida pelo cliente.
9º Passo
Repita o mesmo procedimento para os 3 arquivos enviados.
Integrando o Checkout Cielo
Nesta documentação estão descritas todas as funcionalidades da integração da API Checkout Cielo, os parâmetros técnicos e principalmente os códigos de exemplos para facilitar o seu desenvolvimento.
Existem duas maneiras de realizar a integração:
Tipo | Descrição |
---|---|
API |
É utilizada uma Integração via API que permite o lojista enviar o “Carrinho de compras” do seu site com todos os dados que ele deseja apresentar na tela transacional. Neste tipo de integração o lojista possui maior controle sobre como o pedido será gerado. |
Botão / QR Code / Link |
Dentro do Backoffice do Checkout Cielo, é possível registrar um produto ou grupo de produtos que vão gerar um Link capaz de criar várias telas de pagamento. Esse modelo é usado para pagamentos por redes sociais, campanhas promocionais ou Vendas via QR Code. Nessa categoria o lojista possui menos controle sobre como os pedidos serão apresentados ou gerados na tela transacional |
Fluxo de integração
Durante a integração com o Checkout Cielo, uma seguencia de troca de informações e redirecionamentos serão executados para que a uma transação seja criada e executada.
Veja o fluxo abaixo:
Fluxo de integração Checkout Cielo - Diagrama sequêncial
Fluxo de integração Checkout Cielo - Fluxograma
Após o portador do cartão (consumidor) selecionar suas compras e apertar o botão “Comprar” de uma loja já integrada ao Checkout Cielo, o fluxo nesta ordem:
- A API da Cielo retorna o CheckoutURL, que é a URL da tela transacional montada com base nos dados enviados pelo Lojista/Botão.
- A loja redireciona o cliente para a URL retornada pela Cielo. A tela apresentada é parte do Ambiente de pagamento seguro Cielo.
- O portador escolhe: Meio de pagamento, tipo de frete e endereço de entrega na tela transacional
- O Checkout Cielo redireciona o cliente para a URL de Retorno escolhida pela loja, configurada no Backoffice Checkout Cielo ou enviada pela integração via API.
- Se a loja possui uma URL de notificação, ela será notificada sobre a situação da transação.
- A loja avisa ao cliente que o processo foi concluído e que ele receberá mais informações sobre a compra e o pagamento por e-mail.e
- A loja processa o pedido de compra utilizando os dados do POST de notificação e, se a transação estiver autorizada, libera o pedido.
OBS: O Checkout Cielo não notifica os compradores a respeito do status de compra, apenas ao lojista. Isso ocorre pois permite ao lojista decidir quando e como informar aos seus consumidores sobre o prazo de entrega e processo de envio
Modo de teste do Checkout Cielo
O modo de teste Checkout Cielo é uma ferramenta que permite testar a integração do seu site com a plataforma. Com o modo teste, você pode realizar transações a medida que evolui com a integração e consegue simular cenários para testar diferentes meios de pagamento.
Ativação do Modo de Teste
O modo de teste pode ser ativado na aba Configurações, onde existe um caixa de seleção, que quando marcada, habilitará o modo de teste do Checkout Cielo. O modo somente se iniciará quando a seleção for salva.
Quando a opção for salva, uma tarja vermelha será exibida na parte superior da tela. Ela será exibida em todas as telas do Backoffice Cielo Checkout e na tela transacional do Checkout Cielo.
Essa tarja indica que a sua loja Checkout Cielo está agora operando em ambiente de teste, ou seja, toda a transação realizada nesse modo será considerada como teste.
Backoffice | Transacional |
---|---|
![]() |
![]() |
Como transacionar no Modo de teste
A realização de transações no modo de teste ocorre de forma normal. As informações da transação são enviadas via POST ou API, utilizando os parâmetros como descrito no tópico Integração por API, entretanto, os meios de pagamentos a serem usados serão meios simulados.
Para realizar transações de teste com diferentes meios de pagamento, siga as seguintes regras:
A - Transações com Cartão de crédito:
Para testar cartões de crédito é necessário que dois dados importantes sejam definidos, o status da autorização do cartão e o retorno da analise de fraude.
Status da Autorização do Cartão de Crédito
Status da Transação | Cartões para realização dos testes |
---|---|
Autorizado | 0000.0000.0000.0000 / 0000.0000.0000.0004 |
Não Autorizado | 0000.0000.0000.0005 / 0000.0000.0000.0009 |
Exemplo: 5404434242930100 = Autorizado
B - Boleto Bancário
Basta realizar o processo de compra normalmente sem nenhuma alteração no procedimento. O boleto gerado no modo de teste sempre será um boleto simulado.
C - Debito online
É necessário informa o status da transação de Debito online para que seja retornado o status desejado. Esse processo ocorre como no antifraude do cartão de crédito descrito acima, com a alteração do nome do comprador.
Status do Débito
Sobre nome do cliente | Status |
---|---|
Pago | Pago |
Qualquer nome. | Não autorizado |
- Exemplo: Status não Autorizado.
- Nome do Cliente: Maria Pereira
D - Transações de teste
Todas as transações realizadas no modo de teste serão exibidas como transações normais na aba Pedidos do Checkout Cielo, entretanto, elas serão marcadas como transações de teste e não serão contabilizadas em conjunto com as transações realizadas fora do ambiente de teste.
Essas transações terão o símbolo de teste as diferenciando de suas outras transações. Elas podem ser capturadas ou canceladas utilizando os mesmos procedimentos das transações reais.
SDKs e POSTMAN
O Checkout Cielo possui uma coleção POSTMAN de testes exclusiva com todos os parâmetros e opções descritas neste manual. Basta acessar nosso Tutorial para obter informações sobre a utilização da ferramenta.
No postman é possível criar exemplos de sua integração em:
- PHP
- RUBY
- C#
- JAVA
- PYTHON
- SHELL
Integração por API
Este tipo de integração deve ser usada sempre que houver um “carrinho de compras” a ser enviado, ou seja, no caso do consumidor navegar pelo site e escolher 1 ou mais produtos para adicionar a um carrinho e depois então finalizar a venda.
Se você não possui um carrinho de compras implementado, veja a seção de Integração via botão Checkout Cielo.
Abaixo, é demonstrado como o fluxo de compra ocorre na integração via API:
Criando o Carrinho
Na integração via API, a tela transacional é “montada” com bases em dados enviados que formam um Carrinho de compras. Esses dados são separados nos seguintes “nós principais”:
Nó | Descrição |
---|---|
Cart |
Contem dados dos produtos a serem vendidos. |
Shipping |
Contem dados do tipo de frete a ser cobrado. É influenciado pelo nó Cart |
Payment |
Contem informações que influenciam o valor cobrado. Não contem informações sobre meios de pagamento |
Customer |
Possui dados o comprador. Não obrigatório na integração, mas exigido na tela de pagamentos. Sugerimos que seja enviado para acelerar o processo de compra |
Options |
Controla features opcionais do Checkout. Nó não obrigatório |
Após o envio dos dados do carrinho, o Checkout enviará um Response contendo um LINK para a tela de pagamento
IMPORTANTE: Uma chamada a API Checkout NÃO CRIA UMA TRANSAÇÃO. O Link retornado é apenas uma “pré-ordem” indicando que uma tela transacional está pronta para ser utilizada. A Transação é criada apenas quando o comprador clica em “FINALIZAR”
Request
Endpoint é a URL para onde as requisições com os dados do carrinho serão enviadas. Todas as requisições deverão ser enviadas utilizando o método HTTP POST, para o endpoint:
Produção https://cieloecommerce.cielo.com.br/api/public/v1/orders
.
Exemplo de uma requisição
{
"OrderNumber":"Pedido01",
"SoftDescriptor":"Exemplo",
"Cart":{
"Discount":{
"Type":"Percent",
"Value":00
},
"Items":[
{
"Name":"Produto01",
"Description":"ProdutoExemplo01",
"UnitPrice":100,
"Quantity":1,
"Type":"Asset",
"Sku":"ABC001",
"Weight":500
},
]
},
"Shipping":{
"SourceZipCode":"20020080",
"TargetZipCode":"21911130",
"Type":"FixedAmount",
"Services":[
{
"Name":"Motoboy",
"Price":1,
"Deadline":15,
"Carrier":null
},
{
"Name":"UPS Express",
"Price":1,
"Deadline":2,
"Carrier":null
}
],
"Address":{
"Street":"Rua Cambui",
"Number":"92",
"Complement":"Apto 201",
"District":"Freguesia",
"City":"Rio de Janeiro",
"State":"RJ"
}
},
"Payment":{
"BoletoDiscount":15,
"DebitDiscount":10,
"Installments":null,
"MaxNumberOfInstallments": null
},
"Customer":{
"Identity":"84261300206",
"FullName":"Test de Test",
"Email":"test@cielo.com.br",
"Phone":"21987654321"
},
"Settings":null
}
Header/Cabeçalho
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
MerchantId |
Guid | Sim | 36 | Identificador único da loja. Formato: 00000000-0000-0000-0000-000000000000 |
Content-type |
Alphanumeric | Sim | n/a | Tipo do conteúdo da mensagem a ser enviada. Utilizar: “application/json” |
Cabeçalho e Autenticação - Todas as requisições enviadas para a Cielo deverão ser autenticadas pela loja. A autenticação consiste no envio do MerchantId
, que é o identificador único da loja fornecido pela Cielo após a afiliação da loja. A autenticação da loja deverá ser feita através do envio do campo de cabeçalho HTTP MerchantId
, como ilustrado abaixo e ao lado:
Body - Detalhado
Campo | Tipo | Obrigatório | Tamanho | Condicional |
---|---|---|---|---|
OrderNumber |
Alphanumeric | Opcional | 64 | |
SoftDescriptor |
Alphanumeric | Opcional | 13 | |
Cart.Discount.Type |
Alphanumeric | Condicional | 255 | Obrigatório caso Cart.Discount.Value for maior ou igual a zero. |
Cart.Discount.Value |
Numeric | Condicional | 18 | Obrigatório caso Cart.Discount.Type for Amount ou Percent . |
Cart.Items.Name |
Alphanumeric | Sim | 128 | |
Cart.Items.Description |
Alphanumeric | Opcional | 256 | |
Cart.Items.UnitPrice |
Numeric | Sim | 18 | |
Cart.Items.Quantity |
Numeric | Sim | 9 | |
Cart.Items.Type |
Alphanumeric | Sim | 255 | |
Cart.Items.Sku |
Alphanumeric | Opcional | 32 | |
Cart.Items.Weight |
Numeric | Condicional | 9 | Necessário caso Shipping.Type for “Correios”. |
Payment.BoletoDiscount |
Numeric | Condicional | 3 | |
Payment.DebitDiscount |
Numeric | Condicional | 3 | |
FirstInstallmentDiscount |
Numeric | Condicional | 3 | |
MaxNumberOfInstallments |
Numeric | Condicional | 2 | |
Customer.Identity |
Numeric | Condicional | 14 | Não obrigatório na API, mas obrigatório na tela transacional. |
Customer.FullName |
Alphanumeric | Condicional | 288 | Não obrigatório na API, mas obrigatório na tela transacional. |
Customer.Email |
Alphanumeric | Condicional | 64 | Não obrigatório na API, mas obrigatório na tela transacional. |
Customer.Phone |
Numeric | Condicional | 11 | Não obrigatório na API, mas obrigatório na tela transacional. |
Options.ReturnUrl |
Strin | Condicional | 255 | Uma URL fixa pode ser registrada no Backoffice Checkout. |
Responses
Devido ao seu fluxo de venda ser dividido em duas etapas, sendo a primeira, a criação da tela transacional e a segunda, a finalização do pagamento; O Checkout possui duas respostas para uma transação:
- Response - Tela transacional - É o Response retornado com dados para enviar o comprador para a tela transacional
- Response - Transação Finalizada - Contém dados sobre o resultado da transação, após o comprador clica em “Finalizar” na tela transacional. É retornado apenas via Notificação
Resultado/Status da transação: Para obter o retorno do status da transação, é necessário definir uma URL de NOTIFICAÇÃO. Veja a sessão de notificação para maiores informações.
Response - Tela transacional
Existem apenas duas opções de resposta na integração da API: Sucesso / Erro
Sucesso - Em caso de sucesso, o response será o conteúdo do Request mais o Link que direciona a tela transacional
{
"Settings": {
"CheckoutUrl": "https://cieloecommerce.cielo.com.br/transacional/order/index?id=123",
"Profile": "CheckoutCielo",
"Version": 1
}
}
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
CheckoutUrl |
String | Sim | 255 | URL da tela transacional. O Comprador deve ser direcionado a esse ambiente para finalizar a transação |
Profile |
String | Sim | 16 | Perfil do lojista: fixo “CheckoutCielo”. |
Version |
String | Sim | 1 | Versão do serviço de criação de pedido (versão: 1). |
Erro - Em caso de erro, a mensagem abaixo será retornada.
{
"message":"An error has occurred."
}
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
Message |
String | Sim | 254 | Mensagem descritiva do erro |
Importante - O Checkout Cielo não possui erros numerados, apenas uma mensagem genérica. Veja a sessão “Identificando erros de Integração” para maiores informações
Funcionalidades Adicionais
Nos itens a seguir, será explicado o comportamento de algumas das funcionalidades da integração via API. Essas funcionalidades possuem regras especificas para utilização e não estão disponíveis na integração via Botão.
- Tipos de “Desconto”
- Tipos de “Frete”
Tipos de “Desconto”
O Checkout Cielo permite que o lojista aplique descontos específicos tanto para o carrinho quanto para meios de pagamento. Os descontos disponíveis no Checkout Cielo são:
Desconto | Aplicação | Descrição |
---|---|---|
Carrinho |
API | Quando enviado, aplica o desconto sobre todo o carrinho, independente do meio de pagamento |
Boleto |
API e Backoffice | Quando enviado, o desconto é aplicado somente caso o Boleto seja o meio de pagamento escolhido |
Débito Online |
API e Backoffice | Quando enviado, o desconto é aplicado somente caso o Débito online seja o meio de pagamento escolhido |
A vista |
API | Quando enviado, o desconto é aplicado quando Cartão de crédito a vista é o meio de pagamento escolhido |
OBS: Descontos podem ser enviados na API ou definidos no Backoffice. Caso um Valor de desconto seja enviado na API, esse será o valor considerado, mesmo que o Backoffice possua outro valor registrado
Carrinho
Para enviar um Desconto sobre o Carrinho
basta enviar o nó abaixo dentro do nó Cart
{
"Discount": {
"Type":"Percent",
"Value":00
},
}
Campo | Tipo | Obrigatório | Tamanho | Descrição | Condicional |
---|---|---|---|---|---|
Cart.Discount.Type |
Alphanumeric | Condicional | 255 | Tipo do desconto a ser aplicado: Amount ou Percent . |
Obrigatório caso Cart.Discount.Value for maior ou igual a zero. |
Cart.Discount.Value |
Numeric | Condicional | 18 | Valor do desconto a ser aplicado: Valor ou Percentual | Obrigatório caso Cart.Discount.Type for Amount ou Percent . |
Abaixo, como o efeito do desconto são apresentados no Carrinho:
Percentual | Valor |
---|---|
![]() |
![]() |
Boleto & Débito Online
Para enviar um Desconto sobre o Boleto
e Débito online
basta enviar dentro do nó Payment os campos abaixo:
{
"Payment": {
"BoletoDiscount":15,
"DebitDiscount":10,
"FirstInstallmentDiscount":90
},
}
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
Payment.BoletoDiscount |
Numeric | Condicional | 3 | Desconto, em porcentagem, para pagamentos a serem realizados com boleto. |
Payment.DebitDiscount |
Numeric | Condicional | 3 | Desconto, em porcentagem, para pagamentos a serem realizados com débito online. |
Payment.FirstInstallmentDiscount |
Numeric | Condicional | 3 | Desconto, em porcentagem, para pagamentos a vista no Cartão de crédito |
Abaixo, como o efeito do desconto são apresentados no Carrinho:
Tela transacional |
---|
![]() |
Tipos de “Frete”
O Checkout cielo possui diferentes tipos de frete.
Campo | Descrição |
---|---|
FixedAmount |
Valor fixo enviado pelo lojista. Utilizado caso o Lojista possua um método de entrega próprio |
Free |
Não realiza cálculo de frete e exibe na tela transacional “Frete Grátis” |
WithoutShippingPickUp |
Considerado “Retirada na loja” |
WithoutShipping |
Sem cobrança de frete (aplicável para serviços e produtos digitais). |
Correios |
Utiliza a API dos correios para realizar o cálculo do custo. O valor do cálculo dependerá o contrato utilizado (Escolhido no Backoffice do checkout) e do tipo de integração para cálculo: Frete com Volume ou Frete sem Volume |
Abaixo, como cada opção é demonstrada na tela transacional
Tipo de frete | Transacional |
---|---|
FixedAmount |
![]() |
Free |
![]() |
WithoutShippingPickUp |
![]() |
WithoutShipping |
![]() |
Correios |
![]() |
OBS: As opções para múltiplos fretes na categoria Correios
devem ser selecionadas dentro do Backoffice Cielo.
Os nós que formam as informações de frete abaixo:
- Shipping - Nó base. É obrigatório na integração via API. Ele define os tipos de frete a serem utilizados
Campo | Tipo | Obrigatório | Tamanho | Descrição | Condicional |
---|---|---|---|---|---|
Shipping.Type |
Alphanumeric | Sim | 255 | Tipo do frete: Correios FixedAmount Free WithoutShippingPickUp WithoutShipping |
|
Shipping.SourceZipCode |
Numeric | Condicional | 8 | CEP de origem do carrinho de compras. | Obrigatório caso Shipping.Type for “Correios”. |
Shipping.TargetZipCode |
Numeric | Opcional | 8 | CEP do endereço de entrega do comprador. |
Shipping.Address - Informações de endereço de entrega. Não obrigatório no contrato da API, mas obrigatório na tela transacional. Sugerimos que esses dados sejam enviados, se ja foram recolhidos dentro do ambiente da loja.
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
Shipping.Address.Street |
Alphanumeric | Sim | 256 | Rua, avenida, travessa, etc, do endereço de entrega do comprador. |
Shipping.Address.Number |
Alphanumeric | Sim | 8 | Número do endereço de entrega do comprador. |
Shipping.Address.Complement |
Alphanumeric | Opcional | 14 | Complemento do endereço de entrega do comprador. |
Shipping.Address.District |
Alphanumeric | Sim | 64 | Bairro do endereço de entrega do comprador. |
Shipping.Address.City |
Alphanumeric | Sim | 64 | Cidade do endereço de entrega do comprador. |
Shipping.Address.State |
Alphanumeric | Sim | 2 | Estado (UF) do endereço de entrega do comprador. |
Shipping.Services
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
Shipping.Services.Name |
Alphanumeric | Sim | 128 | Nome do serviço de frete. |
Shipping.Services.Price |
Numeric | Sim | 18 | Preço do serviço de frete em centavos. Ex: R$ 1,00 = 100. |
Shipping.Services.Deadline |
Numeric | Condicional | 9 | Prazo de entrega (em dias). |
O Frete Correios pode ser calculado de 2 maneiras:
- Frete com Volume - Utiliza a API dos correios, mas exige que a loja envie as dimensões do pacote a ser enviado com as mercadorias
- Frete sem Volume - Utiliza a API dos correios, mas considera apenas o peso do carrinho como base de cálculo para a entrega.
Para utilizar o frete volumétrico, basta enviar o nó Shipping.Measures
, seguindo as regras de integração via API REST.
Shipping.Measures
Campo | Tipo | Obrigatório | Tamanho | Descrição | Condicional |
---|---|---|---|---|---|
Shipping.Package |
Alphanumeric | Obrigatório | Inteiro | Tipo de pacote: BOX - Caixa ROL - Cilindro ou ENVELOPE |
|
Shipping.Lenght |
Numeric | Obrigatório | Inteiro | Comprimento do pacote | |
Shipping.Height |
Numeric | Condicional | Inteiro | Altura do pacote enviado | Obrigatório caso Shipping.Package como BOX |
Shipping.Width |
Numeric | Condicional | Inteiro | Largura do pacote. | Obrigatório caso Shipping.Package como BOX ou ENVELOPE |
Shipping.Diameter |
Numeric | Condicional | Inteiro | Diâmetro do pacote. | Obrigatório caso Shipping.Package como ROL |
Para realizar o cálculo de frete via Correios é necessário respeitar as medidas definidas pelo contrato utilizado pelo lojista. Para maiores informações sobre as dimensões e pesos permitidos, sugerimos que valide o contrato da loja no link abaixo:
Limites e dimensões para entregas do correio
Identificando Erros de integração
Devido a estrutura do checkout Cielo, onde o comprador é redirecionado para um ambiente separado para completa a transação, existem possibilidades de erros e falhas de integração em diferentes momentos do fluxo de pagamento. Durante a integração é importante Há dois tipos de erro que poderão ocorrer durante o processo de integração com o Checkout Cielo. São eles:
Tipo de frete | Transacional |
---|---|
Pré-Tela transacional | Significa que houve algum dado errado no envio da transação. Dados obrigatórios podem estar faltando ou no formato invalido. Aqui o lojista sempre vai receber um e-mail informando o que deu errado |
Pós-Tela transacional | Significa que há algum impedimento de cadastro que limita a venda. Coisas como afiliação bloqueada, erro nos dados salvos no cadastro ou até problemas no próprio checkout |
Caso algum erro ocorra após a finalização da transação, entre em contato com o Suporte Cielo.
Integração por BOTÃO
Integração via Botão, QR CODE ou LINK é um método de compra usada sempre que não houver um “carrinho de compras” em sua loja. Esse tipo de integração é realizado via o cadastro de um conjunto de itens a ser vendido on backoffice do Checkout Cielo.
O botão gera um do 3 tipos diferentes de métodos de acesso a mesma tela transacional:
Método | Nome | Descrição |
---|---|---|
![]() |
Botão | É um código HTML que ao ser colado em um site, vai direcionar o comprador a tela transacional - Ideal para uso em hotSites ou E-mail Marketing |
![]() |
QRCODE | Código interpretável por Smartphones e Tablets - Ideal para uso em Marketing impressos ou Digital |
http://bit.ly/2tRkSxZ |
LINK | é um link compartilhável, ideal para uso em Redes Sociais ou Messengers Mobile |
Este modelo de integração é utilizado para:
- Associar uma compra rápida direta a um produto como uma promoção numa homepage pulando a etapa do carrinho.
- Enviar um e-mail marketing, ou uma cobrança via e-mail.
- Adicionar o botão (HTML) referente ao produto/serviço a ser comprado/pago.
- Realizar envio de pagamentos por aplicativos mobile
- Sempre que se deseja disponibilizar uma venda rápida.
Para utilizar este recurso, é necessário cadastrar o produto que se deseja vender, suas informações, e depois simplesmente copiar o código fonte gerado para este botão. A inclusão dos produtos é feita dentro do Backoffice Cielo Checkout, no menu de Produtos/Cadastrar Produto.
Características do Botão
Cada botão possui um código único que só permite comprar aquele determinado produto nas condições de preço e frete cadastrado. Portanto, um fraudador não consegue alterar nenhuma destas informações na hora de submeter à compra, pois o Checkout Cielo vai buscar todos os dados do produto no cadastro do Backoffice Cielo Checkout, e valerão os dados do cadastro.
Característica | Explicação |
---|---|
Específico | Cada botão gerado serve somente para um determinado produto ou grupo de produtos. A quantidade e volume de produtos vendido é definido no cadastro do Botão, não sendo possível altera a quantidade na tela transacional Exemplo: Será necessário criar Um botão para vender 1 camisa. Se o comprador desejar 2 camisas, ele precisará usar o botão 2X ou O lojista deverá criar um botão com 2 camisas |
Número do Pedido do Checkout | O botão não permite o cadastro do número de pedido do Lojista. Como será a Cielo a acionar o próprio Checkout, será gerado um número de pedido (um GUID ) único. O Lojista receberá esse número de pedido como link a venda realizada |
Criação de pedidos | Um botão gera vários pedidos independentes, ou seja, para limitar a quantidade de pedidos gerados por um botão, QRCODE ou Link criado, é necessário definir uma quantidade mínimas de itens em “estoque” no momento de cadastro. O Botão é um método de chamadas à API Checkout. Cada vez que ele é acionado, uma nova requisição é feita a API, criando assim um novo pedido |
Abaixo, o fluxo de pagamento via Botão:
Criando o Botão
Para utilizar este recurso, é necessário cadastrar o produto que se deseja vender, suas informações, e depois simplesmente copiar o código fonte gerado para este botão. A inclusão dos produtos é feita dentro do Backoffice Cielo Checkout, no menu de Produtos/Cadastrar Produto.
Tela de Cadastro:
Botão Cadastrado:
Abaixo a listagem de itens que devem ser cadastrados para a criação do botão:
Campos | Descrição | Tamanho Min. | Tamanho Máx. | Obrigatório |
---|---|---|---|---|
Tipo do Produto |
Indique se está vendendo um bem Material, um Serviço ou um bem Digital. Para bens Digitais, não será apresentada a opção de tipo de Frete. | n/a | n/a | Sim |
SKU |
Código de identificação do produto | 1 | 50 | Não |
Título |
Titulo do Produto | 1 | 50 | Sim |
Descrição |
Descrição do Produto | 1 | 255 | Sim |
Preço |
Valor total do pedido em centavos (ex.: R$1,00 =100). | 11 | 14 | Sim |
Frete |
Escolher dentre uma das opções de Frete (Correios, Frete Fixo, Frete Grátis, Retirar na loja, Sem Cobrança). | n/a | n/a | Sim |
CEP de Origem |
Esse campo só aparece para o frete tipo Correios, deve ser preenchido com o CEP de onde vai partir a mercadoria para fins de cálculo de frete. | 9 | 9 | Sim |
Peso(kg) |
Esse campo só aparece para o frete tipo Correios, deve ser preenchido com o peso do produto em kg para fins de cálculo de frete | n/a | n/a | Sim |
Valor do Frete |
Esse campo só aparece para o frete tipo Frete Fixo, e deve ser preenchido com o valor que o lojista especificar para seus produtos. | n/a | n/a | Sim |
Método de envio |
Esse campo só aparece para Tipo Produto igual a Material Físico e Tipo de Frete igual a Frete Fixo. | n/a | n/a | Sim |
URL |
Esse campo só aparece para Tipo Produto igual a Digital. | n/a | n/a | Sim |
Quantidade |
Define a quantidade máxima de pedidos que o Botão pode gerar. Se não definido, o botão poderá gerar um número infinito de pedidos | n/a | n/a | Não |
Exemplo de Botão:
Abaixo é possível ver como o cadastro de um botão gera os 3 métodos de para acesso a tela transacional.
- Botão - Será criado um código HTML como o abaixo:
<form method='post' action='https://cieloecommerce.cielo.com.br/transactional/Checkout/BuyNow' target='blank'>
<input type='hidden' name='id' value=00000000-0000-0000-000000000000/><input type='image' name='submit' alt='Comprar' src='https://cieloecommerce.cielo.com.br /BackOffice/Contenthttps://developercielo.github.io/images/botao_comprar_3.jpg' />
</form>
Exemplo de um botão Funcional:
- QR CODE E LINK - O link e o QRCODE tem o mesmo comportamento do botão, levando a mesma tela transacional.
QR Code | Link |
---|---|
http://bit.ly/2tRkSxZ |
Adicionando o botão na sua página, você deve copiar o código HTML do botão criado e inclui-lo no HTML de seu site, conforme o exemplo abaixo.
Cada botão possui um código único que só permite comprar aquele determinado produto nas condições de preço e frete cadastrado. Portanto, um fraudador não consegue alterar nenhuma destas informações na hora de submeter a compra, pois o Checkout Cielo vai buscar todos os dados do produto no cadastro do Backoffice Cielo Checkout, e valerão os dados do cadastro.
Fluxos Meios de pagamento
Cartão de Crédito
O Checkout Cielo permite a utilização de Cartões de Crédito das principais bandeiras nacionais e internacionais. Esse meio de pagamento é liberado automaticamente junto a afiliação de Cielo, podendo ser utilizado inicialmente com a integração Checkout.
Transações de cartão de crédito serão incluídas no Backoffice Cielo Checkout como PENDENTE, AUTORIZADO, PAGO, NEGADO, EXPIRADO OU CHARGEBACK dependendo do resultado da autorização junto ao Banco.
Cartão de Crédito Ordem de Status:
Ordem | Status | Explicação |
---|---|---|
1 | PENDENTE | Status original. A transação está ocorrendo, esperando resposta do processo de autorização |
2 | AUTORIZADO / NEGADO | Resultado do processo de autorização. AUTORIZADO - Crédito foi reservado para a compra NEGADO - Cartão não autorizado pelo emissor a continuar a transação |
3 | PAGO | Ocorre pós captura. Indica que o crédito reservado no cartão será depositado na conta do lojista |
N/A | EXPIRADO | Ocorre caso a transação não seja capturada em 15 dias pós autorização. Nessa situação a transação é perdida. |
N/A | CHARGEBACK | Status não automático. Caso o lojista seja notificado de ChargeBack, ele pode marcar esta transação como perdida. Este Status é apenas uma marcação, não afetando processos de pagamento |
Atenção - Cartões Internacionais: O Checkout Cielo aceita cartões emitidos fora do Brasil, entretanto esses cartões não possuem a capacidade de pagar vendas parceladas. Essa é uma limitação imposta pelo banco emissor.
Atenção - TRANSAÇÕES EXPIRADAS: Por padrão, lojas Checkout Cielo possuem 15 dias para realizarem a captura da transação de Crédito. Se não capturadas, essas transações serão PERDIDAs.
Análise de Fraude
Transações de crédito “AUTORIZADAS” serão enviadas para análise da ferramenta de antifraude. Todas as transações classificadas como alto risco serão automaticamente canceladas, sem exceção.
O Antifraude possui o conceito de Status
e SubStatus
, onde o primeiro representa o nível de risco que uma transação possui de ser uma fraude, e o segundo, uma informação adicional sobre a transação.
A análise indicará um grau de RISCO, especificado pelo Status
, para a venda em questão.
Esse grau de risco é o que deve guiar a decisão do lojista de capturar ou cancelar a venda.
Status Antifraude | Substatus | Descrição |
---|---|---|
Baixo Risco |
Baixo Risco | Baixo risco de ser uma transação fraudulenta |
Médio Risco |
Médio Risco | Médio risco de ser uma transação fraudulenta |
Alto Risco |
Alto Risco | Alto risco de ser uma transação fraudulenta |
Não finalizado |
Não finalizado | Não foi possível finalizar a consulta |
N/A |
Autenticado | Transações autenticadas pelo banco - Não são analisáveis pelo AF |
N/A |
Não aplicável | Meio de pagamento não analisável como cartões de débito, boleto e débito online |
N/A |
Transação de recorrência | Transação de crédito seja posterior a transação de agendamento. Somente o Agendamento é analisado |
N/A |
Transação negada | Venda a crédito foi negada - Não são analisáveis pelo AF |
A analise será apresentada no “Detalhes do Pedido”, como abaixo:
Você pode visualizar o status do antifraude acessando o detalhe da compra, na aba Pedidos e clicando no (+)
Cartão de Débito
O Checkout Cielo permite a utilização de Cartões de débito MasterCard e Visa. Esse meio de pagamento é liberado automaticamente junto a afiliação de Cielo, podendo ser utilizado inicialmente com a integração Checkout.
Bancos Suportados:
Mastercard | Visa |
---|---|
Bradesco | Bradesco |
Banco do Brasil | Banco do Brasil |
Santander | Santander |
Itaú | Itaú |
CitiBank | CitiBank |
BRB | N/A |
Caixa | N/A |
BancooB | N/A |
Ao acessar a tela transacional, o comprador obterá pelo pagamento via Cartão de débito, e será redirecionado ao ambiente bancário para Autenticação e Autorização.
Transações de cartão de débito serão incluídas no Backoffice Cielo Checkout como PENDENTE, PAGO, NÃO AUTORIZADO ou NÃO FINALIZADO, dependendo do resultado da autorização junto ao Banco.
Cartão de Débito - Ordem de Status
- Pendente - Status original. A transação está ocorrendo, esperando resposta do banco para envio do comprador ao ambiente de autenticação
- Não Finalizado - Status intermediário. Neste ponto o Checkout Cielo espera a confirmação do Banco sobre o status da autenticação e transação. Caso o comprador abandone o ambiente do banco, o status não se altera.
- Pago - Comprador finalizou o pagamento com o cartão de débito com sucesso.
- Não Autorizado - O Comprador não apresentava saldo em conta para finalizar a transação.
OBS: A opção Cancelar dentro do backoffice, vai modificar o status da transação de PAGO/NÃO PAGO para CANCELADO, mas não terá efeito sobre a movimentação bancaria. Caberá ao lojista retornar o valor ao comprador
Boleto
O Checkout Cielo permite a utilização de Boletos do Bradesco (Carteira 26 e SPS) e Banco do Brasil (Carteira 17). Esse meio de pagamento precisa ser cadastrado pelo Suporte Cielo para que seja disponibilizado no Backoffice Checkout.
Bancos Suportados:
Bancos |
---|
Bradesco |
Banco do Brasil |
Ao acessar a tela transacional, o comprador obterá pelo pagamento via Boleto.
Transações de boleto serão incluídas no Backoffice Cielo Checkout como NÃO FINALIZADO ou PAGO. Diferentemente de outros meios de pagamento, o boleto não possui atualização de Status. Caberá ao Lojista acessar o Backoffice e modificar o status do boleto manualmente.
Boleto - Ordem de Status
- Não Finalizado - Status inicial. O Boleto é gerado, e ainda é valido. Como o Checkout não acessa o ambiente do banco para identificar o pagamento do boleto, esse status continuará efetivo até que o lojista entre no backoffice o atualize.
- Pago - Comprador finalizou o pagamento com o cartão de débito com sucesso.
OBS: A opção Cancelar dentro do backoffice, vai modificar o status da transação de PAGO/NÃO FINALIZADO para CANCELADO, mas não terá efeito sobre a movimentação bancaria. Caberá ao lojista retornar o valor ao comprador
Débito Online
O Checkout Cielo permite a utilização de Débito Online (Transferência entre contas bancarias) para compradores que possuam contas nos bancos Bradesco e Banco do Brasil. Esse meio de pagamento é liberado via cadastro junto ao Suporte Cielo.
Ao acessar a tela transacional, o comprador obterá pelo pagamento via Débito online, e será redirecionado ao ambiente bancário para Autenticação e Autorização.
Transações de Débito online serão incluídos no Backoffice Cielo Checkout como PENDENTE, PAGO, NÃO AUTORIZADO ou NÃO FINALIZADO, dependendo do resultado da autorização junto ao Banco.
Débito online - Ordem de Status
- Pendente - Status original. A transação está ocorrendo, esperando resposta do banco para envio do comprador ao ambiente de autenticação
- Não Finalizado - Status intermediário. Neste ponto o Checkout Cielo espera a confirmação do Banco sobre o status da autenticação e transação. Caso o comprador abandone o ambiente do banco, o status não se altera.
- Pago - Comprador finalizou o pagamento do débito com sucesso.
- Não Autorizado - O Comprador não apresentava saldo em conta para finalizar a transação.
OBS: A opção Cancelar dentro do backoffice, vai modificar o status da transação de PAGO/NÃO PAGO para CANCELADO, mas não terá efeito sobre a movimentação bancaria. Caberá ao lojista retornar o valor ao comprador
Notificações de Pagamento
O processo de notificação transacional no Checkout Cielo ocorre via a inclusão de uma URL para onde serão direcionados dados das transações realizadas na plataforma. Vale destacar que o Checkout realiza a notificação somente quando uma transação é considerada finalizada ou seja, o comprador preencheu todos os dados da tela de pagamento e clicou em “Finalizar”.
Tipos de notificação
O Checkout Cielo possui dois tipos de notificações que o lojista pode utilizar de acordo com suas necessidades:
Tipo | Descrição |
---|---|
POST |
Notificação onde o lojista é passivo. Dois POST HTTP são disparados, um informando dados da venda e outra mudança de Status da transação |
JSON |
Notificação onde o lojista realiza uma consulta. Um POST contendo informações para a realização de uma consulta (GET ) as transações checkout |
Para utilizar ambos os modelos, o lojista necessitará acessar o Backoffice cielo e configurar tanto a URL de NOTIFICAÇÃO
quando a URL de MUDANÇA de STATUS
.
Tipos de URL de Notificação
O Checkout possui 3 tipos de URL que podem impactar o processo de notificação.
Tipo | Descrição | Observação |
---|---|---|
URL de Retorno |
Página web na qual o comprador será redirecionado ao fim da compra. Nenhum dado é trocado ou enviado para essa URL. Essa URL apenas leva o comprador, após finalizar a compra, a uma página definida pela loja. |
Caso o Lojista deseje, ele pode configurar essa página para ser sensibilizada por tráfego, assim identificando que a transação foi finalizada no Checkout Cielo Pode ser enviada via API - Ver “Integração por API” |
URL de Notificação |
Ao finalizar uma transação é enviado um POST HTTP com todos os dados da venda para a URL de Notificação. O POST de notificação é enviado apenas no momento que a transação é finalizada, independentemente se houve alteração do status da transação |
Utilizada na Notificação via POST e JSON |
URL de Mudança de Status |
Quando um pedido tiver seu status alterado, será enviando um post HTTP para a URL de Mudança de Status. O POST de mudança de status não contem dados do carrinho, apenas dados de identificação do pedido |
Utilizada somente na Notificação via POST |
OBS: Caso uma URL de retorno
seja enviada vai API, ela terá prioridade sobre a URL cadastrada no Backoffice / Na integração Checkout Cielo via Botão
, só é possível usar a opção de URL de retorno via backoffice.
Características das URLs
Todas as 3 URLs devem possuir as seguintes características:
- Devem ser URLs estáticas
- Devem possuir menos de 255 caracteres
- Caracteres especiais não são suportados
Configurando as URLs
- Basta acessar dentro do Backoffice as Abas Configurações
- Em Configurações da Loja, Vá a sessão de Pagamentos
- Cadastre as URLS e escolhe o tipo de Notificação desejado
Notificação: POST
A notificação via POST é baseada no envio de um POST HTTP
quando uma transação é realizada. Ela é realizada em duas etapas:
POST de NOTIFICAÇÃO
- Ocorre quando a transação é finalizada. Esse POST possui todos os dados do pedido, incluindo o STATUS inicial da transação.POST de MUDANÇA DE STATUS
- Ocorre quando uma transação possui seu STATUS alterado - EX: “Autorizado” > > > “Pago”
Este fluxo é utilizado por lojas que ainda não realizam transações via API.
Abaixo o Fluxo de uma Notificação POST
Retorno aguardado para o envio da notificação: HttpStatus = 200 (OK)
- Post recebido e processado com sucesso
IMPORTANTE Se a URL de Notificação
cadastrada retornar algum erro/estiver indisponível, serão realizadas *3 novas tentativas, com intervalo de 1 hora entre cada POST.
Caso o POST não seja recebido, é possível reenvia-lo manualmente, basta acessar o pedido em questão pelo Backoffice e clicar no Ícone de envio:
Veja a descrição dos itens de notificação na sessão “Conteúdo do POST de NOTIFICAÇÃO”
Notificação: JSON
A notificação vai JSON é um método mais seguro e flexível para o lojista de realizar uma consulta no Chekcout Cielo.
Essa modalidade de notificação é baseada em um POST JSON
, onde o lojista recebe credenciais para que uma consulta (GET
) possa ser realizado junto a base de dados Checkout Cielo.
Ela é realizada em duas etapas:
POST de NOTIFICAÇÃO
- Ocorre quando a transação é finalizada. Possui as Credenciais necessárias consultas transacionais.CONSULTA TRANSACIONAL
- Com as credenciais de consulta, o lojista busca dados da venda junto ao Checkout Cielo
Na Notificação de JSON, não há diferença entre o POST de Notificação
e Mudança de Status
. Sempre que algo ocorrer na transação, o lojista receberá um POST de Notificação
Abaixo o Fluxo de uma Notificação JSON (Criação da transação + Mudança de status)
Conteúdo do POST de NOTIFICAÇÃO JSON:
Parâmetro | Descrição | Tipo do Campo |
---|---|---|
URL |
URL com os dados necessários para realizar a busca dos dados da transação. | String |
MerchantId |
Identificador da loja no Checkout Cielo; consta no Backoffice no menu Configuração/Dados Cadastrais. | Alfanumérico (GUID) |
MerchantOrderNumber |
Número do pedido da loja; se não for enviado, o Checkout Cielo gerará um número, que será visualizado pelo Consumidor. | Alfanumérico |
Exemplo de uma consulta:
REQUEST
curl
--request GET https://cieloecommerce.cielo.com.br/api/public/v1/orders/{merchantId}/{merchantOrderNumber}"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
--verbose
Propriedade | Descrição | Tipo | Tamanho | Obrigatório |
---|---|---|---|---|
MerchantId |
Identificador da loja | Guid | 36 | Sim |
RESPONSE
{
"order_number": "Pedido01",
"amount": 101,
"discount_amount": 0,
"checkout_cielo_order_number": "65930e7460bd4a849502ed14d7be6c03",
"created_date": "12-09-2017 14:38:56",
"customer_name": "Test Test",
"customer_phone": "21987654321",
"customer_identity": "84261300206",
"customer_email": "test@cielo.com.br",
"shipping_type": 1,
"shipping_name": "Motoboy",
"shipping_price": 1,
"shipping_address_zipcode": "21911130",
"shipping_address_district": "Freguesia",
"shipping_address_city": "Rio de Janeiro",
"shipping_address_state": "RJ",
"shipping_address_line1": "Rua Cambui",
"shipping_address_line2": "Apto 201",
"shipping_address_number": "92",
"payment_method_type": 1,
"payment_method_brand": 1,
"payment_maskedcreditcard": "471612******7044",
"payment_installments": 1,
"payment_status": 3,
"tid": "10447480686J51OH8BPB",
"test_transaction": "False"
}
Veja a descrição dos itens de notificação na sessão “Conteúdo do POST de NOTIFICAÇÃO”
Retorno aguardado para o envio da notificação: HttpStatus = 200 (OK)
- Post recebido e processado com sucesso
IMPORTANTE Se a URL de Notificação
cadastrada retornar algum erro/estiver indisponível, serão realizadas *3 novas tentativas, com intervalo de 1 hora entre cada POST.
Caso o POST não seja recebido, é possível reenvia-lo manualmente, basta acessar o pedido em questão pelo Backoffice e clicar no Ícone de envio:
Conteúdo da Notificação
Tanto na Notificação via POST HTTP ou POST JSON, o conteúdo dos dados retornados é o mesmo. Abaixo são descritos todos os campos retornados, assim como suas definições e tamanhos:
Conteúdo do POST de NOTIFICAÇÃO:
Parâmetro | Descrição | Tipo do campo | Tamanho máximo |
---|---|---|---|
checkout_cielo_order_number |
Identificador único gerado pelo CHECKOUT CIELO | Alfanumérico | 32 |
amount |
Preço unitário do produto, em centavos (ex: R$ 1,00 = 100) | Numérico | 10 |
order_number |
Número do pedido enviado pela loja | Alfanumérico | 32 |
created_date |
Data da criação do pedido - dd-MM-yyyy HH:mm:ss |
Alfanumérico | 20 |
customer_name |
Nome do consumidor. Se enviado, esse valor já vem preenchido na tela do CHECKOUT CIELO | Alfanumérico | 289 |
customer_identity |
Identificação do consumidor (CPF ou CNPJ) Se enviado, esse valor já vem preenchido na tela do CHECKOUT CIELO | Alfanumérico | 14 |
customer_email |
E-mail do consumidor. Se enviado, esse valor já vem preenchido na tela do CHECKOUT CIELO | Alfanumérico | 64 |
customer_phone |
Telefone do consumidor. Se enviado, esse valor já vem preenchido na tela do CHECKOUT CIELO | Numérico | 11 |
discount_amount |
Valor do desconto fornecido (enviado somente se houver desconto) | Numérico | 10 |
shipping_type |
Modalidade de frete | Numérico | 1 |
shipping_name |
Nome do frete | Alfanumérico | 128 |
shipping_price |
Valor do serviço de frete, em centavos (ex: R$ 10,00 = 1000) | Numérico | 10 |
shipping_address_zipcode |
CEP do endereço de entrega | Numérico | 8 |
shipping_address_district |
Bairro do endereço de entrega | Texto | 64 |
shipping_address_city |
Cidade do endereço de entrega | Alfanumérico | 64 |
shipping_address_state |
Estado de endereço de entrega | Alfanumérico | 64 |
shipping_address_line1 |
Endereço de entrega | Alfanumérico | 256 |
shipping_address_line2 |
Complemento do endereço de entrega | Alfanumérico | 14 |
shipping_address_number |
Número do endereço de entrega | Numérico | 8 |
payment_method_type |
Cód. do tipo de meio de pagamento | Numérico | 1 |
payment_method_brand |
Bandeira (somente para transações com meio de pagamento cartão de crédito) | Numérico | 1 |
payment_method_bank |
Banco emissor (Para transações de Boleto e Débito Automático) | Numérico | 1 |
payment_maskedcreditcard |
Cartão Mascarado (Somente para transações com meio de pagamento cartão de crédito) | Alfanumérico | 20 |
payment_installments |
Número de parcelas | Numérico | 1 |
payment_antifrauderesult |
Status das transações de cartão de Crédito no Antifraude | Numérico | 1 |
payment_boletonumber |
número do boleto gerado | String | 1 |
payment_boletoexpirationdate |
Data de vencimento para transações realizadas com boleto bancário | Numérico | 10 |
payment_status |
Status da transação | Numérico | 1 |
tid |
TID Cielo gerado no momento da autorização da transação | Alfanumérico | 20 |
test_transaction |
Indica se a transação foi gerada com o Modo de teste ativado |
Boolean | 32 |
product_id |
Identificador do Botão/Link de pagamento que gerou a transação | Alfanumérico | 32 |
product_type |
Tipo de Botão que gerou o pedido (Ver tabela de ProductID) | Alfanumérico | 32 |
product_sku |
Identificador do produto cadastro no link de pagamento | texto | 16 |
product_max_number_of_installments |
Numero de parcelas liberado pelo lojistas para o link de pagamento | Numérico | 2 |
product_expiration_date |
Data de validade do botão/Link de pagamento | Alfanumérico | 12 |
product_quantity |
Numero de transações restantes até que o link deixe de funcionar | Alfanumérico | 2 |
product_description |
Descrição do link de pagamentos registrada pelo lojista | texto | 256 |
nsu |
NSU - Número sequencial único da transação. | Alfanumérico | 6 |
authorization_code |
Código de autorização. | Alfanumérico | 8 |
Tipos de productID
Tipo de Link de pagamento | Enun |
---|---|
Material físico | 1 |
Digital | 2 |
Serviço | 3 |
Pagamento | 4 |
Recorrência | 5 |
Payment_status
O Checkout possui um Status próprios, diferente do SITE CIELO ou da API Cielo ecommerce. Veja abaixo a lista completa.
Valor | Status de transação | Transaction Status | Meios de pagamento | Descrição |
---|---|---|---|---|
1 | Pendente |
Pending | Para todos os meios de pagamento | Indica que o pagamento ainda está sendo processado; OBS: Boleto - Indica que o boleto não teve o status alterado pelo lojista |
2 | Pago |
Paid | Para todos os meios de pagamento | Transação capturada e o dinheiro será depositado em conta. |
3 | Negado |
Denied | Somente para Cartão Crédito | Transação não autorizada pelo responsável do meio de pagamento |
4 | Expirado |
Expired | Cartões de Crédito e Boleto | Transação deixa de ser válida para captura - 15 dias pós Autorização |
5 | Cancelado |
Voided | Para cartões de crédito | Transação foi cancelada pelo lojista |
6 | Não Finalizado |
NotFinalized | Todos os meios de pagamento | Pagamento esperando Status - Pode indicar erro ou falha de processamento. Entre em contato com o Suporte Cielo |
7 | Autorizado |
Authorized | somente para Cartão de Crédito | Transação autorizada pelo emissor do cartão. Deve ser capturada para que o dinheiro seja depositado em conta |
8 | Chargeback |
Chargeback | somente para Cartão de Crédito | Transação cancelada pelo consumidor junto ao emissor do cartão. O Dinheiro não será depositado em conta. |
Obs: Para consultas de pedido, o campo payment.status será retornado no formato texto, sempre em inglês (coluna Transaction Status).
Payment_antifrauderesult
O Antifraude possui o conceito de Status
e SubStatus
, onde o primeiro representa o nível de risco que uma transação possui de ser uma fraude, e o segundo, uma informação adicional sobre a transação.
Valor | Status Antifraude | Substatus | Descrição |
---|---|---|---|
1 | Baixo Risco |
Baixo Risco | Baixo risco de ser uma transação fraudulenta |
3 | Médio Risco |
Médio Risco | Médio risco de ser uma transação fraudulenta |
2 | Alto Risco |
Alto Risco | Alto risco de ser uma transação fraudulenta |
4 | Não finalizado |
Não finalizado | Não foi possível finalizar a consulta |
N/A | N/A |
Autenticado | Transações autenticadas pelo banco - Não são analisáveis pelo AF |
N/A | N/A |
Não aplicável | Meio de pagamento não analisável como cartões de débito, boleto e débito online |
N/A | N/A |
Transação de recorrência | Transação de crédito seja posterior a transação de agendamento. Somente o Agendamento é analisado |
N/A | N/A |
Transação negada | Venda a crédito foi negada - Não são analisáveis pelo AF |
Payment_method_type
O Checkout permite apenas um tipo de Boleto
ou Débito Online
por lojista, sendo assim não é retornado se o método usado foi Bradesco ou Banco do Brasil, pois apenas um deles estará ativado na afiliação.
Valor | Descrição | Description |
---|---|---|
1 | Cartão de Crédito | CreditCard |
2 | Boleto Bancário | Boleto |
3 | Débito Online | OnlineDebit |
4 | Cartão de Débito | DebitCard |
5 | QR Code | QrCode |
6 | Pix | Pix |
OBS: Para consultas o Type é retornado no campo Payment.Type e vem preenchida com o valor literal (Description)
Payment_method_brand
Valor | Descrição |
---|---|
1 | Visa |
2 | Master |
3 | AmericanExpress |
4 | Diners |
5 | Elo |
6 | Aura |
7 | JCB |
8 | Discover |
9 | HiperCard |
OBS: Para consultas a Brand é retornado no campo Payment.Brand e vem preenchida com o valor literal.
Payment_method_bank
Valor | Descrição |
---|---|
1 | Banco do Brasil |
2 | Bradesco |
Shipping_type
Valor | Descrição |
---|---|
1 | Correios |
2 | Frete fixo |
3 | Frete grátis |
4 | Retirar em mãos/loja |
5 | Sem cobrança de frete (serviços ou produtos digitais) |
Mudança de status
Parâmetro | Descrição | Tipo do Campo | Tamanho Máximo |
---|---|---|---|
checkout_cielo_order_number |
Identificador único gerado pelo CHECKOUT CIELO | Alfanumérico | 32 |
amount |
Preço unitário do produto, em centavos (ex: R$ 1,00 = 100) | Numérico | 10 |
order_number |
Número do pedido enviado pela loja | Alfanumérico | 32 |
payment_method_brand |
Bandeira- somente para transações com meio de pagamento cartão de crédito.Lista Completa | Numérico | 1 |
payment_status |
Status da transação.Lista Completa | Numérico | 1 |
test_transaction |
Indica se a transação foi gerada com o Modo de teste ativado | Boolean | 32 |
nsu |
NSU - Número sequencial único da transação. | Alfanumérico | 6 |
authorization_code |
Código de autorização. | Alfanumérico | 8 |
Parcelamentos do Checkout Cielo
Tipo de Parcelamento
O Checkout Cielo permite que o lojista realize transações de crédito parceladas em até 12 vezes. Existem dois métodos de parcelamento:
- Parcelamento via backoffice - é o método padrão de parcelamento do Checkout. Cada bandeira possui uma configuração de parcelamento até 12X. O Valor do Carrinho (Produtos + Frete) é dividido igualmente pelo número de parcelas.
- Parcelamento via API - O Lojista limita o número de parcelas a serem apresentadas no backoffice
OBS: O Checkout é limitado a parcelamentos de 12X, mesmo que sua afiliação Cielo suporte valores superiores. Caso o valor apresentando em seu backoffice seja menor que 12, entre em contato com o Suporte Cielo e verifique a configuração de sua Afiliação.
Parcelamento via backoffice
Neste modo, o lojista controla o limite máximo de parcelas que a loja realizará pelo Backoffice Checkout. O Valor das parcelas é definido acessando a aba Configurações e alterando a sessão Pagamentos
OBS: O Check Box deve estar marcado para que o meio de pagamento seja exibido na tela transacional.
Características
- Disponível nas integrações do Checkout Cielo via API ou Botão;
- O valor total dos itens do carrinho é somado e dividido pela quantidade de parcelas do lojista;
- O valor da compra é sempre o mesmo, independentemente da quantidade de parcelas escolhida pelo comprador (Não há cobrança de Juros);
- O valor do frete é somado ao valor do parcelamento;
- A opção “à vista” sempre está disponível ao comprador.
- Todas as transações possuirão as mesmas opções de parcelamento.
Parcelamento via API
Nesta opção, o lojista pode configurar a quantidade de parcelas por venda, especificado via request da API no momento de envio da transação. O Checkout realiza o cálculo das parcelas considerando valor total e limite parcelas enviadas via API.
ATENÇÃO: Nesta opção de parcelamento, o número de parcelas desejadas deve ser inferior a quantidade que está cadastrada no backoffice Checkout.
Características
- O lojista envia a quantidade máxima de parcelas que deseja exibir ao comprador.
- O valor do frete é somado ao valor do parcelamento.
O Parcelamento via API é realizado enviando o campo MaxNumberOfInstallments
dentro do nó Payment. Isso forçará o Checkout a recalcular o valor do parcelamento.
Abaixo, um exemplo do Nó
"Payment": {
"MaxNumberOfInstallments": 3
}
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
MaxNumberOfInstallments |
Numeric | Condicional | 2 | Define valor máximo de parcelas apresentadas no transacional, ignorando configuração do Backoffice |
Recorrência do Checkout Cielo
A Recorrência é um processo de agendamento automático de transações de crédito, ou seja, é uma transação que se repetirá automaticamente, sem a necessidade do comprador acessar a tela transacional, de acordo com as regras definidas no momento do agendamento.
Transações recorrentes são ideais para modelos de negócios que envolvam o conceito de assinatura, plano ou mensalidade na sua forma de cobrança. Alguns exemplos de negócios são:
- Escolas
- Academias
- Editoras
- Serviços de hospedagem
Diferença entre transações recorrentes e parceladas:
Tipo | Descrição |
---|---|
Parceladas | Se trata de uma transação dividida em vários meses. O valor total da venda compromete o limite do cartão de crédito do comprador independentemente do valor da parcela inicial. O lojista recebe o valor da venda parceladamente e não corre o risco de uma das parcelas ser negada. EX: Venda de R$1.000,00 parcelado em 2 vezes. Apesar de o comprador pagar apenas R$500,00 na primeira parcela, o valor do limite de crédito consumido é o integral, ou seja, R$1.000,00. Se o limite do cartão for inferior ou o montante não estiver liberado, a R$1.000,00 a transação será negada |
Recorrentes | São transações diferentes realizadas no mesmo cartão em momentos previamente agendados. A primeira venda agenda as futuras vendas a partir de um intervalo de tempo pré definido. A cada intervalo haverá uma cobrança no cartão de crédito. O pagamento recorrente bloqueia do limite do cartão apenas o valor debitado na data da primeira venda recorrente e do valor total da venda. EX: Venda de R$ 1.000,00 em 15/01/2015, com recorrência mensal e data final em 01/06/2015. Todo dia 15 haverá uma nova cobrança de R$1.000,00 no cartão do comprador, se repetindo até 15/05/2015, última data válida antes da data final. |
Recorrência por API
Uma transação de recorrência no Checkout Cielo possui duas configurações: Intervalo
e Data de encerramento
.
- Intervalo – padrão de repetição e intervalo de tempo entre cada transação. Esse intervalo temporal entre as transações podem ser: Mensal, Bimestral, Trimestral, Semestral e Anual.
- Data de encerramento – Data que o processo de recorrência deixa de ocorrer.
"Payment": {
"RecurrentPayment": {
"Interval": "Monthly",
"EndDate": "2018-12-31"
}
Payment.RecurrentPayment
Campo | Tipo | Obrigatório | Tamanho | Descrição |
---|---|---|---|---|
Payment.RecurrentPayment.Interval |
Alphanumeric | Sim | 10 | Intervalo entre cada transação da recorrência |
Payment.RecurrentPayment.EndDate |
YYYY-MM-DD | Não | 255 | Data onde a Recorrência se encerrará; Se não enviado a recorrência se encerra somente se cancelada |
Intervalo | Descrição |
---|---|
Monthly |
Mensal |
Bimonthly |
Bimestral |
Quarterly |
Trimestral |
SemiAnnual |
Semestral |
Annual |
Anual |
Os dados do cartão de crédito do comprador ficam armazenados de forma segura dentro do Checkout Cielo, permitindo sua reutilização em uma transação recorrente. Esses dados não são acessados pelo lojista e essa inteligência é controlada pelo Checkout Cielo.
Exceto o objeto Payment
que contém um novo elemento específico para a recorrência chamado RecurrentPayment
, todos os outros objetos são iguais à integração com o Carrinho.
Request
{
"OrderNumber": "12344",
"SoftDescriptor": "Nome que aparecerá na fatura",
"Cart": {
"Discount": {
"Type": "Percent",
"Value": 10
},
"Items": [
{
"Name": "Nome do produto",
"Description": "Descrição do produto",
"UnitPrice": 100,
"Quantity": 2,
"Type": "Asset",
"Sku": "Sku do item no carrinho",
"Weight": 200
}
]
},
"Shipping": {
"Type": "Correios",
"SourceZipCode": "14400000",
"TargetZipCode": "11000000",
"Address": {
"Street": "Endereço de entrega",
"Number": "123",
"Complement": "",
"District": "Bairro da entrega",
"City": "Cidade de entrega",
"State": "SP"
},
"Services": [
{
"Name": "Serviço de frete",
"Price": 123,
"Deadline": 15
}
]
},
"Payment": {
"BoletoDiscount": 0,
"DebitDiscount": 0,
"RecurrentPayment": {
"Interval": "Monthly",
"EndDate": "2015-12-31"
}
},
"Customer": {
"Identity": 11111111111,
"FullName": "Fulano Comprador da Silva",
"Email": "fulano@email.com",
"Phone": "11999999999"
},
}
Exemplo: Bem Físico
Se o tipo de produto for Bem Físico
, a API obriga o envio do tipo de frete.
Se no contrato técnico existir o nó da recorrência, fica obrigatório o tipo WithoutShipping
, caso contrário, a seguinte resposta será apresentada:
{
"message": "The request is invalid.",
"modelState": {
"[Shipping.Type]": [
"[Shipping.Type] pedidos com recorrência devem possuir o Shipping.Type 'WithoutShipping'."
]
}
}
IMPORTANTE: A Recorrência é criada apenas se a transação for AUTORIZADA. Independente de captura ou não, uma vez autorizada, o processo de recorrência se inicia.
Recorrência por Botão
Uma maneira de realizar a recorrência dentro do Checkout é criar um botão recorrente.
Basta cadastrar o produto, incluindo um intervalo de cobrança e uma data para encerramento (Opcional), como no exemplo abaixo:
ATENÇÃO: Caso um botão seja utilizado após a “Data final” cadastrada, a transação apresentará um erro exibindo Oppss na tela transacional. A Data pode ser editada na tela de edição do botão dentro de “Detalhes do Produto”
Retentativa de Recorrências
Caso uma das transações da recorrência não seja autorizada, o Checkout Cielo executa a retentativa automaticamente, o envio de uma nova transação, considerando:
- Intervalo de tempo entre as tentativas: 4 dias
- Quantidade de retentativas: 4 (quatro), uma por dia, por 4 dias corridos a partir do dia seguinte da transação original não autorizada.
OBS: Esse processo visa manter obter uma resposta positiva do processo de autorização, impedindo o lojista de perder a venda. O Processo de retentativa gera pedidos duplicados dentro do Backoffice, pois o pedido original, negado, será apresentado na lista de Pedidos, junto com a nova transação autorizada
ATENÇÃO: A regra da retentativa não pode ser modificada pelo lojista.
Consultando transações
As transações de Recorrência ficam disponíveis no Backoffice Checkout Cielo como as outras vendas de sua loja na aba “PEDIDOS” (veja imagem abaixo).
A primeira transação da recorrência é uma transação normal, seguindo as regras e preferências definidas pelo lojista no Backoffice.
ATENÇÃO: O valor e data de cobrança das transações recorrentes serão sempre os mesmos da transação inicial. O agendamento passa a funcionar automaticamente a partir da data em que a primeira transação for autorizada.
Esta tela mostra a data que a 1° transação da recorrência foi autorizada e deverá ser capturada manualmente. As demais transações da recorrência sempre serão capturadas automaticamente, independente se primeira transação foi capturada ou cancelada. Se o Cliente tiver configurado Captura automática, a captura da recorrência também será automática.
ATENÇÃO: Somente a 1° transação é submetida a análise do antifraude
Cancelamento de Recorrência no Checkout Cielo.
O cancelamento da recorrência ocorre dentro do Backoffice do Checkout Cielo, também na aba “PEDIDOS”. Basta:
- Acessar uma transação de recorrência (marcada com o símbolo “Recorrente”)
- Entrar em Detalhes (o símbolo de “+”)
Tela de detalhes da Recorrência
Na tela acima, há duas opções de Cancelamento pelos botões:
- Cancelar – Cancela a transação, sem efetuar o cancelamento das futuras transações de recorrência.
- Cancelar Recorrência - Cancela o agendamento de futuras transações, encerrando a recorrência. Não cancela a transação atual nem as que já ocorreram. Essas necessitam ser canceladas manualmente.
ATENÇÃO:
- A Recorrência ocorre somente para Cartões de crédito e para produtos tipo “SERVIÇO” e “BENS DIGITAIS”.
- A Recorrência é iniciada no momento da AUTORIZAÇAO, NÃO NA CAPTURA. Se a recorrência não tiver uma data para ser finalizada, ela se repetirá automaticamente até ser cancelada manualmente.
- Sua afiliação Cielo deve ser habilitada para transacionar sem CVV ou Em recorrência, do contrário, todas as transações recorrentes serão negadas.
Edição da Recorrência
O Checkout Cielo permite que o lojista modifique 3 dados da recorrência:
- Ativação - Uma recorrência pode ser ativada ou cancelada.
- Intervalo - É possivel modificar o intervalo de execução.
- Dia de ocorrência - É possivel modificar o dia de execução da transação recorrente.
A atualização é feita exclusivamente via o Backoffice Cielo. Acesso o Tutorial do Backoffice Checkout Cielo para mais informações.
Programa de Retentativa das Bandeiras
O que são retentativas?
Quando uma pessoa tenta fazer uma compra com cartão na sua loja, a transação pode ser negada devido a uma série de fatores. As tentativas seguintes de concluir a transação usando o mesmo cartão é o que chamamos de retentativa.
O que mudou?
Cada bandeira de cartão define os valores que serão cobrados por retentativa. A quantidade de vezes que uma transação pode ser retentada antes da cobrança também varia de acordo com a bandeira.
E no e-commerce?
As bandeiras de cartão definem regras diferentes para transações com cartão presente e não presente, como no caso das vendas feitas pela internet.
Qual o impacto para a loja?
Os e-commerces que não seguirem as regras serão penalizados com a cobrança de tarifas por transações excedidas, de acordo com o programa de cada bandeira.
Visando melhorar a experiência de compra, o mercado de meios de pagamento, em conjunto com a ABECS, promoveu a padronização nos códigos de respostas das transações recusadas feitas por cartão. As tentativas foram classificadas em dois tipos:
- ❌ Irreversível: nunca realizar retentativa
Significa, por exemplo, que o cartão está cancelado para uso, foi perdido ou roubado, há uma fraude confirmada ou a transação não é permitida para aquele produto, indicando que não há circunstâncias nas quais o emissor concederia uma aprovação. Qualquer tentativa de autorização que, após uma recusa irreversível, não tenha alterado nenhum campo da mensageria, não obterá sucesso.
- ✅ Reversível: permitido realizar retentativa
Significa que o emissor pode aprovar a transação, mas não pode fazê-lo agora, possivelmente devido a um problema do sistema (inoperante) ou falta de limite, suspeita de fraude ou excesso de número de tentativas de digitação da senha. São decisões de recusas temporárias tomadas pelo emissor que podem mudar com o tempo.
As bandeiras Visa, Mastercard, Elo e Hipercard ajustaram suas regras para limitar a quantidade de tentativas de autorização para uma transação negada. Essas mudanças preveem a cobrança de tarifas para o excesso de tentativas. Confira a seguir as regras de cada bandeira.
Mastercard
A bandeira Mastercard possui o programa Transaction Processing Excellence (TPE), que engloba duas categorias:
1. Excessive Attempts: monitora as retentativas de transações negadas nos ambientes de cartão presente e cartão não presente. Válido tanto para códigos de negadas reversíveis quanto irreversíveis.
2. Merchant Advice Code Transaction Excellence (MAC): monitora as retentativas de transações negadas, nos ambientes de cartão não presente e que são irreversíveis. Haverá cobrança somente nos MACs 03 e 21.
1. Excessive Attempts
São cobranças efetuadas quando o estabelecimento comercial excede as regras de retentativas de transações.
A bandeira também realiza o monitoramento para qualquer autorização de valor nominal, aprovada, com estorno subsequente para transações abaixo de 1 unidade de moeda inteira ou o equivalente a US$ 1.
O monitoramento é aplicado para as retentativas de transações de compras negadas e aprovadas, realizadas em ambiente de cartão presente e cartão não presente.
Tabela Excessive Attempts
Categorias | Códigos | Vigência | Tarifa Doméstica | Tarifa Internacional | Quando Ocorre | Permitido Retentar |
---|---|---|---|---|---|---|
Cartão presente e cartão não presente | Qualquer código de negativa que não está atribuído ao MAC 03 e 21. E também os códigos MAC caso não respeite os limites do “Excessive Attempts” | Até 31/01/2023 | R$ 2,00 | - | A partir 11ª retentativa | Permitido retentar em 24h. |
Cartão presente e cartão não presente | Qualquer código de negativa que não está atribuído ao MAC 03 e 21. E também os códigos MAC caso não respeite os limites do “Excessive Attempts” | Nova regra a partir de 01/02/2023 | R$ 2,00 | - | A partir 8ª retentativa | Permitido retentar em 24h. |
- Serão consideradas como retentativas todas as transações de pagamento no mesmo cartão, e mesmo número de estabelecimento;
- A Mastercard prorrogou a data de vigência para o dia 01/02/2023 referente as novas regras do programa (Excessive Attempts) antes prevista para início do dia 01/11/2022. Confira as mudanças:
- O excesso considerado no programa ocorrerá a partir da oitava retentativa dentro do mês de apuração; os valores cobrados sofreram alteração.
- E a Mastercard também está introduzindo um limite de 35 tentativas negadas no mesmo cartão e mesmo número de estabelecimento por período contínuo de 30 dias. Mesmo se a loja não ultrapassar o limite de sete retentativas no período de 24h, mas ultrapassar a quantidade do limite mensal, a cobrança será aplicada.
Obs: A regra vigente do programa Excessive Attempts é válida até 31/01/2023 (tabela Excessive Attempts), permitindo apenas 10 tentativas de aprovar uma mesma transação (no mesmo cartão, e mesmo número de estabelecimento), e é permitido retentar após 24h.
2. Merchant Advice Code Transaction Excellence (MAC)
São cobranças efetuadas quando o estabelecimento comercial realiza retentativa de envio de autorização para códigos de respostas irreversíveis com um mesmo cartão valido para cartão não presente.
Dentro desse programa de retentativas, há programas que se destinam especificamente ao cenário de “Não tente esta transação novamente”. Para esses casos, a Mastercard identifica as transações com os valores MAC 03 e MAC 21, por exemplo.
O programa MAC comporta alguns valores, porém somente os MACs 03 e 21 possuem uma cobrança específica. Os demais MACs não se enquadram nessa cobrança.
Os outros códigos MAC (01, 02, 04, 24, 25, 26, 27, 28, 29 e 30) não entram no programa de cobrança do MAC mas entram na cobrança do programa Excessive Attempts, caso exceda os limites.
Desde 14/10/2022 a Mastercard introduziu novos códigos MAC (24, 25, 26, 27, 28, 29 e 30) quando um emissor recusa uma transação com o código de resposta 51 (insuficiência de fundos) seguido de um dos MAC da tabela a seguir, para que o comerciante tome a melhor ação.
Tabela com toda relação de MACs
MAC | Descrição | Observação |
---|---|---|
01 | Informações da nova conta disponíveis (ABU) | Necessidade de realizar atualização dos dados da conta que está sendo utilizada na transação, usando o ABU, por exemplo. |
02 | Não pode aprovar no momento, tente depois | Tente novamente a transação após 72 horas ou tente a transação com um método de pagamento diferente. |
03 | Não é permitido retentar | Busque outro meio de garantir o pagamento, evitando custos desnecessários de várias solicitações de autorização que continuarão a resultar em declínios. |
04 | Requisitos de token não atendidos para este token modelo | Há necessidade de revisar os requisitos de token, pois os requisitos não foram atendidos para este token modelo enviado na transação. |
21 | Plano cancelado | Comprador realiza cancelamento de plano e mesmo após o cancelamento, estabelecimento continua enviando solicitação de autorização de compra. |
24 | Tente novamente após 1 hora | Válido somente para o código de resposta 51 (insuficiência de fundos) |
25 | Tente novamente após 24 horas | Válido somente para o código de resposta 51 (insuficiência de fundos) |
26 | Tente novamente após 2 dias | Válido somente para o código de resposta 51 (insuficiência de fundos) |
27 | Tente novamente após 4 dias | Válido somente para o código de resposta 51 (insuficiência de fundos) |
28 | Tente novamente após 6 dias | Válido somente para o código de resposta 51 (insuficiência de fundos) |
29 | Tente novamente após 8 dias | Válido somente para o código de resposta 51 (insuficiência de fundos) |
30 | Tente novamente após 10 dias | Válido somente para o código de resposta 51 (insuficiência de fundos) |
Além disso, alguns códigos de retorno deixarão de ser enviados:
- 04 (Cartão de Captura)
- 14 (Número de cartão inválido)
- 41 (Cartão Perdido)
- 43 (Cartão Roubado)
- 54 (Cartão Expirado)
- 57 (Transação Não Permitida)
- 62 (Cartão Restrito)
- 63 (Violação de Segurança)
Categorização de retornos Mastercard
A Mastercard poderá consolidar alguns códigos de respostas dos emissores, que muitas vezes não indicam ao comerciante se pode ou não retentar, em três códigos de uso exclusivo Mastercard:
- 79 (Ciclo de vida);
- 82 (Política);
- 83 (Fraude/ Segurança).
Os códigos originais serão substituídos pelo Merchant Advice Code (MAC), que acompanharão os códigos 79, 82 e 83 para determinar se a transação pode ou não ser retentada.
Por exemplo:
Quando | Então | E o código de resposta |
---|---|---|
O emissor recusar a transação usando o código de resposta 54 (Cartão Expirado) | A Mastercard substituirá o código 54 para o código 79 (recusa por ciclo de vida) | Acompanha o devido Merchant Advice Code (MAC) |
Programa de retentativas MAC 03 e MAC 21
Forma de apuração:
- Serão consideradas as transações de cartão não presente;
- São consideradas como retentativas todas as transações de pagamento no mesmo cartão e mesmo número de estabelecimento;
- São contabilizadas as retentativas no programa MAC com os valores MAC 03 e MAC 21;
- Valido para qualquer código de resposta;
- O excesso contabilizado no programa ocorrerá a partir da 1ª retentativa dentro do mês de apuração;
- O contador é zerado após o período de 30 dias;
- As retentativas podem ser cobradas nos MACs 03/21 e no Excessive Attempts caso ultrapasse o limite de cada programa;
- Atualmente é aplicado o valor de tarifa de R$1,25 e esse valor será alterado a partir de 01 de janeiro de 2023, como listado a seguir.
Tabela de valores:
Número de retentativa | Regra |
---|---|
A partir 1ª rententativa | R$ 2,50 (dois reais e cinquenta centavos) por retentativa, a partir da 1ª retentativa. |
Visa
O que é?
Um programa instituído pela bandeira Visa que gera cobranças quando o estabelecimento comercial excede as regras de retentativas.
- Válido para transações com cartão presente e cartão não presente;
- Códigos reversíveis: são permitidas até 15 tentativas de aprovar uma mesma transação (mesmo cartão, mesmo estabelecimento e valor) no período de 30 dias. Após os 30 dias iniciais (a contar da primeira tentativa), qualquer retentativa será cobrada;
- Códigos irreversíveis: é permitido apenas UMA tentativa de aprovar uma mesma transação (mesmo cartão, mesmo estabelecimento), na segunda tentativa será cobrado;
- Após uma transação ser aprovada, o contador é zerado.
Tarifas: Ao ultrapassar os limites de tentativas estabelecidos pela bandeira, haverá uma cobrança de tarifa para cada transação excedente.
- Doméstico: USD 0,10 + 13,83% de imposto;
- Estrangeiro: USD 0,25 + 13,83% de imposto
Regras de autorização já vigentes. A cobrança de tarifas é aplicada desde abril de 2021.
A Visa agrupou os códigos de retorno em quatro categorias:
- Categoria 1: emissor nunca aprovará
Para essa categoria, indica que o cartão foi cancelado ou nunca existiu ou que a negativa é resultado de uma restrição permanente ou condição de erro que impedirá uma aprovação futura.
- Categoria 2: emissor não pode aprovar neste momento
Indicam que a negativa é resultado de uma condição temporária tal como risco de crédito, controles de velocidade do emissor ou outras restrições do cartão que podem permitir uma retentativa da transação ser aprovada. Em alguns casos, a negativa requer uma ação do portador ou emissor para remover a restrição antes que uma aprovação possa ser obtida.
- Categoria 3: qualidade de dados/revisar dados
Quando um erro de dados é identificado pelo emissor essa transação é declinada como consequência. Os estabelecimentos devem revalidar dados de pagamentos antes de retentar. Estabelecimentos e Credenciadores devem monitorar estes códigos de negativas devido a exposição potencial a fraudes.
Atenção: A categoria 3 tem, além dos limites considerados na categoria 2, um limite diferente que é cumulativo. Um estabelecimento pode realizar até 10.000 transações em um período de 30 dias (neste caso considerando apenas o número do estabelecimento e códigos de negadas). Se ultrapassar o limite, todas as transações recusadas por categoria 3 serão tarifadas.
- Categoria 4: códigos de respostas genéricos
A categoria 4 inclui todos os outros códigos de resposta de recusa, muitos dos quais fornecem pouco ou nenhum valor para Adquirentes/Comerciantes como parte de sua estratégia de nova tentativa. O uso do emissor deve permanecer mínimo.
A maioria das condições de recusa tem códigos de resposta descritivos nas Categorias 1, 2 e 3 para indicar o motivo da recusa. No entanto, pode haver circunstâncias em que não haja valor de código de resposta para uma condição de declínio específica. Emissores pode usar outros valores de códigos de resposta definidos nas Especificações Técnicas VisaNet; no entanto, o uso deve permanecer mínimo.
Os emissores devem usar códigos de resposta que reflitam com mais precisão o motivo das recusas. Categorias 1 (o emissor nunca aprovar), 2 (o emissor não pode aprovar neste momento) e 3 (qualidade dos dados) devem ser usados, e os emissores devem limitar o uso de Categoria 4 (Código de Resposta Genérico) para transações onde nenhum outro valor se aplica. A taxa do Código de Resposta Genérico é cobrada para garantir que não mais do que a porcentagem aprovada regionalmente do total de recusas do emissor sejam categorizadas como Categoria 4. Os emissores que excederem o limite definido regionalmente receberão a Taxa de Código de Resposta Genérica por base de transação para cada declínio em excesso do limite definido.
Tabela com as regras e códigos de recusa:
Observação: O código de resposta 14 aparece nas categorias 1 e 3 porém a contabilização é a seguinte:
-
Na categoria 1 o EC é tarifado a partir da 2ª tentativa para o (mesmo estabelecimento e mesmo cartão) não permitido retentar.
-
Na categoria 3 compõe o grupo de códigos para contabilização das 10.001 transações, após o EC atingir 10.000 retentativas com o este grupo de códigos, qualquer transação será contabilizada independente do cartão.
Exemplo: Tivemos 10.000 transações negadas em um EC com os códigos de categoria 3, se a transação 10.001 for no código 14 ou em qualquer código do grupo de categoria 3 ele será tarifado independente do cartão.
Elo
O que é?
Trata-se de um programa instituído pela bandeira ELO que gera cobranças quando o estabelecimento comercial excede as regras de retentativas de transações com um mesmo cartão.
Formas de Apuração
- Retentativas: todas transações de pagamento no mesmo cartão, validade, valor e Merchant ID (MID) dentro de 30 dias;
- Códigos contabilizados: todos de negativas;
- Excesso: a partir da 16ª retentativa no mês*;
- Tarifa: R$ 0,80 (oitenta centavos) por retentativa, a partir da 16ª;
- Cobrança: a cobrança só será feita em casos de recorrência, sendo assim, o estabelecimento tem que estar no programa por pelo menos dois meses consecutivos;
- Contabilização do excesso: é baseada nos controles internos da Elo. 1º ao último dia corrido do mês.
Tabela de cobrança de retentativas para a bandeira Elo
A tabela a seguir exemplifica como será feita a cobrança pela bandeira:
Mês | Cenário | Cobrança |
---|---|---|
1º (agosto) | EC Excede limites | Advertência |
2º (setembro) | EC Não excede Limites | Não gera cobrança |
3º (outubro) | EC Excede limites | Neste caso será advertido novamente. A cobrança só será feita em caso de recorrência. |
4º (novembro) | EC Excede limites | Aplicação da multa |
5º (dezembro) | EC Excede limites | Aplicação da multa |
6º (janeiro) | EC Não excede Limites | Não gera cobrança |
7º (fevereiro) | EC Excede limites | Será advertido novamente. |
Relação de códigos de recusa Elo:
Os códigos de respostas abaixo estão listados conforme manual de autorização da bandeira.
CÓDIGOS | DESCRIÇÃO | QUANDOO EMISSOR DEVE UTILIZAR O CÓDIGO DE RESPOSTA | RETENTATIVA |
---|---|---|---|
4 | REFAZER A TRANSAÇÃO | Esse código deve ser usado pelo Emissor para solicitar que o portador/EC realize novamente a transação caso ele (Emissor) detecte falha na captura das informações da transação ou caso seja necessário atualização da senha negando a 1ª transação | Reversível |
5 | GENÉRICA | A Bandeira poderá utilizar esse código para outras tratativas (genérica). | Reversível |
6 | CONSULTAR CREDENCIADOR | Esse motivo deve ser utilizado pelo Credenciador quando ele identificar problemas internos que não necessitem de mudanças na mensageria para que a transação siga o fluxo correto. | Reversível |
12 | ERRO NO CARTÃO | - Esse código deve ser usado pelo Emissor quando ele identificar falha na validação do CAVV de transações 3DS ou tokenizada. - Esse código deve ser usado pelo Emissor quando identificar CÓDIGO DE SERVIÇO incorreto/inválido para cartões físicos. - Esse código deve ser usado pelo Emissor para problemas identificados no TOKEN - Este código deve ser utilizado para negar reversões e avisos de reversão onde a transação original não é localizada pelo Emissor. |
Irreversível |
13 | VALOR DA TRANSAÇÃO INVÁLIDA | - Esse código deve ser usado pelo Emissor quando identificar que o valor da transação é inválido de acordo com os parâmetros do Emissor. | Irreversível |
14 | NÚMERO DO CARTÃO INVÁLIDA | - Esse código deve ser utilizado pelo Emissor para Nº DO CARTÃO INVÁLIDO/INCORRETO. - A Bandeira poderá utilizar esse código para outras tratativas. |
Irreversível |
19 | PROBLEMAS ADQUIRENTE | - Esse motivo deve ser utilizado pelo Credenciador quando ele identificar problemas internos que necessitem de mudanças na mensageria para que a transação siga o fluxo correto. | Irreversível |
23 | VALOR DA PARCELA INVÁLIDO | - Esse código deve ser utilizado pelo Emissor quando o VALOR DA PARCELA ESTÁ FORA DOS LIMITES estabelecidos por ele. Esse código deve ser utilizado quando o emissor não aceitar o produto Elo Parcelado Loja (produto 072) com o número de parceladas menor que 12. | Irreversível |
30 | ERRO DE FORMATO DA MENSAGEM | - Esse código deve ser usado pelo Emissor quando ele identificar ERRO DE FORMATO NA MENSAGERIA (campo obrigatório, domínios, formatos, tamanho não presentes ou divergentes da especificação). | Irreversível |
38 | COMPRA/EXCEDIDAS TENTATIVAS SENHA | - Esse código deve ser utilizado pelo Emissor quando for EXCEDIDO O Nº DE TENTATIVAS PERMITIDAS DE DIGITAÇÃO DA SENHA (utilizado apenas para compras). | Reversível |
41 | CARTÃO PERDIDO | - Esse código deve ser utilizado pelo Emissor para CARTÃO COM BLOQUEIO DEFINITIVO pelo motivo “PERDA”. | Irreversível |
43 | CARTÃO ROUBADO | - Esse código deve ser utilizado pelo Emissor para CARTÃO COM BLOQUEIO DEFINITIVO pelo motivo “ROUBO”. | Irreversível |
51 | LIMITE/SALDO INSUFICIENTE | - Esse código deve ser utilizado pelo Emissor para CARTÃO que está TEMPORARIAMENTE SEM SALDO OU LIMITE SUFICIENTE para realizar a transação. - Saque/advance 2 sem trilha 2 - Compra com Troco não suportada. - Verificação de endereço não suportada (somente quando o código de processo for “13” sem valor de compra). * Verificação de conta de cartão não suportada (somente quando o código de processo for “18” sem valor de compra). |
Reversível |
54 | DATA DE VALIDADE DO CARTÃO | - Esse código deve ser utilizado pelo Emissor para CARTÃO FÍSICO ou TOKEN COM VALIDADE / EXPIRAÇÃO VENCIDA ou INVÁLIDA. | Irreversível |
55 | SENHA INVÁLIDA / NÃO ENVIADA | - Esse código deve ser utilizado pelo Emissor quando a SENHA DIGITADA PELO CLIENTE NÃO CONFERE, ESTÁ INVÁLIDA/INCORRETA. - Esse código deve ser utilizado pelo Emissor quando a SENHA NÃO FOR ENVIADA NA MENSAGERIA E A MESMA É EXIGIDA PARA APROVAÇÃO DA TRANSAÇÃO. |
Reversível |
56 | SEM REGISTRO DO CARTÃO | 1. Nº do cartão não pertence ao Emissor 2. Nº do cartão não é válido |
Irreversível |
57 | TRANSAÇÃO NÃO PERMITIDA PARA ESSE CARTÃO | - Esse código deve ser utilizado pelo Emissor quando o cartão estiver com BLOQUEIO DEFINITIVO, exceto bloqueio perda e roubo que já possuem códigos específicos (ex: falecimento, fraude confirmada, cancelamento definitivo a pedido do cliente, etc). - Esse código deve ser utilizado para PRODUTOS E SERVIÇOS NÃO SUPORTADOS pelo emissor do cartão. - Esse código pode ser usado para TOKEN INVÁLIDO / SUSPENSO / INATIVO. - Esse código deve ser usado para negar o modo de entrada FALLBACK. |
Irreversível |
58 | COMERCIANTE INVÁLIDO | - Esse código deve ser utilizado pelo Emissor quando o MCC do estabelecimento não estiver cadastrado para obtenção de token junto ao Emissor. | Irreversível |
59 | SUSPEITA DE FRAUDE | - Esse código deve ser utilizado pelo Emissor quando regras de prevenção SUSPEITAM DE FRAUDE, sendo necessário o contato do portador com o Emissor para liberação do cartão e realização de nova transação. - Esse código deve ser utilizado pelo Emissor para negar transações por ausência do AVISO VIAGEM que deve ser realizado pelo portador do cartão antes de viagens ao exterior ou em alguns casos antes de realizar transações em sites internacionais. |
Reversível |
61 | VALOR MÁXIMO SAQUE/COMPRAS EXCEDIDO | - Esse código deve ser utilizado pelo Emissor quando o valor do saque/compras exceder o limite permitido por ele. | Reversível |
62 | BLOQUEIO TEMPORÁRIO DE COBRANÇA | - Esse código deve ser utilizado pelo Emissor para cartões com BLOQUEIO TEMPORÁRIO DE COBRANÇA. | Reversível |
63 | VIOLAÇÃO DE SEGURANÇA | - Esse código deve ser utilizado pelo Emissor quando o CÓDIGO DE SEGURANÇA DO CARTÃO (CVE2) estiver INCORRETO / INVÁLIDO ou MST inválido (token). | Irreversível |
64 | VALOR MÍNIMO DA TRANSAÇÃO - INVÁLIDO | - Esse código deve ser utilizado pelo Emissor quando o VALOR DA TRANSAÇÃO ESTIVER ABAIXO DO MÍNIMO permitido pelo Emissor | Irreversível |
65 | QUANTIDADE DE SAQUES EXCEDIDOS | - Esse código deve ser utilizado pelo Emissor quando o limite de quantidade de saques estiver excedido | Reversível |
75 | SAQUE/ EXCEDIDAS TENTATIVAS SENHA | - Esse código deve ser utilizado pelo Emissor quando for excedida a quantidade de tentativas de digitação de senha estipuladas pelo Emissor (utilizado apenas para SAQUES) | Reversível |
76 | CONTA DESTINO INVÁLIDA OU INEXISTENTE | - Esse código deve ser utilizado pelo Emissor quando conta “PARA” (destino) no BIT 3 é inválida ou inexistente e exclusivamente para transações de Transferência de Fundos | Irreversível |
77 | CONTA ORIGEM INVÁLIDA OU INEXISTENTE | - Esse código deve ser utilizado pelo Emissor quando conta “DE” (origem) no BIT 3 é inválida ou inexistente e exclusivamente para transações de Transferência de Fundos. | Irreversível |
78 | CARTÃO NOVO SEM DESBLOQUEIO / CARTÃO BLOQUEADO | - Esse código deve ser utilizado pelo Emissor quando o cartão novo ainda não foi desbloqueado (ativado) pelo portador junto ao Emissor ou quando o Portador, mediante autonomia, desejar bloquear temporariamente o cartão através do aplicativo do Emissor. | Reversível |
82 | CARTÃO INVÁLIDO (dados internos) | - Esse código deve ser utilizado pelo Emissor quando dados internos do cartão não conferem (ex: criptograma inválido, ATC inválido etc.) | Irreversível |
83 | NÃO É POSSÍVEL VALIDAR A SENHA | - Esse código deve ser utilizado pelo Emissor e será utilizado pela Elo quando não for possível validar ou descriptografar a senha. | Irreversível |
91 | EMISSOR FORA DO AR | - Esse código será utilizado pela Bandeira quando o Emissor está temporariamente indisponível para autorizar a transação ou não foi recebida a resposta do Emissor no tempo estabelecido. | Reversível |
96 | FALHA DO SISTEMA | - Esse código será utilizado pela Bandeira ou pelo Emissor por problemas no processamento da transação. | Reversível |
AB | FUNÇÃO INCORRETA (DÉBITO) | - Esse código será utilizado pelo Emissor para sinalizar o estabelecimento que ele solicitou a autorização na função DÉBITO, mas o cartão não possui essa função ativa. | Irreversível |
AC | FUNÇÃO INCORRETA (CRÉDITO) | - Esse código será utilizado pelo Emissor para sinalizar o estabelecimento que ele solicitou a autorização na função CRÉDITO, mas o cartão não possui essa função ativa. | Irreversível |
FM | UTILIZAR O CHIP | - Esse código será utilizado pelo Emissor para informar ao estabelecimento que a transação contactless não terá sucesso e que o portador deve utilizar o chip (contato). | Irreversível |
P5 | TROCA DE SENHA / FALHA NO DESBLOQUEIO | - Esse código será utilizado pelo Emissor quando ocorreu falha na troca de senha ou falha no desbloqueio. | Irreversível |
P6 | NOVA SENHA NÃO ACEITA | - Esse código será utilizado pelo Emissor quando a nova senha que o cliente escolheu não atende os critérios mínimos estabelecidos pelo Emissor. | Reversível |
Hipercard
O que é?
Cobranças efetuadas quando um Estabelecimento Comercial excede as regras de retentativas de transações negadas com um mesmo cartão, mesma data ou período mensal, mesmo valor e mesmo número de Estabelecimento Comercial, conforme abaixo:
Programa | Cartão Presente | Cartão não presente |
---|---|---|
Excesso de Retentativa | R$ 1,85 por retentativa a partir da 9ª resposta negada – mesmo cartão e mesmo dia (regra 2) | R$ 1,85 por Retentativas a partir da 9ª resposta negada – mesmo cartão e mesmo mês de referência (regra 3) |
Retentativa de transação ASI (Zero Auth) | R$ 0,15 por retentativa de transação ASI após negativa do emissor – mesmo cartão e mesmo dia (item 2) | R$ 0,15 por retentativa de transação ASI após negativa do emissor – mesmo cartão e mesmo mês de referência (regra 3) |
Retentativa de transação irreversível | 0,03% do valor da transação por retentativa Mínimo R$ 0,15 Máximo R$ 0,80 Mesmo cartão e mesmo dia após resposta com código irreversível |
0,03% do valor da transação por retentativa Mínimo R$ 0,15 Máximo R$ 0,80 Mesmo cartão e mesmo mês após resposta com código irreversível (regra 3) |
Regras:
- Transações ASI: são transações Account Status Inquiry, ou seja, são as transações efetuadas para consultar o status de um cartão (verificar se está ativo). Para esse fim, não devem ser usadas transações financeiras e sim transações específicas;
- Tentativas por dia: considerar para efeito do programa de Retentativas da Hipercard de 00h00 a 23h59;
- Mês de referência: considerar para efeito do programa de Retentativas da Hipercard dia 01 a 30 ou 31 do mês em que ocorreu a transação. A cobrança será enviada após o fechamento do mês subsequente;
- Os códigos de transações consideradas irreversíveis pelo emissor foram categorizados pela indústria de pagamentos e autorregulação da ABECS, por meio do Normativo 21 vigente. Veja os Códigos de retorno (ABECS);
- Os códigos não citados no manual da ABECS são considerados como reversíveis.
Demais bandeiras
- Códigos reversíveis: serão permitidas novas retentativas para o mesmo cliente e cartão. Não há limite e período pré-estabelecido;
Importante: antes de realizar uma nova tentativa, siga a orientação recebida na resposta da transação negada.
- Códigos Irreversíveis: não serão permitidas autorizações para o mesmo cartão ou estabelecimento, depois de receber 1ª resposta de recusa do emissor.
Códigos de retorno ABECS
Para acessar o programa de retentativa das bandeira acesse esse Link
A Associação Brasileira das Empresas de Cartão de Crédito e Serviços (ABECS) estabelece a partir do dia 15 de Julho de 2020 a padronização do código de retorno das autorizações de vendas recusadas tanto para as soluções pagamento do mundo físico e e-commerce do mercado brasileiro.
Essa medida normativa busca trazer benefícios para todo o mercado de pagamentos, proporcionando maior transparência no entendimento do motivo de recusa das transações, além de possibilitar maior assertividade na adoção de estratégias de retentativas de vendas.
A Cielo informa seus clientes que está preparada para processar as transações seguindo esse novo padrão do mercado, segue abaixo a tabela de códigos padronizados pela ABECS.
Mensagem | Tipo de Código | ELO | VISA | MASTERCARD/HIPER | AMEX | AMEX - De/Para Cielo | Mensagem POS/Ecommerce | Houve alteração da ABECS em 2022? | |
---|---|---|---|---|---|---|---|---|---|
GENÉRICA | REVERSÍVEL | 5 | 5 | 5 | 100 | FA | CONTATE A CENTRAL DO SEU CARTÃO | Não | |
SALDO/LIMITE INSUFICIENTE | REVERSÍVEL | 51 | 51 | 51 | 116 | A5 | NÃO AUTORIZADA | Não | |
SALDO/LIMITE INSUFICIENTE | REVERSÍVEL | 51 | 51 | 51 | 121 | A5 | NÃO AUTORIZADA | Somente na nossa Documentação | |
SENHA INVÁLIDA | REVERSÍVEL | 55 | 55 ou 86 | 55 | 117 | A6 | SENHA INVÁLIDA | Não | |
TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO | REVERSÍVEL | - | 57 | 57 | 200 | FD | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO | Sim | |
TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO | IREVERSÍVEL | 57 | - | - | - | - | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE | Novo | |
NÚMERO CARTÃO NÃO PERTENCE AO EMISSOR / NÚMERO CARTÃO INVÁLIDO | IRREVERSÍVEL | 14 ou 56 | 14 | 14 ou 01 | 122 | 8 | VERIFIQUE OS DADOS DO CARTÃO | Sim | |
VIOLAÇÃO DE SEGURANÇA | IRREVERSÍVEL | 63 | 63 | - | 122 | 8 | VERIFIQUE OS DADOS DO CARTÃO | Sim | |
VIOLAÇÃO DE SEGURANÇA | REVERSÍVEL | - | - | 63 | - | - | VERIFIQUE OS DADOS DO CARTÃO | Novo | |
SUSPEITA DE FRAUDE | REVERSÍVEL | 59 | 59 | 63 | 100 | FA | CONTATE A CENTRAL DO SEU CARTÃO | Não | |
COMERCIANTE INVÁLIDO | IRREVERSÍVEL | 58 | 3 | 3 | 109 | DA | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE | Sim | |
REFAZER A TRANSAÇÃO (EMISSOR SOLICITA RETENTATIVA) | REVERSÍVEL | 4 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | REFAZER A TRANSAÇÃO | Sim | |
CONSULTAR CREDENCIADOR | REVERSÍVEL | 6 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | LOJISTA, CONTATE O ADQUIRENTE | Sim | |
PROBLEMA NO ADQUIRENTE | IRREVERSÍVEL | 19 | 19 | 30 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | ERRO NO CARTÃO – NÃO TENTE NOVAMENTE | Não | |
ERRO NO CARTÃO | IRREVERSÍVEL | 12 | 6 | SEM CÓDIGO CORRESPONDENTE | 115 | A2 | VERIFIQUE OS DADOS DO CARTÃO | Não | |
ERRO DE FORMATO (MENSAGERIA) | IRREVERSÍVEL | 30 | 12 | 30 | 181 | A3 | ERRO NO CARTÃO - NÃO TENTE NOVAMENTE | Não | |
VALOR DA TRANSAÇÃO INVÁLIDA | IRREVERSÍVEL | 13 | 13 | 13 | 110 | JB | VALOR DA TRANSAÇÃO NÃO PERMITIDO - NÃO TENTE NOVAMENTE | Não | |
VALOR DA PARCELA INVÁLIDA | IRREVERSÍVEL | 23 | SEM CÓDIGO CORRESPONDENTE | 12 | 115 | A2 | PARCELAMENTO INVÁLIDO - NÃO TENTE NOVAMENTE | Não | |
EXCEDIDAS TENTATIVAS DE SENHA / COMPRAS | REVERSÍVEL | 38 | 75 | 75 | 106 | A4 | EXCEDIDAS TENTATIVAS DE SENHA.CONTATE A CENTRAL DO SEU CARTÃO | Não | |
CARTÃO PERDIDO | IRREVERSÍVEL | 41 | 41 | 41 | 200 | FD | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE | Não | |
CARTÃO ROUBADO | IRREVERSÍVEL | 43 | 43 | 43 | 200 | FD | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE | Não | |
CARTÃO VENCIDO / DT EXPIRAÇÃO INVÁLIDA | IRREVERSÍVEL | 54 | 54 | 54 | 101 | BV | VERIFIQUE OS DADOS DO CARTÃO | Sim | |
TRANSAÇÃO NÃO PERMITIDA CAPACIDADE DO TERMINAL | IRREVERSÍVEL | 57 | 58 | 58 | 116 | A5 | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE | Não | |
VALOR EXCESSO / SAQUE | REVERSÍVEL | 61 | 61 ou N4 | 61 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | VALOR EXCEDIDO. CONTATE A CENTRAL DO SEU CARTÃO | Não | |
BLOQUEIO TEMPORÁRIO (EX: INADIMPLÊNCIA) | REVERSÍVEL | 62 | 62 | 57 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO | Novo | |
CARTÃO DOMÉSTICO - TRANSAÇÃO INTERNACIONAL | IRREVERSÍVEL | 62 | SEM CÓDIGO CORRESPONDENTE | 62 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CARTÃO NÃO PERMITE TRANSAÇÃO INTERNACIONAL | Somente na nossa Documentação | |
CARTÃO DOMÉSTICO - TRANSAÇÃO INTERNACIONAL | REVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 62 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CARTÃO NÃO PERMITE TRANSAÇÃO INTERNACIONAL | Somente na nossa Documentação | |
VALOR MÍNIMO DA TRANSAÇÃO INVÁLIDO | IRREVERSÍVEL | 64 | SEM CÓDIGO CORRESPONDENTE | 13 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | VALOR DA TRANSAÇÃO NÃO PERMITIDO - NÃO TENTE NOVAMENTE | Sim | |
QUANT. DE SAQUES EXCEDIDO | REVERSÍVEL | 65 | 65 | 65 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | QUANTIDADE DE SAQUES EXCEDIDA. CONTATE A CENTRAL DO SEU CARTÃO | Não | |
SENHA VENCIDA / ERRO DE CRIPTOGRAFIA DE SENHA | IRREVERSÍVEL | 83 | 74 ou 81 | 88 | 180 | A7 | SENHA INVÁLIDA - NÃO TENTE NOVAMENTE | Sim | |
EXCEDIDAS TENTATIVAS DE SENHA | SAQUE | REVERSÍVEL | 75 | 75 | 75 | 106 | A4 | EXCEDIDAS TENTATIVAS DE SENHA.CONTATE A CENTRAL DO SEU CARTÃO | Não |
CONTA DESTINO INVÁLIDA OU INEXISTENTE | IRREVERSÍVEL | 76 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTA DESTINO INVÁLIDA - NÃO TENTE NOVAMENTE | Não | |
CONTA ORIGEM INVÁLIDA OU INEXISTENTE | IRREVERSÍVEL | 77 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTA ORIGEM INVÁLIDA - NÃO TENTE NOVAMENTE | Não | |
CARTÃO NOVO SEM DESBLOQUEIO | REVERSÍVEL | 78 | - | 57 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | DESBLOQUEIE O CARTÃO | Sim | |
CARTÃO NOVO SEM DESBLOQUEIO | IRREVERSÍVEL | - | 78 | - | - | - | DESBLOQUEIE O CARTÃO | Novo | |
CARTÃO INVÁLIDO (criptograma) | IRREVERSÍVEL | 82 | 82 | 88 | 180 | A7 | ERRO NO CARTÃO - NÃO TENTE NOVAMENTE | Não | |
EMISSOR FORA DO AR | REVERSÍVEL | 91 | 91 | 91 | 912 | A1 | FALHA DE COMUNICAÇÃO - TENTE MAIS TARDE | Não | |
FALHA DO SISTEMA | REVERSÍVEL | 96 | 96 | 96 | 911 | AE | FALHA DE COMUNICAÇÃO - TENTE MAIS TARDE | Não | |
DIFERENÇA - PRÉ AUTORIZAÇÃO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | N8 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | VALOR DIFERENTE DA PRÉ AUTORIZAÇÃO - NÃO TENTE NOVAMENTE | Sim | |
FUNÇÃO INCORRETA (DÉBITO) | IRREVERSÍVEL | AB | 52 ou 53 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | UTILIZE FUNÇÃO CRÉDITO | Não | |
FUNÇÃO INCORRETA (CRÉDITO) | IRREVERSÍVEL | AC | 39 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | UTILIZE FUNÇÃO DÉBITO | Não | |
TROCA DE SENHA / DESBLOQUEIO | IRREVERSÍVEL | P5 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SENHA INVÁLIDA - NÃO TENTE NOVAMENTE | Não | |
NOVA SENHA NÃO ACEITA | REVERSÍVEL | P6 | SEM CÓDIGO CORRESPONDENTE | 55 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SENHA INVÁLIDA UTILIZE A NOVA SENHA | Sim | |
RECOLHER CARTÃO (NÃO HÁ FRAUDE) | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 4 | 4 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Sim | |
ERRO POR MUDANÇA DE CHAVE DINÂMICA | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | N7 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | ERRO NO CARTÃO - NÃO TENTE NOVAMENTE | Sim | |
FRAUDE CONFIRMADA | IRREVERSÍVEL | 57 | 7 | 4 | 200 | FD | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE | Não | |
EMISSOR Ñ LOCALIZADO - BIN INCORRETO (negativa do adquirente) | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 15 | 15 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | DADOS DO CARTÃO INVÁLIDO - NÃO TENTE NOVAMENTE | Não | |
NÃO CUMPRIMENTO PELAS LEIS DE ANTE LAVAGEM DE DINHEIRO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 64 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Não | |
REVERSÃO INVÁLIDA | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 76 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Não | |
NÃO LOCALIZADO PELO ROTEADOR | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 92 | 92 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Não | |
TRANSAÇÃO NEGADA POR INFRAÇÃO DE LEI | IRREVERSÍVEL | 57 | 93 | 62 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE | Sim | |
VALOR DO TRACING DATA DUPLICADO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 94 | 94 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTENOVAMENTE | Não | |
SURCHARGE NÃO SUPORTADO | REVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | B1 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO | Não | |
SURCHARGE NÃO SUPORTADO PELA REDE DE DÉBITO | REVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | B2 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO | Não | |
FORÇAR STIP | REVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | N0 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO | Não | |
SAQUE NÃO DISPONÍVEL | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | N3 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SAQUE NÃO DISPONÍVEL - NÃO TENTE NOVAMENTE | Não | |
SUSPENSÃO DE PAGAMENTO RECORRENTE PARA UM SERVIÇO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | R0 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SUSPENSÃO DE PAGAMENTO RECORRENTE PARA SERVIÇO - NÃO TENTE NOVAMENTE | Não | |
SUSPENSÃO DE PAGAMENTO RECORRENTE PARA TODOS SERVIÇO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | R1 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SUSPENSÃO DE PAGAMENTO RECORRENTE PARA SERVIÇO - NÃO TENTE NOVAMENTE | Não | |
TRANSAÇÃO NÃO QUALIFICADA PARA VISA PIN | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | R2 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE | Não | |
SUSPENSÃO DE TODAS AS ORDENS DE AUTORIZAÇÃO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | R3 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SUSPENSÃO DE PAGAMENTO RECORRENTE PARA SERVIÇO - NÃO TENTE NOVAMENTE | Não | |
NÃO É POSSÍVEL LOCALIZAR O REGISTRO NO ARQUIVO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Sim | |
ARQUIVO NÃO DISPONÍVEL PARA ATUALIZAÇÃO | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE | Sim | |
CONTA ENCERRADA | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 46 | 62 | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE | Novo | |
FALHA VALIDAÇÃO DE ID | IRREVERSÍVEL | SEM CÓDIGO CORRESPONDENTE | 6P | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | FALHA NA VERIFICAÇÃO DO ID | Novo | |
UTILIZAR O CHIP | IRREVERSÍVEL | FM | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | SEM CÓDIGO CORRESPONDENTE | UTILIZE O CHIP | Novo |
Outros códigos de retorno
Código Resposta | Definição | Significado | Ação | Permite Retentativa |
---|---|---|---|---|
0 | Transação autorizada com sucesso. | Transação autorizada com sucesso. | Transação autorizada com sucesso. | Não |
2 | Transação não autorizada. Transação referida. | Transação não autorizada. Referida (suspeita de fraude) pelo banco emissor. | Transação não autorizada. Entre em contato com seu banco emissor. | Não |
9 | Transação cancelada parcialmente com sucesso. | Transação cancelada parcialmente com sucesso | Transação cancelada parcialmente com sucesso | Não |
11 | Transação autorizada com sucesso para cartão emitido no exterior | Transação autorizada com sucesso. | Transação autorizada com sucesso. | Não |
21 | Cancelamento não efetuado. Transação não localizada. | Não foi possível processar o cancelamento. Se o erro persistir, entre em contato com a Cielo. | Não foi possível processar o cancelamento. Tente novamente mais tarde. Persistindo o erro, entrar em contato com a loja virtual. | Não |
22 | Parcelamento inválido. Número de parcelas inválidas. | Não foi possível processar a transação. Número de parcelas inválidas. Se o erro persistir, entre em contato com a Cielo. | Não foi possível processar a transação. Valor inválido. Refazer a transação confirmando os dados informados. Persistindo o erro, entrar em contato com a loja virtual. | Não |
24 | Quantidade de parcelas inválido. | Não foi possível processar a transação. Quantidade de parcelas inválido. Se o erro persistir, entre em contato com a Cielo. | Não foi possível processar a transação. Quantidade de parcelas inválido. Refazer a transação confirmando os dados informados. Persistindo o erro, entrar em contato com a loja virtual. | Não |
60 | Transação não autorizada. | Transação não autorizada. Tente novamente. Se o erro persistir o portador deve entrar em contato com o banco emissor. | Não foi possível processar a transação. Tente novamente mais tarde. Se o erro persistir, entre em contato com seu banco emissor. | Apenas 4 vezes em 16 dias. |
67 | Transação não autorizada. Cartão bloqueado para compras hoje. | Transação não autorizada. Cartão bloqueado para compras hoje. Bloqueio pode ter ocorrido por excesso de tentativas inválidas. O cartão será desbloqueado automaticamente à meia noite. | Transação não autorizada. Cartão bloqueado temporariamente. Entre em contato com seu banco emissor. | A partir do dia seguinte, apenas 4 vezes em 16 dias. |
70 | Transação não autorizada. Limite excedido/sem saldo. | Transação não autorizada. Limite excedido/sem saldo. | Transação não autorizada. Entre em contato com seu banco emissor. | A partir do dia seguinte, apenas 4 vezes em 16 dias. |
72 | Cancelamento não efetuado. Saldo disponível para cancelamento insuficiente. | Cancelamento não efetuado. Saldo disponível para cancelamento insuficiente. Se o erro persistir, entre em contato com a Cielo. | Cancelamento não efetuado. Tente novamente mais tarde. Se o erro persistir, entre em contato com a loja virtual. | Não |
79 | TRANSAÇÃO MASTERCARD NÃO PERMITIDA PARA O CARTÃO | Transação não autorizada. Não é possível processar a transação devido a erro relacionado ao cartão do portador. Solicite ao portador que entre em contato com o banco emissor. | Entre em contato com o seu banco | Não |
80 | Transação não autorizada. Divergencia na data de transação/pagamento. | Transação não autorizada. Data da transação ou data do primeiro pagamento inválida. | Transação não autorizada. Refazer a transação confirmando os dados. | Não |
82 | TRANSAÇÃO MASTERCARD NÃO AUTORIZADA. LIGUE PARA O EMISSOR | Transação não autorizada devido a regras do emissor. Oriente o portador a entrar em contato com o banco emissor. | Entre em contato com o seu banco | Não |
83 | TRANSAÇÃO MASTERCARD SUSPEITA DE FRAUDE | Transação não autorizada. Suspeita de fraude pelo banco emissor. | Entre em contato com o seu banco | Não |
85 | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento.Solicite ao portador que digite novamente os dados do cartão, se o erro persistir pode haver um problema no terminal do lojista, nesse caso o lojista deve entrar em contato com a Cielo. | Transação não permitida. Informe os dados do cartão novamente. Se o erro persistir, entre em contato com a loja virtual. | Não |
89 | Erro na transação. | Transação não autorizada. Erro na transação. O portador deve tentar novamente e se o erro persistir, entrar em contato com o banco emissor. | Transação não autorizada. Erro na transação. Tente novamente e se o erro persistir, entre em contato com seu banco emissor. | Apenas 4 vezes em 16 dias. |
90 | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento.Solicite ao portador que digite novamente os dados do cartão, se o erro persistir pode haver um problema no terminal do lojista, nesse caso o lojista deve entrar em contato com a Cielo. | Transação não permitida. Informe os dados do cartão novamente. Se o erro persistir, entre em contato com a loja virtual. | Não |
97 | Valor não permitido para essa transação. | Transação não autorizada. Valor não permitido para essa transação. | Transação não autorizada. Valor não permitido para essa transação. | Não |
98 | Sistema/comunicação indisponível. | Transação não autorizada. Sistema do emissor sem comunicação. Se for geral, verificar SITEF, GATEWAY e/ou Conectividade. | Sua Transação não pode ser processada, Tente novamente mais tarde. Se o erro persistir, entre em contato com a loja virtual. | Apenas 4 vezes em 16 dias. |
475 | Timeout de Cancelamento | A aplicação não respondeu dentro do tempo esperado. | Realizar uma nova tentativa após alguns segundos. Persistindo, entrar em contato com o Suporte. | Não |
999 | Sistema/comunicação indisponível. | Transação não autorizada. Sistema do emissor sem comunicação. Tente mais tarde. Pode ser erro no SITEF, favor verificar ! | Sua Transação não pode ser processada, Tente novamente mais tarde. Se o erro persistir, entre em contato com a loja virtual. | A partir do dia seguinte, apenas 4 vezes em 16 dias. |
AA | Tempo Excedido | Tempo excedido na comunicação com o banco emissor. Oriente o portador a tentar novamente, se o erro persistir será necessário que o portador contate seu banco emissor. | Tempo excedido na sua comunicação com o banco emissor, tente novamente mais tarde. Se o erro persistir, entre em contato com seu banco. | Apenas 4 vezes em 16 dias. |
AF | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento.Solicite ao portador que digite novamente os dados do cartão, se o erro persistir pode haver um problema no terminal do lojista, nesse caso o lojista deve entrar em contato com a Cielo. | Transação não permitida. Informe os dados do cartão novamente. Se o erro persistir, entre em contato com a loja virtual. | Não |
AG | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento.Solicite ao portador que digite novamente os dados do cartão, se o erro persistir pode haver um problema no terminal do lojista, nesse caso o lojista deve entrar em contato com a Cielo. | Transação não permitida. Informe os dados do cartão novamente. Se o erro persistir, entre em contato com a loja virtual. | Não |
AH | Transação não permitida. Cartão de crédito sendo usado com débito. Use a função crédito. | Transação não permitida. Cartão de crédito sendo usado com débito. Solicite ao portador que selecione a opção de pagamento Cartão de Crédito. | Transação não autorizada. Tente novamente selecionando a opção de pagamento cartão de crédito. | Não |
AI | Transação não autorizada. Autenticação não foi realizada. | Transação não autorizada. Autenticação não foi realizada. O portador não concluiu a autenticação. Solicite ao portador que reveja os dados e tente novamente. Se o erro persistir, entre em contato com a Cielo informando o BIN (6 primeiros dígitos do cartão) | Transação não autorizada. Autenticação não foi realizada com sucesso. Tente novamente e informe corretamente os dados solicitado. Se o erro persistir, entre em contato com o lojista. | Não |
AJ | Transação não permitida. Transação de crédito ou débito em uma operação que permite apenas Private Label. Tente novamente selecionando a opção Private Label. | Transação não permitida. Transação de crédito ou débito em uma operação que permite apenas Private Label. Solicite ao portador que tente novamente selecionando a opção Private Label. Caso não disponibilize a opção Private Label verifique na Cielo se o seu estabelecimento permite essa operação. | Transação não permitida. Transação de crédito ou débito em uma operação que permite apenas Private Label. Tente novamente e selecione a opção Private Label. Em caso de um novo erro entre em contato com a loja virtual. | Não |
AV | Transação não autorizada. Dados Inválidos | Falha na validação dos dados da transação. Oriente o portador a rever os dados e tentar novamente. | Falha na validação dos dados. Reveja os dados informados e tente novamente. | Apenas 4 vezes em 16 dias. |
BD | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento.Solicite ao portador que digite novamente os dados do cartão, se o erro persistir pode haver um problema no terminal do lojista, nesse caso o lojista deve entrar em contato com a Cielo. | Transação não permitida. Informe os dados do cartão novamente. Se o erro persistir, entre em contato com a loja virtual. | Não |
BL | Transação não autorizada. Limite diário excedido. | Transação não autorizada. Limite diário excedido. Solicite ao portador que entre em contato com seu banco emissor. | Transação não autorizada. Limite diário excedido. Entre em contato com seu banco emissor. | A partir do dia seguinte, apenas 4 vezes em 16 dias. |
BM | Transação não autorizada. Cartão Inválido | Transação não autorizada. Cartão inválido. Pode ser bloqueio do cartão no banco emissor ou dados incorretos. Tente usar o Algoritmo de Lhum (Mod 10) para evitar transações não autorizadas por esse motivo. | Transação não autorizada. Cartão inválido. Refaça a transação confirmando os dados informados. | Não |
BN | Transação não autorizada. Cartão ou conta bloqueado. | Transação não autorizada. O cartão ou a conta do portador está bloqueada. Solicite ao portador que entre em contato com seu banco emissor. | Transação não autorizada. O cartão ou a conta do portador está bloqueada. Entre em contato com seu banco emissor. | Não |
BO | Transação não permitida. Falha da operação. | Transação não permitida. Houve um erro no processamento. Solicite ao portador que digite novamente os dados do cartão, se o erro persistir, entre em contato com o banco emissor. | Transação não permitida. Houve um erro no processamento. Digite novamente os dados do cartão, se o erro persistir, entre em contato com o banco emissor. | Apenas 4 vezes em 16 dias. |
BP | Transação não autorizada. Conta corrente inexistente. | Transação não autorizada. Não possível processar a transação por um erro relacionado ao cartão ou conta do portador. Solicite ao portador que entre em contato com o banco emissor. | Transação não autorizada. Não possível processar a transação por um erro relacionado ao cartão ou conta do portador. Entre em contato com o banco emissor. | Não |
BP176 | Transação não permitida. | Parceiro deve checar se o processo de integração foi concluído com sucesso. | Parceiro deve checar se o processo de integração foi concluído com sucesso. | — |
BR | Transação não autorizada. Conta encerrada | A conta do portador está encerrada. Solicite ao portador que entre em contato com seu banco emissor. | A conta do portador está encerrada. Solicite ao portador que entre em contato com seu banco emissor. | Não |
C1 | Transação não permitida. Cartão não pode processar transações de débito. | Troque a modalidade de pagamento ou o cartão utilizado. | Troque a modalidade de pagamento ou o cartão utilizado. | Não |
C2 | Transação não permitida. | Dados incorretos. Favor rever os dados preenchidos na tela de pagamento. | Dados incorretos. Favor rever os dados preenchidos na tela de pagamento. | Não |
C3 | Transação não permitida. | Período inválido para este tipo de transação. | Período inválido para este tipo de transação. | Não |
CF | Transação não autorizada.C79:J79 Falha na validação dos dados. | Transação não autorizada. Falha na validação dos dados. Solicite ao portador que entre em contato com o banco emissor. | Transação não autorizada. Falha na validação dos dados. Entre em contato com o banco emissor. | Não |
CG | Transação não autorizada. Falha na validação dos dados. | Transação não autorizada. Falha na validação dos dados. Solicite ao portador que entre em contato com o banco emissor. | Transação não autorizada. Falha na validação dos dados. Entre em contato com o banco emissor. | Não |
DF | Transação não permitida. Falha no cartão ou cartão inválido. | Transação não permitida. Falha no cartão ou cartão inválido. Solicite ao portador que digite novamente os dados do cartão, se o erro persistir, entre em contato com o banco | Transação não permitida. Falha no cartão ou cartão inválido. Digite novamente os dados do cartão, se o erro persistir, entre em contato com o banco | Apenas 4 vezes em 16 dias. |
DM | Transação não autorizada. Limite excedido/sem saldo. | Transação não autorizada. Limite excedido/sem saldo. | Transação não autorizada. Entre em contato com seu banco emissor. | A partir do dia seguinte, apenas 4 vezes em 16 dias. |
DQ | Transação não autorizada. Falha na validação dos dados. | Transação não autorizada. Falha na validação dos dados. Solicite ao portador que entre em contato com o banco emissor. | Transação não autorizada. Falha na validação dos dados. Entre em contato com o banco emissor. | Não |
DS | Transação não permitida para o cartão | Transação não autorizada. Transação não permitida para o cartão. | Transação não autorizada. Entre em contato com seu banco emissor. | Apenas 4 vezes em 16 dias. |
EB | Número de parcelas maior que o Permitido. | Transação não autorizada. Entre em contato com a Cielo e verifique se o cadastro possui parcelamento liberado. | Transação não autorizada. Entre em contato com a Cielo e verifique se o cadastro possui parcelamento liberado. | Sim |
EE | Transação não permitida. Valor da parcela inferior ao mínimo permitido. | Transação não permitida. Valor da parcela inferior ao mínimo permitido. Não é permitido parcelas inferiores a R$ 5,00. Necessário rever calculo para parcelas. | Transação não permitida. O valor da parcela está abaixo do mínimo permitido. Entre em contato com a loja virtual. | Não |
EK | Transação não permitida para o cartão | Transação não autorizada. Transação não permitida para o cartão. | Transação não autorizada. Entre em contato com seu banco emissor. | Apenas 4 vezes em 16 dias. |
FC | Transação não autorizada. Ligue Emissor | Transação não autorizada. Oriente o portador a entrar em contato com o banco emissor. | Transação não autorizada. Entre em contato com seu banco emissor. | Não |
FE | Transação não autorizada. Divergencia na data de transação/pagamento. | Transação não autorizada. Data da transação ou data do primeiro pagamento inválida. | Transação não autorizada. Refazer a transação confirmando os dados. | Não |
FF | Cancelamento OK | Transação de cancelamento autorizada com sucesso. ATENÇÂO: Esse retorno é para casos de cancelamentos e não para casos de autorizações. | Transação de cancelamento autorizada com sucesso | Não |
FG | Transação não autorizada. Ligue AmEx 08007285090. | Transação não autorizada. Oriente o portador a entrar em contato com a Central de Atendimento AmEx. | Transação não autorizada. Entre em contato com a Central de Atendimento AmEx no telefone 08007285090 | Não |
GA | Aguarde Contato | Transação não autorizada. Referida pelo Lynx Online de forma preventiva. | Transação não autorizada. lojista deve aguardar contato por parte da Cielo | Não |
GF | Transação negada. | Transação não autorizada, verifique se o IP informado está liberado para processar a transação | Transação não permitida. Entre em contato com a Cielo. | Não |
GD | Transação não permitida. | Transação não permitida. Entre em contato com a Cielo. | Transação não permitida. Entre em contato com a Cielo. | — |
GT | Transação negada. | Ataque de força bruta. | Transação não permitida. Entre em contato com a Cielo. | Não |
GK | Transação negada. | Bloqueio temporário por ataque de força bruta. | Transação não permitida. Entre em contato com a Cielo. | Não |
HJ | Transação não permitida. Código da operação inválido. | Transação não permitida. Código da operação Coban inválido. | Transação não permitida. Código da operação Coban inválido. Entre em contato com o lojista. | Não |
IA | Transação não permitida. Indicador da operação inválido. | Transação não permitida. Indicador da operação Coban inválido. | Transação não permitida. Indicador da operação Coban inválido. Entre em contato com o lojista. | Não |
KA | Transação não permitida. Falha na validação dos dados. | Transação não permitida. Houve uma falha na validação dos dados. Solicite ao portador que reveja os dados e tente novamente. Se o erro persistir verifique a comunicação entre loja virtual e Cielo. | Transação não permitida. Houve uma falha na validação dos dados. reveja os dados informados e tente novamente. Se o erro persistir entre em contato com a Loja Virtual. | Não |
KB | Transação não permitida. Selecionado a opção incorrente. | Transação não permitida. Selecionado a opção incorreta. Solicite ao portador que reveja os dados e tente novamente. Se o erro persistir deve ser verificado a comunicação entre loja virtual e Cielo. | Transação não permitida. Selecionado a opção incorreta. Tente novamente. Se o erro persistir entre em contato com a Loja Virtual. | Não |
KE | Transação não autorizada. Falha na validação dos dados. | Transação não autorizada. Falha na validação dos dados. Opção selecionada não está habilitada. Verifique as opções disponíveis para o portador. | Transação não autorizada. Falha na validação dos dados. Opção selecionada não está habilitada. Entre em contato com a loja virtual. | Não |
NR | Transação não permitida. | Transação não permitida. | Transação não permitida. Retentar a transação após 30 dias | Retentar a transação após 30 dias. |
RP | Transação não permitida. | Transação não permitida. | Transação não permitida. Retentar a transação após 72h | Retentar a transação após 72 horas. |
SC | Transação não permitida. | Transação não permitida. Pagamento recorrente, serviço cancelado. Não retentar. | Transação não permitida. Pagamento recorrente, serviço cancelado. Não retentar. | Não. |
U3 | Transação não permitida. Falha na validação dos dados. | Transação não permitida. Houve uma falha na validação dos dados. Solicite ao portador que reveja os dados e tente novamente. Se o erro persistir verifique a comunicação entre loja virtual e Cielo. | Transação não permitida. Houve uma falha na validação dos dados. reveja os dados informados e tente novamente. Se o erro persistir entre em contato com a Loja Virtual. | Não |
6P | Transação não autorizada. Dados Inválidos | Falha na validação dos dados da transação. Oriente o portador a rever os dados e tentar novamente. | Falha na validação dos dados. Reveja os dados informados e tente novamente. | Apenas 4 vezes em 16 dias. |
Suporte Cielo
Após a leitura deste manual, caso ainda persistam dúvidas (técnicas ou não), a Cielo disponibiliza o suporte técnico 24 horas por dia, 7 dias por semana em idiomas (Português e Inglês), nos seguintes contatos:
- +55 4002-9700 – Capitais e Regiões Metropolitanas
- +55 0800-570-1700 – Demais Localidades
- +55 11 2860-1348 – Internacionais
- Opção 1 – Suporte técnico;
- Opção 2 – Credenciamento E-commerce.
- Email: cieloecommerce@cielo.com.br