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

# Marca personalizada

> Personalice sus páginas de verificación, correos electrónicos y paquetes de prueba con la marca de su organización.

Los inquilinos empresariales pueden aplicar una marca personalizada a las páginas de verificación, los correos electrónicos transaccionales y los paquetes de prueba. Cargue su logotipo, configure los colores de la marca y obtenga una vista previa de los cambios antes de guardar.

> [!NOTE]
>
> La marca personalizada requiere un plan Business o Enterprise, o el complemento White-Label.
> complemento. Consulte [facturación](https://docs.truthlocks.com/es/billing/overview.md) para obtener detalles del plan.

## Configuración de marca

Navegue a **Configuración > Marca** en la consola para configurar su marca.

### Logotipo

Cargue el logotipo de su organización. El logotipo aparece en las páginas de verificación, los correos electrónicos transaccionales y las tarjetas de credenciales.

| Requisito | Valor |
| :- | :- |
| Formatos | PNG, JPEG, SVG, WebP |
| Tamaño máximo de archivo | 2 MB |

### Nombre de la marca

Establezca el nombre que se muestra en las páginas de verificación y las tarjetas de credenciales. Este suele ser el nombre de su organización o producto.

### Colores

Configure dos colores que definan la apariencia de su marca:

| Color | Dónde aparece | Predeterminado |
| :- | :- | :- |
| **Primario** | Encabezados de tarjetas, elementos principales de la interfaz de usuario | `#06b6d4` |
| **Acento** | Insignias, etiquetas, resaltados secundarios | `#0891b2` |

Utilice el selector de color o introduzca un valor hexadecimal directamente (por ejemplo, `#1a2b3c`).

## Vista previa en vivo

La página de marca incluye un panel de vista previa en vivo que muestra cómo aparecen su logotipo, nombre de marca y colores en una tarjeta de credencial. Los cambios se actualizan en tiempo real a medida que ajusta la configuración.

## Configuración de marca

**1. Subir su logotipo**

Haga clic en el área de carga o arrastre y suelte su archivo de logotipo. La vista previa se actualiza
inmediatamente.

**2. Establecer el nombre de su marca**

Introduzca el nombre de su organización en el campo Nombre de la marca.

**3. Elija sus colores**

Utilice los selectores de color para establecer sus colores primario y de acento, o introduzca el código hexadecimal
valores directamente.

**4. Guardar**

Haga clic en **Guardar marca** para aplicar sus cambios. Un banner de confirmación
aparece cuando se completa el guardado.

## Gestión de la marca a través de la API

Puede leer y actualizar la configuración de marca mediante programación. Todos los puntos finales de escritura requieren el derecho de Etiqueta Blanca.

### Obtener marca actual

```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 no se ha configurado ninguna marca, la respuesta devuelve los colores predeterminados (`#06b6d4` principal, `#0891b2` de acento) y ningún logotipo.

### Actualizar marca

Establezca el nombre y los colores de su marca en una sola solicitud:

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

Los colores deben ser valores hexadecimales válidos en formato `#RRGGBB`. Los campos omitidos conservan sus valores actuales.

### Subir un logotipo

Las cargas de logotipos utilizan un flujo de URL prefirmado de tres pasos:

**1. Solicitar una URL de carga prefirmada**

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

La URL prefirmada expira después de 10 minutos.

**2. Subir el archivo a la URL prefirmada**

Suba su logotipo directamente al `upload_url` devuelto utilizando una solicitud HTTP PUT con el contenido del archivo como cuerpo.

**3. Confirmar la carga**

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

Después de la confirmación, el nuevo logotipo aparece en todas las superficies de la marca.

> [!WARNING]
>
> Los puntos de conexión de escritura (`PUT /v1/settings/branding`, presignatura de logotipo y confirmación de logotipo) devuelven HTTP 402 si su plan no incluye el derecho de marca blanca. Consulte [facturación](https://docs.truthlocks.com/es/billing/overview.md) para obtener detalles del plan.

## Dónde aparece la marca

Su marca personalizada se aplica en varias superficies:

> [card] Páginas de verificación
>
> Las páginas de prueba públicas muestran tu logotipo y colores de marca.

> [card] Correos electrónicos transaccionales
>
> Correos electrónicos enviados en su nombre (por ejemplo, entregas de credenciales, invitaciones a equipos)
> incluya su logotipo.

> [card] Paquetes de prueba
>
> Los paquetes de prueba descargados hacen referencia a su marca e identidad de emisor.

> [card] Tarjetas de credenciales
>
> La tarjeta de credenciales que se muestra a los destinatarios utiliza su color principal y logotipo.

## Permisos

La actualización de la configuración de marca requiere el permiso `branding.write`, que se otorga a los roles de **Administrador de inquilinos** y **Administrador de la organización** de forma predeterminada. Cualquier usuario autenticado con `settings.read` puede ver la configuración de marca.

## Relacionado

> [card] [Facturación](https://docs.truthlocks.com/billing/overview.md)
>
> Planifica los niveles y el complemento de marca blanca.

> [card] [Entrega B2B2C](https://docs.truthlocks.com/guides/b2b2c.md)
>
> Cómo se entregan las credenciales de marca a los consumidores.

> [card] [Dominios personalizados](https://docs.truthlocks.com/guides/custom-domains.md)
>
> Sirva el portal de verificación y la consola desde su propio dominio.


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