Changelog

• Agora é possível gerar suas credenciais ClientId e ClientSecret para Silent Order Post no portal e-commerce! Veja como acessar em Como gerar a credencial SOP?
• Incluídas orientações detalhadas para captura, cancelamento e consulta de transações;
• Atualizada a documentação para informar que o CPF é obrigatório nas transações Pix Bradesco, mesmo quando a opção “Aceitar CPF Nulo” estiver habilitada na loja;
• Atualizada a documentação para detalhar o uso do Soft Descriptor.
• Atualizado para informar que o retorno de um cartão com final 9 no ambiente Sandbox será sempre:
  • 6 – Operation Successful, ou
  • 9 – Time Out
• Atualizada o tamanho máximo permitido do parâmetro bpmpi_totalamount no mapeamento de classes para integração 3DS:
  • Atualizado de até 15 posições para até 11 posições.
• Atualizadas informações sobre envio de criptograma em transações MIT tokenizadas na bandeira Mastercard:
  • Não é necessário enviar o criptograma em transações MIT tokenizadas na bandeira Mastercard, pois o token já foi validado previamente na transação CIT original.
  • Saiba mais em Indicador de início da transação - CIT e MIT.

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

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