> ## Documentation Index > Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt > Use this file to discover all available pages before exploring further. # Usar seu próprio domínio nas páginas hospedadas > Cadastre um subdomínio, aponte os registros DNS e sirva checkout, confirmação, faturas e portal do cliente no seu endereço, com certificado emitido automaticamente. Por padrão, as páginas hospedadas da Chargefy abrem em endereços da Chargefy: `pay.chargefy.io` para o checkout e a confirmação da compra, e `billing.chargefy.io` para a fatura hospedada e o portal do cliente. Com um domínio próprio, como `pagamentos.meusite.com`, essas páginas passam a abrir no seu endereço, com a sua marca e com certificado de segurança emitido automaticamente. O domínio muda apenas o endereço e a apresentação. A organização continua sendo a vendedora — nome, CPF/CNPJ e descritor no extrato do comprador não mudam — e taxas, repasses e permissões seguem iguais. Entre no Dashboard, escolha a organização e abra **Configurações → Marca → Domínio próprio**. ## Quais páginas usam o domínio Um domínio pronto e ativo vale para todas as páginas hospedadas da organização. As URLs devolvidas pela API e pelo Dashboard já vêm com ele: a `url` da Checkout Session e do Payment Link, o `hosted_invoice_url` da fatura, a `url` da sessão do portal e o link público do portal. | Página | Endereço padrão | Com domínio próprio pronto e ativo | | ------------------------ | --------------------------------------- | --------------------------------------------- | | Checkout e Payment Links | `https://pay.chargefy.io/session/…` | `https://pagamentos.meusite.com/session/…` | | Confirmação da compra | `https://pay.chargefy.io/confirmation` | `https://pagamentos.meusite.com/confirmation` | | Fatura hospedada | `https://billing.chargefy.io/invoice/…` | `https://pagamentos.meusite.com/invoice/…` | | Portal do cliente | `https://billing.chargefy.io/portal/…` | `https://pagamentos.meusite.com/portal/…` | Os endereços padrão continuam funcionando mesmo com o domínio pronto: um link antigo em `pay.chargefy.io` abre normalmente. ## Antes de começar * **Um subdomínio que você controla**, como `pagamentos.meusite.com` ou `pagar.meusite.com.br`. O domínio raiz (`meusite.com`) não é aceito, porque o apontamento substituiria o seu site principal. Use letras minúsculas. * **Acesso ao DNS** do provedor onde o domínio está registrado, para criar dois registros. * **Permissão para editar a marca** da organização no Dashboard. Cada marca aceita **um** domínio. Um mesmo hostname não pode ser cadastrado em duas organizações. ## Cadastrar o domínio Em **Configurações → Marca → Domínio próprio**, clique em **Adicionar domínio** e informe o endereço (`pagamentos.meusite.com`). Você pode deixar **Usar domínio próprio** ligado desde já: o domínio só entra em uso quando estiver pronto. O painel mostra os registros exatos para o seu domínio. Crie os dois no seu provedor de DNS. No `CNAME`, use **somente DNS, sem proxy**. | Tipo | Nome | Valor | | ------- | -------------------------------------------- | ------------------------------- | | `CNAME` | `pagamentos.meusite.com` | `checkout.chargefy.io` | | `TXT` | `_chargefy-challenge.pagamentos.meusite.com` | `chargefy-verification=` | O `CNAME` leva o tráfego até a Chargefy. O `TXT` prova que o domínio é seu; o `` é gerado no cadastro e aparece no painel. A Chargefy confere os registros automaticamente a cada minuto. Assim que o DNS propaga — de minutos a algumas horas, dependendo do provedor — o estado muda de **Aguardando DNS** para **Emitindo certificado**. Use **Verificar configuração** para conferir na hora. O certificado de segurança é emitido automaticamente depois que o DNS é confirmado. Quando ele fica ativo, o estado muda para **Pronto**. Com o domínio **Pronto** e **Usar domínio próprio** ligado, abra um Payment Link ou uma fatura criados a partir daí: a URL já usa o seu endereço, e a página abre com a marca da organização. ## Estados do domínio | Estado | O que significa | O que fazer | | ------------------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | **Aguardando DNS** | O `CNAME` ou o `TXT` ainda não foram encontrados com os valores esperados. | Confira os registros no provedor e aguarde a propagação. A verificação é automática. | | **Emitindo certificado** | DNS confirmado; o certificado de segurança está sendo emitido. | Nada. Costuma levar poucos minutos. | | **Pronto** | DNS e certificado ativos. O domínio já pode servir as páginas. | Deixe **Usar domínio próprio** ligado para que os links novos usem o seu endereço. | | **Atenção necessária** | A configuração deixou de ser válida: registro alterado ou removido, certificado vencido ou hostname indisponível. | Restaure os registros e clique em **Verificar configuração**. Se persistir, remova e cadastre de novo. | O painel também mostra cada registro como **Pendente** ou **Verificado**, a situação do certificado e o horário da última verificação. ## Ligar, desligar e remover * **Usar domínio próprio** liga e desliga o uso do domínio sem apagar nada. Desligado, os links novos voltam aos endereços padrão e o domínio permanece cadastrado, com DNS e certificado preservados. Ligado antes de o domínio estar pronto, ele passa a valer automaticamente quando ficar **Pronto**. * **Remover domínio** apaga o cadastro e o certificado. O hostname deixa de responder, e os links que já foram enviados com esse endereço deixam de abrir — o painel avisa antes de confirmar. Os mesmos links continuam disponíveis nos endereços padrão da Chargefy. Para usar o domínio de novo, cadastre-o novamente: um novo `TXT` de verificação é gerado. ## O que acontece com os links * **Links já enviados continuam valendo** enquanto o domínio estiver cadastrado e o DNS apontar para a Chargefy. Sessão, link e fatura são os mesmos; só o endereço muda. * **Domínio pendente ou desligado:** os links novos usam os endereços padrão (`pay.chargefy.io` e `billing.chargefy.io`). Um link com o seu domínio aberto nesse estado é encaminhado para o endereço padrão da mesma página. * **Domínio removido:** links antigos com aquele hostname deixam de abrir. Os links novos voltam aos endereços padrão. * **Marca alterada:** cores, fonte, tema e logos valem na hora em todas as páginas, inclusive nas que já abrem no seu domínio. ## Falhas e recuperação | Sintoma | Causa provável | Resolução | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | **Aguardando DNS** por mais de algumas horas | `CNAME` com proxy ligado, apontando para outro destino, ou `TXT` ausente ou com valor diferente. | Corrija os registros exatamente como o painel mostra, desligue o proxy e clique em **Verificar configuração**. | | **Atenção necessária** depois de já ter ficado **Pronto** | Um registro foi alterado ou removido no provedor, e o certificado venceu sem conseguir renovar. | Restaure os registros e verifique de novo. A emissão do certificado reinicia sozinha. | | "Este domínio já está cadastrado" | O hostname já pertence a outra marca — outra organização ou uma plataforma. | Use outro subdomínio, ou remova o domínio de onde ele está antes de cadastrar aqui. | | "Informe um domínio válido" | Domínio raiz, letras maiúsculas, caracteres inválidos ou subdomínio de `chargefy.io`. | Informe um subdomínio seu em minúsculas, como `pagamentos.meusite.com`. | | "Não foi possível concluir a operação agora" | A verificação ficou temporariamente indisponível. | Nada a fazer: a Chargefy tenta de novo automaticamente. Você também pode verificar mais tarde. | | "Página não encontrada" ao abrir um link no seu domínio | O link é de outra marca (por exemplo, uma venda apresentada com a marca de uma plataforma) ou o domínio foi removido. | Abra o link no endereço em que ele foi enviado, ou no endereço padrão da Chargefy. | ## Chargefy for Platforms Esta seção só se aplica a contas com o produto **Chargefy for Platforms** habilitado. Nesse produto, uma plataforma opera pagamentos para **suas organizações filhas**. A plataforma tem a própria marca e o próprio domínio, cadastrados em **Configurações da plataforma → Marca** com os mesmos passos desta página. O domínio da plataforma serve as páginas de ativação e de revisão cadastral das organizações filhas — que por padrão abrem em `hosted.chargefy.io` — e as vendas que a plataforma escolher apresentar com a própria marca. Cada hostname só serve as páginas da própria marca: um link de uma venda apresentada com a marca da organização filha não abre no domínio da plataforma, e vice-versa. Veja [Marca e domínio próprio da plataforma](/platforms/branding-and-custom-domain). ## Próximos passos Cores, fonte, tema, cantos, logo principal e marca do rodapé. Publique uma URL reutilizável que já usa o seu domínio. O link público e as sessões do portal também abrem no seu endereço. `hosted_invoice_url` usa o seu domínio quando ele está pronto.