O modo de instalação certo, com propriedade clara e um caminho prático de configuração.
1. Escolha para quem é o servidor
| Seu plano | Escolha |
|---|---|
| Aceite pagamentos para seu próprio negócio, com vários projetos ou lojas se precisar. | Comerciante |
| Hospede outros negócios, dê a eles suas próprias contas e cobre suas próprias taxas de processamento. | Operador |
Você não precisa do modo Operador apenas para gerenciar várias lojas. O modo Operador também inclui Meu negócio, para você aceitar seus próprios pagamentos na mesma instalação.
Os comerciantes hospedados têm contas, projetos, lojas e carteiras separados, mas compartilham o servidor. O operador do servidor pode acessar as chaves das carteiras hospedadas. Isso não é o mesmo que operar seu próprio VPS. Os comerciantes hospedados devem confiar no operador e manter seus próprios backups.
2. Escolha no primeiro cadastro
Siga VPS e instalação primeiro. Em uma instalação nova, abra o nome do host do seu comércio, passe pelo HTTP Basic Auth e crie a primeira conta de administrador. Selecione Comerciante ou Operador, depois escolha o idioma e o fuso horário e revise os termos e a política de privacidade.
Essa escolha é permanente. Você não pode alterá-la depois em Configurações nem por uma atualização. Um modo diferente exige uma nova instalação. Instalações criadas antes da versão 7 permanecem no modo Comerciante.
Mantenha o acesso Basic Auth separado da senha da sua conta e habilite a autenticação de dois fatores. Se precisar apenas das próprias lojas, Comerciante é a opção mais simples.
3. Configure seu próprio negócio
No modo Comerciante, comece no console do comerciante. No modo Operador, clique em Meu negócio para abrir seu próprio console do comerciante em uma nova aba.
Crie um projeto, faça backup das carteiras, adicione uma loja e selecione os métodos de pagamento aceitos. Um novo projeto não cria uma loja automaticamente. Conclua a configuração, habilite o projeto/a loja e teste um pagamento pequeno.
Crie seu primeiro projeto, loja e fatura →
O negócio próprio do operador não tem taxa interna do operador. As cobranças normais da instalação do Wholly Crypto continuam aplicáveis aos pagamentos dos clientes dele.
4. Conclua a configuração do painel do operador
Somente modo Operador: escolha um quarto nome de host, como operator.example.com, e credenciais Basic Auth separadas no assistente. Aponte seu DNS para o VPS, conclua a validação e ative HTTPS. Mantenha as portas 80/443 abertas durante a configuração. Abra o endereço de Operador validado, não o console do comerciante.
O operador mantém as conexões de redes, as taxas, os domínios e as atualizações de software compartilhados. Os comerciantes hospedados gerenciam as configurações do próprio negócio, não a configuração global do servidor. Confira a prontidão do scanner e os provedores de reserva independentes antes de convidá-los.
Abra Carteiras → Criar carteiras de recebimento. Estas são as carteiras do operador para recargas de crédito de comerciantes, não para vendas a clientes. Faça backup das duas frases de recuperação independentes de Bitcoin e Ethereum. Atualmente as recargas aceitam BTC, ETH e USDC/USDT do Ethereum.
Revise as confirmações de recebimento e os métodos de recarga aceitos. Os envios de fundos são opcionais; transferências de tokens Ethereum precisam de ETH para gas. Guia de envio de fundos →
5. Adicione e convide um comerciante
Abra Comerciantes → Adicionar comerciante. Informe o nome do negócio, o email do administrador, sua taxa de processamento e a moeda do crédito pré-pago. Essa moeda de crédito é fixa para a conta. Defina Crédito inicial gratuito com qualquer valor permitido, incluindo 0.
Enviar convite por email vem marcado por padrão. Configure primeiro seu provedor SMTP em Configurações → Email de convite com TLS ou STARTTLS. O teste de conexão não envia email. Como alternativa, desmarque o email e compartilhe o link privado por conta própria.
O convite permite ao comerciante escolher uma senha e reconhecer que o operador pode acessar suas carteiras. Dura 48 horas e funciona uma única vez. Compartilhe o Basic Auth do comerciante separadamente; nunca compartilhe suas credenciais de operador. Depois, o comerciante cria seus projetos e lojas.
Se o envio falhar, a conta e o crédito inicial continuam salvos. Copie o link ou use Gerenciar → Contas de usuário → Enviar novo link por email. Não crie o comerciante novamente para tentar de novo. A aceitação SMTP não garante a entrega na caixa de entrada.
6. Mantenha separados os dois saldos de crédito
| Saldo | O que paga |
|---|---|
| Crédito pré-pago do comerciante hospedado | As taxas que você define para esse comerciante. As recargas dele vão para suas carteiras de recebimento. |
| Crédito da instalação do operador | Suas cobranças de processamento do Wholly Crypto. Clique no saldo do cabeçalho de Operador para recarregar. |
Por exemplo, uma taxa do operador de 3% em uma fatura de 100 EUR usa 3 EUR de crédito do comerciante quando a moeda de crédito dele é EUR. Os pagamentos dos clientes não são divididos on-chain para cobrar essa taxa. A cobrança da sua instalação é contabilizada separadamente.
Dar crédito inicial gratuito a um comerciante não recarrega seu saldo de operador. Mantenha fundos nos dois saldos. Use Finanças para revisar as taxas ganhas e os custos; depósitos pré-pagos não são o mesmo que receita obtida.
Antes de abrir o serviço, teste um convite, uma recarga de crédito, uma fatura de cliente e sua integração IPN/webhook. Proteja o acesso de administradores e mantenha backups privados do servidor e das carteiras fora do VPS. Backup e restauração →