Il token è un riferimento a informazioni memorizzate nella piattaforma. Poiché queste informazioni possono essere sensibili o non strutturate, vi offriamo un modo semplice per memorizzarle nella nostra piattaforma creando un token con un riferimento. Per utilizzare le informazioni con il pagamento, ad esempio con un charge flow o una transazione, potete usare questo token e non dovete chiedere di nuovo le informazioni al cliente.
Il principale caso d’uso dei token è la memorizzazione di informazioni critiche delle carte di credito, poiché queste possono essere memorizzate solo all’interno di ambienti certificati PCI. Esistono tuttavia diverse altre situazioni in cui l’utilizzo dei token può essere utile. Potete creare un token per ogni connettore che supporta la tokenizzazione.
Un cliente ha già ordinato online nel vostro negozio utilizzando l’addebito diretto SEPA come tipo di pagamento. Potete memorizzare queste informazioni con un token per acquisti successivi. Immaginate che chiami dopo 4 mesi e voglia riordinare alcuni prodotti. Potete ora creare una transazione senza la presenza del cliente utilizzando il riferimento del token, senza chiedere di nuovo le informazioni.
Tutte le operazioni sui token possono essere eseguite tramite il Token Service. I token creati possono essere visualizzati nel back office in Space > Pagamento > Token
Non tutti i tipi di pagamento e le configurazioni dei connettori supportano la funzione token. Se volete verificare se il tipo di pagamento la supporta, trovate maggiori informazioni nel nostro riferimento dei tipi di pagamento. Potete farlo aprendo il vostro gestore nel nostro elenco dei connettori e facendo clic sul connettore. Si aprirà una schermata che mostra le funzionalità della pagina di pagamento.
Se è selezionato il pagamento ricorrente, dopo il primo pagamento viene creato un token.
Per creare un token utilizzate il Token Service
con l’operazione create.
Potete impostare se il token debba essere abilitato per il pagamento con un clic. Quando un token è abilitato per i pagamenti con un clic, l’acquirente potrà selezionare il token all’interno dell’iFrame o sulla pagina di pagamento per pagare con il token. L’utilizzo del token ridurrà il numero di passaggi che l’acquirente deve completare. L’acquirente viene riconosciuto tramite l’ID cliente della transazione. Ciò significa che all’acquirente verranno presentati i token utilizzati in precedenza quando abbiamo un token con lo stesso ID cliente della transazione. Inoltre, il tipo di pagamento deve essere configurato per consentire i pagamenti con un clic.
La richiesta qui sotto crea un nuovo token per il cliente di test. Il riferimento di pagamento verrà ora memorizzato automaticamente nella Token Version.
Richiesta
{
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"tokenReference": "test-customer"
}Risposta
La richiesta qui sotto crea una transazione utilizzando il token creato.
{
"createdOn": "2017-12-07T14:53:20.285Z",
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"id": 1572,
"linkedSpaceId": 396,
"state": "ACTIVE",
"timeZone": "Europe/Zurich",
"tokenReference": "test-customer",
"version": 0
}Potete utilizzare il token per creare una transazione. Per farlo, basta fornire l'`id` del token nella Transaction Create Operation. Il token può ora essere utilizzato nei seguenti modi:
Potete mostrare il token utilizzando l’autorizzazione iframe, che consentirà al vostro cliente di scegliere il token per elaborare la transazione.
Potete utilizzare il token tramite l’autorizzazione con pagina di pagamento. In questo modo il
cliente verrà addebitato direttamente e inviato alla successURL o alla failedURL a seconda che il token abbia potuto essere addebitato o meno.
Potete applicare un Charge Flow alla transazione che utilizza un token. Questo comporterà un addebito diretto, oppure verranno attivati i livelli del Charge Flow nel caso in cui il token non possa essere addebitato.
Richiesta
La richiesta qui sotto crea una transazione utilizzando il token creato.
{
"billingAddress": {
"city": "Zurich",
"country": "Switzerland",
"familyName": "Test",
"givenName": "Customer",
"street": "Teststreet 4"
},
"currency": "chf",
"lineItems": [{
"amountIncludingTax": "15",
"name": "Test",
"quantity": "1",
"type": "PRODUCT",
"uniqueId": "12354"
}],
"token": 1572
}Il checkout con un clic aumenta la vostra conversione perché le informazioni di pagamento del vostro cliente possono essere memorizzate in modo sicuro per acquisti successivi, in modo che la volta successiva il cliente possa pagare direttamente con il token. Questa funzionalità è disponibile nell’integrazione Iframe o Pagina di pagamento per tutti i tipi di pagamento che supportano i token (vedi sopra).
Affinché il checkout con un clic funzioni, dovete assicurarvi che i seguenti requisiti siano soddisfatti:
Il tipo di pagamento supporta la tokenizzazione (controllate l’elenco dei connettori)
Fornite la proprietà customerId nella Transaction Create Operation
La modalità di pagamento con un clic deve essere attivata nella configurazione del tipo di pagamento (vedi sotto)
Se questi requisiti sono soddisfatti, l’applicazione inizializzerà automaticamente un token e memorizzerà le informazioni di pagamento in modo sicuro presso il vostro gestore. Questo funziona con la integrazione con pagina di pagamento e con la integrazione iframe.
Assicuratevi di abilitare la modalità di pagamento con un clic per ogni tipo di pagamento per cui volete attivare il pagamento con un clic. Potete scegliere tra 3 opzioni:
Disabilita (predefinito): in questo caso non verrà creato alcun token
Forza memorizzazione: in questo caso l’applicazione proverà sempre a creare un token.
Consenti memorizzazione: in questo caso al cliente verrà chiesto se desidera memorizzare il token. Ha inoltre la possibilità di gestire i token memorizzati.
Non appena viene fornito un ID cliente, la modalità con un clic è attivata ed è presente un token registrato, all’acquirente verrà proposto un token per pagare, oppure avrà la possibilità di utilizzare un altro tipo di pagamento.
Nel caso in cui vogliate addebitare direttamente il token, potete fornire il tokenId direttamente nella Transaction Create Operation; in questo caso il token verrà addebitato direttamente.
