Changelog

Acompanhe as últimas atualizações da API E-commerce Cielo.

• Novos códigos de retorno das bandeiras:
  • Elo: códigos 15, 66, 73, 79, 80;
  • Amex: código 102;
• Atualização da descrição de códigos de retorno das bandeiras:
  • Visa: código 46;
  • Elo: código 78;
• A partir do dia 17/04/2026, será necessário enviar o criptograma em transações de verificação de cartão (Zero Auth) com tokenização na bandeira Visa:
  • Envie o DPAN (token) no campo Card.CardNumber;
  • Envie o criptograma no campo Card.SecurityCode.
• Nova página para gestão de recorrências disponibilizada:
  • Agora é possível editar, ativar ou desativar uma recorrência via site Cielo!
• Aviso sobre Click to Pay funcionar apenas com os dados do cartão ou DPAN incluso.
• Nova página sobre Merchant Advice Code (MAC) – Mastercard disponibilizada:
  • O Merchant Advice Code (MAC) é um código retornado pela Mastercard em transações negadas ou em outros cenários específicos, como casos envolvendo cartões virtuais, atualização de dados do cartão (ABU) ou requisitos de token.
• Novo código 298 – Split payment facilitator data not found :
  • O MerchantId informado não existe na base de dados do ambiente selecionado (produção ou sandbox).

• Melhoramos a organização das páginas sobre retornos da API E‑commerce;

• Conteúdo expandido e aprimorado, com explicações mais detalhadas, exemplos práticos de cenários e orientações claras sobre como interpretar corretamente códigos, status e retornos da API;

• Não há nenhuma alteração no comportamento da API.

  Saiba mais em Códigos retornados pela API E‑commerce (HTTP, status e códigos de negócio) .

• Disponibilizado passo a passo para utilização do boleto Bradesco;
• Atualizada a documentação para ampliar a lista de bandeiras compatíveis com Soft Descriptor. As bandeiras disponíveis são:
  • Visa;
  • Mastercard;
  • Amex;
  • Elo.

• Atualizado certificado para uso no domínio api.cieloecommerce.com.br;

• Atualizados os contatos do suporte Cielo E-commerce;

• Adicionada nova página sobre credenciamento no site Cielo;

• Adicionada nova página sobre Visa Intelligent Data Exchange (IDX): solução da Visa para compartilhamento de dados em transações sem cartão presente;

• Adicionados os códigos de erro 220 e 233 na documentação;

• Adicionada orientação para uso de credenciais do Silent Order Post;

• Adicionada orientação sobre uso de autenticação 3DS para cartão de crédito e cartão de débito:

  • A validação e o retorno do campo Payment.Eci ocorrem apenas no ambiente de produção neste primeiro momento;

• Adicionada orientação sobre erro 389 - Restrição Cadastral do Zero Auth:

  • Caso a requisição retorne o erro 389, procure o gestor comercial para validar se o serviço está habilitado corretamente; se estiver, o retorno indica que essa tentativa não pode ser validada por critérios internos da Cielo. Recomendamos tentar outro cartão para concluir a validação;

• Adicionada orientação sobre pagamento com cartão multibenefícios:

  • Para voucher multibenefícios Alelo, use a integração do tipo voucher;

• Adicionadas orientações para cancelamento em voucher Alelo:

  • Não é possível realizar cancelamento parcial;
  • O cancelamento total pode ser feito apenas no dia da transação (D0);
  • Para cancelar após o dia da transação (D+1 em diante), é necessário contatar a Alelo;

• Adicionadas orientação para criar pagamento com cartão de crédito:

  • Por padrão, a API E-commerce aceita até 12 parcelas para cartão de crédito;

  • Para habilitar até 24 parcelas, é necessário entrar em contato com o Atendimento E-commerce. A habilitação estará sujeita à análise interna da Cielo.

• Orientações sobre uso de Click to Pay adicionada:
  • Quando o cartão é tokenizado, o Click to Pay retorna o CAVV e o envio do código de segurança não é obrigatório;
  • Quando o cartão não é tokenizado, é obrigatório enviar o código de segurança;
