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

# Domínios próprios

> Como conectar um domínio do zero pela API

Com estes endpoints dá para conectar um domínio próprio sem abrir o painel. O fluxo completo:

**1. Adicione o domínio**

`POST /api/v1/domain` com `{ "domain": "loja.seudominio.com.br" }`. A resposta já traz `dns_records`.

**2. Crie os registros DNS**

No provedor do domínio, crie **todos** os registros de `dns_records`: o `CNAME` que aponta para a loja e o `TXT` de verificação. `name` é o nome completo do registro; `host` é o que digitar em painéis que pedem só a parte antes do domínio (`@` é a raiz).

**3. Verifique**

`POST /api/v1/domain/{id}/verify`. Enquanto o DNS propaga, o status segue `PENDING`; repita depois de alguns minutos. A plataforma também confere sozinha a cada minuto.

**4. Defina como principal**

Com o status `VERIFIED`, `PATCH /api/v1/domain/{id}/primary` faz a loja responder nesse domínio.

> [!WARNING]
>
> Domínio que não for verificado em 24 horas é removido automaticamente (`verification_expires_at`). Se isso acontecer, adicione de novo: o valor do `TXT` muda.

Cada loja pode ter até 5 domínios. O primeiro domínio adicionado já nasce como principal, mas só passa a valer depois de verificado.


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