> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Update your card by link

> How the card update page works: single-use link, 48-hour validity and what it shows

When a card charge fails, the notice email includes a link to register a new card without signing in to the dashboard. The page lives at `/checkout/cartao?token=…`.

## How the link works

* **Single use:** once the card is saved successfully, the link stops working.
* **Valid for 48 hours** from the moment it is generated.
* **No sign-in:** the link itself identifies your account.
* **Privacy:** the page shows only the **account name**. It does not show an email, a document number or other cards.

<Warning>
  Treat the link like a password: anyone who has it can change the subscription's card while it is valid. Do not forward it to others.
</Warning>

## Step by step

<Steps>
  <Step title="Open the link from the email">
    The page checks the link and shows the account name.
  </Step>

  <Step title="Enter the new card">
    Fill in number, name on card, expiry and CVV. The details go straight to the payment processor and are not stored by us.
  </Step>

  <Step title="Save">
    If the card is accepted, it becomes the **default card** and the page confirms it showing only the brand and last digits. The new card is used for upcoming charges.
  </Step>
</Steps>

## Messages you may see

| Situation | What the page shows |
| - | - |
| Expired or already used link | "This link has expired or was already used." Ask support for a new one. |
| Wrong or incomplete link | "Invalid link." Check the address you received. |
| Card declined at verification | "Card declined." The link stays valid: use another credit card. |
| Too many attempts | Wait a minute and try again. |
| Could not confirm | Reload the page. If the link shows as used, your card was updated. |

<Note>
  The page is available in Portuguese and English, following your browser language; other languages are shown in Portuguese.
</Note>

Need a new link? Contact support. See also [Renewal and retries](/en/guide/subscription-renewal).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.