> ## 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.

# Marque personnalisée

> Personnalisez vos pages de vérification, vos e-mails et vos ensembles de preuves avec la marque de votre organisation.

Les locataires d'entreprise peuvent appliquer une image de marque personnalisée aux pages de vérification, aux e-mails transactionnels et aux bundles de preuves. Téléchargez votre logo, définissez les couleurs de la marque et prévisualisez les modifications avant de les enregistrer.

> [!NOTE]
>
> La personnalisation de la marque nécessite un plan Business ou Enterprise, ou l'option White-Label
> module complémentaire. Voir [facturation](https://docs.truthlocks.com/fr/billing/overview.md) pour les détails du plan.

## Paramètres de marque

Naviguez vers **Paramètres > Marque** dans la console pour configurer votre marque.

### Logo

Téléchargez le logo de votre organisation. Le logo apparaît sur les pages de vérification, les e-mails transactionnels et les cartes d'identification.

| Exigence | Valeur |
| :- | :- |
| Formats | PNG, JPEG, SVG, WebP |
| Taille de fichier max | 2 Mo |

### Nom de marque

Définissez le nom affiché sur les pages de vérification et les cartes d'identification. Il s'agit généralement du nom de votre organisation ou de votre produit.

### Couleurs

Configurez deux couleurs qui définissent l'apparence de votre marque :

| Couleur | Où elle apparaît | Par défaut |
| :- | :- | :- |
| **Principal** | En-têtes de carte, éléments d'interface utilisateur principaux | `#06b6d4` |
| **Accent** | Badges, étiquettes, surlignages secondaires | `#0891b2` |

Utilisez le sélecteur de couleurs ou entrez directement une valeur hexadécimale (par exemple, `#1a2b3c`).

## Aperçu en direct

La page de personnalisation comprend un panneau de prévisualisation en direct qui montre comment votre logo, votre nom de marque et vos couleurs apparaissent sur une carte d'identification. Les modifications sont mises à jour en temps réel au fur et à mesure que vous ajustez les paramètres.

## Configuration de la marque

**1. Téléchargez votre logo**

Cliquez sur la zone de téléchargement ou faites glisser et déposez votre fichier logo. L'aperçu se met à jour
immédiatement.

**2. Définir le nom de votre marque**

Saisissez le nom de votre organisation dans le champ Nom de la marque.

**3. Choisissez vos couleurs**

Utilisez les sélecteurs de couleurs pour définir vos couleurs primaires et d'accentuation, ou entrez le code hexadécimal
valeurs directement.

**4. Enregistrer**

Cliquez sur **Enregistrer la marque** pour appliquer vos modifications. Une bannière de confirmation
apparaît lorsque la sauvegarde est terminée.

## Gestion de l'image de marque via l'API

Vous pouvez lire et mettre à jour les paramètres de marque par programmation. Tous les points de terminaison d'écriture nécessitent le droit White-Label.

### Obtenir l'image de marque actuelle

```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"
}
```

Si aucune image de marque n'a été configurée, la réponse renvoie les couleurs par défaut (`#06b6d4` primaire, `#0891b2` accent) et aucun logo.

### Mettre à jour l'image de marque

Définissez le nom et les couleurs de votre marque en une seule requête :

```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"
}
```

Les couleurs doivent être des valeurs hexadécimales valides au format `#RRGGBB`. Les champs omis conservent leurs valeurs actuelles.

### Télécharger un logo

Les téléchargements de logo utilisent un flux d'URL pré-signées en trois étapes :

**1. Demander une URL de téléchargement présignée**

```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
}
```

L'URL pré-signée expire après 10 minutes.

**2. Télécharger le fichier vers l'URL pré-signée**

Téléchargez votre logo directement sur le `upload_url` renvoyé en utilisant une requête HTTP PUT avec le contenu du fichier comme corps.

**3. Confirmer le téléchargement**

```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"
}
```

Après confirmation, le nouveau logo apparaît sur toutes les surfaces de marque.

> [!WARNING]
>
> Les points de terminaison d'écriture (`PUT /v1/settings/branding`, pré-signature de logo et confirmation de logo) renvoient HTTP 402 si votre plan n'inclut pas le droit de marque blanche. Voir [facturation](https://docs.truthlocks.com/fr/billing/overview.md) pour les détails du plan.

## Où apparaît la marque

Votre marque personnalisée est appliquée sur plusieurs surfaces :

> [card] Pages de vérification
>
> Les pages de preuve publiques affichent votre logo et les couleurs de votre marque.

> [card] E-mails transactionnels
>
> Emails envoyés en votre nom (par exemple, livraisons d'identifiants, invitations d'équipe)
> inclure votre logo.

> [card] Paquets de preuves
>
> Les bundles de preuves téléchargés font référence à votre nom de marque et à l'identité de l'émetteur.

> [card] Cartes d'identité
>
> La carte d'identification présentée aux destinataires utilise votre couleur principale et votre logo.

## Autorisations

La mise à jour des paramètres de marque nécessite la permission `branding.write`, qui est accordée par défaut aux rôles **Administrateur de locataire** et **Administrateur d'organisation**. Tout utilisateur authentifié avec `settings.read` peut consulter les paramètres de marque.

## Lié

> [card] [Facturation](https://docs.truthlocks.com/billing/overview.md)
>
> Planifiez les niveaux et l'add-on White-Label.

> [card] [Livraison B2B2C](https://docs.truthlocks.com/guides/b2b2c.md)
>
> Comment les identifiants de marque sont livrés aux consommateurs.

> [card] [Domaines personnalisés](https://docs.truthlocks.com/guides/custom-domains.md)
>
> Hébergez le portail de vérification et la console depuis votre propre domaine.


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