API e integrazioni

Come Automatizzare Cloud Server e Pagamenti con WHMCS: Guida ai Moduli

  • Tempo di lettura: 13 minuti
  • Team Hostragons
Come Automatizzare Cloud Server e Pagamenti con WHMCS: Guida ai Moduli

I moduli WHMCS riuniscono in un unico pannello flussi di lavoro specifici come la riscossione dei pagamenti, l'aggiornamento dei prezzi di rinnovo, la gestione delle operazioni dei clienti e il controllo delle risorse dei cloud server direttamente da WHMCS. Nel catalogo Hostragons trovi cinque moduli focalizzati su pagamenti e operatività, insieme a cinque integrazioni indipendenti per le infrastrutture OVHcloud, AWS Lightsail, Contabo, Microsoft Azure e Google Cloud. Questa guida mette a confronto le funzionalità dei dieci moduli, i loro limiti di copertura e gli scenari d'uso più adatti.

Quando si sceglie un modulo, non basta guardare l'elenco delle funzionalità. Bisogna considerare anche la versione di WHMCS in uso, l'account del provider, i permessi API, il sistema operativo, il modello di fatturazione e un piano di test pre-produzione. Le integrazioni qui descritte non sostituiscono la licenza WHMCS, l'account del cloud provider o l'account dell'istituto di pagamento. I costi di utilizzo, rete, licenza e imposte applicati dai provider rimangono a carico dell'utente.

Cosa semplificano i moduli WHMCS?

Il core di WHMCS gestisce il ciclo di vita di clienti, ordini, fatture e servizi. I moduli collegano questo core a un flusso di lavoro specifico. Un gateway di pagamento può trasferire la fattura a una pagina di pagamento esterna e comunicare a WHMCS il risultato verificato. Un modulo operativo può eseguire un aggiornamento massivo del credito o dei prezzi. Un modulo server, invece, può creare una macchina virtuale collegata a un ordine e offrire le funzioni di gestione consentite nell'area cliente.

Questa distinzione è fondamentale: non tutti i moduli fanno tutto. Per esempio, i moduli Paddle e Mollie si concentrano sul flusso di pagamento, il Gestore Credito Clienti sulle operazioni amministrative di credito, mentre le integrazioni cloud si focalizzano esclusivamente sulle risorse del provider specifico. Suddividere le proprie esigenze in “pagamenti”, “operazioni cliente” e “automazione server” aiuta a scegliere il prodotto giusto.

Confronto rapido dei 10 moduli WHMCS

Confronto rapido dei 10 moduli WHMCS
ModuloUtilizzo principaleAccount esterno richiestoPrezzo alla data di pubblicazione
Aggiornamento automatico delle tariffeAggiornare i prezzi di servizi ricorrenti, addon e dominiNon richiestoOne-time 99 USD
Gateway di pagamento PaddlePagamenti one-time e in abbonamentoPaddle BillingOne-time 99 USD
Gateway di pagamento MollieMetodi di pagamento supportati da MollieMollieOne-time 99 USD
Trasferimento dominio tra clientiTrasferimento controllato di domini tra clienti WHMCSNon richiestoOne-time 99 USD
Gestore saldo clienteGestione massiva del credito clienteNon richiestoOne-time 99 USD
OVHcloud VPS & DedicatedConnessione al ciclo di vita dei server OVHcloudOVHcloudOne-time 99 USD
AWS LightsailProvisioning e gestione server LightsailAWSOne-time 99 USD
Contabo CloudGestione VPS e VDS ContaboContaboOne-time 99 USD
Microsoft Azure VMCiclo di vita macchine virtuali AzureMicrosoft AzureOne-time 99 USD
Google Cloud Compute EngineRisorse Compute Engine basate su LinuxGoogle CloudOne-time 99 USD

I prezzi in tabella sono quelli di listino aggiornati alla data di pubblicazione di questo articolo e non costituiscono un impegno di prezzo permanente. Prima dell'acquisto, fare sempre riferimento alla copertura, alla licenza e ai prezzi aggiornati sulla pagina del prodotto.

Moduli per operazioni di pagamento e gestione

Aggiornamento automatico delle tariffe

Quando i prezzi ricorrenti cambiano nel tempo, i servizi attivi o sospesi aperti in precedenza possono rimanere al vecchio costo di rinnovo. Il modulo Aggiornamento Automatico Prezzi serve a ricalcolare gli importi di rinnovo di servizi, addon e domini in base ai prezzi correnti in WHMCS. L'operazione può essere eseguita una tantum o integrata in un flusso cron pianificato.

