POS VIRTUALE. Manuale d integrazione. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi.

Transcript

1 POS VIRTUALE Manuale d integrazione Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 1 / 48

2 INDICE: Aprile 2010 versione CONTENUTO DEL MANUALE INTRODUZIONE A CHI E DESTINATO IL MANUALE D INTEGRAZIONE GLOSSARIO IL POS VIRTUALE IWSMILE - per il venditore SCHEMA DEL FLUSSO DI PAGAMENTO RICHIESTA POS VIRTUALE CONFIGURAZIONE POS VIRTUALE CREAZIONE DEL POS VIRTUALE LA CREAZIONE DEL CODICE HTML DEL PULSANTE DI PAGAMENTO INSERIMENTO DI CAMPI DINAMICI NEL PULSANTE DI PAGAMENTO IMPOSTARE LA LINGUA DEL POS VIRTUALE PRECOMPILARE I CAMPI ALL INTERNO DEL POS COME UTILIZZARE IL PULSANTE DI PAGAMENTO RICEZIONE DI UNA CALLBACK AUTOMATICA DA PARTE DI IWSMILE VALUTE SUPPORTATE DAL SISTEMA RIMBORSI ALLA CLIENTELA IL POS VIRTUALE IWSMILE per il compratore SCHEMA DEL FLUSSO DI PAGAMENTO MASCHERA DI INTRODUZIONE DEL POS VIRTUALE PAGAMENTO ESEGUITO DA CLIENTE IWSMILE/IWBANK STEP 1 - LOGIN STEP 2 - CONFERMA STEP 3 ESITO DEL PAGAMENTO PAGAMENTO ESEGUITO DA TITOLARE DI CARTA DI CREDITO O PREPAGATA STEP 1 MASCHERA INSERIMENTO DATI TITOLARE STEP 2 MASCHERA RIEPILOGO E CONFERMA OPERAZIONE STEP 3 ESITO DEL PAGAMENTO INVIO DELLE DI CONFERMA PAGAMENTO ESEGUITO DA CLIENTE NON ITALIANO ELENCO OPERAZIONI POS VIRTUALE NOTE LEGALI ASSISTENZA ALLEGATI ALLEGATO 1 SCHEMA LOGICO DEL FLUSSO DI PAGAMENTO ALLEGATO 2 TABELLA PARAMETRI HTML DEL PULSANTE DI PAGAMENTO ALLEGATO 3 TABELLA DEI PARAMETRI IN RISPOSTA ALLA POST HTML DEL PULSANTE DI PAGAMENTO ALLEGATO 5 INFORMAZIONE SUI CAMPI ALLEGATO 6 PROVE IN AMBIENTE DI TEST Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 2 / 48

3 FIGURE: Figura 1: Schema di ricezione pagamento attraverso POS Virtuale IWSMILE... 6 Figura 2: Richiesta POS Virtuale... 7 Figura 3: Conferma di avvenuta richiesta POS Virtuale... 7 Figura 4: Maschera di conferma positiva della richiesta del POS Virtuale Figura 5: Maschera per la configurazione del POS Virtuale IWSMILE... 8 Figura 6: Maschera per la configurazione del POS Virtuale IWSMILE... 9 Figura 7: Maschera per la configurazione del POS Virtuale IWSMILE Figura 8: Maschera per la configurazione del POS Virtuale IWSMILE Figura 9: Maschera di creazione pulsante POS Virtuale IWSMILE Figura 10: posizionamento del logo personalizzato nella schermata del POS VIRTUALE Figura 11: Maschera per la scelta della grafica del pulsante di pagamento Figura 12: Maschera del codice del pulsante di pagamento Figura 13: Esempio di autocompilazione dei dati del cliente Figura 14: Esempio di pulsante di pagamento tramite POS Virtuale IWSMILE Figura 15: Maschera dei pagamenti inviati e ricevuti tramite POS Virtuale Figura 16: Maschera per il rimborso di un pagamento ricevuto Figura 17: Maschera introduttiva del POS Virtuale IWSMILE Figura 18: Maschera di riepilogo del pagamento Figura 19: Maschera di conferma del pagamento Figura 20: Maschera di inserimento dati Figura 21: Maschera di riepilogo del pagamento Figura 22: Maschera di conferma del pagamento Figura 23: Selezione della lingua del POS virtuale Figura 24: Maschera di elenco dei pagamenti inviati e ricevuti Figura 25: Filtro per la visualizzazione dei pagamenti inviati e ricevuti Figura 26: Dettaglio pagamento inviato o ricevuto Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 3 / 48

4 1. CONTENUTO DEL MANUALE IWSMILE è il conto di moneta elettronica ideato da IWBANK per effettuare pagamenti o trasferimenti di denaro, in modo semplice, comodo e sicuro. IWSMILE consente di usufruire di molteplici servizi bancari come bonifici, giroconti, pagamenti utenze, ricariche del cellulare. Il presente Manuale di integrazione contiene informazioni specifiche sull utilizzo della funzionalità POS VIRTUALE IWSMILE disponibile all interno del conto di moneta elettronica IWSMILE. 1.1 INTRODUZIONE Il POS VIRTUALE IWSMILE è l interfaccia grafica che permette al cliente IWSMILE di assumere il ruolo di venditore e quindi la possibilità di: o o o o vendere beni e servizi accreditando il proprio conto IWSMILE di moneta elettronica; alimentare il conto IWSMILE grazie a pagamenti ricevuti dai propri compratori; fornire ai propri compratori la possibilità di eseguire transazioni di pagamento, in tre semplici passi e in modo sicuro e veloce; fornire ai propri compratori la possibilità di acquistare addebitando il proprio conto IWSMILE/IWBANK (o la propria carta di credito/prepagata associata); 1.2 A CHI E DESTINATO IL MANUALE D INTEGRAZIONE Il Manuale di integrazione è principalmente destinato a clienti IWSMILE che possiedono un sito WEB ed intendono utilizzare il POS VIRTUALE IWSMILE per eseguire e ricevere pagamenti elettronici. Come dettagliato nelle pagine successive, il POS VIRTUALE IWSMILE fornisce la possibilità di accettare pagamenti anche per quei clienti che possiedono un sito WEB e che, mediante azioni di Direct Marketing vogliono accettare pagamenti da terzi potenziali compratori. Per quest ultima tipologia di clienti il sistema permette loro di creare il pulsante (per accettare pagamenti) ed inviare tale pulsante alla clientela a mezzo di . In altri termini, questo manuale supporta il cliente IWSMILE nell attività venditore di beni e servizi. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 4 / 48

5 2. GLOSSARIO Acquirer: istituzione finanziaria con licenza propria (Visa, MasterCard, ecc.) che mantiene rapporti con gli esercenti convenzionati. L acquirer gestisce i pagamenti elettronici ricevuti e costituisce l interfaccia con i circuiti internazionali. Backoffice: termine utilizzato con riferimento alla funzioni proprie di gestione di un negozio (es: resoconti, elenchi, interrogazioni, disposizioni ecc). Carta di credito: carta con un plafond di spesa limitato da utilizzare per il pagamento presso i punti convenzionati o per l anticipo di contanti. L addebito può avvenire con diverse modalità a seconda del tipo di carta. Carta prepagata: carta che funziona esattamente come le normali carte di credito, con la sostanziale differenza che, in sede di prima attivazione, tale carta viene "caricata" dal titolare con l'importo desiderato. Tali carte sono spendibili effettuando acquisti attraverso il circuito Visa o MasterCard sia online che nei negozi fisici. Contabilizzazione: operazione che crea effetti di natura contabile per una transazione precedentemente autorizzata. Cvv2: codice di 3 cifre riportato sul retro di ogni carta di credito, posto a destra del numero della stessa. GET: operazione di comunicazione del protocollo Http. HTTP: protocollo applicativo utilizzato per trasmettere le pagine web, standard RFC Messaggio di controllo dell identità: codice assegnato da IWSMILE che identifica in modo univoco il negozio. PHP: Hypertext Preprocessor. POS Virtuale: il POS VIRTUALE IWSMILE, attraverso la dotazione di un collegamento a un processor di pagamenti è in grado di addebitare le carte di credito dei circuiti internazionali. POST: operazione di comunicazione del protocollo http. Processor: soggetto di natura tecnica che con l acquirer gestisce il processing delle richieste di autorizzazione delle transazioni di pagamenti. Pulsante di pagamento: strumento creato dal venditore che pubblicato sul proprio sito (o inviato tramite ) permette al venditore di ricevere pagamenti; URL: è l acronimo di Universal Resource Locator. In altri termini rappresenta le coordinate di un sito o di una informazione presente su Internet: una sorta di indirizzo elettronico (es: la URL del sito di IWSMILE è Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 5 / 48

