Informazioni generali sull’abbonamento e sul ciclo di vita con sospensione.
Il vostro abbonamento può avere diversi stati:
Pending: Un abbonamento si trova nello stato Pending quando l’abbonamento e la versione dell’abbonamento vengono creati.
Initializing: Una volta creato l’abbonamento e in assenza di una versione attiva del token, l’abbonamento
passa nello stato Initializing finché non vengono fornite informazioni di pagamento valide.
Active: Non appena il token può essere addebitato, l’abbonamento passa nello stato attivo.
Terminating: Un abbonamento che è stato terminato ma che ha addebiti in sospeso o periodi in sospeso si trova nello
stato Terminating.
Terminated: Una volta eseguiti tutti gli addebiti, l’abbonamento passa nello stato Terminated.
Failed: Se l’inizializzazione dell’abbonamento fallisce, l’abbonamento passa
automaticamente nello stato Failed. Questo può accadere anche quando la transazione iniziale
raggiunge il timeout. Se utilizzate la pagina di pagamento o l’integrazione iframe
per inizializzare l’abbonamento, dovete tenerne conto. Se desiderate
inviare un’e-mail con cui il cliente può inizializzare la transazione, si consiglia
di utilizzare i Charge Flow anche per la transazione iniziale.
Una volta creato un abbonamento, il mancato pagamento di una fattura diventa l’evento più importante che possa verificarsi. I fallimenti si verificano per molte ragioni:
Mancanza di una fonte di pagamento effettiva sul cliente associato
Tentativo di utilizzare una fonte di pagamento obsoleta o scaduta
Un rifiuto effettivo di una fonte di pagamento altrimenti valida
Non appena il pagamento fallisce, viene attivato il Charge Flow standard per acquisire informazioni di pagamento valide.
Nella configurazione del Charge Flow potete impostare i livelli del Charge Flow per configurare quante volte
viene inviata l’e-mail di richiesta delle informazioni di pagamento. Quando viene raggiunto l’ultimo livello del Charge Flow e l’abbonato
non ha fornito credenziali valide, l’abbonamento passa nello stato suspended.
Le sospensioni possono essere rimosse manualmente aprendo l’abbonamento e passando alla scheda delle sospensioni. L’importo in sospeso verrà addebitato con il ciclo di fatturazione successivo.
|
Note
|
Potete testare facilmente un pagamento non riuscito creando un abbonamento reale e invalidando poi il token dell’abbonamento. Questo attiverà automaticamente il processo di pagamento non riuscito per aggiornare la versione del token. |
Gli abbonamenti possono essere sospesi. Questo può avvenire automaticamente se l’importo in sospeso non può essere addebitato. Prima che ciò accada, il Charge Flow associato deve arrivare alla fine senza un pagamento riuscito.
Sospensioni aggiuntive possono essere aggiunte manualmente. In sostanza, una sospensione mette in pausa la fatturazione e interrompe temporaneamente i servizi. Una sospensione richiede sempre una data di fine. La data di fine indica quando la sospensione verrà terminata. Durante la creazione della sospensione è possibile definire il comportamento dopo la fine della sospensione. Questo consente di stabilire se, al raggiungimento della fine della sospensione, l’abbonamento debba essere terminato o se l’abbonamento debba essere riattivato. Quando il Charge Flow fallisce, creiamo una sospensione che terminerà l’abbonamento dopo la fine della sospensione. Ciò significa che mettiamo in pausa l’abbonamento per la durata della sospensione e, se l’abbonato non contatta l’esercente entro questo periodo per riattivare l’abbonamento, terminiamo successivamente l’abbonamento, perché la nostra ipotesi è che, se l’abbonato non reagisce alle e-mail di promemoria inviate e se la messa in pausa del servizio non provoca alcuna reazione da parte dell’abbonato, molto probabilmente l’abbonato non è più interessato al servizio.
Le sospensioni possono essere aggiunte a un abbonamento tramite il backend. Per farlo dovete aprire l’abbonamento e passare alla scheda delle sospensioni. Lì potete aggiungere sospensioni a un abbonamento. Per la durata della sospensione non verrà eseguito alcun addebito. Quando l’abbonamento esce dalla sospensione e non è terminato, l’abbonamento riprende esattamente da dove era stato sospeso.
Un abbonamento può anche essere sospeso automaticamente nel caso in cui l’addebito dell’importo in sospeso fallisca e le informazioni di pagamento non abbiano potuto essere recuperate tramite il Charge Flow. Se un abbonamento è in sospensione, dovreste interrompere la fornitura del servizio da parte vostra. Se l’importo in sospeso non viene pagato entro il periodo di sospensione definito sul prodotto tramite il collegamento al Charge Flow, l’abbonamento verrà terminato automaticamente.
Se il vostro abbonamento si trova nello stato termination e aggiungete una sospensione all’abbonamento, questo porterà a
una sospensione dell’abbonamento e la data in cui l’abbonamento sarà terminated verrà
posticipata per la durata della sospensione.
Se un pagamento fallisce durante l’addebito, viene attivato un processo di Charge Flow basato sulle vostre configurazioni. L’abbonato riceverà un’e-mail che inviterà l’abbonato ad aggiornare le proprie informazioni di pagamento. Se avete bisogno di un maggiore controllo sulla formattazione e sull’invio dell’e-mail, potete configurare il Charge Flow in modo che la vostra applicazione venga notificata di una nuova e-mail del Charge Flow da inviare. L’applicazione può così occuparsi dell’invio. La documentazione del Charge Flow contiene maggiori dettagli su come configurare tutto questo.
Nel caso in cui l’abbonato debba poter aggiornare i dettagli di pagamento dall’interno della vostra applicazione, potreste voler utilizzare la chiamata API di aggiornamento del token. Questa operazione API crea una transazione che aggiorna semplicemente i dettagli di pagamento per il token. Il token si trova sull’oggetto abbonamento. Consultate la documentazione API per i dettagli sull’operazione di aggiornamento del token.
Per farlo, dovete aggiornare il token come segue:
Utilizzate l’endpoint crea una transazione per l’aggiornamento del token. Nella chiamata fornite il token che desiderate aggiornare.
Questo creerà una transazione nello stato pending. Utilizzate ora la transazione nella vostra applicazione per costruire la pagina di pagamento o
per creare un checkout iframe