Automatic Billing Updater (ABU)

ℹ️

Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

O Automatic Billing Updater (ABU) é consultado automaticamente em transações recorrentes com cartões Mastercard que tenham sido negadas com um dos códigos de resposta elegíveis. Quando há um novo cartão disponível, o ABU retorna os dados atualizados, que são repassados pela Cielo ao estabelecimento no nó NewCard, seguindo o mesmo padrão do serviço Renova Fácil.

A loja poderá utilizar os dados do novo cartão retornados pelo ABU para realizar uma nova tentativa de autorização, com o objetivo de recuperar a transação originalmente recusada.

ℹ️

Importante

Para usar o ABU, é necessário habilitar o serviço na Cielo.

Benefícios

A integração com o ABU traz vantagens tanto para os lojistas quanto para os compradores:

Lojistas:

  • Evitar diminuição da taxa de conversão em transações recorrentes;
  • Menos atrito na jornada do cliente, com pagamentos fluindo sem necessidade de reentrada de dados.

Compradores:

  • Continuidade de serviços sem interrupções por falhas de cobrança;
  • Experiência mais fluida, sem necessidade de atualizar manualmente os dados de pagamento em múltiplos serviços.

Como funciona

Com o ABU habilitado, sempre haverá o retorno do campo Payment.CardBrandStatus e se houver novo cartão, retornará no nó NewCard.

Veja a seguir o exemplo de resposta de uma transação de crédito recorrente com os campos mencionados.

Exemplo do retorno do no NewCard

{
  "Payment":{
    "CardBrandStatus":"VALID",
    "NewCard": {
      "CardNumber": "40000000000000000",
      "ExpirationDate": "10/2032",
      "SaveCard": true,
      "Brand": "Master"
    }
  }
}
PropriedadeDescriçãoTipoTamanho
CardBrandStatusRetorno de status da conta Mastercardstring-
NewCard.CardNumberNovo número do cartão do comprador.string16
NewCard.ExpirationDateNova data de validade do cartão.string7
NewCard.BrandBandeira do cartão.string10
NewCard.SaveCardIdentifica se o cartão gerou Cardtoken durante a transação. Saiba mais sobre Tokenizaçãobooleano***

Valores possíveis para Payment.CardBrandStatus :

ValorDescrição
VALIDCartão Valido ou sem atualizações na base
UNKNOWNCartão não está disponível na ABU
NON_PARTICIPATINGCartão não está disponível na ABU
ACCOUNT_CLOSEDCartão está encerrado
UPDATEAtualização Plástico ou Validade
EXPIRYAtualização da Validade
ERRORHouve algum erro na atualização (Timeout por exemplo)