6 3. IL POS VIRTUALE IWSMILE - per il venditore Il POS VIRTUALE IWSMILE, con la procedura di creazione del Pulsante di pagamento, è in grado di addebitare una transazione eseguita con carta di credito dei principali circuiti internazionali per: o alimentare il proprio conto IWSMILE; o ricevere pagamenti per transazioni di commercio elettronico. Il POS VIRTUALE IWSMILE accetta pagamenti da: o compratori che hanno già attivo un conto di moneta elettronica IWSMILE; o compratori che hanno già attivo un conto con IWBANK; o compratori che intendono pagare con la propria carta di credito o prepagata. La procedura di check-out o d utilizzo del POS VIRTUALE IWSMILE è la procedura attraverso la quale un compratore può acquistare merce o i servizi che il venditore ha inteso vendere. Ciò può avvenire cliccando il pulsante di pagamento (Cfr. par 3.1.2): o disponibile sul sito Web del venditore; o ricevuto dal compratore tramite una del venditore; 3.1 SCHEMA DEL FLUSSO DI PAGAMENTO Il Venditore che intende vendere un bene o servizio colloca il pulsante di pagamento generato tramite il POS VIRTUALE IWSMILE sul proprio sito Web. Ogni cliente che clicca sul pulsante genera una transazione di pagamento elettronica che va ad accreditare il conto IWSMILE del venditore. Di seguito è rappresentato lo schema dell operazione di pagamento attraverso il POS VIRTUALE IWSMILE: 2) Il compratore al momento del PAGAMENTO è re-direzionato sul server IWSMILE 3) IWSMILE (solo per pagamenti a mezzo carta di credito) A) richiede l autorizzazione ai circuiti internazionali B) riceve la risposta dai Circuiti Internazionali COMPRATORE 1) Il compratore naviga sul sito del venditore VENDITORE (Cliente IWSMILE) 4) Al completamento della transazione Il sistema reindirizza al Venditore POS VIRTUALE IWSMILE Circuiti Internazionali Visa / MC Figura 1: Schema di ricezione pagamento attraverso POS Virtuale IWSMILE Per avere evidenza dello schema logico si rinvia all allegato 1 Schema Logico. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 6 / 48

7 3.1.2 RICHIESTA POS VIRTUALE Il venditore quale operazione preliminare attraverso la sezione POS Virtuale / POS Virtuale / Richiesta POS Virtuale deve richiedere l abilitazione all utilizzo del POS Virtuale. L operazione è molto semplice, si tratta dell abilitazione del flag Richiesta utilizzo POS e conseguente click sul pulsante conferma 1. Figura 2: Richiesta POS Virtuale Il passo successivo alla richiesta è la presa in carico della stessa da parte di IWBank: tale attività viene altresì comunicata con una . Figura 3: Conferma di avvenuta richiesta POS Virtuale. Trascorsi i tempi tecnici per la verifica della richiesta, IWBank fornirà il riscontro via mail al venditore. Dal momento della approvazione, di regola, può passare qualche giorno affinché sia possibile per il Merchant cominciare a ricevere pagamenti. Il suggerimento è quello di procedere comunque alla integrazione. Infatti, a partire da tale abilitazione, devono necessariamente trascorre tempi tecnici finalizzati all'abilitazione del POS Virtuale verso i circuiti di pagamento internazionali. A verifica ultimata, nel caso in cui la richiesta è stata approvata, IWSMILE visualizzerà l esito della richiesta come segue. 1 Senza tale richiesta non è possibile creare il POS (vedi par. successivo) e quindi utilizzarlo per la ricezione dei pagamenti. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 7 / 48

8 Figura 4: Maschera di conferma positiva della richiesta del POS Virtuale. Nel caso la richiesta non sia andata a buon fine il cliente è invitato a richiedere chiarimenti all indirizzo info@iwsmile.it. Figura 5: Maschera di conferma negativa della richiesta del POS Virtuale CONFIGURAZIONE POS VIRTUALE Il venditore può configurare il proprio POS VIRTUALE, selezionando le diverse funzionalità disponibili all interno della sezione POS Virtuale/Configurazione. Attraverso tale funzione il venditore ha la possibilità di personalizzare la configurazione del POS Virtuale IWSMILE. Figura 5: Maschera per la configurazione del POS Virtuale IWSMILE Manuale Integrazione: il cliente in questa sezione può visualizzare o scaricare il presente Manuale di integrazione che intende supportare il cliente nell utilizzo del POS Virtuale e nell integrazione dello stesso sul proprio sito WEB. Immagine Negozio: il sistema permette al venditore di eseguire l upload del proprio logo che apparirà al compratore al momento del pagamento tramite il POS VIRTUALE IWSMILE. IWSMILE si riserva di esaminare il logo caricato dal venditore verificando che la pubblicazione non violi norme di legge. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 8 / 48

9 L'immagine da caricare deve essere in formato gif, o jpeg, dimensioni 150 x 50 pixel e non può superare i 100 Kb di grandezza. In caso contrario il sistema non consente il caricamento. Nell intervallo di tempo che intercorre tra l upload e la pubblicazione il sistema mostra il messaggio Logo in validazione. Completato il processo di validazione, nella sezione POS Virtuale / Configurazione / Immagine negozio appare una di anteprima del logo caricato. Figura 6: Maschera per la configurazione del POS Virtuale IWSMILE Completato il processo di validazione, nella sezione POS Virtuale / Configurazione / Immagine negozio appare un anteprima del logo caricato. Al momento del caricamento del logo da parte del Venditore, il sistema associa un codice che è utilizzato per nominare l immagine stessa a livello fisico sul file system. Attraverso questo codice è possibile personalizzare il POS Virtuale con il proprio logo. Il richiamo del logo può essere effettuato attraverso il parametro IMAGE all interno della POST HTML di chiamata al POS Virtuale IWSMILE. Figura 7: Maschera per la configurazione del POS Virtuale IWSMILE Notifica di pagamento: il sistema permette al venditore di ricevere un messaggio da parte di IWSMILE contenente tutte le informazioni della transazione di pagamento ricevuta. Il Venditore deve inserire in tale campo l URL della pagina preposta alla ricezione della notifica stessa. La compilazione del campo è facoltativa (il venditore può scegliere di non ricevere la notifica di pagamento). Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 9 / 48

10 Per maggiori informazioni sull utilizzo di questa funzione si veda il par. 2.6 RICEZIONE DI UNA CALLBACK AUTOMATICA DA PARTE DI IWSMILE. Codice di controllo dell identità: il messaggio di controllo di identità è un codice univoco assegnato dal POS VIRTUALE IWSMILE al venditore; Questi infatti ha la possibilità di includere tale messaggio nella risposta del proprio server e IWSMILE c.d. call back. Si tratta di un ulteriore controllo, rispetto alla notifica di pagamento che permette al venditore di accertarsi della provenienza della notifica stessa. Mail per Scontrini POS Virtuale: il sistema permette al venditore di ricevere gli scontrini del POS Virtuale ad uno o più indirizzi diversi dall indirizzo principale, che ci hai comunicato in sede di apertura conto. in questa sezione hai la possibilità di impostare fino a 3 diverse . Figura 8: Maschera per la configurazione del POS Virtuale IWSMILE Preferenze. Pagamenti da utenti IWSMILE/IWBANK: il sistema permette - alla clientela che lo preferisce - l accettazione dei pagamenti dai soli clienti IWSMILE/IWBANK. In questo modo il venditore - che con tale opzione ha così configurato il proprio POS - non potrà ricevere pagamenti da titolari di carta di credito o prepagate. Chiamate Skype : il cliente che ha aperto un account su Skype e desidera essere contattato può permettere agli altri utenti di IWSMILE di chiamarlo per agevolare la comunicazione sulle transazioni di pagamento con il POS virtuale. E sufficiente attivare l opzione attiva la possibilità di essere contattato ed inserire il proprio nome utente utilizzato per Skype. La compilazione del campo è facoltativa (il venditore può scegliere di non ricevere chiamate da altri utenti). Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 10 / 48

