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:
Emissores | VISA | MASTER | ELO | Amex |
---|---|---|---|---|
BRADESCO | Sim | Sim | Sim | Sim |
BANCO DO BRASIL | Sim | *** | *** | *** |
SANTANDER | Sim | *** | *** | *** |
CITI | Sim | *** | *** | *** |
BANCO PAN | Sim | *** | *** | *** |
Veja a seguir o exemplo de resposta de uma transação de crédito com o nó NewCard
.
Exemplo do retorno do no NewCard
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"
}
Propriedade | Descrição | Tipo | Tamanho | Obrigatório |
---|---|---|---|---|
NewCard.CardNumber | Novo número do cartão do comprador. | string | 16 | Sim |
NewCard.ExpirationDate | Nova data de validade do cartão. | string | 7 | Sim |
NewCard.Brand | Bandeira do cartão. | string | 10 | Sim |
NewCard.SaveCard | Identifica se o cartão gerou Cardtoken durante a transação. Saiba mais sobre Tokenização | booleano | *** | Sim |
O Renova Fácil não atualiza automaticamente cartões armazenados como alias.
Updated 3 days ago