Questo modulo è particolarmente adatto alle aziende che non vogliono modificare manualmente un gran numero di record dopo variazioni del tasso di cambio o delle tariffe. Puoi esaminare esempi di implementazione nella guida Modulo WHMCS per l'aggiornamento automatico dei prezzi. Tuttavia, prima di un aggiornamento massivo è sempre necessario fare un backup del database, testare su un gruppo ristretto di clienti e verificare le fatture generate.

Gateway di pagamento Paddle

L'integrazione Paddle Billing V3 avvia pagamenti one-time e in abbonamento tramite Paddle Checkout per le fatture WHMCS. Verifica le notifiche webhook con firma HMAC-SHA256 e aiuta ad associare la notifica di pagamento ricorrente alla fattura corretta tramite ID abbonamento. In questo modo viene elaborata la notifica firmata dal server, anziché fare affidamento sul risultato del reindirizzamento nel browser.

Il modulo non fornisce un account Paddle né l'approvazione di idoneità commerciale. L'account Paddle, le definizioni dei prodotti, la valuta e la configurazione del webhook devono essere completati dall'azienda. Per i dettagli di installazione, consulta la guida Pagamenti con Paddle su WHMCS; prima di passare a Checkout, testa separatamente in un ambiente di prova gli scenari di pagamento riuscito, fallito, annullato e ricorrente.

Gateway di pagamento Mollie

Il modulo Mollie collega alle fatture WHMCS i metodi di pagamento attivi sul tuo account Mollie, come iDEAL, carte, PayPal, Apple Pay, Bancontact, SOFORT e bonifico bancario. Le callback webhook trasmettono gli stati di pagamento a WHMCS e offre funzioni specifiche per metodo, come la selezione della banca nel flusso iDEAL e la gestione della scadenza per i bonifici.

La disponibilità di un metodo di pagamento dipende dal Paese, dalla valuta, dall'account Mollie e dai metodi da esso abilitati. Per questo motivo, l'espressione “15 metodi” non significa che tutti saranno attivi su ogni account. Insieme alla guida Modulo Mollie per WHMCS, verifica i permessi nel pannello Mollie e l'endpoint webhook prima di passare in produzione.

Trasferimento dominio tra clienti

Questo modulo imposta un processo controllato per trasferire un dominio dall'account di un cliente WHMCS a quello di un altro. La richiesta parte dall'area cliente e viene confermata tramite un link monouso inviato all'indirizzo email del ricevente. La verifica del token, la registrazione IP, la durata di validità regolabile e il monitoraggio dello stato offrono un flusso più tracciabile rispetto al trasferimento manuale.

Questa operazione è diversa dal classico trasferimento di dominio tra registrar: qui si cambia la proprietà del cliente all'interno della stessa installazione WHMCS. Per il blocco del trasferimento, il codice EPP o il processo di spostamento dell'account esterno, continuano ad applicarsi le regole del registrar competente.

Gestore saldo cliente

Il Gestore Credito Clienti si concentra sulla necessità di filtrare ed eseguire operazioni massive sui crediti dei clienti nell'area amministrativa. I clienti possono essere trovati per nome, azienda, email, valuta e stato del credito; è possibile aggiungere credito in blocco agli account selezionati o azzerare il saldo. Le transazioni sono tracciate con nota amministratore e log attività.

Poiché il saldo del credito influisce direttamente sulle registrazioni finanziarie, i ruoli amministrativi autorizzati devono essere limitati, la lista dei clienti selezionati va controllata prima dell'operazione e le modifiche massive di grandi dimensioni vanno eseguite solo dopo aver effettuato un backup.

Moduli di automazione per cloud server

I moduli cloud fanno da ponte tra gli ordini e i record di servizio di WHMCS e le API dei provider. Puoi vedere come funziona il ciclo di vita di un servizio di base nella guida Creazione automatica di account hosting con WHMCS. Le operazioni esposte al cliente variano in base al comportamento delle API del provider, alle impostazioni del prodotto e ai permessi concessi dall'azienda. Questi moduli sono integrazioni indipendenti; non sono prodotti sviluppati dai cloud provider e non costituiscono una dichiarazione di partnership.

OVHcloud VPS & Dedicated

L'integrazione OVHcloud collega i servizi VPS e Dedicated a WHMCS. Sul lato VPS, ciclo di vita e operazioni di reinstallazione possono essere gestiti con i controlli self-service consentiti nell'area cliente. La copertura Dedicated è pensata per l'assegnazione di server esistenti e operazioni controllate; non si deve presupporre che automatizzi l'acquisto di nuovi server fisici. Per sospensione, terminazione e operazioni che possono causare perdita di dati, è necessario il controllo dell'operatore.

AWS Lightsail

