Renova Fácil

Renova Fácil is a service developed by Cielo along with issuers. The service aims to increase the conversion rate of recurring transactions with credit cards.

Renova Fácil allows the automatic replacement of a credit card that has been replaced by the issuing bank for some reason (expiry date, exchange, etc.).

This way, when a recurrent transaction (Recurrent set as true) is submitted to the API and Cielo identifies that the card sent has been replaced, authorization will be denied and the API will return the new card data in the NewCard node. When you receive the new card details, you will need to send a new authorization request with the new card details..

ℹ️

To use Renova Fácil, you must enable the service at Cielo.

No extra information is sent in the authorization request, however the response will include the NewCard node.

Below is an example of how the node NewCard will return:

Response

{
  "MerchantOrderId": "2014113245231706",
  "Customer": {
    (...)
  },
  "Payment": {
    (...)
    "NewCard": {
      "CardNumber": "40000000000000000",
      "ExpirationDate": "10/2020",
      "SaveCard": false,
      "Brand": "Visa"
    },
    (...)
  }
}
--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "MerchantOrderId": "2014113245231706",
  "Customer": {
    (...)
  },
  "Payment": {
    (...)
    "NewCard": {
      "CardNumber": "40000000000000000",
      "ExpirationDate": "10/2020",
      "SaveCard": false,
      "Brand": "Visa"
    },
    (...)
  }
}

Property

Description

Type

Size

Format

RecurrentPaymentId

Next recurrence Identifier field.

Guid

36

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

NextRecurrency

Date of next recurrence.

Text

7

12/2030 (MM/YYYY)

EndDate

End date of recurrence.

Text

7

12/2030 (MM/YYYY)

Interval

Interval between recurrences.

Text

10

Monthly
Bimonthly
Quarterly
SemiAnnual Annual

AuthorizeNow

Boolean to know if the first recurrence is about to be Authorized or not.

Boolean

---

true ou false

NewCard.CardNumber

Shopper's new card number.

Text

16

Yes

NewCard.ExpirationDate

New expiry date of the card.

Text

7

Yes

NewCard.Brand

Card brand.

Text

10

Yes

NewCard.SaveCard

Identifies whether the card generated Cardtoken during the transaction. Find out more about Tokenization of Cards

Boolean

---

Yes