---
title: DirectLink evoluzione - note condivise Claranet/Mercury
tags: Mercury, DirectLink
---

# DirectLink evoluzione - note condivise Claranet/Mercury

## Riunione 20/05/2020

* alcuni utenti inviano DL via mail ma non si accorgono di messaggio in alto di DL inviato. Si vorrebbe evitare questo scenario.
* opzione 1: mostrare popup con messaggio. Quando confermo chiude popup e ricarica pagina con campi vuoti
* opzione 2: refresh di pagina, che viene mostrata coi campi vuoti

* si richiede possibilità di annullare un DL inviato, dalla pagina di ricerca. Per annullato si intende comportamento analogo a quanto già fatto oggi in caso di re-inoltro ma senza nuovo invio DL (deve essere solo annullo): il DL inviato viene annullato e url di pagamento non è più valida (è utile nel caso di invii doppi vedi punto precedente e in caso di cambio idea/pagamento ricevuto in altro modo da merchant)**[*modificato da Fanelli 25/05*]**

* almeno uno tra phone e email address devi inserirlo quando crei DL: l'idea era quella di avere dei radio button / box per scelta canale invio DL on top della schermata di EDIT.
In base alla scelta fatta da merchant si ingrigiscono campi non obbligatori (es: se SMS n° cell obbligatorio, mail facoltativa, campo mail diventa grigio). se mechant cambia scelta canale durante compilazione i campi obbligatori da grigi diventano bianchi, e campi non obbligatori diventano grigi (es cambio da SMS a mail, campo cell diventa grigio e mail diventa bianco obbligatorio) ci deve essere un controllo sulla compilazione dei campi obbligatori al momento del click per l'invio, il controllo deve essere coerente anche nel caso in cui il merchant abbia cambiato canale e lasciato compilato i campi obbligatori relativi al canale selezionato in precedenza
**[*modificato da Fanelli 25/05*]**
* la pagina di search dovrebbe essere responsive: se invio un DL con un campo libero molto lungo, la visualizzazione della tabella è sfasata.
**[FF]** anche se pagina non è completamente responsive l'importante è che le righe della tabella siano centrate con la pagina stessa, ora la tabella ha un margine sinistro bianco di larghezza fissa indipendentemente da lunghezza contenuto campi

* attenzione ai caratteri speciali. SMS utilizza il formato GSM.
* non dovrebbe essere un problema, anche SMS in tedesco avrà un testo minimale, il grosso sarà l'url di pagamento.

* la funzione "esporta come CSV" dell'elenco dei direct link da backoffice è molto richiesta: lo facciamo anche su monetaweb? Per ora no. Solo sul NPG

## Testo SMS :phone: :scroll:

**in italiano**: :flag-it:

{merchant name} ha richiesto un pagamento di {amount}{currency} clicca qui {url} 

* `{merchant name}` deve essere di ~~12~~ 30 caratteri, se è più lungo va troncato [FF] effettuato studio su Insegne esitenti che hanno attivo DL, hanno tutti insegna superiore 12 caratteri in media 20, 30 cmq ci sta vedi punto successivo
* `{currency}` valuta espressa in EUR/USD/ecc..
* `{url}` è una stringa di circa 105 caratteri

Esempio:

merchantAAAA ha richiesto un pagamento di 1234.56EUR clicca qui {url} 

## Accorciamento della Url DL

**[aggiunto da Fanelli 25/05]**
ho fatto delle prove con i testi nelle varie lingue dallo studio si evice che possiamo evitare di fare shortening con il token, dato che è sufficiente la URL ridotta a 74 caratteri es: https://dev.monetaonline.it/monetaweb/d/p?t=31LmpzKPMXRJHcQIlGDsOsM_&l=USA

[MERCHANT NAME30]+[corpo testo]+[URL74caratteri] <=160

LINGUA | [corpo testo con spazi inizio e fine] | [lunghezza corpo testo] | [CHECK<=160] | LUNGHEZZA SMS
ITA | ha richiesto un pagamento di 11.234,56EUR clicca qui | 53 | =30+53+74 | 157
ENG | has requested a payment of 11.234,56EUR click here | 52 | =30+52+74 | 156
GER | hat eine Zahlung von 11.234,56EUR beantragt click hier | 56 | =30+56+74 | 160
FRA | a demandé un paiement de 11.234,56EUR cliquez ici | 51 | =30+51+74 | 155
ESP | ha solicitado un pago de 11.234,56EUR pulse aquí | 50 | =30+50+74 | 154

l'importo funziona fino a 99.999,99
con le traduzioni non ci sono caratteri speciali

-------------------------
* L'accorciamento della URL del DL lo facciamo direttamente noi riducendo tutti gli elementi della URL, ad es rotta, nome dei parametri, etc etc

Ad es: https://dev.monetaonline.it/monetaweb/directlink/payment?token=31LmpzKPMXRJHcQIlGDsOsM_&languageId=USA

*prima versione:* senza shortening, accorciamo solo la URL,
tipo https://dev.monetaonline.it/monetaweb/d/p?t=31LmpzKPMXRJHcQIlGDsOsM_&l=USA (risparmio ~28 caratteri)

*seconda versione:* con shortening, che consiste in un token univoco generato da noi. Questo token verrebbe salvato in una nuova tabella del db, con associato l'url "completo" della pagina hosted da invocare (l'url che attualmente inviamo nelle mail DL)

su DB

| token-shortner | link |
| -------------- | ------------------------------------------------------------------------------------------------------ |
| XXsspzKPMXRJHc | https://dev.monetaonline.it/monetaweb/directlink/payment?token=31LmpzKPMXRJHcQIlGDsOsM_&languageId=USA |
| Ad23$123ASD23d | https://dev.monetaonline.it/monetaweb/directlink/payment?token=asdasdasdw34343cdfe22sds&languageId=ITA |

Utente riceverebbe SMS con link

https://dev.monetaonline.it/monetaweb/d/p?s=XXsspzKPMXRJHc => (risparmio altri 15 caratteri)

cliccando su questo link, phoenix userebbe il token `XXsspzKPMXRJHc` per recuperare dal db l'url della pagina hosted di pagamento`https://dev.monetaonline.it/monetaweb/directlink/payment?token=31LmpzKPMXRJHcQIlGDsOsM_&languageId=USA`, quindi phoenix stesso farebbe il redirect dell'utente su quella pagina hosted

## Esempi di ClicPay

### QRCode


---

### SMS


---

### Email