Documentazione
Documentazione
Inizio rapido

1Panoramica

Questa documentazione introduce gli abbonamenti e mostra come configurare una fatturazione ricorrente di base per i vostri clienti. Se dopo la lettura avete bisogno di aiuto, consultate la nostra documentazione o contattateci per ricevere assistenza nella configurazione degli abbonamenti.

Un riferimento API dettagliato è disponibile nel nostro Riferimento API. Il riferimento API collega le operazioni rilevanti direttamente con il client API WebService per inviare richieste direttamente dal vostro browser all’API del servizio web.

L’idea del sistema di abbonamenti è di spostare tutti i pagamenti e la comunicazione tra voi e il vostro abbonato fuori dal vostro sistema. Ciò significa che ci occupiamo noi della gestione della pianificazione, degli upgrade, dei downgrade e della raccolta delle informazioni di pagamento dal vostro abbonato qualora fossero obsolete. Segnaliamo soltanto se un determinato abbonamento debba essere proseguito o meno sul lato dell’esercente. In sostanza, inviamo un webhook al sistema dell’esercente quando lo stato dell’abbonamento cambia. Sulla base di questi cambiamenti di stato, il sistema dell’esercente deve attivare, sospendere o terminare l’abbonamento. Di tutto il resto ci occupiamo noi.

2Avvio rapido

Fatturare periodicamente i propri clienti è un modello di business comune, facile da realizzare con la nostra piattaforma, che richiede solo pochi passaggi e alcune conoscenze sulla configurazione generale:

  1. Create un Charge Flow per raccogliere le informazioni di pagamento dai vostri abbonati

  2. Definite un prodotto e una versione del prodotto che stabilisce quanto e quando deve essere fatturato.

  3. Create un abbonato.

  4. Abbonate l’abbonato al prodotto creato in precedenza.

Una volta creato un prodotto, per ogni cliente successivo dovete eseguire solo il secondo e il terzo passaggio.

3Charge Flows vs. abbonamenti

Potete utilizzare due modi diversi per addebitare a un cliente pagamenti ricorrenti. Potete utilizzare i Charge Flows, in cui il pagamento viene attivato dall’esercente, oppure la funzionalità Abbonamento, in cui il calcolo degli importi, inclusa la comunicazione ecc., viene gestito da noi.

3.1Charge Flows

Se applicate un Charge Flow a un oggetto transazione, i dati di pagamento verranno raccolti secondo le impostazioni dei livelli di charge flow nel vostro Space. Nel caso in cui un cliente disponga di un token valido, questo verrà addebitato direttamente. I Charge Flows devono essere attivati e pianificati dall’esercente e dovrebbero quindi essere utilizzati quando l’esercente desidera controllare quando addebitare il cliente. Questo è principalmente il caso degli abbonamenti che riguardano prodotti fisici, per i quali si desidera prima verificare le scorte. I Charge Flows vi aiutano notevolmente ad addebitare i vostri clienti, poiché gestiscono automaticamente anche i casi di errore e raccolgono i dettagli di pagamento mancanti o errati dal vostro cliente secondo le vostre impostazioni.

Maggiori informazioni sui Charge Flows sono disponibili nella documentazione dei Charge Flows.

3.2Abbonamenti

D’altra parte, dovreste utilizzare gli Abbonamenti ogni volta che la gestione di abbonati e versioni del prodotto, inclusi i calcoli dei prezzi ecc., deve essere pianificata da noi. Nella configurazione dei prodotti definite il ciclo di fatturazione ecc. e la piattaforma gestirà automaticamente la raccolta delle informazioni di pagamento e gli addebiti successivi. Anche la funzionalità di abbonamento utilizza i Charge Flows per addebitare il vostro abbonato. Rispetto all’uso diretto dei Charge Flows, la funzionalità di abbonamento organizza anche la gestione dei vostri abbonati e prodotti e calcola l’importo da addebitare secondo le vostre impostazioni, oltre alla raccolta delle informazioni di pagamento. Maggiori informazioni sugli abbonamenti sono disponibili nelle pagine seguenti.

Note
 Poiché la funzionalità di abbonamento utilizza anch’essa i Charge Flows per addebitare il cliente, dovete anche attivare la funzionalità Charge Flow e configurare almeno un charge flow per poter utilizzare gli abbonamenti nel vostro Space.

4Esempio

Per illustrare le impostazioni seguenti utilizziamo un prodotto di abbonamento di esempio. Nella documentazione seguente tutte le impostazioni si baseranno su questo esempio.

Esempio

Esempio di prodotto

Vendiamo un prodotto di pagamento con le seguenti particolarità:

  • È prevista una tariffa di attivazione di 249 EUR per gli esercenti al momento della registrazione.

  • La tariffa periodica per i servizi di pagamento di base è di 15 EUR / mese

  • Ogni transazione di pagamento ha un prezzo di 10 ct. per le prime 1'000 transazioni al mese. Successivamente applichiamo uno speciale prezzo ridotto.

  • L’esercente ha la possibilità di abbonarsi a uno speciale servizio di integrazione con cui il prodotto viene installato nel suo ambiente.

  • L’esercente ha la possibilità di abbonarsi a uno speciale SLA di supporto con orari di supporto specifici.

Nelle pagine successive faremo riferimento a questo esempio quando creeremo le versioni del prodotto, i componenti e i gruppi di componenti.