Pagamenti ricorrenti
L'integrazione di questa soluzione consente all'esercente di tokenizzare i dati della carta del cliente, in modo da poter effettuare delle ricorrenze per servizi come abbonamenti.
Se si è invece interessati ad una soluzione che consente al cliente finale di salvare i dati della propria carta, ed utilizzarli successivamente per effettuare acquisti più velocemente, fare riferimento alla soluzione OneClick.
I pagamenti ricorrenti sono identificati anche con il termine "MIT" (Merchant Initiated Transaction). Le transazione MIT si dividono in:
- Scheduled: addebiti con cadenza definita (es. primo di ogni mese).
- Unscheduled: addebiti con cadenza non definita.
La gestione di questa soluzione si divide in 2 fasi:
- Primo pagamento
- Pagamenti successivi
Di seguito viene presentato come effettuare primi pagamenti di tokenizzazione e pagamenti successivi nelle modalità di integrazione:
- Hosted Payment Page
- Pay-by-Link
- XPay Build
- Server to Server:
- Pagamento 3D Secure
Primo pagamento
Va generata una prima transazione, assegnando un contratto univoco per cliente, un identificativo che consente a XPay di salvare l'abbinamento tra il cliente e la carta di pagamento utilizzata.
Hosted Payment Page
Il flusso di pagamento non varia rispetto alla soluzione Hosted Payment Page, è necessario infatti richiamare la medesima API:
Valorizzando l'oggetto "recurrence" con i parametri:
| action | CONTRACT_CREATION |
| contractId | Stringa univoca |
| contractType | MIT_UNSCHEDULED o MIT_SCHEDULED |
Pay-by-Link
Il flusso di pagamento non varia rispetto alla soluzione Pay-by-Link, è necessario infatti richiamare la medesima API:
Valorizzando l'oggetto "recurrence" con i parametri:
| action | CONTRACT_CREATION |
| contractId | Stringa univoca |
| contractType | MIT_UNSCHEDULED o MIT_SCHEDULED |
XPay Build
Il flusso di pagamento non varia rispetto alla soluzione XPay Build, è necessario infatti richiamare la medesima API:
Valorizzando l'oggetto "recurrence" con i parametri:
| action | CONTRACT_CREATION |
| contractId | Stringa univoca |
| contractType | MIT_UNSCHEDULED o MIT_SCHEDULED |
Pagamento 3D Secure
Il flusso di pagamento non varia rispetto alla soluzione Pagamento 3D Secure, è necessario infatti richiamare le medesima API:
Valorizzando l'oggetto "recurrence" con i parametri:
| action | CONTRACT_CREATION |
| contractId | Stringa univoca |
| contractType | MIT_UNSCHEDULED o MIT_SCHEDULED |
Gestione dei pagamenti successivi
È possibile procedere con l'addebito successivo inviando a XPay una chiamata con il contratto registrato in fase di primo pagamento. Il pagamento successivo non è sottoposto ad autenticazione 3D Secure.
Per tutte le modalità di integrazione, per eseguire il pagamento successivo è necessario eseguire la chiamata API:
NOTE:
-
Vengono messe a disposizione le seguenti API per poter intervenire sui contratti esistenti:
- Il gateway non consente l’esecuzione del pagamento quando il parametro “actionType” è valorizzato a “PAY” e l’importo è pari a zero. Per effettuare una verifica carta con importo pari a zero (“amount”: “0”) e contestuale tokenizzazione, è necessario impostare il parametro “actionType” con “VERIFY”.
- All'interno dell'oggetto "recurrence", il valore "action":"CARD_SUBSTITUTION" consente di sostituire la carta associata a un contratto (contractId) esistente. Il flusso di pagamento con la sostituzione carta è identico a quello della tokenizzazione iniziale.
Nota importante: questa funzionalità è disponibile esclusivamente per le carte di pagamento. Per i metodi di pagamento alternativi (APM), non è possibile effettuare la sostituzione: sarà pertanto necessario procedere con una nuova tokenizzazione generando un differente "contractId".