---
title: "Use a claim code"
manual: "AI Foundation"
version: "main"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:t3planet-credits-claim-code@main"
source: "T3Planet-Credit-System/ClaimCode/Index.rst"
rendered: "2026-10-30T14:56:34+00:00"
---

# Use a claim code {#t3planet-credits-claim-code}

The claim link is on **AI Foundation > AI Providers**: on the
**T3Planet Credits** card, click **Use a claim code** (red box).

![AI Foundation, AI Providers module with a red box around the Use a claim code link on the T3Planet Credits card](../../Images/credits-claim-link.png)

A **claim code** connects your TYPO3 site to a T3Planet credits account that
already exists. T3Planet sends it to you by email. You paste it once. After
that the site uses your balance.

## When do you need one? {#when-do-you-need-one}

-   You **bought credits**, in the TYPO3 backend or on t3planet.de, and now want
    the site to use them.
-   You are **recovering an account** after a site rebuild, a move to a new
    server, or a changed server IP address.
-   TYPO3 says that **this server IP already belongs to a paying account** and
    asks you to use a claim code.

You do **not** need a claim code to start with the free trial. Use
**Activate** for that. See
[Configuration](https://docs.typo3.org/permalink/nitsan/ns-t3af:t3planet-credits-configuration@main).

## Where do you get the code? {#where-do-you-get-the-code}

-   After **every purchase**, T3Planet emails the code to the address you used.
    This is the same if you bought in the TYPO3 backend (**AI Credit
    Bundles**) or on [https://t3planet.de/ki-credits](https://t3planet.de/ki-credits).
-   Lost it, or it expired? Ask for a new one inside TYPO3 (see
    [below](https://docs.typo3.org/permalink/nitsan/ns-t3af:t3planet-credits-claim-resend@main)).

> [!WARNING]
> Treat the code like a password. Anyone who has it can connect a site to
> your credits. Do not post it in tickets, chats or screenshots.

## Enter the code {#enter-the-code}

1.  Open **AI Foundation > AI Providers**. On the
    **T3Planet Credits** card, click **Use a claim code** (see
    the red box above).
1.  Paste the code into **Claim code**. Spaces and line breaks are
    removed for you.
1.  Click **Connect this site**.
1.  A green message appears in the bottom right corner. Then the page reloads.

![Animated recording: the Use a claim code dialog, the pasted code (blurred), the green success message and the reloaded page with the credit balance](../../Images/credits-claim-flow.gif)

## What happens next {#what-happens-next}

-   TYPO3 sends the code to T3Planet. The code is not stored in TYPO3.
-   TYPO3 saves the access token it gets back in encrypted form and switches
    Credits on. You do not need to click **Activate**.
-   After the reload, the **T3Planet Credits** card shows the green
    badge **Active**. **Credit Balance** shows your credits.
    See [Dashboard & AI Usage](https://docs.typo3.org/permalink/nitsan/ns-t3af:t3planet-credits-ai-usage@main).

The green message depends on your site:

-   *Your purchase was added to this site's existing credits account. Loading
    your dashboard…* The site already had a credits account, for example from
    the free trial. Your purchase is added to it. The balance can still say
    **Current: Free Trial**.
-   *Credits account connected. Loading your dashboard…* The site had no credits
    account yet.

The **Use a claim code** link stays on the card after Credits is
active. If the code belongs to a different account than before, the list
**Recent AI Usage** is cleared. It then shows only the connected
account.

## Lost the code or it expired {#t3planet-credits-claim-resend}

In the same dialog, use **Email me a code**.

1.  Enter the email address of your T3Planet credits account.
1.  Click **Email me a code**.
1.  Paste the new code from the email.

T3Planet always answers *If that address has an AI Credits account, a claim
code is on its way to it.* It never says whether the address is registered.
The code goes only to the address stored on the account.

Code not accepted or something else does not work? See
[Troubleshooting: Claim code not accepted](https://docs.typo3.org/permalink/nitsan/ns-t3af:t3planet-credits-troubleshooting-claim@main).