11 Ritorno automatico: attraverso questa funzionalità, al termine del completamento della procedura di pagamento, dopo qualche secondo ogni compratore sarà automaticamente indirizzato al sito web del venditore. La pagina di redirezione è quella corrispondente al parametro URL_OK (indirizzo URL della pagina di conferma pagamento). Nome sull'estratto conto cliente: il nome sull'estratto conto della carta di pagamento è il nome che figurerà sull'estratto conto dei tuoi clienti. Il nome può avere una lunghezza massima di 10 caratteri alfanumerici. Per ogni pagamento tramite carta, il nome specificato apparirà nella sezione descrizione dell'estratto conto del cliente in posizione successiva alla parola "IWBANK". Per esempio, nel caso il nome sia "VENDITORE", la descrizione del pagamento visualizzata nell estratto conto del cliente sarà "IWBANK VENDITORE". Figura 9: Maschera per la configurazione del POS Virtuale IWSMILE Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 11 / 48

12 3.1.2 CREAZIONE DEL POS VIRTUALE Il venditore può creare il pulsante di pagamento selezionando la funzionalità apposita, posta all interno della sezione POS Virtuale / POS Virtuale / Crea pulsante di pagamento. Il sistema visualizzerà la seguente maschera che consente al venditore l inserimento di tutti i dati riguardanti la creazione del pulsante di pagamento. Viene di seguito rappresentata la prima maschera dell inserimento dei dati: Figura 10: Maschera di creazione pulsante POS Virtuale IWSMILE Nota: Ogni transazione di pagamento è soggetta ad un pricing di servizio (Importo della commissione) richiesto dai circuiti internazionali. Le informazioni che il venditore può inserire all interno del pulsante di pagamento sono le seguenti: Nome dell oggetto/servizio: è necessario inserire il nome dell oggetto o del servizio che il venditore desidera vendere. La compilazione di tale campo per il venditore è obbligatoria. ID/Numero dell oggetto: è possibile inserire l eventuale ID o numero di rintracciamento dell oggetto. Il campo è stato ideato per quei venditori che intendono assegnare una codifica interna e propria al bene/servizio che intendono mettere in vendita. Si noti che l informazione contenuta in tale campo non sarà visualizzata dal proprio cliente/compratore al momento del pagamento. Viceversa tale informazione compare tra i dettagli della transazione sul proprio conto di moneta elettronica IWSMILE. La compilazione di tale campo per il venditore è facoltativa. Prezzo dell oggetto: è possibile inserire il prezzo dell oggetto che si desidera vendere. La compilazione di tale campo per il venditore è facoltativa. Il venditore che decide di lasciare vuoto il campo, infatti, intende dare la possibilità ai compratori di compilarlo al momento Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 12 / 48

13 dell acquisto indicando loro l importo del pagamento: tale possibilità è utilizzabile, ad esempio, nel caso di donazioni, offerte libere, ecc. URL di Pagamento riuscito: è possibile inserire l URL al quale si desidera reindirizzare i propri clienti al termine della procedura di pagamento. Il compratore sarà reindirizzato alla pagina di pagamento riuscito previamente specificata dal Venditore. Nel caso il venditore non abbia immesso uno specifico URL all interno di tale campo, cliccando sul link torna al commerciante i compratori visualizzeranno la pagina principale di IWSMILE. La compilazione di tale campo per il venditore è facoltativa. URL di Pagamento non riuscito: è possibile inserire l URL al quale si desidera reindirizzare i propri clienti nel caso la procedura di pagamento, qualunque sia il momento della procedura, non vada a buon fine. Infatti, in tale caso il compratore sarà reindirizzato alla pagina di pagamento non riuscito previamente specificata dal Venditore. La compilazione di tale campo per il venditore è facoltativa. Quantità: con l impostazione di tale campo si vuole consentire al venditore di vendere più di un bene/servizio. Se il venditore compila sia il campo quantità, sia il campo prezzo : il sistema considera prezzo dell oggetto come un importo parziale e calcola l importo totale del pagamento moltiplicando il prezzo dell oggetto per la quantità. Se il venditore non compila il campo quantità (in bianco) e compila soltanto il campo prezzo allora il sistema valorizza la quantità pari a 1 (default) e considera prezzo dell oggetto come un importo totale. Se il venditore non compila né il campo quantità (in bianco) né il campo prezzo (in bianco), si pensi al caso delle donazioni, allora il sistema valorizza sempre la quantità pari a 1 (default); Non è invece possibile compilare il campo quantità con numeri superiori a 1 non valorizzando il campo prezzo. In questo caso, il sistema segnala un errore del tipo: Attenzione non hai valorizzato l importo. Personalizza il flusso di pagamento con il tuo logo. Il venditore ha la possibilità di personalizzare il POS Virtuale scegliendo tra due opzioni alternative: o o non utilizzare alcuna immagine. Il compratore che esegue l operazione di pagamento attraverso il POS VIRTUALE IWSMILE non vedrà alcuna immagine, ma soltanto i loghi del sistema IWSMILE; utilizzare il logo caricato. Il compratore che paga attraverso il POS VIRTUALE IWSMILE vedrà il logo prescelto e predefinito dal venditore. Viene di seguito rappresentato la schermata e la posizione del logo visualizzato. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 13 / 48

14 Figura 11: posizionamento del logo personalizzato nella schermata del POS VIRTUALE Nel caso in cui il Venditore non abbia eseguito l Upload del proprio logo (cfr. 2.2 Configurazione POS) il sistema visualizzerà il messaggio: Attenzione non hai caricato nessuna immagine o logo: se vuoi caricare un immagine o il tuo logo vai alla sezione impostazione del venditore. Nel caso, invece, l immagine sia ancora in fase di approvazione da parte di IWSMILE il sistema visualizzerà il messaggio: l immagine/logo che hai caricato è tuttora in validazione. Al venditore è data la possibilità di scegliere la grafica del proprio pulsante di pagamento tra quattro diverse grafiche preselezionate da IWSMILE. In assenza di tale scelta sarà utilizzata la grafica di default. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 14 / 48

15 Figura 12: Maschera per la scelta della grafica del pulsante di pagamento LA CREAZIONE DEL CODICE HTML DEL PULSANTE DI PAGAMENTO Una volta che il venditore compila il modulo Crea pulsante di pagamento, clicca sul bottone Crea Pulsante il sistema genererà automaticamente il codice HTML che rappresenta, appunto, il pulsante di pagamento che contiene tutte le informazioni specificate in precedenza. Nella sezione link per messaggi è data la possibilità al venditore di copiare il codice HTML dalla apposita casella di testo Codice HTML della form e incollarla in una e- mail che il venditore potrà spedire alla propria clientela. Di seguito è rappresentata la relativa maschera. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 15 / 48

