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 Worldline
  • Tramite la creazione della transazione in Pagina di pagamento ospitata, 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 Pagina di pagamento ospitata) 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 Worldline, 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:

CampoDescrizione
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.
La stessa regola vale anche per le settimane e i mesi: ad esempio, se la scadenza deve essere il giorno cinque ogni due mesi, impostare la ricorrenza su "Mensile" e il pagamento deve avvenire il "5" ogni "2" mesi.

Nota:
- 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, Worldline 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

  • Quando modifichi gli abbonamenti, assicurati di adattare le impostazioni dell’ora legale dell’utente all’impostazione del parametro PSPID
  • In caso contrario, i pagamenti dovuti potrebbero non essere attivati per gli abbonamenti modificati su questo parametro PSPID
  • Per modificare l’impostazione dell’utente, vai su Configurazione> Utent> Modifica nel tuo utente > Disattiva/Attiva “Regolare automaticamente in base alle modifiche di risparmio energetico (ora legale)”
  • Per modificare l’impostazione del parametro PSPID, vai su Configurazione> Abbonamento > Dettagli amministrativi > Disattiva/Attiva “Regolare automaticamente in base alle modifiche di risparmio energetico (ora legale)”

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.1 Inserimento

Per creare un abbonamento mediante Pagina di pagamento ospitata o DirectLink, occorre eseguire una transazione iniziale. In caso di Pagina di pagamento ospitata, 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
N

In base a SUB_PERIOD_UNIT (non applicabile per "giornaliero" (d) in cui il momento corrisponde all'unità)



  • Settimanale (ww): 1=Domenica, … 7=Sabato
  • Mensile (m): giorno del mese (1-31)

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 Pagina di pagamento ospitata)





  • Ricordare di inserire questi campi nel calcolo SHA. Per maggiori informazioni relative a SHA, vedere Pagina di pagamento ospitata o la documentazione DirectLink.
  • Affinché i pagamenti dell'abbonamento vengano eseguiti, è necessario impostare lo stato dell'abbonamento su “active”. Lo stato dell'abbonamento non passa automaticamente ad active alla data d'inizio definita nell'abbonamento.

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 Pagina di pagamento ospitata, 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 Pagina di pagamento ospitata 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

  • Il file deve essere un file di testo ASCII
  • Il file deve contenere una sola riga per abbonamento. Le righe sono separate da caratteri di ritorno a capo e avanzamento riga (ASCII :13 10 – – HEX : 0xD 0xA)
  • I campi devono essere separati da un punto e virgola (“;”)
  • I campi non possono contenere alcun punto e virgola (“;”)

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.