Subscription Manager
1. Introduzione
La funzionalità Subscription Manager permette di creare e memorizzare in anticipo pagamenti ricorrenti, sulla base dell'intervallo di data o del tasso di ricorrenza.
L'applicazione tipica è l'abbonamento alle riviste, per cui il cliente deve pagare lo stesso importo ogni mese fino alla disdetta dell'abbonamento.
L'abbonamento può essere creato in diversi modi:
- Manualmente nell'account Viveum
- Tramite la creazione della transazione in e-Commerce, DirectLink o Batch.
2. Nel back office
Facendo clic su “Subscription” tramite "Advanced" nel menu dell'account, viene visualizzato il dashboard "Subscription management" (gestione abbonamenti), suddiviso nelle seguenti parti:
- La pagina predefinita Subscription status (stato abbonamenti) mostra un riepilogo degli abbonamenti correnti del rivenditore. Facendo clic sul numero di abbonamenti corrispondenti a un determinato stato, si visualizza l'elenco degli abbonamenti.
- L'opzione "Global parameters" permette di configurare le opzioni di gestione delle sottoscrizioni.
- "Edit/View Subscriptions" (modifica/visualizza abbonamenti) permette di cercare, visualizzare e modificare qualsiasi abbonamento memorizzato nel proprio account. Invece di visualizzarlo nel browser, è anche possibile scaricare l'elenco degli abbonamenti in un file di testo.
- L'opzione "Create Subscription" permette di creare manualmente nuovi abbonamenti.
2.1 Configurazione
Nella scheda “Global Parameters” è possibile impostare i seguenti parametri:
- Number of retries when a payment fails (Numero di tentativi in caso di pagamento non riuscito). Può succedere che un pagamento presenti un errore. In tal caso, il sistema riprova a effettuarlo per il numero di volte qui configurato (max 5). L'intervallo tra ciascun tentativo è di un giorno.
- What to do when the maximum number of retries has been reached (Che cosa fare una volta raggiunto il numero massimo di nuovi tentativi).
- Se si sceglie di disattivare un abbonamento, non verranno eseguiti ulteriori pagamenti relativi ad esso.
- Se si sceglie di passare alla scadenza seguente definita nell'abbonamento, il pagamento successivo sarà eseguito alla prossima scadenza.
- In entrambi i casi, il mancato pagamento resterà insoluto finché non sarà stato raggiunto il numero massimo di tentativi. Se l'errore persiste dopo che è stato raggiunto il numero massimo di tentativi, un messaggio di notifica verrà inviato all'indirizzo e-mail configurato nella scheda “Transaction emails” (E-mail delle transazioni) nella pagina “Technical information" (Informazioni tecniche) dell'account.
- Disclaimer (solo e-Commerce) definisce se visualizzare o meno un messaggio che richiede il consenso dell'acquirente per la conservazione dei dati del suo pagamento e delle future rate dell'abbonamento. Se non si desidera utilizzare il disclaimer predefinito fornito da Viveum, si consiglia vivamente di richiedere il consenso dell'acquirente per la conservazione dei dati del suo pagamento e delle future rate dell'abbonamento.
2.2 Creazione di un abbonamento
Per creare un abbonamento, è necessario inserire le seguenti informazioni:
| Campo | Descrizione |
|---|---|
| Subscription ID | Identificativo unico dell'abbonamento. Non si tratta di un OrderID, in quanto ciascuna rata dell'abbonamento costituisce un pagamento separato. |
| Name/email/phone | Dati dei titolare del conto/carta di credito |
| Credit Card/Direct Debits |
Metodo di pagamento e relativi dati sul conto o sulla carta di credito. Nota: non è possibile creare abbonamenti Direct Debits DE con i dati IBAN; è necessario utilizzare invece Konto/BLZ. Direct Debits NL non è supportato. |
| Recurrence |
È possibile scegliere una ricorrenza giornaliera, settimanale o mensile. La ricorrenza scelta può essere ulteriormente dettagliata (ad esempio, scegliendo il giorno della settimana per la ricorrenza settimanale o il giorno del mese per la ricorrenza mensile). Se si desidera avere una ricorrenza a intervalli di qualche giorno, occorre selezionare “giornaliera”, quindi impostare il numero di giorni desiderato. - Quando il giorno del mese per l'abbonamento supera il numero di giorni disponibili nel mese corrente (ad es. non c'è il 30 febbraio), l'abbonamento usa l'ultimo giorno disponibile del mese. - Se si crea un abbonamento con una data di inizio passata, la data di inizio viene cambiata in data futura, in base a uno qualsiasi dei valori immessi con la ricorrenza (v. sopra). |
| Start date / End date |
Intervallo di date dell'abbonamento. Se la data dell'ultimo pagamento dell'abbonamento coincide con la data di fine, il pagamento verrà elaborato. Per garantire l’esecuzione ottimale di tutti i pagamenti consecutive, vi consigliamo di non modificare la data di inizio dopo la registrazione del primo pagamento. |
| OrderID | Identificativo dell'ordine che verrà incluso in ciascun pagamento dell'abbonamento. Facendo clic sul pulsante “add/MM/yyyy” si include la data nell'OrderID, così da distinguere facilmente ciascun pagamento dell'abbonamento. |
| COM | Descrizione dell'ordine inclusa in ciascun pagamento dell'abbonamento. Facendo clic sul pulsante “add/MM/yyyy” si include la data nel campo COM, così da distinguere facilmente ciascun pagamento dell'abbonamento. |
| Comment | Spazio libero in cui è possibile memorizzare un commento per il rivenditore. |
| Status | Impostando l'abbonamento sullo stato “active”, si attiva il pagamento come configurato. |
|
Quando si crea un commento, non viene effettuata alcuna verifica della carta di credito. La validità della carta sarà verificata al primo pagamento dell'abbonamento. |
2.3 Modifica di un abbonamento
La schermata di modifica di un abbonamento propone le stesse funzionalità illustrate per la creazione.
Tutti i campi possono essere modificati, ad eccezione del campo Subscription ID. In caso di scadenza della carta di credito del cliente, è possibile aggiornarla o modificarla senza bisogno di ricrearla.
Se si modificano le date di pagamento relative a un abbonamento, Viveum può elaborare un pagamento di recupero a copertura delle transazioni che altrimenti verrebbero ignorate a seguito della modifica.
Ad esempio:
- Settimana 1 – L'abbonamento viene creato in modo da essere elaborato ogni mercoledì. La prima transazione viene elaborata il primo mercoledì.
- Settimana 2 – Il martedì si modifica l'abbonamento, impostandone la data di elaborazione sul lunedì.
- Settimana 3 – L'abbonamento viene elaborato il lunedì.
|
IMPORTANTE! Evita differenze di ora legale tra utenti e il parametro PSPID
|
2.4 Cancellazione di un abbonamento
Per cancellare un abbonamento, è necessario visualizzarlo tramite il link “Edit/View subscriptions”, poi fare clic sul pulsante “delete” accanto all'abbonamento corrispondente.
|
La cancellazione di un abbonamento determina unicamente la cancellazione delle rate, ma non il rimborso o l'annullamento di qualunque pagamento in corso. |
2.5 Visualizzazione delle transazioni
Ogni transazione di abbonamento rappresenta un pagamento distinto, con un proprio PAYID e stato. È possibile visualizzarli mediante il link “View transactions” del back-office.
Se si desidera visualizzare tutte le transazioni di un abbonamento, è più semplice cercarle tramite Subscription Manager inserendo il Subscription ID (verranno visualizzate solo le ultime 12 transazioni).
3. Tramite e-Commerce e DirectLink
3.1 Inserimento
Per creare un abbonamento mediante e-Commerce o DirectLink, occorre eseguire una transazione iniziale. In caso di e-Commerce, l'abbonamento non viene creato se la transazione iniziale non viene completata. Vogliate notare che la creazione di un abbonamento in DirectLink richiede l'elaborazione della transazione iniziale senza 3D-Secure.
Suggerimento: se non si desidera eseguire una transazione reale al momento della creazione dell'abbonamento, si può inserire un importo pari a 0 €, che serve unicamente a convalidare la carta di credito; la transazione non verrà inoltrata all'acquirente.
Per creare un abbonamento, è necessario trasmettere i seguenti dati insieme alla transazione:
| Campo / Formato | Descrizione |
|---|---|
|
SUBSCRIPTION_ID AN, 50 |
Identificativo unico dell'abbonamento. Il Subscription ID deve essere assegnato dinamicamente. |
| SUB_AMOUNT N |
Importo dell'abbonamento (può essere diverso dall'importo della transazione iniziale) moltiplicato per 100, poiché il formato dell'importo non deve contenere decimali né altri separatori. |
|
SUB_COM AN, 100 |
Descrizione dell'ordine |
|
SUB_ORDERID AN, 40 |
OrderID dei pagamenti dell'abbonamento |
|
SUB_PERIOD_UNIT AN, 2 |
"d" = giornaliero "ww" = settimanale "m" = mensile |
|
SUB_PERIOD_NUMBER N |
Intervallo tra ciascuna rata dell'abbonamento. |
|
SUB_PERIOD_MOMENT |
In base a SUB_PERIOD_UNIT (non applicabile per "giornaliero" (d) in cui il momento corrisponde all'unità)
|
|
SUB_STARTDATE Date |
Data d'inizio dell'abbonamento |
|
SUB_ENDDATE Date |
Data di fine dell'abbonamento |
|
SUB_STATUS AN, 1 |
0 = inattivo 1 = attivo |
|
SUB_COMMENT AN, 200 |
Commento per il rivenditore |
|
CN AN, 35 |
Nome del titolare della carta Deve essere inviato nel campo predefinito nella pagina del pagamento di e-Commerce) |
|
Se i campi EMAIL e OWNERTELNO sono compilati nell'ordine, verranno verranno inseriti anche nell'abbonamento.
Nota: i pagamenti dell'abbonamento vengono sempre elaborati come vendite dirette. Tuttavia, quando si utilizza e-Commerce, la prima transazione viene elaborata come configurata nella pagina Technical information dell'account.
3.2 Feedback
Il feedback post-vendita deve restituire i seguenti parametri:
| Campo | Descrizione |
|---|---|
| subscription_id | Conferma dell'identificativo univoco dell'abbonamento |
| creation_status | Indica se l'abbonamento è stato creato correttamente. Valori possibili: “OK” o “ERROR”. |
|
Ricordare di inserire questi campi nel calcolo SHA-OUT. Per maggiori informazioni relative a SHA, vedere e-Commerce o la documentazione DirectLink. |
4. Tramite Batch
Per le operazioni di abbonamento in batch, occorre specificare i seguenti campi:
| # / Campo (*=Obbligatorio) / Formato | Descrizione |
|---|---|
|
1 / OPERATION* AN, 8 |
ADDSUBS (Aggiungi abbonamento) DELSUBS (Elimina abbonamento) |
|
2 / CN* AN, 35 |
Nome del titolare della carta |
|
3 / ACC_CARDNO* AN, 23 |
Numero della carta di credito o del conto corrente |
|
4 / EXPDATE* AN, 4 |
Data di scadenza (se applicabile) |
|
5 / BRAND* AN, 25 |
Marchio del metodo di pagamento |
|
6 / PSPID* AN, 30 |
Identificativo del venditore nel nostro sistema |
|
7 / SUBSCRIPTION_ID* AN,50 |
Codice identificativo univoco dell'abbonamento. |
|
8 / AMOUNT* N |
Importo dell'abbonamento moltiplicato per 100, in quanto il formato dell'importo non deve contenere decimali o altri separatori. |
|
9 / CURRENCY* AN, 3 |
Valuta (formato ISO a 3 cifre) |
|
10 / PERIODICITY_UNIT* AN, 2 |
‘d’ = giornaliero ‘ww’ = settimanale ‘m’ = mensile |
|
11 / PERIODICITY_NUMBER* N |
Intervallo tra ciascuna rata dell'abbonamento. |
| 12 / PERIODICITY_MOMENT* | In base al campo 10 Giornaliero (d): intervallo in giorni Settimanale(ww): 1=domenica, … 7=sabato Mensile (m): giorno del mese |
|
13 / SUBSCRIPTION_STATUS* N |
0 – Inattivo 1 – Attivo |
|
14 / START_DATE* Date |
Date d'inizio e di fine. Il formato della data deve essere gg-MM-aaaa. Tutte le date vengono convertite nel fuso orario dell'utente, ad esempio se START_DATE è 01/05/2020 e l'utente è impostato su GMT–1, data e ora verranno convertite in 01/05/2020 1:00:00 (CET). |
|
15 / END_DATE Date |
|
|
16 / EXTERNALREF_PATTERN AN, 40 |
Riferimento del pagamento. È possibile inserire il formato della data che sarà sostituito dei valori effettivi alla data del pagamento. Es.: abbonamento 123 [MM-AAAA] |
|
17 / COMDESC_PATTERN AN, 100 |
Descrizione dell'ordine Anche in questo caso, si può inserire il formato della data che sarà sostituito dai rispettivi valori al momento di ciascun pagamento. ad es. vostra rivista [AAAAggg] |
| 18 / (empty) | |
|
19 / BUYER_EMAIL AN, 50 |
Indirizzo email |
|
20 / BUYER_TELNO AN, 50 |
Numero di telefono |
|
21 / COMMENT AN, 200 |
Spazio libero per commenti |
|
Esempio di un abbonamento tramite VISA:
ADDSUBS;John Doe;41111;1012;VISA;PSPID;ID001;100;EUR;d;1;1;1;2010-08-13;2011-08-13;Cotisation [MM-AAAA];Paiement n° [AAAAggg];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs;
Esempio di un abbonamento tramite addebiti diretti:
ADDSUBS;John Doe;XXXXXXXXXBLZXXXXXXXX;;DIRECT DEBITS DE;PSPID;ID002;100;EUR;d;1;1;1;2010-04-20;2010-05-15 00:00:00.000;Cotisation [MM-YYYY];Paiement n° [YYYYddd];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs;
Nota: se si copiano e incollano le righe di esempio per effettuare una prova sul proprio account di prova, assicurarsi di sostituire il PSPID e i numeri di conto.
Per maggiori informazioni, vedere Batch.