Changelog

• 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.

• Agora é possível habilitar e configurar os microsserviços no site Cielo;
• Mais informações sobre o código MAC 02 adicionadas;
• Exemplo de resposta para consulta por TId atualizada;
• Novo campo obrigatório PaymentFacilitator.SubEstablishment.EstablishmentUrl para transações de facilitadores de pagamentos;
• O campo Customer.Name não aceita números e caracteres especiais;
• Novo código ChangeType= 25 para Post de Notificação. O novo código indica que a transação cancelada ou estornada parcialmente;
• Voucher Alelo agora está disponível como meio de pagamento;
• Instruções para envio dos campos bpmpi_billto_state e bpmpi_shipTo_state no script para autenticação 3DS atualizada para diferentes países;
• Código 14 do Programa de Retentativa da Visa movido da categoria 1 para categoria 3 seguindo determinação da bandeira;
• Novos cartões de teste disponíveis para 3DS Data Only.

• Instruções de como obter as credenciais de sandbox adicionadas;
• Nova página sobre obter carta de cancelamento via site Cielo;
• Nova página detalhando como cancelar uma venda via site Cielo.

A bandeira Hipercard foi descontinuada em 30/06/2025. Os cartões Hipercard migrarão para a bandeira Mastercard. Após essa data, transações com a bandeira Hipercard serão recusadas.

• Adição de nota sobre os códigos 12 e 15 sendo convertidos pela bandeira Visa;
• Adição de nota sobre pagamento com dois cartões na API E-commerce Cielo;
• Atualização do tempo de consulta via site Cielo;
• Nova página Automatic Billing Updater (ABU);
• Adição de informação sobre campos retornados caso a loja tenha o ABU habilitado ;
• Atualização sobre os meios de pagamentos aceitos na recorrência própria e na recorrência;
• Atualização sobre os ambientes para autenticação 3DS;
• Adição de nota sobre o status 12 retornado na resposta da requisição com conversão de moeda;
• Adição de informação sobre conta transitória de Pix na Cielo em regras para devolução Pix, gestão da conta Pix na Cielo e Solicitar uma devolução Pix;
• Atualização de informação sobre o número de retentativas permitidas para Visa;
• Adição de novas instruções de obrigatoriedade de recaptcha e validação via token para acesso ao site Cielo;
• Nova página de Como começar a usar a API E-commerce Cielo;
• Adição dos campos Wallet.ReceiverData.Name e Wallet.ReceiverData.Identity em SDWO.

• Criação do campo CardNumberType permite enviar transações com ou sem criptograma em pagamentos com token de bandeira via integração externa;
• Hipercard e Amex inclusas nas bandeiras suportadas pelos identificadores de bandeira numa recorrência;
• Novos campos obrigatórios para facilitadores de pagamento;
• Tempo da sondagem reduzido de 30 para apenas cinco minutos;
• Possibilidade de configurar IPs confiáveis no Site Cielo;
• Novo código de erro (340) adicionado na tabela de códigos de retorno de cancelamento;
• Novos campos Wallet.ReceiverData.Namee Wallet.ReceiverData.CompanyName para transações SDWO.

A partir de 11/04/2025 a Visa irá retornar dois novos códigos para transações negadas na categoria 2, na qual o emissor não pode aprovar no momento. Os retornos são:

• Melhorias no conteúdo de autenticação 3DS;
• Melhorias no conteúdo de Data Only;
• Correção do exemplo da concatenação do ClientId e ClientSecret para autenticação 3DS;
• Aviso sobre novos campos obrigatórios para Facilitadores de Pagamento.