16 Figura 13: Maschera del codice del pulsante di pagamento E possibile per i clienti che hanno maggior dimestichezza con il linguaggio HTML generare in autonomia il codice: Segue un esempio di codice HTML generato in fase di creazione del pulsante: <form action=" method="post"> <input type="hidden" name="account" value="70000xxxxxx"> <input type="hidden" name="amount" value="2"> <input type="hidden" name="item_name" value="prova manuale"> <input type="hidden" name="item_number" value="01 prova"> <input type="hidden" name="quantity" value="1"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> I parametri della form rappresentante il pulsante di pagamento dovranno ospitare i seguenti dati obbligatori: ACCOUNT: numero del conto ricevente (venditore) ITEM_NAME: nome dell oggetto o servizio che si intende vendere Si rimanda all allegato 1 Tabella con le Variabili HTML del pulsante di pagamento per avere i dettagli dei campi utilizzabili nella form di pagamento. All interno della stessa maschera di creazione del codice HTML, il sistema mette a disposizione un ulteriore modalità di utilizzo del POS Virtuale: il link per messaggi . Il link per messaggi rappresenta la chiamata che lo stesso codice HTML del pulsante di pagamento effettua verso il POS Virtuale IWSMILE. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 16 / 48

17 Questa ulteriore modalità di utilizzo del POS è utile nel caso in cui si voglia incollare la chiamata al POS direttamente all interno di messaggi . Cliccando direttamente sul link generato è possibile accedere al POS ed eseguire il pagamento. Segue un esempio di codice HTML generato in fase di creazione del pulsante: manuale&item_number=01+prova&quantity=1&url_ok=http%3a%2f%2fwww.miosito.it% 2Fok.asp&URL_BAD=http%3A%2F%2Fwww.miosito.it%2Fko.asp&FLAG_ONLY_IWS= INSERIMENTO DI CAMPI DINAMICI NEL PULSANTE DI PAGAMENTO Per coloro che gestiscono diversi prodotti e servizi all interno del proprio sito di commercio elettronico, c è la possibilità di rendere dinamici i campi di valore presenti all interno del codice HTML creato dal sistema. Ciò consente di creare un unico codice HTML in grado di essere utilizzato per molteplici prodotti/servizi, prezzi e quantità. Si tratta di sostituire i valori dei parametri AMOUNT, ITEM_NAME, ITEM_NUMBER, QUANTITY con le variabili lato server gestite dal vostro sistema di carrello di commercio elettronico. Segue un esempio di codice HTML con integrazione dei campi dinamici in VBScript: <%@LANGUAGE="VBScript"%> <% Dim ACTUAL_ITEM_NAME Dim ACTUAL_ITEM_NUMBER Dim ACTUAL_QUANTITY Dim ACTUAL_AMOUNT ACTUAL_ITEM_NAME = 'kawasaki Z 750' ACTUAL_ITEM_NUMBER = 212 ACTUAL_QUANTITY = 1 ACTUAL_AMOUNT = 100 %> <form action=" method="post"> <input type="hidden" name="account" value="70000xxxxxx"> <input type="hidden" name="amount" value="<% ACTUAL_AMOUNT %>"> <input type="hidden" name="item_name" value="<% ACTUAL_ITEM_NAME %>"> <input type="hidden" name="item_number" value= <% ACTUAL_ITEM_NUMBER %> > <input type="hidden" name="quantity" value="<% ACTUAL_QUANTITY %>"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> Segue un esempio di codice HTML con integrazione dei campi dinamici in PHP: <?php $ACTUAL_ITEM_NAME = 'kawasaki Z 750'; $ACTUAL_ITEM_NUMBER = 666 ; $ACTUAL_QUANTITY = 1 ; $ACTUAL_AMOUNT = 100 ;?> Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 17 / 48

18 <form action=" method="post"> <input type="hidden" name="account" value="70000xxxxxx"> <input type="hidden" name="amount" value="<?php echo $ACTUAL_AMOUNT;?>"> <input type="hidden" name="item_name" value="<?php echo $ACTUAL_ITEM_NAME;?>"> <input type="hidden" name="item_number" value="<?php echo $ACTUAL_ITEM_NUMBER;?>"> <input type="hidden" name="quantity" value="<?php echo $ACTUAL_QUANTITY;?>"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> IMPOSTARE LA LINGUA DEL POS VIRTUALE Il venditore ha la possibilità di definire la lingua utilizzata dall'acquirente nella procedura di pagamento. Le lingue disponibili sono l italiano, l'inglese, il tedesco e lo spagnolo e il francese. Per poter definire la lingua con la quale sarà visualizzato il POS Virtuale, il venditore dovrà utilizzare il parametro LANG_COUNTRY all interno del codice HTML della chiamata del pulsante di pagamento valorizzandolo con il codice della lingua scelta (si veda l allegato 2 TABELLA VARIABILI HTML DEL PULSANTE DI PAGAMENTO di questo documento): - IT = italiano - EN = inglese - DE = tedesco - FR = francese - ES = spagnolo Il nuovo parametro dovrà essere aggiunto nel codice HTML della chiamata a IWSMILE e valorizzato come segue: <input type="hidden" name="lang_country" value="it"> <form action=" method="post"> <input type="hidden" name="account" value="70000xxxxxx"> <input type="hidden" name="amount" value="2"> <input type="hidden" name="item_name" value="prova manuale"> <input type="hidden" name="item_number" value="01 prova"> <input type="hidden" name="quantity" value="1"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="lang_country" value="it"> <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> Il sistema IWSMILE provvederà a visualizzare il POS Virtuale secondo la lingua richiesta all interno del parametro LANG_COUNTRY. Il compratore ha comunque sempre la possibilità di modificare la lingua del POS cliccando sull apposito selezionatore della lingua. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 18 / 48

19 3.1.6 PRECOMPILARE I CAMPI ALL INTERNO DEL POS Aprile 2010 versione 8.2 Allo scopo di agevolare la compilazione dei dati da parte del compratore durante la procedura di pagamento, il venditore ha la possibilità di specificare direttamente alcuni dati nella chiamata verso il POS Virtuale. Più precisamente, all interno della POST HTML di chiamata è possibile valorizzare i parametri inserendo i dati corrispondenti del cliente memorizzati sul proprio sistema ecommerce (si veda ALLEGATO 2 TABELLA PARAMETRI HTML DEL PULSANTE DI PAGAMENTO di questo documento): - PAYER_FIRSTNAME (nome del compratore) - PAYER_LASTNAME (cognome del compratore) - PAYER_ (indirizzo del compratore) I parametri potranno essere aggiunti nel codice HTML della chiamata a IWSMILE e valorizzati come segue: <input type="hidden" name="payer_firstname" value="nome"> <input type="hidden" name="payer_lastname" value="cognome"> <input type="hidden" name="payer_ " value="nome.cognome@mail.it"> Esempio di chiamata HTML: <form action=" method="post"> <input type="hidden" name="account" value="701xxxxx"> <input type="hidden" name="amount" value="2"> <input type="hidden" name="item_name" value="prova manuale"> <input type="hidden" name="item_number" value="01 prova"> <input type="hidden" name="quantity" value="1"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="payer_firstname" value="nome"> <input type="hidden" name="payer_lastname" value="cognome"> <input type="hidden" name="payer_ " value="n.cognome@mail.it"> <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> Dopo aver valorizzato i parametri specificati, il sistema IWSMILE provvederà ad compilare automaticamente i campi Nome, Cognome e Indirizzo evitando al cliente di specificare nuovamente tali campi, si veda la figura seguente. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 19 / 48

20 Figura 14: Esempio di autocompilazione dei dati del cliente COME UTILIZZARE IL PULSANTE DI PAGAMENTO Il venditore, in possesso di un conto IWSMILE, potrà quindi ospitare sulle pagine del proprio sito web il pulsante di pagamento generato secondo quanto indicato nei paragrafi precedenti. Figura 15: Esempio di pulsante di pagamento tramite POS Virtuale IWSMILE Attraverso tale pulsante, collocato sul sito del venditore il compratore potrà accedere alle pagine del gateway per richiede l autorizzazione del pagamento. Successivamente alla conferma della transazione e ritorno del compratore sul sito del venditore, il sistema IWSMILE provvede a comunicare al sito del venditore, più precisamente alla pagina di conferma del pagamento che è stata specificata dal venditore stesso all interno del parametro URL_OK, tutte le informazioni relative al pagamento. Tali informazioni sono necessarie affinché il venditore possa identificare automaticamente il pagamento avvenuto e controllare i dati dello stesso (importo, quantità, ecc.). Il sistema IWSMILE provvede a comunicare le seguenti variabili del pagamento: Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 20 / 48

