Renova Fácil

ℹ️

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

O Renova Fácil é um serviço desenvolvido pela Cielo em conjunto com os emissores, cujo objetivo é aumentar a taxa de conversão de vendas recorrentes com cartão de crédito.

O uso desta funcionalidade permite a substituição automática de um cartão de crédito que foi substituído pelo banco emissor por algum motivo (vencimento atingido, troca etc). Dessa forma, quando uma transação com marcação de recorrência (Recurrent igual a true) for submetida para a API e a Cielo identificar que o cartão enviado foi substituído, sua autorização será negada e a API retornará os dados do novo cartão no nó NewCard. Quando receber os dados do novo cartão, será necessário enviar uma nova requisição de autorização com os dados do novo cartão.

ℹ️

Importante

Para usar o Renova Fácil, é necessário habilitar o serviço na Cielo. Nenhuma informação extra é enviada na requisição de autorização, porém a resposta terá o nó NewCard.


Bandeiras e emissores habilitados

Bandeiras e emissores que já habilitaram o Renova Fácil:

EmissoresVISAMASTERELOAmex
BRADESCOSimSimSimSim
BANCO DO BRASILSim*********
SANTANDERSim*********
CITISim*********
BANCO PANSim*********

Veja a seguir o exemplo de resposta de uma transação de crédito com o nó NewCard.

Exemplo do retorno do no NewCard

{
  "MerchantOrderId": "2014113245231706",
  "Customer": {
    "Name": "Comprador  Renova facil"
  },
  "Payment": {
(...)
    "NewCard": {
      "CardNumber": "40000000000000000",
      "ExpirationDate": "10/2032",
      "SaveCard": false,
      "Brand": "Visa"
}
--header "Content-Type: application/json"  
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"  
--data-binary  
{  
  "MerchantOrderId": "2014113245231706",  
  "Customer": {  
    "Name": "Comprador  Renova facil"  
  },  
  "Payment": {  
(...)  
    "NewCard": {  
      "CardNumber": "40000000000000000",  
      "ExpirationDate": "10/2020",  
      "SaveCard": false,  
      "Brand": "Visa"  
 }
PropriedadeDescriçãoTipoTamanhoObrigatório
NewCard.CardNumberNovo número do cartão do comprador.string16Sim
NewCard.ExpirationDateNova data de validade do cartão.string7Sim
NewCard.BrandBandeira do cartão.string10Sim
NewCard.SaveCardIdentifica se o cartão gerou Cardtoken durante a transação. Saiba mais sobre Tokenizaçãobooleano***Sim

⚠️

O Renova Fácil não atualiza automaticamente cartões armazenados como alias.