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

> Personalize suas páginas de verificação, e-mails e pacotes de prova com a marca da sua organização.

Locatários empresariais podem aplicar branding personalizado a páginas de verificação, e-mails transacionais e pacotes de prova. Carregue seu logotipo, defina as cores da marca e visualize as alterações antes de salvar.

> [!NOTE]
>
> A marca personalizada requer um plano Business ou Enterprise, ou o White-Label
> complemento. Consulte [faturamento](https://docs.truthlocks.com/pt/billing/overview.md) para detalhes do plano.

## Configurações de marca

Navegue até **Configurações > Branding** no console para configurar sua marca.

### Logotipo

Carregue o logotipo da sua organização. O logotipo aparece nas páginas de verificação, e-mails transacionais e cartões de credenciais.

| Requisito | Valor |
| :- | :- |
| Formatos | PNG, JPEG, SVG, WebP |
| Tamanho máximo do arquivo | 2 MB |

### Nome da marca

Defina o nome exibido nas páginas de verificação e cartões de credenciais. Geralmente, é o nome da sua organização ou produto.

### Cores

Configure duas cores que definem a aparência da sua marca:

| Cor | Onde aparece | Padrão |
| :- | :- | :- |
| **Primário** | Cabeçalhos de cartão, elementos primários da UI | `#06b6d4` |
| **Destaque** | Emblemas, tags, destaques secundários | `#0891b2` |

Use o seletor de cores ou insira um valor hexadecimal diretamente (por exemplo, `#1a2b3c`).

## Pré-visualização ao vivo

A página de branding inclui um painel de visualização ao vivo que mostra como seu logotipo, nome da marca e cores aparecem em um cartão de credencial. As alterações são atualizadas em tempo real conforme você ajusta as configurações.

## Configurando a marca

**1. Carregar seu logotipo**

Clique na área de upload ou arraste e solte seu arquivo de logotipo. A pré-visualização é atualizada
imediatamente.

**2. Definir o nome da sua marca**

Insira o nome da sua organização no campo Nome da Marca.

**3. Escolha suas cores**

Use os seletores de cores para definir suas cores primárias e de destaque, ou insira o código hexadecimal
valores diretamente.

**4. Salvar**

Clique em **Salvar Branding** para aplicar suas alterações. Um banner de confirmação
aparece quando a gravação é concluída.

## Gerenciando a marca via API

Você pode ler e atualizar as configurações de marca programaticamente. Todos os endpoints de gravação exigem o direito de White-Label.

### Obter marca atual

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

Se nenhuma marca tiver sido configurada, a resposta retorna as cores padrão (`#06b6d4` primária, `#0891b2` de destaque) e nenhum logotipo.

### Atualizar branding

Defina o nome e as cores da sua marca em uma única requisição:

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

As cores devem ser valores hexadecimais válidos no formato `#RRGGBB`. Campos omitidos mantêm seus valores atuais.

### Carregar um logotipo

Os uploads de logotipo usam um fluxo de URL pré-assinado de três etapas:

**1. Solicitar um URL de upload pré-assinado**

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

O URL pré-assinado expira após 10 minutos.

**2. Carregar o arquivo para o URL pré-assinado**

Faça o upload do seu logotipo diretamente para o `upload_url` retornado usando uma solicitação HTTP PUT com o conteúdo do arquivo como corpo.

**3. Confirmar o upload**

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

Após a confirmação, o novo logotipo aparece em todas as superfícies de branding.

> [!WARNING]
>
> Endpoints de escrita (`PUT /v1/settings/branding`, pré-assinatura de logotipo e confirmação de logotipo) retornam HTTP 402 se seu plano não incluir o direito de White-Label. Consulte [faturamento](https://docs.truthlocks.com/pt/billing/overview.md) para detalhes do plano.

## Onde a marca aparece

Sua marca personalizada é aplicada em várias superfícies:

> [card] Páginas de verificação
>
> As páginas de prova públicas exibem seu logotipo e cores da marca.

> [card] E-mails transacionais
>
> E-mails enviados em seu nome (por exemplo, entrega de credenciais, convites de equipe)
> inclua seu logotipo.

> [card] Pacotes de prova
>
> Os pacotes de prova baixados referenciam o nome da sua marca e a identidade do emissor.

> [card] Cartões de credenciais
>
> O cartão de credencial mostrado aos destinatários usa sua cor primária e logotipo.

## Permissões

A atualização das configurações de branding requer a permissão `branding.write`, que é concedida às funções de **Administrador de Inquilino** e **Administrador de Organização** por padrão. Qualquer usuário autenticado com `settings.read` pode visualizar as configurações de branding.

## Relacionado

> [card] [Faturamento](https://docs.truthlocks.com/billing/overview.md)
>
> Planeje os níveis e o complemento White-Label.

> [card] [Entrega B2B2C](https://docs.truthlocks.com/guides/b2b2c.md)
>
> Como as credenciais de marca são entregues aos consumidores.

> [card] [Domínios personalizados](https://docs.truthlocks.com/guides/custom-domains.md)
>
> Sirva o portal de verificação e o console do seu próprio domínio.


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