• Incluído na documentação o fluxo de uso do 3DS com Silent Order POST:
  • Adicionado desenho explicativo do processo, incluindo a etapa anterior e a chamada de autorização.
• Adicionado o código de retorno de cancelamento 100 – “Transação não encontrada para cancelamento”;
  • Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação.
• Incluídos os códigos 100, BP900 e BP903 na tabela de códigos de retorno de cancelamento
  • 100: Transação não encontrada para cancelamento. Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação.
  • BP900: Falha na operação. Tente novamente em 5 minutos. Recomendamos realizar a consulta do status da transação antes de fazer uma nova tentativa de requisição.
  • BP903: Falha no cancelamento. Tente novamente.

• Orientação sobre verificação de autenticação no 3DS em transações de crédito e débito:
  • Para confirmar se a autenticação foi acatada na autorização, verifique o valor do ECI em Payment.Eci.
  • API replica ECI informado pela loja em Payment.ExternalAuthentication, mas o valor efetivo utilizado pela bandeira é o de Payment.Eci.
• Informação sobre o campo SentOrderId em transações de crédito e débito:
  • Quando o MerchantOrderId não atende às regras da adquirente, um novo número de pedido é gerado e retornado em SentOrderId;
  • Se o formato for válido, SentOrderId retorna o mesmo valor informado em MerchantOrderId.
• Regra do Programa de Retentativas da Visa:
  • O código 14 agora é considerado na categoria 1 e também na categoria 3 (Data Quality).
• Código de erro 100 no cancelamento:
  • Ocorre quando a tentativa de cancelamento parcial é feita antes da liquidação da transação.

• Novo campo SentOrderId na resposta de autorização da transação de cartão de crédito e débito;
• Inclusão do código de erro 003 – Transação inexistente em códigos de retorno ABECS;
• Novas listas de status da transação Pix, boleto, e-wallets, débito e crédito;
• Nova funcionalidade de agendamento de atualização de valor na recorrência programada, que permite ao cliente programar ajustes futuros no valor da assinatura para uma data específica;
• Nova funcionalidade de habilitação e desabilitação de e-wallet no site Cielo, disponível para Apple Pay, Google Pay e Samsung Pay.
• Informação sobre a habilitação do voucher Alelo, a solicitação deve ser encaminhada diretamente à Alelo;
• Novos fluxos disponíveis no Renova Fácil: recorrência programada; recorrência própria com cartão aberto; recorrência própria com CardToken ou Alias; e recorrência própria com PaymentToken utilizando Silent Order Post.

• Novo conteúdo sobre os tipos de tokenização oferecidos pela Cielo;
• Novo conteúdo sobre facilitadores de pagamento;
• Informação sobre configuração da URL de notificação no site Cielo;
• Cartão de débito disponível para pagamentos via carteira digital;
• Informação sobre valor mínimo de parcelas (R$ 5,00);
• Informação sobre cobranças retroativas ao agendar recorrência para uma data passada;
• O campo ServiceTaxAmount agora é aceito para agências de turismo, além de companhias aéreas;
• Automatic Billing Update (ABU) aceito para bandeiras Visa e Elo, além de Mastercard.

• Nova documentação detalhando Tokenização;
• Instruções para integração dos scripts para 3DS e Silent Order Post;
• Inclusão da bandeira Alelo para pagamentos com voucher;
• Informação de que o MCC 6540 é obrigado para transações SDWO de boleto identificado e não identificado da bandeira Mastercard;
• Inclusão do erro 228 nos possíveis erros da API;
• Novas instruções sobre revogar credenciais 3DS no site Cielo;
• Novas instruções sobre revogar credenciais SOP no site Cielo;
• Novo meio de pagamento disponível: cartão multibenefícios. Válido para as bandeiras Visa, Mastercard e Elo;
• Inclusão do MAC CODE 43 na tabela de retornos de retentativa da Mastercard;
• Obrigatoriedade na identificação de transações oriundas de link de pagamento para cartões da bandeira Elo a partir de 15/09/2025.