<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > JamioPlug > JamioPlug Message > StartTransactionVerificationBySMS |
Verifica un'operazione inviando un messaggio SMS contenente un Codice OTP di 6 cifre a un numero telefonico. Il metodo permette di implementare flussi di verifica conformi alle normative PSDS2.
Metodo
PlugMessage/StartTransactionVerificationBySMS
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
token |
Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto). |
String |
Y |
mobilePhoneNumber |
Testo che contiene il numero di telefono a cui inviare il messaggio. |
String |
|
senderId |
Identificativo del chiamante. Il valore di default è Jamio PaaS. |
String |
Y |
startMessage |
Testo che contiene la parte iniziale del messaggio da inviare. Il valore di default è “Per confermare la transazione utilizza il codice'' |
String |
Y |
endMessage |
Testo che contiene la parte finale del messaggio da inviare. |
String |
Y |
fields |
Dato strutturato che contiene i dati su cui viene costruito il codice identificativo, associato univocamente al codice OTP, e che consente di sostituire eventuali placeholder, presenti nei parametri startMessage e endMessage, con il corrispondente elemento presente nella struttura dati, avente nome uguale a quello del placeholder. |
Dataset |
Y |
timeout |
Numerico che indica il tempo di validità del codice OTP in secondi. Il valore di default è 600. |
Integer |
Y |
codeLength |
Numerico che indica la lunghezza del codice OTP. Il valore di default è 6. |
Integer |
Y |
testMode |
True se il messaggio non deve essere inviato realmente. Il valore di default è false. |
Boolean |
Y |
Output |
|
||
Nome |
Descrizione |
Tipo |
|
returnValue |
Testo che contiene l'identificativo di verifica. |
String |
|
Commenti
Il messaggio inviato è strutturato nella forma <StartMessage> Code <EndMessage>, ove StartMessage e EndMessage sono le stringhe passate ai parametri startMessage e endMessage e Code è il codice OTP aggiunto dal metodo nel messaggio.
Il codice OTP è composto da un numero di caratteri pari al valore del parametro codeLength e la sua validità è 10 min.
Se il parametro testMode è true e il numero indicato nel parametro mobilePhoneNumber è valido, il messaggio sms non viene inviato e il returnValue restituisce una stringa random invece dell' identificativo di verifica.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore PLUG_WrongPhoneNumber |
Se il numero telefonico indicato nel parametro mobilePhoneNumber non è mobile.
|