Il modulo AWS Lightsail associa provisioning del server, operazioni di alimentazione, IPv4 statico, firewall e snapshot al servizio WHMCS. Le credenziali di accesso per le risorse Linux e Windows sono gestite secondo le regole della rispettiva piattaforma. Il modulo è un'integrazione focalizzata sulle risorse Lightsail, non un catalogo generale di servizi AWS.

Informazioni come ID provider, regione, nome istanza e IP statico associato devono rimanere specifiche del servizio. Le chiavi API non sono incluse nell'archivio ZIP; durante l'installazione, il cliente le configura con i permessi necessari del proprio account AWS.

Contabo Cloud

Il modulo Contabo Cloud fornisce una connessione per provisioning, operazioni di alimentazione, reinstallazione, reset password e gestione snapshot su risorse Contabo VPS e VDS. Sono critici il corretto abbinamento dell'ID risorsa con il servizio, la risoluzione di richieste di provisioning ripetute sulla stessa risorsa e la verifica della proprietà in operazioni come l'eliminazione.

Account Contabo, accesso API e costi di utilizzo del provider sono richiesti separatamente. Non dare per scontato che upgrade del pacchetto, reverse DNS, VNC nel browser o qualsiasi altra funzionalità del provider siano inclusi nel modulo; fare sempre riferimento all'elenco aggiornato delle funzionalità sulla pagina del prodotto.

Microsoft Azure VM

Il modulo Microsoft Azure VM collega a WHMCS il provisioning di macchine virtuali, operazioni di alimentazione, deallocate, ridimensionamento, gestione di dischi, snapshot e firewall. I tag del gruppo di risorse e della macchina virtuale sono usati per verificare la proprietà del servizio. L'eliminazione non deve considerarsi completata prima di aver verificato il risultato dell'operazione asincrona di Azure e l'effettiva rimozione della risorsa.

Per risorse aggiuntive a pagamento come dischi e snapshot Azure, l'allestimento del catalogo e dei prezzi è a carico dell'azienda. Le opzioni mostrate al cliente devono essere limitate esclusivamente alla copertura configurata e testata.

Google Cloud Compute Engine

Il modulo Google Cloud collega il provisioning, le operazioni di alimentazione, il cambio del tipo di macchina e la gestione delle regole di rete a livello di servizio per le macchine virtuali Compute Engine basate su Linux. Il nome della risorsa, la regione e le etichette di servizio sono conservati come identità persistente; le operazioni del ciclo di vita vengono eseguite solo dopo aver verificato queste informazioni di proprietà.

La copertura della distribuzione 2.0.0 attuale riguarda i carichi di lavoro Linux. Non pianificare come se ci fosse supporto per Windows o RDP. Progetto Google Cloud, account di servizio, quota, rete e impostazioni di fatturazione sono forniti e gestiti dall'azienda.

Quale modulo WHMCS scegliere?

  • Se vuoi allineare i vecchi prezzi di rinnovo al catalogo aggiornato, valuta il modulo Aggiornamento Automatico Prezzi.
  • Se intendi incassare pagamenti tramite Paddle Checkout o Mollie, scegli il relativo modulo gateway di pagamento.
  • Se è richiesto il trasferimento di domini tra clienti all'interno della stessa installazione WHMCS, utilizza il modulo Trasferimento Domini tra Clienti.
  • Se devi operare sui crediti di un grande numero di account cliente, il Gestore Credito Clienti è l'opzione adatta.
  • Se vuoi connettere un servizio VPS, VDS o VM alle API di un provider, scegli esclusivamente il modulo cloud server corrispondente al tuo provider.

Se sulla tua infrastruttura offri VPS o VDS, pianifica l'automazione WHMCS insieme alla struttura del prodotto server virtuale. Per le aziende che usano più provider, attivare ciascuna integrazione con un account API separato, un prodotto di test separato e, se possibile, credenziali con privilegi ridotti, riduce l'area di errore.

Flusso di acquisto, download e installazione

Flusso di acquisto, download e installazione
  1. Verifica il modulo adatto alle tue esigenze e la copertura aggiornata sulla pagina ufficiale del prodotto.
  2. Completa l'ordine nell'area clienti WHMCS e paga la fattura.
  3. Dopo la conferma del pagamento da parte di WHMCS, il flusso ufficiale di Auto Release porterà il servizio allo stato Active.
  4. Sull'account con il servizio Active sarà visibile solo il download relativo al prodotto acquistato.
  5. Verifica l'archivio ZIP, leggi la documentazione di installazione e carica i file in un ambiente WHMCS di test.
  6. Dopo l'installazione, inserisci le credenziali API del provider o dell'istituto di pagamento negli appositi campi di configurazione.
  7. Passa in produzione dopo aver testato scenari di transazione riuscita e fallita, webhook, timeout, retry e terminazione.