21 Campo thx_id payer_id payment_date payment_status payer_name payer_ amount qta custom memo Descrizione Identificativo della transazione di pagamento numero di conto di colui che ha inviato il pagamento data di invio e ricezione del pagamento Stato del pagamento Nome di colui che ha inviato il pagamento indirizzo di colui che ha inviato il pagamento Importo totale del pagamento avvenuto quantità di oggetti pagati campo personalizzato dal venditore Campo memo impostato durante il pagamento Aprile 2010 versione 8.2 Viene di seguito descritta un esempio di pagina di conferma: <%@LANGUAGE="VBScript"%> <% 'Visualizzazione dei parametri di ritorno dal sistema POS Virtuale IWSMILE response.write "thx_id: " + Request.Form("thx_id") + "<BR>" response.write "payer_id: " + Request.Form("payer_id") + "<BR>" response.write "payment_date: " + Request.Form("payment_date") + "<BR>" response.write "payment_status: " + Request.Form("payment_status") + "<BR>" response.write "payer_name: " + Request.Form("payer_name") + "<BR>" response.write "payer_ " + Request.Form("payer_ ") + "<BR>" response.write "receiver_ " + Request.Form("receiver_ ") + "<BR>" response.write "amount: " + Request.Form("amount") + "<BR>" response.write "qta: " + Request.Form("qta") + "<BR>" response.write "custom: " + Request.Form("custom") + "<BR>" response.write "memo: " + Request.Form("memo") + "<BR>" 'Attraverso la pagina di conferma chiamata dal POS 'Virtuale IWSMILE e specificata nel parametro "URL_OK" 'della form del pulsante di pagamento è possibile effettuare 'un primo controllo dei dati del pagamento %> RICEZIONE DI UNA CALLBACK AUTOMATICA DA PARTE DI IWSMILE Per migliorare il livello di sicurezza di ogni transazione di pagamento il POS VIRTUALE IWSMILE prevede un ulteriore controllo sulla provenienza della transazione stessa. Infatti, ogni volta che un acquirente effettua un pagamento con esito positivo tramite il sito web del venditore, il sistema IWSMILE chiamerà la pagina di notifica all URL specificato in sede di configurazione del POS (si veda notifica di pagamento a pag. 7 di questo documento) oppure all URL specificato direttamente nella POST di chiamata attraverso il parametro URL_CALLBACK 2 : <form action=" method="post"> <input type="hidden" name="account" value="70000xxx"> <input type="hidden" name="amount" value="2"> <input type="hidden" name="item_name" value="prova manuale"> 2 Se viene specificato l indirizzo della pagina di notifica direttamente nella POST di chiamata a IWSMILE attraverso il parametro URL_CALLBACK, il sistema prenderà il valore passato in tale parametro sovrascrivendo quello specificato alla funzione Notifica di pagamento (Pag. 7). Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 21 / 48

22 <input type="hidden" name="item_number" value="01 prova"> <input type="hidden" name="quantity" value="1"> <input type="hidden" name="note" value="1"> <input type="hidden" name="url_ok" value=" <input type="hidden" name="url_bad" value=" <input type="hidden" name="url_callback" value=" <input type="hidden" name="lang_country" value="it"> <input type="hidden" name="flag_only_iws" value="0"> <input type="image" src=" border="0" name="submit" alt="effettua i tuoi pagamenti con IWSMILE. Un sistema rapido, gratuito e sicuro."> </form> Per utilizzare questa funzione in modo corretto e permettere la consultazione dei dettagli sulla transazione, è necessario leggere il messaggio di controllo della transazione dalla variabile verify_sign e recuperare i dettagli della transazione da IWSMILE formulando un POST HTTP ad IWSMILE. Il sistema IWSMILE provvede, infatti, a comunicare alla pagina specificata nell URL di notifica 3 le seguenti variabili del pagamento, tra cui il campo VERIFY_SIGN necessario ad eseguire il controllo: Campo thx_id verify_sign payer_id payment_date payment_status payer_name payer_ amount qta custom memo Descrizione Identificativo della transazione di pagamento identificativo per la chiamata della callback numero di conto di colui che ha inviato il pagamento data di invio e ricezione del pagamento Stato del pagamento Nome di colui che ha inviato il pagamento indirizzo di colui che ha inviato il pagamento Importo totale del pagamento avvenuto quantità di oggetti pagati campo personalizzato dal venditore Campo memo impostato durante il pagamento Questa operazione viene definita sincronizzazione di notifica o semplicemente sincronizzazione. Di seguito sono suggerite alcune azioni che la vostra pagina deve eseguire nel controllare i dati precedentemente ricevuti da IWSMILE, preparare e inviare la chiamata di conferma e controllarne il risultato. 1. Controllare che le variabili ricevute in ritorno siano coerenti e integre rispetto a quelle del carrello del tuo negozio (esempio: l importo totale ricevuto deve corrispondere a quello dell ordine registrato sul tuo database); 2. Preparare la chiamata di conferma al POS Virtuale includendo i campi thxid, verifysign 4, payerid e amount e il codice di controllo d identità 5 ; 3 Il sistema IWSMILE chiama la pagina indicata come notifica di pagamento usando la porta TCP 80 oppure 443 nel caso si tratti di protocollo di comunicazione protetto HTTPS. Per ragioni di sicurezza, IWSMILE non è in grado di chiamare le pagine web che usano porte TCP diverse dall 80 o VerifySign = è un campo di controllo che ha una durata di 3 minuti. Se si tenta di utilizzare tale codice per la verifica passati 3 minuti dalla sua ricezione, il sistema non accetterà tale codice e rifiuterà la chiamata. Per ulteriori informazioni sulle variabili di risposta ricevute si veda l allegato 3 TABELLA CON POST HTML DEL PULSANTE DI PAGAMENTO. 5 Il codice di controllo d identità del venditore lo puoi trovare nella funzione Configurazione POS / Notifica Pagamento. Per ulteriori informazioni sulle variabili di risposta ricevute si veda l allegato 3 TABELLA CON POST HTML DEL PULSANTE DI PAGAMENTO. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 22 / 48

23 3. Inviare la chiamata tramite POST all indirizzo 4. Controllare il valore di ritorno della conferma ricevuta da IWSMILE: a. OK = Ordine confermato b. KO = Ordine non confermato c. IR = Richiesta non valida d. EX = Tempo di richiesta conferma scaduto Segue un esempio di gestione callback in linguaggio VBScript: <%@LANGUAGE="VBScript"%> <% Dim objhttp, str Dim objfso, objtextfile ' Apertura del file per la memorizzazione dei dati ricevuti in ritorno dal POS Virtuale IWSMILE Set objfso = CreateObject("Scripting.FileSystemObject") Set objtextfile = objfso.createtextfile("c:\inetpub\risposta callback.txt") 'Salvataggio di tutta la stringa delle variabili ricevuta objtextfile.writeline "STREAM:" objtextfile.writeline Request.Form 'Salvataggio dei singoli parametri objtextfile.writeline "CAMPI:" response.write "thx_id: " + Request.Form("thx_id") response.write "verify_sign: " + Request.Form("verify_sign") response.write "payer_id: " + Request.Form("payer_id") response.write "payment_date: " + Request.Form("payment_date") response.write "payment_status: " + Request.Form("payment_status") response.write "payer_name: " + Request.Form("payer_name") response.write "payer_ " + Request.Form("payer_ ") response.write "receiver_ " + Request.Form("receiver_ ") response.write "amount: " + Request.Form("amount") response.write "qta: " + Request.Form("qta") response.write "custom: " + Request.Form("custom") response.write "memo: " + Request.Form("memo") '*** ESECUZIONE Controllo delle variabili ricevute con i dati interni del carrello ' If not(controllook) then 'ERRORE: Exit page 'ElseIf '*** Preparazione chiamata di conferma al POS Virtuale IWSMILE 'Crazione stringa dei parametri str = "thx_id=" + Request.Form("thx_id") + "&amount=" + Request.Form("amount") + "&verify_sign=" + Request.Form("verify_sign") + "&payer_id=" + Request.Form("payer_id") + "&merchant_key= MODIFICARE_CON_IL_PROPRIO_CODICE_SEGRETO" objtextfile.writeline "Stringa: " + str 'Preparazione della chiamata al POS Virtuale IWSMILE set objhttp = Server.CreateObject("Msxml2.ServerXMLHTTP") objhttp.open "POST", " false objhttp.setrequestheader "Content-type", "application/x-www-form-urlencoded" objhttp.send str 'Verifica della risposta di conferma da parte del POS Virtuale IWSMILE if (objhttp.status <> 200 ) then Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 23 / 48

