Changelog

• Nova página sobre provedores e bandeiras suportados pela API Gateway de Pagamento;
• Orientação sobre uso de autenticação 3DS para cartão de crédito e cartão de débito adicionada:
  • A validação e o retorno do campo Payment.Eci ocorrem apenas no ambiente de produção neste primeiro momento;
• Adicionada orientação sobre uso de pagamento com cartão multibenefícios:
  • O voucher Alelo multibenefícios usa a integração de voucher convencional;
• Orientações para cancelamento em voucher Alelo adicionadas:
  • 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;
• Orientações para captura e cancelamento em lote pelo portal e-commerce adicionadas:
  • A API permite capturar ou cancelar transações individualmente. Para capturar ou cancelar um grupo de transações, utilize o portal e-commerce;
• Adicionada orientação para cancelar transação de débito via PaymentId :
  • Para cartão de débito, é possível fazer apenas um cancelamento parcial;
• 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.

• 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 erro BP172 à documentação:
  • Indica falha na validação das credenciais enviadas.

• 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.
• Documentação sobre o código de erro 286:
  • Caso o MerchantId informado não exista na base do ambiente (Produção ou Sandbox), será retornado o erro "298 – Split payment facilitator data not found";

• Nova página sobre pagamento com cartão multibenefícios;
• Informação sobre importação de token preferencialmente no formato CSV e com campos obrigatórios;
• Novas listas de status da transação Pix, boleto, e-wallets, débito e crédito;
• Nova funcionalidade 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.

• Novo conteúdo sobre facilitadores de pagamento;
• Cartão de débito disponível para pagamentos via carteira digital;
• 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.

• Pix Automático disponibilizado para cobranças recorrentes;
• Instruções para integração dos scripts para 3DS e Silent Order Post;
• Inclusão da bandeira Alelo para pagamentos com voucher;
• Inclusão de endpoint de cancelamento parcial;
• Obrigatoriedade na identificação de transações oriundas de link de pagamento para cartões da bandeira Elo a partir de 15/09/2025.

• 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;
• Endpoints para criar cartão tokenizado com o Cartão Protegido adicionados na referência da API;
• Novo código ChangeType= 25 para Post de Notificação. O novo código indica que a transação cancelada ou estornada parcialmente;
• Instruções para envio dos campos bpmpi_billto_state e bpmpi_shipTo_state no script para autenticação 3DS atualizada para diferentes países;
• Novos cartões de teste disponíveis para 3DS Data Only.

• Novas páginas sobre consulta, captura e cancelamento;
• Detalhes sobre como cancelar parcialmente uma transação;
• Certificado TLS atualizado.

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 aviso sobre pagamento com dois cartões no Gateway de Pagamento;
• Adição de aviso sobre padrão de autenticação em token de acesso;
• Nova página de criar pagamento com token da bandeira via integração externa;
• Atualização do tempo de consulta via API ou painel administrativo;
• Nova página de Automatic Billing Updater (ABU);
• Adição de informação sobre campos retornados caso a loja tenha o ABU habilitado ;
• Adição de informação sobre bandeiras disponíveis por adquirente no Zero Auth;
• Nova página de Soft Descriptor.