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

# Benutzerdefiniertes Branding

> Passen Sie Ihre Verifizierungsseiten, E-Mails und Nachweispakete mit dem Branding Ihrer Organisation an.

Unternehmensmieter können Verifizierungsseiten, Transaktions-E-Mails und Proof-Bundles mit einem benutzerdefinierten Branding versehen. Laden Sie Ihr Logo hoch, legen Sie Markenfarben fest und sehen Sie sich die Änderungen vor dem Speichern in der Vorschau an.

> [!NOTE]
>
> Benutzerdefiniertes Branding erfordert einen Business- oder Enterprise-Plan oder das White-Label
> Add-on. Siehe [Abrechnung](https://docs.truthlocks.com/de/billing/overview.md) für Plandetails.

## Branding-Einstellungen

Navigieren Sie in der Konsole zu **Einstellungen > Branding**, um Ihre Marke zu konfigurieren.

### Logo

Laden Sie das Logo Ihrer Organisation hoch. Das Logo erscheint auf Verifizierungsseiten, Transaktions-E-Mails und Berechtigungskarten.

| Anforderung | Wert |
| :- | :- |
| Formate | PNG, JPEG, SVG, WebP |
| Max. Dateigröße | 2 MB |

### Markenname

Legen Sie den Namen fest, der auf Verifizierungsseiten und Anmeldeinformationskarten angezeigt wird. Dies ist typischerweise der Name Ihrer Organisation oder Ihres Produkts.

### Farben

Konfigurieren Sie zwei Farben, die das Erscheinungsbild Ihrer Marke definieren:

| Farbe | Wo sie erscheint | Standard |
| :- | :- | :- |
| **Primär** | Kartenüberschriften, primäre UI-Elemente | `#06b6d4` |
| **Akzent** | Abzeichen, Tags, sekundäre Hervorhebungen | `#0891b2` |

Verwenden Sie die Farbauswahl oder geben Sie einen Hex-Wert direkt ein (z.B. `#1a2b3c`).

## Live-Vorschau

Die Branding-Seite enthält ein Live-Vorschaufenster, das zeigt, wie Ihr Logo, Ihr Markenname und Ihre Farben auf einer Anmeldekarte erscheinen. Änderungen werden in Echtzeit aktualisiert, während Sie die Einstellungen anpassen.

## Branding konfigurieren

**1. Ihr Logo hochladen**

Klicken Sie auf den Upload-Bereich oder ziehen Sie Ihre Logodatei per Drag & Drop. Die Vorschau wird aktualisiert
sofort.

**2. Ihren Markennamen festlegen**

Geben Sie den Namen Ihrer Organisation in das Feld „Markenname“ ein.

**3. Wählen Sie Ihre Farben**

Verwenden Sie die Farbwähler, um Ihre Primär- und Akzentfarben festzulegen, oder geben Sie Hexadezimalwerte ein
Werte direkt.

**4. Speichern**

Klicken Sie auf **Branding speichern**, um Ihre Änderungen zu übernehmen. Ein Bestätigungsbanner
erscheint, wenn das Speichern abgeschlossen ist.

## Branding über die API verwalten

Sie können Branding-Einstellungen programmgesteuert lesen und aktualisieren. Alle Schreibendpunkte erfordern die White-Label-Berechtigung.

### Aktuelles Branding abrufen

```http Request theme={null}
GET /v1/settings/branding
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "tenant_id": "tn_abc123",
  "brand_name": "Acme Corp",
  "logo_url": "https://cdn.truthlocks.com/branding/tn_abc123/logo/logo.png",
  "primary_color": "#10b981",
  "accent_color": "#059669"
}
```

Wenn kein Branding konfiguriert wurde, gibt die Antwort die Standardfarben (`#06b6d4` primär, `#0891b2` Akzent) und kein Logo zurück.

### Branding aktualisieren

Legen Sie Ihren Markennamen und Ihre Farben in einer einzigen Anfrage fest:

```http Request theme={null}
PUT /v1/settings/branding
X-API-Key: tl_live_...
Content-Type: application/json

{
  "brand_name": "Acme Corp",
  "primary_color": "#10b981",
  "accent_color": "#059669"
}
```

Farben müssen gültige Hex-Werte im Format `#RRGGBB` sein. Ausgelassene Felder behalten ihre aktuellen Werte.

### Ein Logo hochladen

Logo-Uploads verwenden einen dreistufigen vorab signierten URL-Flow:

**1. Eine vorab signierte Upload-URL anfordern**

```http Request theme={null}
POST /v1/settings/branding/logo/presign
X-API-Key: tl_live_...
Content-Type: application/json

{
  "filename": "logo.png",
  "content_type": "image/png",
  "size_bytes": 48000
}
```

```json Response theme={null}
{
  "upload_url": "https://s3.amazonaws.com/...",
  "s3_key": "branding/tn_abc123/logo/ast_xyz/logo.png",
  "asset_id": "ast_xyz",
  "expires_in": 600
}
```

Die vorab signierte URL läuft nach 10 Minuten ab.

**2. Datei auf die vorab signierte URL hochladen**

Laden Sie Ihr Logo direkt in die zurückgegebene `upload_url` hoch, indem Sie eine HTTP PUT-Anfrage mit dem Dateiinhalt als Body verwenden.

**3. Den Upload bestätigen**

```http Request theme={null}
POST /v1/settings/branding/logo/confirm
X-API-Key: tl_live_...
Content-Type: application/json

{
  "asset_id": "ast_xyz",
  "s3_key": "branding/tn_abc123/logo/ast_xyz/logo.png"
}
```

Nach der Bestätigung erscheint das neue Logo auf allen Branding-Oberflächen.

> [!WARNING]
>
> Schreib-Endpunkte (`PUT /v1/settings/branding`, Logo-Vorsignierung und Logo-Bestätigung) geben HTTP 402 zurück, wenn Ihr Plan die White-Label-Berechtigung nicht enthält. Details zum Plan finden Sie unter [Abrechnung](https://docs.truthlocks.com/de/billing/overview.md).

## Wo Branding erscheint

Ihr benutzerdefiniertes Branding wird auf mehreren Oberflächen angewendet:

> [card] Verifizierungsseiten
>
> Öffentliche Nachweisseiten zeigen Ihr Logo und Ihre Markenfarben an.

> [card] Transaktions-E-Mails
>
> In Ihrem Namen gesendete E-Mails (z. B. Zustellung von Anmeldeinformationen, Teameinladungen)
> Ihr Logo einfügen.

> [card] Proof-Bundles
>
> Heruntergeladene Proof-Bundles verweisen auf Ihren Markennamen und Ihre Ausstelleridentität.

> [card] Anmeldekarten
>
> Die den Empfängern angezeigte Anmeldeinformationskarte verwendet Ihre Primärfarbe und Ihr Logo.

## Berechtigungen

Das Aktualisieren von Branding-Einstellungen erfordert die Berechtigung `branding.write`, die standardmäßig den Rollen **Tenant Admin** und **Org Admin** zugewiesen ist. Jeder authentifizierte Benutzer mit `settings.read` kann Branding-Einstellungen anzeigen.

## Verwandt

> [card] [Abrechnung](https://docs.truthlocks.com/billing/overview.md)
>
> Planen Sie Tarifstufen und das White-Label-Add-on.

> [card] [B2B2C-Lieferung](https://docs.truthlocks.com/guides/b2b2c.md)
>
> Wie Marken-Anmeldeinformationen an Verbraucher geliefert werden.

> [card] [Benutzerdefinierte Domains](https://docs.truthlocks.com/guides/custom-domains.md)
>
> Stellen Sie das Verifizierungsportal und die Konsole von Ihrer eigenen Domain bereit.


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