24 ' HTTP error handling elseif (objhttp.responsetext = "OK") then 'Ordine di pagamento VERIFICATO objtextfile.writeline "VERIFICATO!!!" Aprile 2010 versione 8.2 elseif (objhttp.responsetext = "KO") then 'Ordine di pagamento NON VERIFICATO objtextfile.writeline "NON VERIFICATO!!!" elseif (objhttp.responsetext = "IR") then 'Richiesta di conferma non VALIDA: controllare i dati e la stringa dei parametri creata per la richiesta objtextfile.writeline "INVALID REQUEST!!!" elseif (objhttp.responsetext = "EX") then 'Parametro "verify_sign" scaduto objtextfile.writeline "EXPIRED!!!" else objtextfile.writeline "E' AVVENUTO UN ERRORE!!!" end if objtextfile.close Set objtextfile = Nothing Set objfso = Nothing set objhttp = nothing %> Segue un ulteriore esempio di gestione callback in linguaggio PHP con controllo del risultato ricevuto: <?php //Mi faccio restituire i parametri di request $payer_id = $_REQUEST["payer_id"]; $thx_id = $_REQUEST["thx_id"]; $verify_sign = $_REQUEST["verify_sign"]; $amount = $_REQUEST["amount"]; $codice_segreto = 'MODIFICARE_CON_IL_PROPRIO_CODICE_SEGRETO'; //Inserire il merchant_key indicato all'interno del sito IWSMILE su POS VIRTUALE/Configurazione/Notifica Pagamento. $str = "thx_id=".$thx_id."&amount=".$amount."&verify_sign=".$verify_sign; $str.= "&payer_id=".$payer_id; $str.= "&merchant_key=".$codice_segreto; $url = " $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_POSTFIELDS, $str); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); curl_setopt($ch, CURLOPT_POST, TRUE); $content = curl_exec ($ch); $c_error = "NONE"; Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 24 / 48

25 $ret = 'NON DISPONIBILE'; if (curl_errno($ch)!= 0) { $c_error = curl_error($ch); }else{ if(strstr($content,"ok")) { // Ordine di pagamento VERIFICATO $ret='verificato'; Aprile 2010 versione 8.2 } elseif(strstr($content,"ko")) { // Ordine di pagamento NON VERIFICATO $ret='non VERIFICATO'; } elseif(strstr($content,"ir")) { // Richiesta di conferma non VALIDA: controllare i dati e la stringa dei parametri creata per la richiesta $ret='richiesta NON VALIDA'; } } elseif(strstr($content,"ex")) { // Parametro "verify_sign" scaduto $ret='richiesta SCADUTA'; } curl_close ($ch); $handle = fopen($_server['document_root']."/risultati.html", "a"); fwrite($handle, "NOTIFICA VERSO ".$url."<br>\n"); fwrite($handle, "merchant_key: ".$codice_segreto."<br>\n"); fwrite($handle, "payer_id: ".$payer_id."<br>\n"); fwrite($handle, "thx_id: ".$thx_id."<br>\n"); fwrite($handle, "verify_sign: ".$verify_sign."<br>\n"); fwrite($handle, "amount: ".$amount."<br>\n"); fwrite($handle, "STRING: ".$str."<br>\n"); fwrite($handle, "CURL Error: ".$c_error."<br>\n"); fwrite($handle, "DECODIFICA RISULTATO: ".$ret." \n<br>\n [".$content."]<br><br>\n"); fclose($handle); echo "Correttamente elaborato.";?> VALUTE SUPPORTATE DAL SISTEMA Il POS VIRTUALE IWSMILE gestisce la divisa Euro. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 25 / 48

26 3.2 RIMBORSI ALLA CLIENTELA Il sistema permette al venditore di generare un rimborso totale o parziale di un pagamento ricevuto tramite il sistema di IWSMILE POS VIRTUALE. Il venditore decide in completa autonomia se, e quanto, rimborsare al proprio compratore. La tempistica necessaria per l accredito del rimborso al compratore dipende dalla fonte di finanziamento utilizzata per il pagamento originario (saldo del conto o carta di credito o prepagata). Nota: Il sistema permette il rimborso (parziale o completo) del pagamento originale soltanto su iniziativa del venditore: il compratore che volesse essere rimborsato - per qualsiasi ragione - dovrà attivarsi autonomamente verso il venditore. Rimborso totale: in tale caso il compratore viene rimborsato dell intero importo originale della transazione di pagamento eseguita. Al venditore viene addebitato l intero importo originale della transazione. Il sistema restituisce per intero al venditore la commissione sostenuta al momento del pagamento ricevuto. Rimborso parziale: in tale caso compratore viene rimborsato di parte dell importo originale della transazione di pagamento eseguita. Al venditore viene addebitato parte dell importo originale della transazione. Il cliente all interno della sezione Elenco Operazioni POS Virtuale può posizionarsi sul pagamento ricevuto a mezzo POS Virtuale che intende rimborsare al cliente. Figura 16: Maschera dei pagamenti inviati e ricevuti tramite POS Virtuale Nella colonna rimborso (ultima colonna a destra) il Venditore può cliccare sull apposita icona : per mostrare il dettaglio della transazione da rimborsare. Il sistema visualizzerà le seguente maschera: Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 26 / 48

27 Figura 17: Maschera per il rimborso di un pagamento ricevuto Il venditore inserisce l'importo del rimborso che intende effettuare e preme il pulsante Calcola. Il sistema determinerà automaticamente le commissioni rimborsabili da accreditare sul conto IWSMILE del venditore in base a una percentuale calcolata sull'importo del rimborso. Il sistema permette inoltre al venditore di inserire delle note opzionali destinate al proprio compratore. Nota: il sistema permette il rimborso completo o parziale per un periodo di 60 giorni dalla ricezione del pagamento originario. Al completamento della transazione di rimborso, il POS VIRTUALE procede con l invio in automatico dell di conferma del rimborso totale o parziale sia verso il compratore, sia verso il venditore. Le conterranno tutte le informazioni attinenti alla transazione. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 27 / 48

28 4. IL POS VIRTUALE IWSMILE per il compratore 4.1 SCHEMA DEL FLUSSO DI PAGAMENTO Il cliente che intende effettuare l acquisto di un bene o servizio presso il sito del venditore, clicca sul pulsante IWSMILE e in tal modo è generata una transazione di pagamento elettronica. Segue rappresentazione dello schema dell operazione di pagamento attraverso il POS VIRTUALE IWSMILE: 2) Il compratore al momento del PAGAMENTO è re-direzionato sul server IWSMILE 3) IWSMILE (solo per pagamenti a mezzo carta di credito) A) richiede l autorizzazione ai circuiti internazionali B) riceve la risposta dai Circuiti Internazionali COMPRATORE 1) Il compratore naviga sul sito del venditore VENDITORE (Cliente IWSMILE) POS VIRTUALE IWSMILE 4) Al completamento della transazione Il sistema reindirizza al Venditore Circuiti Internazionali Visa / MC 4.2 MASCHERA DI INTRODUZIONE DEL POS VIRTUALE Il compratore che accede al sito del Venditore (oppure che riceve l con il link al POS VIRTUALE IWSMILE) se clicca sul pulsante di pagamento avrà la possibilità di eseguire il pagamento secondo le seguenti modalità. 1. Se il compratore è già cliente IWSMILE/IWBANK potrà completare il pagamento - in tre semplici passi - mediante l inserimento della propria User, della Password di accesso e di quella dispositiva (o del Token se previsto); 2. Se il compratore è già un titolare di carta di credito o prepagata potrà comunque completare la transazione inserendo qualche informazione aggiuntiva. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 28 / 48

