Domínios ativos validados, links específicos por loja e um plano seguro para substituir nomes de host antigos.
1. Planeje os endereços
Cada domínio base tem três funções: Console para sua equipe, Checkout para os clientes e API pública para integrações. Os nomes padrão são merchant, pay e api; você pode escolher outros e adicionar aliases.
| Função | Primeiro domínio | Segundo domínio |
|---|---|---|
| Console | merchant.example.com | panel.example.org |
| Checkout | pay.example.com | payment.example.org |
| API pública | api.example.com | api.example.org |
Os dois domínios chegam à mesma instalação. Não criam carteiras, dados nem permissões de acesso separados. O domínio preferido de uma loja controla os links gerados; não é isolamento entre clientes.
2. Adicione um domínio ou gerencie aliases
Abra Configurações → Sistema → Domínios. Use Adicionar domínio acima de Domínios ativos para uma nova base como example.org. Use Gerenciar em uma entrada existente para adicionar aliases ou alterar endereços principais.
Por exemplo, mantenha merchant e panel como nomes de console. O primeiro nome, marcado com uma estrela, é o principal dessa função. Escolha o domínio base principal para os links padrão de todo o sistema.
Um nome base ativo não é renomeado diretamente; adicione um domínio substituto. Os rascunhos mostram Ativação pendente e ainda não estão ativos. Escolha Continuar para DNS para salvar e revisar.
3. Aponte o DNS para seu VPS
Adicione um registro A para cada novo nome de host, apontando para o IPv4 do VPS mostrado pelo painel. Adicione AAAA apenas quando esse endereço IPv6 realmente alcançar o servidor. Remova os registros desatualizados; o Wholly Crypto não edita o DNS por você.
Mantenha a entrada por TCP 80 e 443 aberta nos firewalls do servidor e do provedor. Mantenha seu acesso SSH intacto. Clique em Verificar DNS. Verifica os pares de host/função novos ou alterados no DNS autoritativo; os endereços ativos sem alterações são reutilizados.
Usa Cloudflare?
Na primeira instalação, mantenha o proxy desativado até concluir a configuração. Depois você pode usar DNS direto ou com proxy sem mudar um modo no Wholly Crypto. O Let's Encrypt permanece no VPS.
Use Full (strict) ↗. Mantenha o desafio HTTP do certificado acessível e exclua do cache e dos desafios de navegador/bots as solicitações de console, checkout e API. O Wholly Crypto também deve conseguir verificar a origem.
As verificações autoritativas ignoram os caches comuns de endereços do VPS/ISP. Os visitantes ainda podem ter DNS antigo em cache e as alterações de servidores de nomes podem demorar mais.
4. Revise e depois publique
Salvar um rascunho ou passar nas verificações de DNS não altera as rotas ativas.
Revise as adições, remoções e alterações de endereço principal e depois escolha Continuar para ativação → Validar SSL e publicar. Edições ou uma verificação de DNS com mais de dez minutos exigem outra verificação.
Nos endereços novos são verificados os desafios de certificados, HTTPS e o serviço correto. Os pares de host/função ativos sem alterações não repetem essas verificações de rede, mas a configuração completa do Nginx continua sendo validada.
Aguarde o sucesso e o retorno a Domínios ativos. Abra cada novo nome de host e confira sua função. Se falhar, leia o relatório de implantação e o estado da reversão antes de tentar novamente; não exclua o domínio que funciona para forçar a ativação.
5. Escolha domínios para cada loja
Vá para Projeto → Lojas → selecione uma loja → Dados básicos → Domínios da loja. Escolha os hosts ativos do comerciante, checkout e API dessa loja. Endereços pendentes não podem ser selecionados.
Os links gerados usam escolha da loja → loja padrão do projeto → padrão do sistema. Por exemplo, o campo da API de faturas links.checkout pode usar payment.example.org para uma loja enquanto outra mantém pay.example.com.
Configure as origens de API dos SDKs e plugins de loja separadamente; alterar uma preferência da loja não reescreve as configurações das suas integrações. As novas tentativas de IPN/webhooks assinados retidos mantêm seus links originais. Favoritos e links de clientes existentes não são reescritos.
Os aliases do console ainda exigem Basic Auth e login no aplicativo. Em Configurações → Sistema → Restrições de IP de origem, as regras se aplicam separadamente a cada nome de host. Mantenha aberto o checkout do cliente, a menos que opere deliberadamente um checkout privado.
6. Substitua endereços antigos em duas etapas
- Adicione e publique o substituto enquanto o nome de host antigo ainda funciona.
- Abra o novo endereço do console e entre. Teste o acesso ao checkout e à API pelos substitutos.
- Atualize as preferências das lojas, integrações, favoritos e links publicados. Mantenha os aliases antigos de pagamento/API enquanto clientes ou aplicativos ainda os usam.
- Pelo novo endereço do console, gerencie o domínio ou alias antigo e prepare sua remoção. Revise e publique a alteração antes de remover seu registro DNS.
O painel impede a remoção do nome de host do console que você está usando. Hosts desativados são rejeitados, não são redirecionados automaticamente. Uma alteração apenas do principal ou uma remoção ainda exigem revisão e publicação, mesmo quando não é necessária uma nova consulta de DNS.