I file di download non sono serviti dalla directory web pubblica. La relazione prodotto-servizio e lo stato Active del servizio determinano l'autorizzazione al download nell'area clienti. I termini di licenza e la documentazione di installazione aggiornati sulla pagina d'ordine prevalgono sempre su questo riepilogo.

Licenza, costi del provider e confini di sicurezza

I file del modulo sono distribuiti con codice sorgente non cifrato; questo non significa “open source” né diritto di ridistribuzione libera. I diritti di utilizzo, modifica e ridistribuzione sono soggetti al contratto di licenza acquistato; vanno tracciati per prodotto e installazione secondo l'approccio Gestione delle licenze WHMCS. Le chiavi API del provider, i dati reali dei clienti, gli ID delle risorse live o i dati operativi di Hostragons non sono mai inclusi nei pacchetti di distribuzione.

In fase di installazione, applica il principio del minimo privilegio. Quando possibile, assegna al modulo credenziali separate solo per le operazioni API necessarie, ruota regolarmente i segreti webhook, limita i ruoli amministratore WHMCS e oscura i dati sensibili nei log. Prima della produzione, utilizza un account di test separato o una risorsa di test a basso costo. Nei test di annullamento e terminazione, verifica non solo la risposta API del provider, ma anche che la risorsa sia stata effettivamente rimossa e che non siano state abbandonate risorse aggiuntive a pagamento.

Quando vendi un servizio server cloud, nel calcolo dei costi includi non solo la macchina virtuale, ma anche dischi, snapshot, IP, traffico, licenze e differenze di prezzo regionali. L'automazione del modulo può ridurre i tempi operativi, ma non elimina la responsabilità su quote del provider, approvazione dell'account o fatturazione.

Breve checklist prima dell'installazione

  • Leggi la documentazione aggiornata del prodotto per la tua versione di WHMCS e PHP.
  • Effettua un backup del database e dei file.
  • Concedi all'utente API esterno solo i permessi strettamente necessari.
  • Crea un prodotto di test, un cliente di test e una risorsa del provider a basso rischio.
  • Verifica che chiamate ripetute di CreateAccount non creino una seconda risorsa.
  • Controlla dal pannello del provider i risultati di sospensione, riattivazione, terminazione e reinstallazione.
  • Nei moduli di pagamento, testa gli scenari di webhook firmato, importo errato, notifica duplicata e rimborso.
  • Dopo il passaggio in produzione, monitora attentamente i primi ordini e i log degli errori.

Domande Frequenti

Cosa è un modulo WHMCS?

Un modulo WHMCS aggiunge a WHMCS un flusso di lavoro specifico come pagamenti, operazioni sui clienti o gestione server. Non sostituisce la licenza WHMCS né l'account del provider esterno.

Quali cloud provider sono supportati?

Sono disponibili moduli separati per OVHcloud VPS e Dedicated, AWS Lightsail, Contabo VPS/VDS, Microsoft Azure VM e Google Cloud Compute Engine basato su Linux.

L'account del cloud provider e i costi di utilizzo sono inclusi nel prezzo?

No. Account del provider, abbonamenti, consumo risorse, rete, licenze e imposte sono addebitati separatamente dal provider competente.

Le credenziali API si trovano nel pacchetto del modulo?

No. I file ZIP del modulo non contengono credenziali del provider né dati reali dei clienti. Le informazioni necessarie vanno inserite dopo l'installazione negli appositi campi di configurazione WHMCS.

Come si scarica il modulo acquistato?

Dopo la conferma del pagamento da parte di WHMCS e il passaggio del servizio allo stato Active, nell'area clienti comparirà l'accesso al download esclusivamente per il prodotto acquistato.

Il codice sorgente del modulo è cifrato?

I file del modulo sono distribuiti con codice sorgente non cifrato. I diritti di utilizzo, personalizzazione e ridistribuzione sono regolati dai termini di licenza acquistati.

Scegli il modulo giusto per il tuo flusso di lavoro WHMCS

Confronta copertura, prezzo aggiornato e condizioni di licenza del modulo di cui hai bisogno per pagamenti, operazioni cliente o automazione di cloud server. Scopri i moduli WHMCS e prepara il tuo piano di test pre-produzione insieme alla documentazione di installazione.

Condividi questo articolo:

Team Hostragons

Guide aggiornate dal nostro team di esperti su hosting, server e nomi di dominio. Troviamo insieme la soluzione ideale per il tuo progetto.

Contattaci