open menu
axerve docs
Pagamenti/Axerve Pay by Link

Axerve Pay by Link

REST

Axerve Pay by Link, servizio attivabile contattando il commerciale di riferimento o l’assistenza, offre l’opportunità di inviare un link o creare un QR code tramite il quale l’acquirente può finalizzare un pagamento. La funzionalità amplia l’offerta di modalità di pagamento e incrementa le opportuntà di vendita per il merchant, contribuendo ad incrementare cross e up selling, rafforzando il tasso di retention.

Come funziona Axerve Pay by Link

Axerve Pay by Link è disponibile, previa attivazione, direttamente all’interno della dashboard myStore oppure è possibile connettere un catalogo digitale o una qualsiasi altra piattaforma a Pay by Link via API, modalità che affrontiamo in questa sezione della documentazione.

Dopo aver cliccato sul pulsante di acquisto nel carrello digitale, il servizio genera un’email – o un QR code che può essere mostrato sul dispositivo dell’esercente – contenente il link che rimanda ad una pagina di pagamento, identica alla pagina di pagamento di un Ecommerce.

Come generare il link/QR code

Per creare il link o il QR code occorre aggiungere paymentChannel e buyerEmail nel corpo della chiamata API payment/createapi link.

Ecco un esempio:

copy
1{  
2  "shopLogin":"GESPAY65987",
3  "amount":"27.30",
4  "currency":"EUR",
5  "shopTransactionID":"your-custom-id",
6  "buyerEmail": "your-customer@email.it",
7  "paymentChannel": {
8    "channelType": [
9      "EMAIL", "QRCODE", "LINK"
10    ]
11  }
12}

Se la richiesta è stata formattata correttamente, la risposta sarà simile all’oggetto qui sotto:

copy
1{
2  "error": {
3    "code": "0",
4    "description": "request correctly processed"
5  },
6  "payload": {
7    "paymentToken": "f19e60d0-ef11-45bc-b404-ee9b17ba6c81",
8    "paymentID": "17665541289",
9    "userRedirect": {
10      "href": "https://sandbox.gestpay.net/pagam/src/index.html?paymentID=17665541282&paymentToken=f19e60d0-ef21-45bc-b404-ee9b17ba6c81&shopLogin=GESPAY65987&lightbox=false"
11    }
12  }
13}

Dove inserire le URL di redirect

Una volta inviata la call create, si può definire dove debba atterrare il cliente una volta ricevuto l’esito OK o KO alla chiamata autorizzativa, specificando questi dati:

  • All’interno della chiamata payment/create

copy
1{  
2  ...
3  "responseURLs":{
4    "buyerOK":"https://www.mysite.com/OK_URL",
5    "buyerKO":"https://www.mysite.com/KO_URL",
6    "serverNotificationURL":"https://www.mysite.com/S2S_URL"
7  }
8}
  • Nel backoffice di Axerve Ecommerce Solutions (maggiori informazioni qui)

default

È bene tenere in considerazione che nel caso in cui si siano inseriti i dati sia nella chiamata sia nel backoffice il sistema considererà validi quelli della chiamata.

default

Opzione: LINK
Se nella create è stata scelta solo l’opzione LINK, non verrà inviata nessuna email e l’esercente dovrà gestire l’invio dell’URL presente nel campo href della risposta.

Spedire il link di pagamento

Come anticipato, per spedire il link è necessario essere in possesso dell’indirizzo e-mail del cliente che va inserito nel corpo della chiamata payment/createapi link.

Qui sotto un mockup di come potrebbe essere sviluppato il front-end.

È quindi possibile chiamare il servizio payment/create che invierà automaticamente l’e-mail al cliente.

default

Il link generato ha una validità di 49 ore dal momento della creazione.

Nell’immagine, una rappresentazione di ciò che viene visualizzato dall’acquirente fino alla finalizzazione del pagamento.

Creare il QRcode

In questo caso d’uso l’indirizzo e-mail del cliente è superfluo, ricevuto il QR code direttamente in risposta alla chiamata payment/createapi link sarà sufficiente mostrarlo al cliente.

Di seguito un mockup di un possibile front-end.

Il cliente inquadra il QR code con la fotocamera o con un’app reader e viene reindirizzato sulla pagina di pagamento all’interno del browser.

Questa pagina è stata utile?

Precedente
prevGestire le sottoscrizioni
Successiva
Obblighi normativinext