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

# Domínio personalizado para verificação KYC: DNS

> Sirva o fluxo de verificação da Didit no seu subdomínio, não em verify.didit.me: adicione o domínio, crie dois registros DNS e confirme a posse.

Disponibilize o fluxo de verificação a partir do seu próprio subdomínio: `verify.yourbrand.com` em vez de `verify.didit.me`. Os usuários permanecem no seu domínio durante toda a jornada, o que remove a última referência visível à Didit em um fluxo de [marca branca](https://docs.didit.me/pt-br/console/white-label.md).

> [!NOTE]
>
> O domínio personalizado faz parte da Marca própria, nos planos **Scale** e **Enterprise**. Você também precisa de **acesso de escrita à Personalização**: membros com acesso somente leitura veem a seção desativada.

> [!NOTE]
>
> Quando sua organização deixa o plano Scale ou Enterprise, incluindo um teste do Scale que termina sem um plano pago, o domínio personalizado é removido e os novos links de verificação voltam a usar o domínio da Didit. Um domínio personalizado conectado antes de 1º de novembro de 2026 permanece em qualquer plano; se você o excluir, adicionar um domínio personalizado novamente exige o Scale ou o Enterprise.

> [!NOTE]
>
> Domínios personalizados estão disponíveis **somente em aplicações de produção**. Uma aplicação de [sandbox](https://docs.didit.me/pt-br/integration/sandbox-testing.md) não pode adicionar um, e as sessões de sandbox sempre são executadas no domínio padrão da página de verificação hospedada. Mude para a sua aplicação de produção no Business Console para configurar seu domínio.

***

## Requisitos

| Requisito | Detalhe |
| - | - |
| **Aplicação de produção** | O domínio pertence a uma aplicação de produção. Aplicações de sandbox não podem configurar um domínio personalizado. |
| **Somente subdomínio** | Use `verify.yourbrand.com`. Domínios raiz como `yourbrand.com` são rejeitados, assim como o prefixo `www.`. |
| **Ainda não utilizado** | O subdomínio não pode apontar para um site ou aplicação que você já tenha. |
| **Acesso ao DNS** | Você precisa criar dois registros no seu provedor de DNS. |

***

## Como funciona

Você informa seu subdomínio no Business Console. Em seguida, a Didit gera dois registros DNS para você adicionar no seu provedor:

| Registro | Finalidade |
| - | - |
| **CNAME de verificação** | Comprova que você é o proprietário do domínio, o que permite emitir o certificado SSL. |
| **CNAME do CloudFront** | Aponta seu subdomínio para a interface de verificação. |

Os dois registros são obrigatórios. Assim que eles forem resolvidos, você verifica a propriedade pelo console e o fluxo passa a ser servido a partir do seu domínio.

***

## Configure seu domínio

**1. Adicione o domínio**

Acesse **Customization > Domain**, informe seu subdomínio (por exemplo, `verify.yourbrand.com`) e clique em **Add Domain**.

O console gera seus registros DNS. Isso leva alguns segundos.

**2. Copie os dois registros**

O console mostra um cartão para cada registro: **Verification CNAME** e **CloudFront CNAME**. Cada cartão fornece dois valores:

| Campo do cartão | Onde ele vai no seu provedor de DNS |
| - | - |
| **Nome do host** | O **nome** do registro (host) |
| **Dados/URL** | O **valor** do registro (destino) |

> [!WARNING]
>
> Não inverta **Nome do host** e **Dados/URL** ao colá-los no seu provedor de DNS, e use o botão de copiar para cada valor. Os valores de verificação são longos e fáceis de digitar errado.

**3. Adicione os dois registros no seu provedor de DNS**

Crie os dois registros como `CNAME`. Adicionar apenas o registro do CloudFront é o motivo mais comum para que a verificação falhe posteriormente.

Defina o TTL como `300` para que qualquer correção feita depois se propague em minutos, e não em horas.

**4. Verifique a propriedade**

De volta ao console, clique em **Verify domain**. Em caso de sucesso, o painel muda para **Domain verified** e o botão desaparece.

Se falhar, o console mostra uma caixa **Verification failed** com o motivo específico. Leia-a antes de alterar qualquer coisa: ela indica o registro que está ausente ou incorreto.

> [!NOTE]
>
> A propagação do DNS costuma levar minutos, mas pode levar até **24–48 horas**. Se o console informar **DNS changes detected**, seus registros estão corretos e a propagação ainda está em andamento: nenhuma ação é necessária.

***

## Altere ou remova seu domínio

Para mover o fluxo para outro subdomínio, informe o novo e clique em **Atualizar domínio**. A Didit emite um novo par de registros, então você precisa adicioná-los ao seu provedor de DNS e verificar novamente.

Para voltar a `verify.didit.me`, limpe o campo e clique em **Remover domínio**.

> [!NOTE]
>
> Enquanto houver um domínio personalizado configurado, você não pode reativar a tela de login da Didit. Remova o domínio primeiro.

***

## Solução de problemas

> [accordion] Erro 500 ou uma mensagem sobre outra distribuição do CloudFront
>
> Seu subdomínio tem um registro `A` em conflito com o CNAME, e um host não pode ter os dois. Exclua o registro `A` e mantenha apenas o CNAME.
>
> Se não houver registro `A`, o CNAME do CloudFront aponta para o destino errado. Compare-o caractere por caractere com o valor de **Data/URL** no console.

> [accordion] A verificação nunca é concluída
>
> Confira se **os dois** registros existem no seu provedor. Adicionar apenas o registro do CloudFront é a causa mais comum, porque o fluxo parece carregar enquanto o certificado nunca é emitido.
>
> A caixa **Verification failed** no console indica qual registro está faltando ou incorreto.

> [accordion] O certificado nunca é emitido (Cloudflare)
>
> Configure os dois registros como **DNS only**: nuvem cinza, proxy desativado. O proxy da nuvem laranja intercepta a requisição e impede a emissão do certificado.
>
> Provedores sem a opção de proxy, como o cPanel, não são afetados.

> [accordion] O nome do registro fica duplicado
>
> Alguns provedores acrescentam sua zona automaticamente, transformando `verify.yourbrand.com` em `verify.yourbrand.com.yourbrand.com`.
>
> Nesses provedores, informe o nome **relativo** em vez do nome completo exibido no console: `verify` em vez de `verify.yourbrand.com`, e `_abc123.verify` em vez de `_abc123.verify.yourbrand.com`. Depois, abra novamente o registro salvo e confira se o nome completo armazenado corresponde exatamente ao **Hostname** do console.

> [accordion] Uma correção está levando horas para ser aplicada
>
> Seus registros ficam em cache durante o tempo definido no TTL. Reduza o TTL para `300` e aguarde o valor anterior expirar antes de testar novamente.

***

## Próximos passos

* **Adapte o restante da interface à sua marca**: cores, logotipo e tipografia ficam em [Personalização](https://docs.didit.me/pt-br/console/white-label.md).
* **Ative seu estilo em cada fluxo**: a identidade visual só se aplica aos fluxos com **Incluir estilo personalizado** ativado. Consulte [Marca própria](https://docs.didit.me/pt-br/console/white-label.md#ative-o-estilo-personalizado-no-seu-fluxo).
* **Revise suas obrigações de divulgação**: um domínio personalizado oculta a marca da Didit, mas não o papel da Didit. Consulte [responsabilidades de conformidade](https://docs.didit.me/pt-br/console/white-label.md#responsabilidades-de-conformidade-em-fluxos-com-marca-própria).


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