---
title: "Card Updater (legado)"
url: "https://devcenter.stone.com.br/legacy-card-updater"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Card+Updater+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktY2FyZC11cGRhdGVyIg,s_4vSbS2ul8GzrVGZs.png"
---

# Card Updater

Atualização automática de cartões expirados na Pagar.me v5.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

O **Card Updater** é uma funcionalidade que permite a atualização de cartões de crédito expirados que foram reemitidos — eliminando a necessidade de renovação do cartão por parte do consumidor final.

Essa funcionalidade é **especialmente valiosa para clientes com assinatura**, pois reduz significativamente a taxa de **churn involuntário** (quando o consumidor não deseja cancelar o serviço, mas o cartão expira).

## [Bandeiras suportadas](#bandeiras-suportadas)

Apenas algumas bandeiras disponibilizam cartões para essa funcionalidade:

-   ✅ **Mastercard**
-   ✅ **Visa**
-   ✅ **Hipercard**

## [Modos de operação](#modos-de-operação)

Pensando na melhor experiência, a funcionalidade foi desenvolvida de duas formas distintas: **manual** ou **automática**.

### [Renovação Manual](#renovação-manual)

Permite que o cliente, ao receber como resposta que o cartão está vencido ou inválido, **envie uma requisição de renovação**, chamando a API e verificando se esse cartão foi reemitido.

Caso o cartão tenha sido reemitido, a API cria um **novo cartão** (mantendo o antigo, para garantir rastreabilidade das transações realizadas com ele) na **Wallet do lojista**.

Essa solução é interessante para clientes que utilizam funcionalidades como **"one click buy"**: a loja pode renovar manualmente um cartão prestes a vencer e avisar ao consumidor que o cartão foi atualizado.

Segurança

Por questões de segurança, só é possível utilizar essa funcionalidade caso o cartão **já esteja gravado na wallet**.

### [Renovação Automática](#renovação-automática)

Pensada para clientes com modelo de negócios de **recorrência**. Se um cartão atrelado a assinaturas for identificado como expirado, a API envia automaticamente uma requisição de renovação. Em caso de renovação bem-sucedida:

1.  O **cartão novo** é gravado na wallet (mantendo o antigo para rastreabilidade)
2.  É **atualizado na assinatura**
3.  A **cobrança referente à assinatura é retentada automaticamente** com o novo cartão

Funciona para todos os tipos de assinatura — pré, pós-paga e "exact day".

Permite que o lojista não perca transações por churn involuntário e diminua a inadimplência.

Use os dois juntos

É possível utilizar as duas formas separadamente ou de forma simultânea — combine como se encaixar melhor no seu modelo de negócios.

## [Migração para a API Unificada](#migração-para-a-api-unificada)

Na Stone, Card Updater funciona **transparentemente** quando você usa `wallet_id` em uma cobrança recorrente:

```json
{
  "amount": 4990,
  "currency": "BRL",
  "payment_method": "credit_card",
  "card": { "wallet_id": "wlt_aN9k..." },
  "recurring": { "interval": "month", "frequency": 1 }
}
```

Não há chamada extra — se o cartão foi reemitido, a Stone usa a versão atualizada automaticamente. Veja [Stone Online · Recorrência](https://devcenter.stone.com.br/ecommerce-recurrence).

---

**Jornada: [Cobrar de forma recorrente](https://devcenter.stone.com.br/legacy-overview-recorrencia)**  
Etapa 7 de 7

[**Etapa anterior**Recorrência com Split](https://devcenter.stone.com.br/legacy-recorrencia-com-split)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.