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"
}
}
}
Propriedade | Descrição | Tipo | Tamanho |
---|---|---|---|
CardBrandStatus | Retorno de status da conta Mastercard | string | - |
NewCard.CardNumber | Novo número do cartão do comprador. | string | 16 |
NewCard.ExpirationDate | Nova data de validade do cartão. | string | 7 |
NewCard.Brand | Bandeira do cartão. | string | 10 |
NewCard.SaveCard | Identifica se o cartão gerou Cardtoken durante a transação. Saiba mais sobre Tokenização | booleano | *** |
Valores possíveis para Payment.CardBrandStatus
:
Valor | Descrição |
---|---|
VALID | Cartão Valido ou sem atualizações na base |
UNKNOWN | Cartão não está disponível na ABU |
NON_PARTICIPATING | Cartão não está disponível na ABU |
ACCOUNT_CLOSED | Cartão está encerrado |
UPDATE | Atualização Plástico ou Validade |
EXPIRY | Atualização da Validade |
ERROR | Houve algum erro na atualização (Timeout por exemplo) |
Updated about 5 hours ago