Skip to main content
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.

Abrir a configuração de domínio

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

1

Informe o subdomí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.
2

Crie os registros DNS

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.O CNAME leva o tráfego até a Chargefy. O TXT prova que o domínio é seu; o <token> é gerado no cadastro e aparece no painel.
3

Aguarde a verificação

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.
4

Aguarde o certificado

O certificado de segurança é emitido automaticamente depois que o DNS é confirmado. Quando ele fica ativo, o estado muda para Pronto.
5

Ative e teste

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

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.
  • 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

​
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.

​
Próximos passos

Configurar a marca e o checkout

Cores, fonte, tema, cantos, logo principal e marca do rodapé.

Criar um Link de pagamento

Publique uma URL reutilizável que já usa o seu domínio.

Portal do cliente

O link público e as sessões do portal também abrem no seu endereço.

Faturas

hosted_invoice_url usa o seu domínio quando ele está pronto.