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

# Domínio próprio

> Coloque a sua área de membros no seu endereço, como membros.suaescola.com.br, com HTTPS automático.

Por padrão, a área de membros abre no endereço da Gravity Play. Com um domínio próprio, os seus
alunos entram pelo seu endereço, e os links de acesso, de redefinição de senha e de suporte passam a
usá-lo. O endereço padrão continua funcionando.

A configuração fica no painel, em **Área de membros → Domínio próprio**.

## 1. Escolha o tipo

| Tipo                         | Exemplo                    | Registro DNS                                                                                                         |
| ---------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Subdomínio** (recomendado) | `membros.suaescola.com.br` | `CNAME` para `dominios.gravitypay.app`                                                                               |
| **Domínio raiz**             | `suaescola.com.br`         | `A` para `187.77.35.50` e `AAAA` para `2a02:4780:6e:500c::1`, mais o `www` em `CNAME` para `dominios.gravitypay.app` |

Recomendamos **subdomínio**: o CNAME acompanha qualquer mudança do nosso servidor e o seu site
principal continua onde está.

No **domínio raiz** os registros apontam para o IP do servidor. Se esse IP mudar, avisaremos, e você
vai precisar atualizar os registros. Se o seu provedor aceita CNAME no raiz (CNAME flattening, ALIAS
ou ANAME, como a Cloudflare), prefira apontar o raiz para `dominios.gravitypay.app` no lugar do `A` e
do `AAAA`. O `www` redireciona para o raiz.

Nos dois tipos há também um registro **TXT de verificação**, que prova que o domínio é seu:

| Tipo  | Nome                                                                      | Valor                                                   |
| ----- | ------------------------------------------------------------------------- | ------------------------------------------------------- |
| `TXT` | `_gravitypay.<seu domínio>` (ex.: `_gravitypay.membros.suaescola.com.br`) | `gravitypay-verify=…` (código único mostrado no painel) |

O código é gerado para a sua loja e para aquele domínio: só muda se você trocar o domínio. Sem esse
TXT a verificação não passa, e por isso ninguém consegue usar o seu domínio em outra conta. Mantenha o
registro depois de verificar.

<Note>
  Os valores exatos aparecem no painel depois de salvar o domínio, com um botão para copiar cada um.
  Use sempre os valores do painel.
</Note>

## 2. Crie os registros no seu provedor de DNS

Entre no provedor onde o domínio está (Registro.br, Cloudflare, GoDaddy, Hostinger…) e crie os
registros mostrados no painel, incluindo o TXT. Alguns provedores pedem só a parte antes do domínio no
campo **Nome** (por exemplo, `membros` em vez de `membros.suaescola.com.br`, ou
`_gravitypay.membros` no TXT).

<Warning>
  **Usa Cloudflare?** Deixe os registros como **Somente DNS** (nuvem cinza). Com o proxy ligado
  (nuvem laranja), a verificação reprova e o certificado HTTPS não é emitido.
</Warning>

Apague registros antigos do mesmo nome que apontem para outro lugar: com dois registros `A`, parte
dos alunos cairia no servidor antigo. O mesmo vale para um `AAAA` antigo.

## 3. Verifique

Clique em **Verificar**. A propagação do DNS pode levar de alguns minutos a algumas horas; se a
verificação não passar, o painel explica o motivo (registro não encontrado, apontando para outro
lugar, TXT ausente ou com valor diferente, proxy da Cloudflare ligado…). Corrija e verifique de novo.

| Status                 | O que significa                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------- |
| Aguardando verificação | O domínio foi salvo, mas ainda não foi verificado. Ele ainda não abre a área.             |
| Verificado             | O domínio aponta para a Gravity Play, o TXT confirmou que ele é seu e já abre a sua área. |
| Falhou                 | A última verificação não passou. O motivo aparece logo abaixo.                            |

Depois de verificado, o domínio entra no ar em até 1 minuto. **No primeiro acesso o certificado HTTPS
é emitido na hora** e pode levar alguns minutos. Se o navegador acusar erro de certificado, aguarde e
recarregue.

## Trocar ou remover

* **Trocar** o domínio volta o status para *Aguardando verificação* e gera um novo código TXT: crie os
  registros do novo domínio e verifique de novo.
* **Remover** faz a área voltar ao endereço padrão. Links já enviados com o domínio próprio param de
  funcionar.

## Dúvidas comuns

<AccordionGroup>
  <Accordion title="Posso usar um domínio que outra loja já cadastrou?">
    Cadastrar, qualquer conta cadastra, mas só verifica quem cria o TXT com o código da própria loja,
    ou seja, quem controla o DNS. Depois de verificado, o domínio fica preso a uma única área de
    membros. Se o domínio é seu e aparece como em uso por outra conta, procure o suporte.
  </Accordion>

  <Accordion title="Os alunos precisam entrar de novo?">
    Sim, uma vez: a sessão fica guardada por endereço, então quem entrava pelo endereço padrão faz
    login de novo no domínio próprio.
  </Accordion>

  <Accordion title="Posso usar http:// ou um caminho, como suaescola.com.br/cursos?">
    Não. Informe só o domínio. A área sempre abre em HTTPS, na raiz do domínio.
  </Accordion>
</AccordionGroup>