Automatic Billing Updater (ABU)

ℹ️

Go to the API Reference to access the complete request and response examples..

The Automatic Billing Updater (ABU) is automatically consulted for recurring Mastercard transactions that have been denied with one of the eligible response codes. When a new card is available, the ABU returns the updated data, which is passed on by Cielo to the merchant in the NewCard node, following the same pattern as the Renova Fácil service.

The merchant may use the new card data returned by the ABU to make a new authorization attempt in order to recover the originally declined transaction.

ℹ️

Important

To use ABU, you need to enable the service with Cielo.

Benefits

Integration with ABU brings advantages for both shopkeepers and shoppers:

Merchants:

• Avoid lower conversion rates on recurring transactions;
• Less friction in the customer journey, with payments flowing without the need for data re-entry.

Shoppers:

• Continuity of services without interruptions due to billing failures;
• Smoother experience, with no need to manually update payment data for multiple services.

How it works

With ABU enabled, the Payment.CardBrandStatus field will always be returned and if there is a new card, it will be returned in the NewCard node.

Below is an example of a response to a recurring credit transaction with the fields mentioned.

Example of the return from the CardBrandStatus field and in NewCard

{
  "Payment":{
    "CardBrandStatus":"VALID",
    "NewCard": {
      "CardNumber": "40000000000000000",
      "ExpirationDate": "10/2032",
      "SaveCard": true,
      "Brand": "Master"
    }
  }
}

Possible values for Payment.CardBrandStatus :