La modalità di installazione giusta, con proprietà chiara e un percorso di configurazione pratico.
1. Scegli a chi serve il server
| Il tuo piano | Scegli |
|---|---|
| Accettare pagamenti per la tua attività, con più progetti o negozi se necessario. | Commerciante |
| Ospitare altre imprese, dare loro account propri e applicare le tue commissioni di elaborazione. | Operatore |
Non ti serve la modalità Operatore solo per gestire più negozi. La modalità Operatore include anche La mia attività, così puoi accettare i tuoi pagamenti sulla stessa installazione.
I commercianti ospitati hanno account, progetti, negozi e wallet separati, ma condividono il server. L'operatore del server può accedere alle chiavi dei wallet ospitati. Non equivale a gestire un VPS proprio. I commercianti ospitati devono fidarsi dell'operatore e conservare i propri backup.
2. Fai la scelta alla prima registrazione
Segui VPS e installazione per prima cosa. Su una nuova installazione, apri l'hostname merchant, supera HTTP Basic Auth e crea il primo account amministratore. Seleziona Commerciante oppure Operatore, poi scegli lingua e fuso orario ed esamina condizioni e informativa sulla privacy.
Questa scelta è permanente. Non puoi cambiare in seguito nelle Impostazioni o con un aggiornamento. Una modalità diversa richiede una nuova installazione. Le installazioni create prima della versione 7 restano in modalità Commerciante.
Tieni l'accesso Basic Auth separato dalla password dell'account e abilita l'autenticazione a due fattori. Se ti servono solo i tuoi negozi, Commerciante è la scelta più semplice.
3. Configura la tua attività
In modalità Commerciante, inizia dalla console commerciante. In modalità Operatore, fai clic su La mia attività per aprire la tua console commerciante in una nuova scheda.
Crea un progetto, esegui il backup dei suoi wallet, aggiungi un negozio e seleziona i metodi di pagamento accettati. Un nuovo progetto non crea un negozio automaticamente. Completa la configurazione, abilita progetto/negozio e prova un piccolo pagamento.
Crea il tuo primo progetto, negozio e fattura →
L'attività dell'operatore non ha commissioni interne dell'operatore. Le normali commissioni dell'installazione Wholly Crypto si applicano comunque ai suoi pagamenti dei clienti.
4. Completa la configurazione del pannello Operatore
Solo modalità Operatore: scegli un quarto hostname, per esempio operator.example.com, e credenziali Basic Auth separate nella procedura guidata. Punta il DNS al VPS, completa la convalida e attiva HTTPS. Mantieni aperte le porte 80/443 per la configurazione. Apri l'indirizzo Operatore convalidato, non la console commerciante.
L'operatore mantiene connessioni blockchain condivise, tassi, domini e aggiornamenti software. I commercianti ospitati gestiscono le proprie impostazioni aziendali, non la configurazione globale del server. Controlla l'operatività dello scanner e i provider di riserva indipendenti prima di invitarli.
Apri Wallet → Crea wallet di ricezione. Sono i wallet dell'operatore per le ricariche di crediti dei commercianti, non per le vendite ai clienti. Esegui il backup di entrambe le frasi di recupero indipendenti Bitcoin ed Ethereum. Le ricariche supportano attualmente BTC, ETH e USDC/USDT su Ethereum.
Controlla le conferme di ricezione e i metodi di ricarica accettati. Gli sweep sono facoltativi; i trasferimenti di token Ethereum richiedono ETH per il gas. Guida Sweep →
5. Aggiungi e invita un commerciante
Apri Commercianti → Aggiungi commerciante. Inserisci nome dell'attività, email dell'amministratore, commissione di elaborazione e valuta dei crediti prepagati. Questa valuta dei crediti è fissa per l'account. Imposta Credito iniziale gratuito su qualsiasi importo consentito, incluso 0.
Invia invito via email è selezionato per impostazione predefinita. Configura il tuo provider SMTP in Impostazioni → Email di invito prima con TLS o STARTTLS. Il test di connessione non invia email. In alternativa, deseleziona l'email e condividi personalmente il link privato.
L'invito permette al commerciante di scegliere una password e prendere atto dell'accesso dell'operatore ai wallet. Dura 48 ore e funziona una sola volta. Condividi Basic Auth commerciante separatamente; non condividere mai le tue credenziali operatore. Il commerciante crea poi progetti e negozi propri.
Se l'invio fallisce, account e credito iniziale restano salvati. Copia il link o usa Gestisci → Account utente → Invia nuovo link via email. Non ricreare il commerciante per riprovare. L'accettazione SMTP non garantisce la consegna nella casella di posta.
6. Tieni separati i due saldi crediti
| Saldo | Cosa paga |
|---|---|
| Credito prepagato del commerciante ospitato | Le commissioni che imposti per quel commerciante. Le sue ricariche arrivano ai tuoi wallet di ricezione. |
| Credito dell'installazione Operatore | Le tue commissioni di elaborazione Wholly Crypto. Fai clic sul saldo nell'intestazione Operatore per ricaricare. |
Per esempio, una commissione operatore del 3% su una fattura da 100 EUR usa 3 EUR di credito del commerciante quando la sua valuta di credito è EUR. I pagamenti dei clienti non vengono divisi on-chain per riscuotere quella commissione. La commissione della tua installazione è contabilizzata separatamente.
Dare credito iniziale gratuito a un commerciante non ricarica il tuo saldo operatore. Mantieni finanziati entrambi i saldi. Usa Finanze per esaminare commissioni guadagnate e costi; i depositi prepagati non sono la stessa cosa dei ricavi maturati.
Prima di aprire il servizio, prova un invito, una ricarica di crediti, una fattura cliente e l'integrazione IPN/webhook. Proteggi l'accesso amministratore e conserva backup privati di server e wallet fuori dal VPS. Backup e ripristino →