29 Figura 18: Maschera introduttiva del POS Virtuale IWSMILE 4.3 PAGAMENTO ESEGUITO DA CLIENTE IWSMILE/IWBANK STEP 1 - LOGIN Il cliente già in possesso del conto IWSMILE/IWBANK dovrà quindi identificarsi attraverso la propria Login e Password inserendoli negli appositi campi contenuti nella sezione sopra evidenziata. Alla pressione del pulsante Acquista il compratore effettua l accesso al sistema IWSMILE e può quindi procedere con la transazione. Il pulsante Annulla permette all utente di uscire dalla procedura di pagamento e di essere redirezionato alla pagina di URL_BAD del venditore. Nel caso in cui tale pagina non sia stata impostata in precedenza il pulsante ANNULLA non sarà visualizzato STEP 2 - CONFERMA Una volta identificato il cliente compratore, il POS VIRTUALE nell apposita pagina di conferma sintetizza al compratore tutti i dati relativi alla transazione che sta per effettuare. Il cliente controlla che le informazioni inserite siano corrette e procede all inserimento della propria password dispositiva (o del token se previsto) e conclude la transazione (cliccando su CONFERMA ). Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 29 / 48

30 Il pulsante ANNULLA permette all utente/compratore di ripensare alla conclusione della transazione, tornando alla pagina del Venditore (sempre che questi l abbia precedentemente configurato POS VIRTUALE / Configurazione / Configurazione POS). Il POS VIRTUALE eseguirà un controllo in merito alla disponibilità della moneta elettronica presente sul conto associato al compratore identificato e si comporterà in modo diverso a seconda dei casi. Nel caso in cui il saldo sia maggiore o uguale dell importo della transazione di pagamento, allora il finanziamento avverrà con la moneta elettronica disponibile sul conto stesso. Nel caso in cui il saldo sia insufficiente per finanziare la transazione allora il POS Virtuale proporrà altre forme di pagamento ovvero tutti gli strumenti di pagamento associati al conto stesso (carte di credito, carte prepagate). Nel caso in cui il saldo non sia sufficiente ed il cliente non abbia nessuno strumento di pagamento associati al conto il sistema visualizzerà un messaggio di errore ed il compratore non potrà proseguire nella transazione. Alla pressione del pulsante Conferma, il sistema IWSMILE effettuerà le dovute verifiche per il finanziamento della transazione e procede ad accreditare il conto del Venditore ed addebitare il conto del compratore (o la carta di credito associata al conto stesso). Segue rappresentazione della relativa maschera: Figura 19: Maschera di riepilogo del pagamento STEP 3 ESITO DEL PAGAMENTO A completamento della transazione, il sistema IWSMILE visualizza la pagina di conferma permettendo all utente di essere redirezionato nuovamente al sito web del venditore. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 30 / 48

31 Viene di seguito rappresentata la pagina di conferma del pagamento con IWSMILE/IWBANK: Figura 20: Maschera di conferma del pagamento Il pulsante TORNA AL VENDITORE disponibile nel solo caso in cui il venditore l abbia impostato nella apposita sezione (cfr. par. 2.2), permette all utente di uscire dalla procedura di pagamento e di essere redirezionato sulla pagina del venditore. Sul sito del Venditore il compratore potrà decidere di effettuare altri acquisti oppure di navigare sul Web. 4.4 PAGAMENTO ESEGUITO DA TITOLARE DI CARTA DI CREDITO O PREPAGATA Attraverso questa modalità, il POS consente altresì il pagamento ad un titolare di carta di credito o prepagata completando la transazione inserendo qualche informazione aggiuntiva STEP 1 MASCHERA INSERIMENTO DATI TITOLARE Il Titolare di carta deve inserire tutte le informazioni necessarie al completamento della transazione: Cognome: inserire il cognome dell intestatario della carta di pagamento che s intende utilizzare per il completamento della transazione. Nome: inserire il nome dell intestatario della carta di pagamento che si intende utilizzare per il completamento della transazione. Indirizzo inserire l indirizzo del compratore. Attraverso tale indirizzo il Venditore potrà contattarti per qualsiasi informazione (il venditore riceverà nelle di conferma le informazioni da te inserite). Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 31 / 48

32 Tel. Cellulare: inserire il numero di cellulare se si desidera essere contattato dal Venditore per qualsiasi informazione (il venditore riceverà nelle il numero da te inserito). La compilazione di tale campo è facoltativa. Nome Skype : inserire il proprio account Skype se si desidera essere contattati dal Venditore per qualsiasi informazione. La compilazione di tale campo è facoltativa. Carta di credito: selezionare il tipo di carta di credito (Visa, Visa Electron, MasterCard), il numero della carta, la data di scadenza ed il CVV2 relativi alla carta di pagamento che si vuole utilizzare per completare il pagamento. Successivamente il cliente appone il flag sull informativa relativa alla privacy e conclude il pagamento cliccando sul pulsante Conferma. Figura 21: Maschera di inserimento dati STEP 2 MASCHERA RIEPILOGO E CONFERMA OPERAZIONE Una volta inserite tutte le informazioni necessarie, il cliente compratore controlla che le informazioni inserite siano corrette e procede alla conferma concludendo la transazione. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 32 / 48

33 Il pulsante Modifica permette al compratore di modificare i dati inseriti qualora si volesse modificare qualche informazione errata inserita in precedenza. Confermando invece la transazione il POS VIRTUALE eseguirà un controllo in merito alla disponibilità della carta e procederà con l accredito immediato del conto del Venditore e all addebito della carta di pagamento utilizzata per il finanziamento della transazione. Segue rappresentazione della relativa maschera: Figura 22: Maschera di riepilogo del pagamento STEP 3 ESITO DEL PAGAMENTO A completamento della transazione, il sistema IWSMILE visualizza la pagina di conferma permettendo all utente di essere redirezionato nuovamente al sito web del venditore. Viene di seguito rappresentata la pagina di conferma del pagamento con IWSMILE: Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 33 / 48

34 Figura 23: Maschera di conferma del pagamento 4.5 INVIO DELLE DI CONFERMA Il POS VIRTUALE al completamento della transazione procede con l invio in automatico delle di conferma invio e ricezione pagamento sia verso il compratore e sia verso il venditore. Le conterranno tutte le informazioni attinenti alla transazione. IWSMILE al Cliente Compratore: Oggetto: Notifica pagamento eseguito POS Virtuale From: To: Gentile Enzo Bianchi info@iwsmile.it e.bianchi@iwbank.it Ti informiamo che il pagamento verso Mario Rossi n. conto IWSMILE e' avvenuto correttamente. Informazioni sul pagamento: Identificativo della transazione: lhtmnzloiryzliustfusxkwyibfubbui Pagamento per: nome del bene acquistato Importo totale: Divisa Euro Data: gg/mm/aaaa Ora: 12:05:46 Tipo di finanziamento:carta XXXXXXXXXXXX4532 / saldo IWSMILE IWSMILE al Cliente Venditore Oggetto: Notifica pagamento ricevuto POS Virtuale From: To: Gentile Mario Rossi info@iwsmile.it m.rossi@iwbank.it Ti informiamo che hai appena ricevuto un pagamento da Enzo Bianchi. Informazioni sul pagamento: Identificativo della transazione: lhtmnzloiryzliustfusxkwyibfubbui Pagamento per: nome del bene venduto Importo totale: Divisa Euro; Importo delle commissioni: 1.35 EUR Ammontare netto: EUR Data: gg/mm/aaaa Ora: 12:05:46 Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 34 / 48

