Changelog

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

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