35 Informazioni sul Venditore: Informazioni sul Compratore: Aprile 2010 versione 8.2 Insegna: Mario Rossi scarpe italiane / non disponibile Conto IWSMILE Venditore: Nome e Cognome: Mario Rossi del Venditore: e.bianchi@iwbank.it Identificativo Skype: rossino Telefono assistenza clienti: 02/ assistenza clienti: 02/ Informazioni sul tuo / vostro conto: Ti informiamo che a seguito del pagamento eseguito il saldo del tuo conto IWSMILE è: N pari a Euro Per altre Informazioni: Per qualsiasi chiarimento o per ulteriori informazioni non esitare a: - consultare il sito web IWSMILE; - contattare i nostri operatori tramite chat direttamente dalle pagine del sito (cliccare il bottone "parla con noi"); - inviare una all'indirizzo info.commerciali@iwsmile.it. Cordiali Saluti Il Customer Care IW BANK S.p.A Nome e Cognome: Enzo Bianchi del compratore: e.bianchi@iwbank.it Cellulare: non disponibile Identificativo Skype: bianchino Nota del compratore: per favore spedite la merce qui e non li Informazioni sul tuo / vostro conto IWSMILE: Ti informiamo informiamo che a seguito del pagamento ricevuto il saldo del tuo / vostro conto IWSMILE è: N pari a Euro Per altre Informazioni: Per qualsiasi chiarimento o per ulteriori informazioni non esitare a: - consultare il sito web IWSMILE; - contattare i nostri operatori tramite chat direttamente dalle pagine del sito (cliccare il bottone "parla con noi"); - inviare una all'indirizzo info.commerciali@iwsmile.it. Cordiali Saluti Il Customer Care IW BANK S.p.A 4.6 PAGAMENTO ESEGUITO DA CLIENTE NON ITALIANO Il cliente compratore di lingua non italiana ha la possibilità di inviare pagamenti al venditore in modo facile grazie alla possibilità di selezionare la lingua all interno del POS Virtuale. Oltre alla lingua Italiana, le lingue disponibili sono le seguenti: - Inglese - Francese - Tedesco - Spagnolo Il compratore può selezionare la lingua corrispondente cliccando nella bandierina corrispondente in alto a destra del POS Virtuale, come da figura successiva: Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 35 / 48

36 Per cambiare lingua è necessario cliccare sulla bandierina corrispondente Figura 24: Selezione della lingua del POS virtuale Una volta eseguita la transazione di pagamento, le di notifica del pagamento ricevute dal compratore conterranno tutte le informazioni attinenti alla transazione rappresentate nella lingua selezionata dal compratore. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 36 / 48

37 5. ELENCO OPERAZIONI POS VIRTUALE All intero della sezione POS VIRTUALE / Operazioni POS / Elenco operazioni POS Virtuale è prevista un apposita sottosezione dove il cliente IWSmile (compratore o venditore che sia) può vedere l elenco completo delle transazioni generate con il POS Virtuale. Figura 25: Maschera di elenco dei pagamenti inviati e ricevuti Il cliente mediante la selezione dei filtri ha la possibilità di scegliere la visualizzazione delle operazioni effettuate. In modo particolare potrà consultare ogni: o pagamento effettuato a mezzo POS VIRTUALE (in qualità di compratore); o pagamento ricevuto a mezzo POS VIRTUALE (nel suo ruolo di venditore); o rimborso ricevuto (nel suo ruolo di compratore); o rimborso eseguito (nel suo ruolo di venditore); Nota: Il sistema permette il rimborso (parziale o completo) del pagamento originale soltanto su iniziativa del venditore. Il compratore che volesse essere rimborsato - per qualsiasi ragione - dovrà attivarsi autonomamente verso il venditore. Figura 26: Filtro per la visualizzazione dei pagamenti inviati e ricevuti Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 37 / 48

38 Cliccando sull icona verde posta nella colonna info il cliente potrà visualizzare il dettaglio corrispondente del movimento: Figura 27: Dettaglio pagamento inviato o ricevuto Il dettaglio del movimento contiene tutti dati attinenti all operazione (eseguita o ricevuta). Tra le altre informazioni disponibili segnaliamo l identificativo della transazione - che identifica la transazione in modo univoco - e il numero dell oggetto che il venditore attribuisce ai beni e servizi che ha venduto. Quest ultimo codice può essere utile per esigenze legate all organizzazione, alla logistica ed alla spedizione dei propri prodotti. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 38 / 48

39 6. NOTE LEGALI La Banca è estranea al rapporto di compravendita che si instaura tra venditore e compratore. La Banca tramite IWSMILE mette a disposizione della propria clientela il sistema di pagamento POS VIRTUALE che permette al venditore di ricevere pagamenti a fronte della vendita di beni/servizi. Tale aspetto è di esclusiva competenza e responsabilità del venditore stesso. La Banca si limita a prestare un servizio di pagamento a favore dei Clienti, con la conseguenza che la Banca medesima è del tutto estranea ai rapporti instaurati o che saranno instaurati tra il Soggetto che effettua il pagamento e il Cliente che riceve il pagamento. La Banca ha il diritto di addebitare di propria iniziativa il conto del Cliente, anche nell interesse di terzi, di quanto già corrisposto per eventuali contestazioni o reclami relativi a rapporti instaurati tra il Soggetto che effettua il pagamento e il Cliente che lo riceve. I Clienti, diversi dai Clienti-professionisti, danno atto e garantiscono, nel caso in cui ricevano pagamenti a mezzo POS Virtuale: o che la vendita di beni e/o servizi ha natura occasionale e non configura lo svolgimento di alcuna attività imprenditoriale e/o professionale; o che la vendita di beni e/o servizi è legittima e non è soggetta a limitazioni e/o restrizioni di qualunque tipo in forza delle disposizioni normative tempo per tempo vigenti; Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 39 / 48

40 7. ASSISTENZA Il Customer Care è a completa disposizione della clientela per tutte le informazioni relative al conto di pagamento e alle attività gestite in esso. Per qualsiasi chiarimento o per informazioni sul conto IWSMILE non esitare a: - Contattare gli operatori tramite chat direttamente dalle pagine del sito (cliccare il bottone "parla con noi"). Il servizio di chat è disponibile dal lunedì al venerdì dalle ore 8.00 alle ore Inviare una all'indirizzo info@iwsmile.it Per informazioni su pagamenti sospetti, contestazioni o informazioni tecniche sul POS virtuale: - Contattare gli operatori tramite telefono diretto del supporto: Il servizio è disponibile dal Lunedì al Venerdì dalle ore 9.00 alle ore Inviare una all'indirizzo pagamenti@iwsmile.it Per qualsiasi verifica tecnica sulla disponibilità del servizio POS Virtuale: - Contattare gli operatori tramite telefono diretto del supporto tecnico sempre attivo (H24 7gg su 7gg): ; - Inviare una all'indirizzo it.supporto@iwbank.it Per qualsiasi informazione attinente al bene o servizio acquistato (difformità della merce, merce non consegnata, ecc.) si invita la clientela a rivolgersi direttamente al venditore. A tal fine IWSMILE ha predisposto alcuni meccanismi quale il pulsante Skype e la diffusa presenza dell indirizzo del venditore, nelle informazioni relative al pagamento. Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 40 / 48

41 8. ALLEGATI ALLEGATO 1 SCHEMA LOGICO DEL FLUSSO DI PAGAMENTO Sito WEB Del Venditore (pulsante POS Virtuale) First Page IWS SI Il Compratore ha ha un Conto IWSMILE/IWBANK? NO Il Compratore esegue login e password Compratore ha una carta di pagamento NO Il Compratore non può completare la transazione SI Compratore Inserisce le info necessarie (dati carta, altre info) Riepilogo informazioni Inserimento Psw dispositiva Conferma pagamento Riepilogo informazioni Conferma OK Richiesta Autorizzazione KO Operazione conclusa Torna al Venditore Il Compratore non può completare la transazione Il contenuto di questo documento ha carattere strettamente riservato e non può essere rivelato a terzi. 41 / 48