MonetaWeb 2.0 - Documentazione Tecnica
MonetaWeb 2.0 - Documentazione Tecnica
Giugno 2017
MonetaWeb 2.0
INDICE
1.INTRODUZIONE...................................................................................................5
2.SPECIFICHE DI UTILIZZO DEI SERVIZI...................................................................6
SPECIFICHE DI CHIAMATA......................................................................................................... 6
SPECIFICHE DI RISPOSTA.......................................................................................................... 6
CERTIFICATI DI SICUREZZA...................................................................................................... 7
3.PROTOCOLLI DI PAGAMENTO...............................................................................8
3.1.PROTOCOLLO PER PAGAMENTI E-COMMERCE NON SICURO E MO.TO....................8
INVIO DEL MESSAGGIO DI PAGAMENTO....................................................................................8
RICEZIONE DEL MESSAGGIO DI ESITO......................................................................................9
CASI DI ERRORE..................................................................................................................... 10
3.2.PROTOCOLLO XML HOSTED 3DSECURE............................................................11
INIZIALIZZAZIONE DEL PAGAMENTO......................................................................................13
NOTIFICA DELLESITO DEL PAGAMENTO.................................................................................15
CASI DI ERRORE..................................................................................................................... 17
3.3.PROTOCOLLO XML SERVER TO SERVER 3D SECURE..........................................19
VERIFY ENROLLMENT............................................................................................................. 21
AUTENTICAZIONE 3D SECURE, REDIREZIONE DEL TITOLARE.................................................25
VERIFY PARES......................................................................................................................... 25
PAY......................................................................................................................................... 27
PAYTHREESTEP....................................................................................................................... 28
3.4.PAGAMENTO MYBANK (SEPA CREDIT TRANSFERT)............................................31
INIZIALIZZAZIONE DEL PAGAMENTO MYBANK........................................................................32
NOTIFICA DELLESITO DEL PAGAMENTO.................................................................................34
CASI DI ERRORE..................................................................................................................... 36
3.5.PAGAMENTO PAYPAL......................................................................................37
INIZIALIZZAZIONE DEL PAGAMENTO......................................................................................38
NOTIFICA DELLESITO DEL PAGAMENTO.................................................................................39
CASI DI ERRORE..................................................................................................................... 41
3.6.PAGAMENTO MASTERPASS.............................................................................43
INIZIALIZZAZIONE DEL PAGAMENTO......................................................................................43
NOTIFICA DELLESITO DEL PAGAMENTO.................................................................................45
CASI DI ERRORE..................................................................................................................... 48
3.7.PAGAMENTO ALIPAY.......................................................................................49
INIZIALIZZAZIONE DEL PAGAMENTO......................................................................................50
NOTIFICA DELLESITO DEL PAGAMENTO.................................................................................52
NOTIFICA ASINCRONA DEL CAMBIO DI STATO DEL PAGAMENTO............................................54
CASI DI ERRORE..................................................................................................................... 55
4.MONETAWALLET (TOKENIZZAZIONE) - PAGAMENTI RICORRENTI ..........................56
4.1.ATTIVAZIONE................................................................................................. 56
4.2.PAGAMENTI SUCCESSIVI.................................................................................56
1. Introduzione
MonetaWeb un POS virtuale di ultima generazione progettato per chi, tramite un sito
internet, vuole vendere merci o servizi gestendo i pagamenti on line con carta di credito.
Facilit di integrazione
MonetaWeb 2.0 una piattaforma di pagamento elettronico che mette a disposizione dei
clienti una suite di protocolli e un set di metodi di pagamento a seconda delle specifiche
esigenze.
Questo documento si propone come guida per gli sviluppatori, non tralasciando l'aspetto
funzionale.
Questa documentazione tecnica tutto quello che serve per poter comprendere i protocolli
di pagamento on-line e poterli testare in totale autonomia.
SPECIFICHE DI CHIAMATA
Protocollo
HTTPS
Metodo
POST
Content-Type
application/x-www-form-urlencoded
URL DI TEST
https://test.monetaonline.it/monetaweb/payment/2/xml
URL DI PRODUZIONE
https://www.monetaonline.it/monetaweb/payment/2/xml
SPECIFICHE DI RISPOSTA
I messaggi di risposta alla chiamata ad uno dei servizi sincroni utilizzano il formato XML.
All'interno del paragrafo di ogni protocollo di pagamento, sono riportati degli esempi con il tracciato
corretto.
CERTIFICATI DI SICUREZZA
Assicurarsi di avere installato i certificati per gli ambienti di TEST e di PRODUZIONE, riportati di
seguito:
3. Protocolli di Pagamento
3.1. Protocollo per pagamenti E-commerce non sicuro e MO.TO.
Con la parola MO.TO. (Mail Order/Telephone Order) indichiamo i pagamenti effettuati in
modalit Server to Server, nei quali non viene richiesta lautenticazione 3DSecure del titolare.
In questi casi, la fase di pagamento si esaurisce con linvio verso MonetaWeb di un messaggio
in POST contenente tutti i dati necessari per effettuare il pagamento e la ricezione di una
risposta in modalit sincrona contenente lesito del pagamento stesso. Nei casi in cui
previsto che il titolare sottoponga i dati relativi alla propria carta di credito direttamente al
sistema del Commerciante, lo stesso soggetto alle normative PCI; Setefi si riserva la
possibilit di richiedere un documento che ne attesti la certificazione.
id=99999999&password=99999999&operationType=pay&amount=1.00¤cyCode=978&Merc
hantOrderId=TrackingNo12345&description=Descrizione&cardHolderName=NomeCognome&card
=1234567890123456&cvv2=123&expiryMonth=09&expiryYear=2015&customField=campoPerson
alizzabile
<response>
<result>APPROVED</result>
<authorizationcode>123456</authorizationcode>
<paymentid>123456789012345678</paymentid>
<merchantorderid>TrackingNo12345</merchantorderid>
<customfield>campoPersonalizzabile</customfield>
<rrn>123456789012</rrn>
<responsecode>000</responsecode>
<description>Descrizione</description>
<cardcountry>ITALY</cardcountry>
<cardtype>VISA</cardtype> (solo se il terminale abilitato alla funzionalit)
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di pagamento:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
[Web]: phoenix.css
[Mobile]: phoenix-mobile.css
Sia il logo che i file CSS modificati devono essere inviati via mail al servizio di supporto
Commercio Elettronico per la validazione e la pubblicazione. Il logo deve essere in formato
grafico (jpeg o png) e con una dimensione in larghezza massima di 350 pixel e altezza libera.
Il cookie generato dalla pagina di pagamento durante la navigazione di tipo tecnico, quindi
utilizzato solo a scopi statistici e non commerciali.
Per ulteriori dettagli, si rimanda alla consultazione del documento alla pagina:
http://www.mercurypayments.it/PortaleIstituzionale/file/cookie_policy.pdf.
1. Il titolare carta effettua un acquisto sul sito del commerciante; i dati del pagamento sono
trasmessi al server del Commerciante
2. Il server del Commerciante inizializza il pagamento con un messaggio HTTP Post
3. MonetaWeb valida linizializzazione
4. MonetaWeb restituisce il PaymentID, un security token e la URL della Hosted Payment
Page
5. Il server del Commerciante redirige il titolare carta verso la HPP usando come parametro il
PaymentID
6. Il titolare carta riempie la form con i dati sensibili della carta di credito
7. MonetaWeb storicizza i dati del pagamento
8. MonetaWeb invia una Verify Enrollment Request (VEReq) ai Directory Server dei Circuiti
8A. I Directory Server dei Circuiti redirigono la richiesta verso lIssuer
8B. LIssuer replica verso i Directory Server dei Circuiti con lesito dellenrollment e la
URL dellAccess Control Server (ACS)
9. Directory Server dei Circuiti rispondono con una Verify Enrollment Response (VERes)
9A. MonetaWeb redirige il titolare carta verso lACS dellIssuer con la Payment
Authentication Request (PAReq)
9B. LACS risponde con la Payment Authentication Response (PARes)
10. MonetaWeb invia in modalit server to server lesito del pagamento alla ResponseURL
del Commerciante
11. MonetaWeb legge la ResultURL restituita dinamicamente dal Commerciante allinterno
della pagina ResponseURL
12. Monetaweb redirige il titolare carta verso la ResultURL
Per le seguenti operazioni seguire le specifiche dei messaggi Server to Server indicate nei
seguenti capitoli:
conferma del pagamento
storno contabile
annullamento dell'autorizzazione
inquiry
id=99999999&password=99999999&operationType=initialize&amount=1.00¤cyCode=978&
language=ITA&responseToMerchantUrl=http://www.merchant.it/notify.jsp&
recoveryUrl=http://www.merchant.it/error.jsp&merchantOrderId=TRCK0001&description=Descrizio
ne&
cardHolderName=NomeCognome&[email protected]&
customField=campoPersonalizzabile
<response>
<paymentid>123456789012345678</paymentid>
<securitytoken>80957febda6a467c82d34da0e0673a6e</securitytoken>
<hostedpageurl>https://www.monetaonline.it/monetaweb/</hostedpageurl>
</response>
Una volta raggiunta questa pagina, il titolare carta inserir i dati della propria carta di credito e, se
la carta partecipa al protoccollo 3D Secure, verr richiesto anche linserimento della relativa
password 3D Secure.
pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE
l'intervento andr schedulato con almeno un mese di anticipo.
Nel caso in cui la comunicazione dellurl di redirezione del titolare dovesse fallire (indisponibilit
della pagina responseToMerchantUrl, contenuto della pagina responseToMerchantUrl non valido,
timeout nella risposta o certificato non riconosciuto) Monetaweb reindirizzer il titolare verso la
pagina recoveryUrl, che viene comunicata dal Commerciante stesso tramite lapposito parametro
del messaggio di Inizializzazione. Qualora il parametro recoveryUrl non fosse stato valorizzato
MonetaWeb redireger il titolare verso una pagina di cortesia, pubblicata direttamente sul server
MonetaWeb.
Dalla pagina di dettaglio della transazione, dal portale di Back-Office, possibile visualizzare gli
errori di notifica con la relativa causale.
Transazione autorizzata:
authorizationcode=85963&cardcountry=ITALY&cardexpirydate=0115&cardtype=VISA&
customfield=some custom field&maskedpan=483054******1294&
merchantorderid=TRCK0001&paymentid=123456789012345678&responsecode=000&
result=APPROVED&rrn=123456789012&securitytoken=80957febda6a467c82d34da0e0673a6e&t
hreedsecure=S
CASI DI ERRORE
Fase di Inizializzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
Fase di Notifica:
Nel caso in cui non sia possibile completare il pagamento (es. autenticazione 3DSecure fallita)
MonetaWeb notifica il Commerciante con un messaggio di errore in formato NVP.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
- il riferimento alla transazione
Caso Enrolled
1. Il titolare carta effettua un pagamento tramite il sito del Commerciante; i dati del pagamento
sono trasmessi al server del Commerciante
2. Il server del Commerciante invia un messaggio di tipo VerifyEnrollment a MonetaWeb per
verificare la partecipazione della carta al protocollo 3D Secure
3. MonetaWeb invia una VEReq (Verify Enrollment Request) al dominio di interoperabilit
Visa/Mastercard
3A. Visa/Mastercard gira la richiesta allIssuer
3B. LIssuer risponde a Visa/Mastercard con lesito e la URL dellACS (Access Control
Server)
4. Visa/Mastercard risponde con la VERes (Verify Enrollment Response)
5. MonetaWeb invia al server del Commerciante lesito della verifica di partecipazione della
carta al protocollo 3D Secure e la PAReq (Payment Authentication Request)
6. Il server del Commerciante redirige il titolare carta verso lACS dellIssuer unitamente alla
PAReq
7. Completata l'autenticazione, lACS redirige il titolare verso la pagina di ritorno del
Commerciante passando come parametro la PARes (Payment Authentication Response)
1. Il titolare carta effettua un pagamento tramite il sito del Commerciante; i dati del pagamento
sono trasmessi al server del Commerciante
2. Il server del Commerciante invia un messaggio di tipo VerifyEnrollment a MonetaWeb per
verificare la partecipazione della carta al protocollo 3D Secure
3. MonetaWeb invia un messaggio VEReq (Verify Enrollment Request) al dominio di
interoperabilit Visa/Mastercard
3A. Visa/Mastercard gira la richiesta allIssuer
3B. LIssuer risponde a Visa/Mastercard con lesito della verifica
4. Visa/Mastercard risponde con il messaggio VERes (Verify Enrollment Response)
5. MonetaWeb risponde al Commerciante segnalando che la carta non deve effettuare
l'autenticazione.
6. Il Commerciante invia a Setefi una richiesta di autorizzazione
(operationtype=PAYTHREESTEP) completa di tutti i dati (dati ordine, dati carta, flag ECI)
7. MonetaWeb processa la richiesta di autorizzazione e restituisce l'esito al Commerciante.
1. Il titolare carta effettua un pagamento tramite il sito del Commerciante; i dati del pagamento
sono trasmessi al server del Commerciante
2. Il server del Commerciante invia un messaggio di tipo VerifyEnrollment a MonetaWeb
3. MonetaWeb verifica la partecipazione della carta al protocollo 3D Secure
4. MonetaWeb risponde al Commerciante segnalando che la carta non partecipa al protocollo
3DS
5. Il Commerciante invia a Setefi una richiesta di autorizzazione NO3D (operationtype=PAY)
completa di tutti i dati (dati ordine, dati carta, ...)
6. MonetaWeb processa la richiesta di autorizzazione e restituisce l'esito al Commerciante.
Per le seguenti operazioni seguire le specifiche dei messaggi Server to Server indicate nei
seguenti capitoli:
conferma del pagamento
storno contabile
annullamento dell'autorizzazione
inquiry
VERIFY ENROLLMENT
Allinterno del flow per i pagamenti Server to Server, la servlet esposta per la verifica
dellenrollment della carta; riceve in input i dati del pagamento, compresi i dati sensibili relativi alla
carta di credito e restituisce in output l'id univoco associato al pagamento, lesito della verifica 3D
Secure e, in caso di carta enrolled, il messaggio PaReq e la url dellACS.
Esempio di richiesta:
id=99999999&password=99999999&operationtype=verifyenrollment&card=4349940199997007&c
vv2=892&expiryyear=2018&expirymonth=02&cardholdername=member&amount=0.1¤cyco
de=978&description=description&customfield=customdata&merchantorderid=order001
Parametri di richiesta:
Esempi di risposta:
Caso Enrolled
<response>
<result>ENROLLED</result>
<paymentid>702655129270232529</paymentid>
<customfield>customdata</customfield>
<description>description</description>
<merchantorderid>order001</merchantorderid>
<PAReq>eJxVkt1u4jAQhV8Fcb(...)</PAReq>
<url>http://www.bank.com/acs/insertPassword?brand=Visa</url>
</response>
<response>
<result>NOT ENROLLED</result>
<paymentid>336725896310532529</paymentid>
<customfield>customdata</customfield>
<description>description</description>
<merchantorderid>order001</merchantorderid>
<eci>01</eci>
</response>
<response>
<result>NOT SUPPORTED</result>
<customfield>customdata</customfield>
<description>description</description>
<merchantorderid>order001</merchantorderid>
</response>
Parametri di risposta:
Al termine dell'autenticazione, il titolare sar redirezionato verso la TermUrl portando con s due
parametri: MD, identificativo della sessione di autenticazione e PaRes (Payer Authentication
Response), esito cifrato dell'autenticazione. La PaRes dovr essere girata a Setefi per la
validazione, la decodifica e l'estrazione dei valori necessari ad effettuare la richiesta di
autorizzazione in modalit full/half secure.
VERIFY PARES
Allinterno del flow per i pagamenti Server to Server, la servlet esposta per la validazione del
messaggio PaRes e la restituzione dei parametri 3D Secure legati alla firma del pagamento; riceve
in input il messaggio PaRes, restituito dallACS e contenente lesito dellautenticazione, e ne
restituisce in output una versione decriptata e semplificata.
Esempio di richiesta:
id=99999999&password=99999999&operationtype=verifypares&paymentid=29859709665504020
9&pares=eJydWFmzosqyfudXdKzzSPRmVGGHvU4UMyoIMolvTDKDCgry60+pPazdu(...)
Parametri di richiesta:
Esempio di risposta:
<response>
<paymentid>298597096655040209</paymentid>
<cavv>AAACBSMAFQAAAAAAAAAVAAAAAAA=</cavv>
<cavvalgo>2</cavvalgo>
<eci>05</eci>
<merchantacquirerbin>494330</merchantacquirerbin>
<currency>978</currency>
<xid>eFtyU1M8OWlhSzcmOWhNKCZXZF4=</xid>
<purchasedate>20140120 15:07:33</purchasedate>
<purchaseamount>100</purchaseamount>
<exponent>2</exponent>
<time>20140120 15:07:33</time>
<status>Y</status>
<pan>0000000000005019</pan>
<vendorcode>123456</vendorcode>
<version>1.0.2</version>
</response>
Parametri di risposta:
PAY
Allinterno del flow per i pagamenti Server to Server la servlet esposta per la richiesta di
autorizzazione nel caso di circuiti non partecipanti al 3D Secure (verifyenrollment con result =
[NOT SUPPORTED]); riceve in input tutti i dati del pagamento: dati ordine, dati carta (l'eci
opzionale, se presente, deve essere valorizzato con '07'); restituisce in output l'esito del
pagamento.
PAYTHREESTEP
Allinterno del flow per i pagamenti Server to Server la servlet esposta per la richiesta di
autorizzazione nel caso la carta abbia eseguito l'autenticazione sul sito dell'Issuer (verifyenrollment
con result = [ ENROLLED, NOT ENROLLED ] ); riceve in input tutti i dati del pagamento: dati
ordine, dati carta e dati 3D Secure; restituisce in output l'esito del pagamento.
Esempio di richiesta:
id=99999999&password=99999999&operationtype=paythreestep&paymentid=
298597096655040209&amount=0.1¤cycode=978&merchantorderid=order001&description=
description&cardholdername=member&card=4349940199997007&expiryyear=2018&expirymonth
=02&cvv2=123&customfield=customdata&eci=05&xid=eFtyU1M8OWlhSzcmOWhNKCZXZF4=&cavv=
AAACBSMAFQAAAAAAAAAVAAAAAAA=
Parametri di richiesta:
L'ECI deve essere valorizzato con il valore ricevuto nella verifyenrollment nel caso di NO 3D e
con il valore ricevuto nella verifypares nel caso di transazione sicura ( FULL o HALF ).
Esempio di risposta:
<response>
<result>APPROVED</result>
<authorizationcode>695683</authorizationcode>
<paymentid>176244506440940209</paymentid>
<merchantorderid>order001</merchantorderid>
<rrn>123456789012</rrn>
<responsecode>000</responsecode>
<cardcountry>ITALY</cardcountry>
<description>description</description>
<customfield>customdata</customfield>
</response>
Parametri di risposta:
1. Il Pagatore effettua un acquisto sul sito del Commerciante scegliendo MyBank come
strumento di pagamento
2. ll server del Commerciante inizializza il pagamento
3. MonetaWeb valida linizializzazione
4. MonetaWeb restituisce al Commerciante il PaymentID, un security token e la URL della
pagina di scelta Banca
5. Il server del Commerciante redirige il Pagatore verso la pagina di scelta Banca
6. Il Pagatore sceglie la Banca tra quelle disponibili
7. MonetaWeb contatta il Routing Service di EBA
8. Il Routing Service di EBA restituisce l'id myBank e URL della banca
9. Il Pagatore viene rediretto sull'internet banking della Banca selezionata
10. Il Pagatore si autentica e trova un bonifico SEPA precompilato, conferma il pagamento
11. Il Pagatore riceve in tempo reale dalla Banca l'esito del bonifico.
12. La Banca redirige il Pagatore verso MonetaWeb
13. MonetaWeb contatta il Routing Service di EBA per conoscere l'esito del bonifico
14. Il Routing Service di EBA invia l'esito richiesto a MonetaWeb
15. MonetaWeb invia in modalit server to server lesito del pagamento alla ResponseURL
sul server del Commerciante
16. Il Commerciante invia sulla stessa socket la ResultURL del Commerciante
17. Monetaweb redirige il Pagatore verso la pagina di esito del Commerciante (ResultURL)
id=99999999&password=99999999&operationType=initializemybank&amount=1.00&responseTom
erchantUrl=http://www.merchant.it/notify.jsp&recoveryUrl=http://www.merchant.it/error.jsp&mercha
ntOrderId=TRCK0001&description=Descrizione&cardHolderName=NomeCognome&cardHolderE
[email protected]&customField=campoPersonalizzabile
responseToMerchantUrl Url verso cui notificare l'esito della transazione varchar 2048
<response>
<paymentid>123456789012345678</paymentid>
<securitytoken>80957febda6a467c82d34da0e0673a6e</securitytoken>
<hostedpageurl>https://www.monetaonline.it/monetaweb/mybank/selection</hostedpageurl>
</response>
parametro paymentid. Tale url non deve essere considerata come valore fisso ma, per ogni
pagamento, deve essere reperita dinamicamente dallapposito tag.
Una volta raggiunta questa pagina, il pagatore dovr selezionare la Banca su cui effetuare il
bonifico. Nel caso in cui il Pagatore non trovasse la propria Banca nell'elenco di quelle
partecipanti, vi la possibilit di passare al pagamento con carta di credito. In questo caso il
tracciato della notifica di risposta sar quello del pagamento con carta. possibile inibire il
passaggio al pagamento con carta di credito, inviando una richiesta al servizio di supporto
Commercio Elettronico.
Una volta autenticatosi sull'home banking, il pagatore trover un bonifico SEPA precompilato che
potr confermare. Ricevuto l'esito del bonifico dalla Banca, il pagatore, per proseguire, dovr
cliccare il pulsante predisposto dalla Banca e sar rediretto su una pagina di transizione di
MonetaWeb. A questo punto viene fornita al Commerciante una notifica dellesito del pagamento
stesso. La notifica viene effettuata tramite post HTTP in formato NVP (NameValue Pair) sullurl
indicato nel parametro responseToMerchantUrl.
Tra i vari parametri passati in post, il securityToken una quantit di sicurezza generata da
MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase
di notifica dellesito; per scopi di sicurezza, si consiglia di verificare che il valore del securityToken
ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del pagatore verso una nuova pagina contenente lesito
della transazione, il Commerciante deve rispondere al messaggio di notifica, appena ricevuto da
Monetaweb, con lurl della propria pagina di esito associando il 'paymentid' come parametro.
Questo url pu essere arricchito con dei parametri custom per consentire la corretta
visualizzazione dellesito stesso. Attenzione: la risposta non deve contenere codice HTML.
I nostri servizi, all'atto della notifica di un pagamento hosted verso la merchant response URL, una
volta instaurata la connessione, attendono per 20 secondi di ricevere in risposta la URL per la
redirezione finale. Allo scadere del timeout, la socket viene chiusa.
Nel caso in cui la comunicazione dellurl di redirezione del titolare dovesse fallire
(indisponibilit della pagina responseToMerchantUrl, contenuto della pagina
responseToMerchantUrl non valido e timeout nella risposta) Monetaweb reindirizzer il titolare
verso la pagina recoveryUrl, che viene comunicata dal Commerciante stesso tramite lapposito
parametro del messaggio di Inizializzazione. Qualora il parametro recoveryUrl non fosse stato
valorizzato MonetaWeb redireger il titolare verso una pagina di cortesia, pubblicata direttamente
sul server MonetaWeb.
Il protocollo MyBank, definito dal consorzio EBA, prevede che la risposta verso il Commerciante
venga inviata solo dopo che il Pagatore (Intestatario del conto) abbia fatto ritorno dalla pagina della
Banca che ha scelto per effettuare il bonifico. Nei casi in cui il Pagatore non faccia ritorno dalla
pagina della propria Banca e interrompa quindi il processo di pagamento, come da protocollo, il
gateway offre la possibilit, attraverso lo strumento di inquiry, di conoscere in qualsiasi momento lo
stato della transazione. L'integrazione MyBank soggetta a certificazione e pertanto aderisce al
protocollo del consorzio EBA.
Tutti i pagamenti MyBank assumono lo stato PENDING (sui sistemi Setefi) in attesa che la Banca
comunichi l'esito del bonifico. Il pagatore ha tempo 15 minuti, dall'inizio della transazione, per
confermare il bonifico. Oltre questo limite lo stato del pagamento sar impostato a TIMEOUT dalla
Banca.
Se il bonifico verr autorizzato (AUTHORISED) o negato (ERROR) dalla Banca oppure annullato
(AUTHORISINGPARTYABORTED) dal pagatore sull'homebanking, lo stato sar aggiornato
coerentemente.
Quando il pagatore non raggiunge o non fa ritorno dalla pagina della Banca, lo stato rester
PENDING sui sistemi Setefi, ma il merchant non ricever notifica.
Un batch automatico aggiorner, ogni 15 minuti, interrogando i servizi MyBank, lo stato di eventuali
pagamenti pending. possibile forzare l'aggiornamento dello stato di un pagamento in stato
pending in qualsiasi momento attraverso il servizio di inquirymybank.
Il pagamento potr assumere lo stato CANCELED nei seguenti scenari:
Qualora non fosse possibile associare uno stato finale ad un pagamento (aggiornamento
batch, il Commerciante non ricever alcuna notifica)
Qualora il pagatore dovesse abbandonare la sessione prima della scelta Banca
(aggiornamento batch, il Commerciante non ricever alcuna notifica)
Qualora il pagatore dovesse cliccare su Annulla la transazione dalla pagina di scelta
banca (Il commerciante ricever relativa notifica)
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di Inizializzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
1. Il titolare carta effettua un acquisto sul sito del Commerciante, scegliendo PayPal come
strumento di pagamento; i dati del pagamento sono trasmessi al server del Commerciante
2. Il server del Commerciante inizializza il pagamento con un messaggio HTTP Post
3. MonetaWeb inizializza il pagamemento verso PayPal
4. PayPal restituisce un tocken di sessione
5. Monetaweb restituisce al Commerciante il PaymentID, il security token e la URL per la
redirezione del titolare
6. Il server del Commerciante redirige il titolare carta verso la login page di PayPal
7. Il titolare carta inserisce le proprie credenziali PayPal, sceglie lo strumento di pagamento e
l'eventuale indirizzo di spedizione e autorizza il pagamento
8. PayPal restitusce a MonetaWeb la sessione del Titolare
9. MonetaWeb invia a PayPal una richiesta di pagamento
10. PayPal processa il pagamento e restituisce un esito a MonetaWeb
11. MonetaWeb notifica in modalit server to server lesito del pagamento alla ResponseURL
del Commerciante
12. Il Commerciante restituisce a MonetaWeb la ResultURL
13. Monetaweb redirige il titolare carta verso la ResultURL per la visualizzazione dell'esito
finale.
id=99999999&password=99999999&operationType=initializepaypal&amount=1.00&responseToMe
rchantUrl=http://www.merchant.it/notify.jsp&
recoveryUrl=http://www.merchant.it/error.jsp&merchantOrderId=TRCK0001&description=Descrizio
ne&
cardHolderName=NomeCognome&[email protected]&
customField=campoPersonalizzabile
Parametri di chiamata del messaggio HTTP di Inizializzazione Pagamento:
<response>
<paymentid>945288470910940699</paymentid>
<hostedpageurl>https://www.monetaonline.it/monetaweb/hosted/thirdparty</hostedpageurl>
<securitytoken>07dc08f9bde84c7aa0481d8e604c91e9</securitytoken>
</response>
hostedpageurl Url della pagina verso cui ridirigere il titolare carta varchar 255
Sulla base delle scelte operate dal titolare, attraverso il proprio account, PayPal processa il
pagamento e ne comunica l'esito a MonetaWeb; il Commerciante riceve quindi una notifica tramite
post HTTP in formato NVP (NameValue Pair) sullurl indicato nel parametro
responseToMerchantUrl.
Tra i vari parametri passati in post, il securityToken una quantit di sicurezza generata da
MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase
di notifica dellesito; per scopi di sicurezza, si consiglia di verificare che il valore del securityToken
ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente lesito
della transazione, il Commerciante deve rispondere al messaggio di notifica, appena ricevuto da
Monetaweb, con lurl della propria pagina di esito associando il 'paymentid' come parametro.
Questo url pu essere arricchito con dei parametri per consentire la corretta visualizzazione
dellesito stesso. Attenzione: la risposta non deve contenere codice HTML.
I nostri servizi, all'atto della notifica di un pagamento hosted verso la merchant response URL, una
volta instaurata la connessione, attendono per 20 secondi di ricevere in risposta la URL per la
redirezione finale. Allo scadere del timeout, la socket viene chiusa.
Nel caso in cui la comunicazione dellurl di redirezione del titolare dovesse fallire (indisponibilit
della pagina responseToMerchantUrl, contenuto della pagina responseToMerchantUrl non valido e
timeout nella risposta) Monetaweb reindirizzer il titolare verso la pagina recoveryUrl, che viene
comunicata dal Commerciante stesso tramite lapposito parametro del messaggio di
Inizializzazione. Qualora il parametro recoveryUrl non fosse stato valorizzato MonetaWeb
redireger il titolare verso una pagina di cortesia, pubblicata direttamente sul server MonetaWeb.
CASI DI ERRORE
Fase di Inizializzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
Esempio messaggio di errore in fase di inizializzazione:
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
Fase di notifica:
Nel caso di transazione negata dal sistema PayPal, MonetaWeb notifica il Commerciante con un
messaggio di errore in formato NVP.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
- il riferimento alla transazione
1. Il titolare carta effettua un acquisto sul sito del Commerciante, scegliendo MasterPass
come strumento di pagamento; i dati del pagamento sono trasmessi al server del
Commerciante
2. Il server del Commerciante inizializza il pagamento con un messaggio HTTP Post
3. MonetaWeb inizializza il pagamemento verso MasterPass
4. MasterPass restituisce un token di sessione
5. Monetaweb restituisce al Commerciante il PaymentID, il security token e la URL per la
redirezione del titolare
6. Il server del Commerciante redirige il titolare carta verso la login page di MasterPass
7. Il titolare carta inserisce le proprie credenziali MasterPass, sceglie lo strumento di
pagamento e l'eventuale indirizzo di spedizione e conferma il checkout
8. MasterPass restituisce la sessione del Titolare a MonetaWeb
9. MonetaWeb richiede i dati di checkout a MasterPass
10. MasterPass restituisce i dati di checkout
11. MonetaWeb elabora i dati carta, di spedizione e di billing da MasterPass e processa il
pagamento
12. MonetaWeb notifica in modalit server to server lesito del pagamento alla ResponseURL
del Commerciante
13. Il Commerciante risponde a MonetaWeb inviando la ResultURL
14. Monetaweb redirige il titolare carta verso la ResultURL per la visualizzazione dell'esito
finale.
id=99999999&password=99999999&operationType=initializemasterpass&amount=1.00¤cy
Code=978&responseToMerchantUrl=http://www.merchant.it/notify.jsp&recoveryUrl=http://www.mer
chant.it/error.jsp&merchantOrderId=TRCK0001&description=Descrizione&cardHolderName=Nome
Cognome&[email protected]&customField=campoPersonalizzabile.
Parametri di chiamata del messaggio HTTP di Inizializzazione Pagamento:
<response>
<paymentid>123456789012345678</paymentid>
<securitytoken>80957febda6a467c82d34da0e0673a6e</securitytoken>
<hostedpageurl>http://www.monetaonline.it/monetaweb/masterpass</hostedpageurl>
</response>
Lunghezz
Nome Descrizione Tipo
a
CASI DI ERRORE
Fase di Inizializzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
Fase di Notifica:
Nel caso in cui non sia possibile completare il pagamento (es. autenticazione 3DSecure fallita)
MonetaWeb notifica il Commerciante con un messaggio di errore in formato NVP.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
- Il riferimento univoco del pagamento
Il processo di pagamento Alipay si compone molto spesso di due fasi: nella prima fase, il
Titolare effettua il login e conferma il pagamento (la transazione assume lo stato PENDING);
nella seconda fase, Alipay effettua delle verifiche interne e quindi notifica a MonetaWeb
l'eventuale cambio di stato e MonetaWeb inoltra la notifica al Commerciante.
Processo di pagamento
1. Il Titolare dell'account di Alipay effettua un acquisto sul sito del Commerciante, scegliendo
Alipay come strumento di pagamento
2. Il server del Commerciante inizializza il pagamento con un messaggio HTTP Post
3. Monetaweb restituisce al Commerciante il PaymentID, il security token e la URL per la
redirezione del titolare
4. Il server del Commerciante redirige il titolare verso una pagina di appoggio di MonetaWeb
5. MonetaWeb redirige il titolare verso la login page di Alipay
6. Il titolare inserisce le proprie credenziali Alipay e autorizza il pagamento
7. Alipay notifica a MonetaWeb il completamento del pagamento
8. MonetaWeb notifica in modalit server to server lesito del pagamento alla ResponseURL
del Commerciante
9. Il Commerciante restituisce a MonetaWeb la ResultURL
10. Alipay restitusce a MonetaWeb la sessione del Titolare
11. Monetaweb redirige il titolare verso la ResultURL per la visualizzazione dell'esito finale.
Notifica asincrona
1. Lo stato del pagamento sui sistemi Alipay subisce una variazione (e. g. conferma buon fine)
2. Alipay notifica a MonetaWeb il cambiamento di stato del pagamento
3. MonetaWeb notifica al Commerciante il cambiamento di stato del pagamento invocando la
ipnUrl.
id=99999999&password=99999999&operationType=initializealipay&amount=1.00&responseToMer
chantUrl=http://www.merchant.it/notify.jsp&
recoveryUrl=http://www.merchant.it/error.jsp&merchantOrderId=TRCK0001&description=Descripti
on&
cardHolderName=NameSurname&[email protected]&
customField=customField&ipnurl= http://www.merchant.it/ipn.jsp
<response>
<paymentid>945288470910940699</paymentid>
<hostedpageurl>https://www.monetaonline.it/monetaweb/hosted/thirdparty</hostedpageurl>
<securitytoken>07dc08f9bde84c7aa0481d8e604c91e9</securitytoken>
</response>
hostedpageurl Url della pagina verso cui ridirigere il titolare varchar 255
Tra i vari parametri passati in post, il securityToken una quantit di sicurezza generata da
MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase
di notifica dellesito; per scopi di sicurezza, si consiglia di verificare che il valore del securityToken
ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente lesito
della transazione, il Commerciante deve rispondere al messaggio di notifica, appena ricevuto da
Monetaweb, con lurl della propria pagina di esito associando il 'paymentid' come parametro.
Questo url pu essere arricchito con dei parametri per consentire la corretta visualizzazione
dellesito stesso. Attenzione: la risposta non deve contenere codice HTML.
I nostri servizi, all'atto della notifica di un pagamento hosted verso la merchant response URL, una
volta instaurata la connessione, attendono per 20 secondi di ricevere in risposta la URL per la
redirezione finale. Allo scadere del timeout, la socket viene chiusa.
Nel caso in cui la comunicazione dellurl di redirezione del titolare dovesse fallire (indisponibilit
della pagina responseToMerchantUrl, contenuto della pagina responseToMerchantUrl non valido e
timeout nella risposta) Monetaweb reindirizzer il titolare verso la pagina recoveryUrl, che viene
comunicata dal Commerciante stesso tramite lapposito parametro del messaggio di
Inizializzazione. Qualora il parametro recoveryUrl non fosse stato valorizzato MonetaWeb
redireger il titolare verso una pagina di cortesia, pubblicata direttamente sul server MonetaWeb.
CASI DI ERRORE
Fase di Inizializzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, importo invalido, )
MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
Esempio messaggio di errore in fase di inizializzazione:
<error>
<errorcode>XYZ123</errorcode>
<errormessage>Invalid amount</errormessage>
</error>
E' sufficiente popolare i parametri aggiuntivi recurringAction e walletid oltre ai parametri standard
previsti dal protocollo di pagamento :
Il salvataggio dei dati carta condizionato al buon esito della richiesta di autorizzazione.
Nel caso di pagamenti ricorrenti, le richieste di addebito successive all'attivazione possono essere
processate anche via file, secondo il tracciato descritto nel paragrafo MSG DETAIL Record di
dettaglio per Pagamenti Rata.
4.3. Cancellazione
La cancellazione wallet permette di eliminare un wallet precedentemente attivato.
<response type="valid">
<result>WALLET DELETED</result>
<walletid>wallet001</walletid>
</response>
Nel caso in cui la richiesta violi le regole di creazione di un walletID o sostituzione carta, il sistema
restituir il codice esito 182, il dettaglio del fallimento viene esposto dai parametri errorcode ed
errormessage.
result=NOT APPROVED&paymentid=742792762584270189&walletid=WalletIsExample&
merchantorderid=OrderId&rn=123456789123&responsecode=182&errorcode=WS00063&
errormessage=Wallet Already Exists
<response>
<result>NOT APPROVED</result>
<paymentid>742792762584270189</paymentid>
<walletid>WalletIsExample</walletid>
<merchantorderid>OrderId</merchantorderid>
<rrn>123456789123</rrn>
<responsecode>182</responsecode>
<errorcode>WS00063</errorcode>
<errormessage>Wallet Already Exists</errormessage>
</response>
L'elenco dei codici di errori ammissibili sono riportati nell'appendice H - Codici di Errore
Monetawallet
<error>
<errorcode>WS00061</errorcode>
<errormessage>Wallet not found</errormessage>
</error>
- ESPLICITA: dopo la fase di pagamento sar necessario procedere alla conferma esplicita
delle transazioni autorizzate che si desidera vengano contabilizzate e liquidate. In caso di
modifica a favore di una contabilizzazione implicita, occorre confermare
manualmente, attraverso il portale di Back-Office, le transazioni che ricadono nel gap
non gestito dalla nuova configurazione.
- A MEZZO FILE: dopo la fase di pagamento sar necessario inviare a Setefi un file
contenente i dati delle sole transazioni autorizzate che si desidera vengano contabilizzate e
liquidate.
Carta di
Credito / S 4 giorni 4 giorni 4 giorni
MasterPass
MyBank S No No No
PayPal S 29 giorni No No
Alipay S No No No
Se una transazione autorizzata non viene confermata, il plafond della carta di credito rester
bloccato per un importo pari a quello autorizzato. Dopo un certo numero di giorni lautorizzazione
decadr e limporto bloccato torner disponibile; tale numero di giorni variabile in base alla banca
emittente della carta di credito utilizzata.
id=99999999&password=99999999&operationType=confirm&amount=1.00¤cyCode=978&
merchantOrderId=TrackingNo12345&paymentId=123456789012345
<response>
<result>CAPTURED</result>
<authorizationcode>123456</authorizationcode>
<paymentid>123456789012345</paymentid>
<merchantorderid>TrackingNo12345</merchantorderid>
<responsecode>000</responsecode>
<customfield />
<description />
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di conferma:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di
confermare un pagamento gi confermato, tentativo di confermare un pagamento per un importo
maggiore rispetto a quanto autorizzato, ) MonetaWeb risponde con un messaggio di errore in
formato XML.
<error>
<errorcode>GW00176</errorcode>
<errormessage>Failed Previous Captures check.</errormessage>
</error>
<response>
<result>VOIDED</result>
<authorizationcode>123456</authorizationcode>
<paymentid>123456789012345</paymentid>
<merchantorderid>TrackingNo12345</merchantorderid>
<responsecode>000</responsecode>
<customfield />
<description />
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di storno:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di stornare
un pagamento gi completamente stornato, ) MonetaWeb risponde con un messaggio di errore
in formato XML.
<error>
<errorcode>GW00181</errorcode>
<errormessage>Operation Failed.</errormessage>
</error>
NOTA: l'efficacia dell'operazione di annullamento dell'autorizzazione dipende sia dal tipo di carta
utilizzata sia dalle politiche della Banca emittente; si raccomanda di effettuare l'annullamento
dell'autorizzazione nei giorni immediatamente successivi al rilascio dell'autorizzazione, in
alternativa l'operazione potrebbe essere rifiutata.
id=99999999&password=99999999&operationType=voidauthorization&paymentId=123456789012
345
<response>
<result>AUTH VOIDED</result>
<authorizationcode>123456</authorizationcode>
<paymentid>123456789012345</paymentid>
<merchantorderid>TrackingNo12345</merchantorderid>
<responsecode>000</responsecode>
<customfield />
<description />
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di annullamento autorizzazione:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di
annullare un pagamento gi annullato, tentativo di annullare un pagamento non autorizzato, )
MonetaWeb risponde con un messaggio di errore in formato XML.
<error>
<errorcode>GW00179</errorcode>
<errormessage>Failed Previous Voids check.</errormessage>
</error>
L'operazione di Annullamento della conferma con rilascio del plafond supportata dai seguenti
metodi di pagamento:
- Carta di Credito
- MasterPass
id=99999999&password=99999999&operationType=forcedvoidauthorization&paymentId=1234567
89012345
<response>
<result>AUTH VOIDED</result>
<authorizationcode>123456</authorizationcode>
<paymentid>123456789012345</paymentid>
<merchantorderid>TrackingNo12345</merchantorderid>
<responsecode>000</responsecode>
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di forced void authorization:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di
annullare un pagamento gi annullato, tentativo di annullare un pagamento non autorizzato,
tentativo di annullare un pagamento confermato oltre la stessa giornata) MonetaWeb risponde
con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>GW00179</errorcode>
<errormessage>Failed Previous Voids check.</errormessage>
</error>
Si consiglia di effettuare l'operazione di inquiry al termine della durata massima di una sessione di
pagamento, ovvero dopo 20 minuti dalla generazione del paymentid.
<response>
<result>APPROVED</result>
<paymentid>434166330386052949</paymentid>
<transactiontime>2015-10-23T09:55:17.837+0200</transactiontime>
<amount>0.10</amount>
<currencycode>978</currencycode>
<merchantorderid>2011IVR4189718Anti</merchantorderid>
<authorizationcode>888620</authorizationcode>
<threedsecure>H</threedsecure>
<responsecode>000</responsecode>
<customfield>some custom field</customfield>
<description>some description</description>
<rrn>123456789012</rrn>
<cardcountry>ITALY</cardcountry>
<cardbrand>MC</cardbrand>
<cardtype>MONETA</cardtype>
<maskedpan>539832**1283</maskedpan>
<securitytoken>925a86bbbf0444809dbc37ab08ee1d87</securitytoken>
<cardholderip>192.168.99.202</cardholderip>
</response>
<response>
<amount>0.10</amount>
<authorizationcode>888621</authorizationcode>
<currencycode>978</currencycode>
<customfield>some custom field</customfield>
<description>Some description</description>
<merchantorderid>2011IVR4189718Anti</merchantorderid>
<mybankid>7844111</mybankid>
<paymentid>423129329528760639</paymentid>
<result>AUTHORISED</result>
<securitytoken>6afebc810bcf48bd9aff71d39c223dc4</securitytoken>
<selectedbank>Intesa San Paolo</selectedbank>
<transactiontime>2016-03-03 16:51:51.746</transactiontime>
</response>
CASI DI ERRORE
Comportamento del sistema in caso di errore in fase di inquiry:
In caso di invio di parametri errati (es. terminale sconosciuto, password errata, riferimento
transazione non univoco, ) MonetaWeb risponde con un messaggio di errore in formato XML.
Tale messaggio comprende:
- un codice di errore
- una descrizione parlante dellerrore
<error>
<errorcode>GW00201</errorcode>
<errormessage>Transaction not found.</errormessage>
</error>
Appendice
A. Ambiente di test
Per i pagamenti standard il sistema simula una richiesta di autorizzazione senza verificare la data
scadenza e il cvv; lesito della transazione viene determinato sulla base dellimporto valorizzato:
- se importo = 9999 -> transazione negata
- se importo <> 9999 -> transazione autorizzata
Per i pagamenti ricorrenti e per l'utilizzo di MonetaWallet, il sistema effettua una richiesta di
autorizzazione in ambiente di test verificando tutti i dati carta.
Il nome titolare carta pu essere qualsiasi.
Come codice di autorizzazione (authorizationcode) possibile ricevere in risposta il valore
fakews.
Nell'ottica di garantire una maggiore segregazione tra gli ambienti di TEST e PRODUZIONE,
l'ambiente di TEST accetta solo il set di carte di credito sotto riportate. Tutte le altre carte
riceveranno l'esito NOT APPROVED con response code 111 Numero Carta non Valido.
CARTE DI TEST
Password
Data
Circuito Numero Carta CVV Verifica 3D Secure 3D Esito
Scadenza
Secure
VISA 4349940199997007 02/2018 829 ENROLLED valid OK
VISA 4349940199996900 02/2018 665 ENROLLED valid OK
VISA 4943319608775645 01/2018 429 NOT ENROLLED - OK
VISA 4163640001410479 01/2018 349 NOT ENROLLED - OK
MC 5533890199999896 02/2018 670 ENROLLED valid OK
MC 5398320199997454 01/2020 278 ENROLLED valid OK
MC 5533890199999870 02/2018 145 ENROLLED valid OK
MC 5209569609471604 01/2018 008 NOT ENROLLED - OK
AMEX 375200000000003 12/2018 5861 NOT SUPPORTED - OK
DINERS 36961903000009 11/2018 553 NOT SUPPORTED - OK
CREDENZIALI DI TEST
Back Office: https://test.monetaonline.it/monetaweb/backoffice
Password
Codice Codice Password
Use Case Back Terminale
Commerciante Utente Terminale
Office
Hosted 3D - contabilizzazione
009999999 009999999 Setefi14 99999999 99999999
esplicita
Hosted 3D - contabilizzazione
009999100 009999100 Setefi14 99999100 Setefi01
implicita
Hosted NO 3D -
009999101 009999101 Setefi14 99999101 Setefi01
contabilizzazione esplicita
Hosted NO 3D -
009999102 009999102 Setefi14 99999102 Setefi01
contabilizzazione implicita
MOTO - contabilizzazione
99999906 99999906 Setefi14 99999906 Password1
esplicita
MOTO - contabilizzazione
99999907 99999907 Setefi14 99999907 Password1
implicita
MonetaWallet (tokenizzazione)
Pagamenti Ricorrenti:
001723477 001723477 Setefi14 93026293 Password1
Primo pagamento - Hosted 3D -
contabilizzazione esplicita
MonetaWallet (tokenizzazione)
Pagamenti Ricorrenti:
001723477 001723477 Setefi14 93029357 Password1
Primo pagamento - Hosted 3D -
contabilizzazione implicita
MonetaWallet (tokenizzazione)
Pagamenti Ricorrenti:
Primo pagamento - Hosted NO 001723477 001723477 Setefi14 93026294 Password1
3D / MOTO - contabilizzazione
esplicita
MonetaWallet (tokenizzazione)
Pagamenti Ricorrenti:
001723477 001723477 Setefi14 93026295 Password1
Pagamenti successivi - MOTO -
contabilizzazione esplicita
PayPal: https://www.sandbox.paypal.com
Password: setefiPP
Password: provaprova
In caso di selezione errata, utilizzare il link in alto a sinistra Altri wallet e successivamente
cliccare sul wallet corretto.
Password: abc123
Masterpass potrebbe richiedere la risposta alla domanda segreta, in tal caso digitare: Ferrari
B. Tracciato TRINIZ
Il tracciato TRINIZ il formato ufficiale con cui avviene lo scambio di informazioni off-line tra il
Commerciante e MonetaWeb. A fronte dell'elaborazione del file di ingresso fornito dal
Commerciante viene restituito un file di esito.
Per quanto concerne il nome del file si pu scegliere tra un nome custom o la dicitura di default
che ha la seguente nomenclatura INSEGNA_AAAAMMGGHHMMSS, dove:
INSEGNA: Nome dell'insegna del Commerciante (indicato da Setefi),
AAAA l'anno,
MM il mese,
GG il giorno,
HH l'ora,
MM sono i minuti,
SS sono i secondi.
Lestensione opzionale.
Per quanto riguarda il nome del file di esito, si pu scegliere tra un nome custom oppure lo
stesso nome del file di ingresso. Lestensione opzionale.
Per il file delle conferme contabili, la schedulazione di invio del file di ingresso giornaliera .
Per il file dei pagamenti rata e delle autorizzazioni a mezzo file, la schedulazione di invio del file di ingresso
pu essere:
Giornaliera.
Settimanale.
Mensile.
Il protocollo da utilizzare per lo scambio dei file da concordare scrivendo all'indirizzo
[email protected].
Effettuate tutte le scelte, occorre inviare una mail al servizio di supporto Commercio Elettronico
specificando:
Nome del file in ingresso: default o indicare il nome custom.
Nome del file di esito: default o indicare il nome custom.
Schedulazione invio del file in ingresso:
Giornaliera: ora di invio (HH:MM).
Settimanale (solo per i pagamenti rata e le autorizzazioni a mezzo file): giorno della
settimana (es. Luned).
Mensile (solo per i pagamenti rata e le autorizzazioni a mezzo file): giorno del mese
(GG).
Gli indirizzi email dei destinatari se si desidera email di notifica di presa in carico del file in
ingresso (opzionale).
Gli indirizzi email dei destinatari se si desidera email di notifica di generazione del file di
esito (opzionale).
L'invio del file deve rispettare la schedulazione anche in assenza di transazioni, occorre processare un file
contenente solo i record di testa e coda.
Per la validazione formale di un file di esempio in ambiente di test occorre:
1 01 6 A TRINIZ
5 24 1 A T
6 25 3 A E45
8 31 1 A A
9 32 1 A Spazi vuoti
92 per il tracciato di
Conferma Contabile
1 01 6 A COINIZ
7 28 2 N 50 (euro)
97 per il tracciato di
Conferma Contabile
Comporre il record di dettaglio in base allo scopo del file, successivamente vengono descritte
alcune tipologie di MSG DETAIL ( per contabilizzazione via file, pagamenti rata, ecc... ).
1 01 6 A COFINE
3 12 1 N 0
7 33 12 N Zeri
58 per il tracciato di
Conferma Contabile
11 69 A Spazi vuoti
122 per il tracciato dei
Pagamenti Rata e delle
Autorizzazioni a mezzo file
1 01 6 A TRFINE
MSG DETAIL Record di dettaglio per Conferme contabili per contabilizzazione a mezzo file
1 01 1 N 0
8 36 23 A Spazi vuoti
11 74 3 A Spazi vuoti
12 77 1 A 1
0 (contabilizzazione)
13 78 1 A
7 (storno)
1 01 1 N 0
8 36 23 A Spazi vuoti
Codice Autorizzazione
12 77 1 A 1
Tipo operazione
13 78 1 A -0 acquisto
-7 storno
RRN (Retrieval Reference Number)
Response Code
1 01 1 N 0
Codice Autorizzazione
13 77 1 A 1
Tipo operazione
14 78 1 A -0 acquisto
-7 storno
RRN (Retrieval Reference Number)
Response code
I due tracciati, seppur con struttura simile, sono indipendenti l'uno dall'altro, necessitando di una
configurazione dedicata, e la loro attivazione deve avvenire separatamente.
Per quanto concerne il nome del file si pu scegliere tra un nome custom (purch i due tracciati
abbiano nomi distinti) o la dicitura di default che ha la seguente nomenclatura
INSEGNA_TIPO_AAAAMMGGHHMMSS, dove:
INSEGNA: Nome dell'insegna del Commerciante (indicato da Setefi),
TIPO: tipo di tracciato tra:
ALL: per il file di allineamento carte.
UPD: per il file di modifica stato del contratto/wallet id.
AAAA l'anno,
MM il mese,
GG il giorno,
HH l'ora,
MM sono i minuti,
SS sono i secondi.
Lestensione opzionale.
Per quanto riguarda il nome del file di esito, si pu scegliere tra un nome custom oppure lo
stesso nome del file di ingresso. Lestensione opzionale.
L'invio del file relativo al dettaglio modifica stato del contratto/wallet id libero. Se invece si
desidera essere notificati in caso di non ricezione del file, occorre comunicare la schedulazione di
invio, che segue le stesse politiche della schedulazione di invio del file di allineamento carte.
Per il file di allineamento carte, la schedulazione di invio del file di ingresso pu essere:
Giornaliera.
Settimanale.
Mensile.
Gli indirizzi email dei destinatari se si desidera email di notifica di generazione del file di
esito (opzionale).
L'invio del file deve rispettare la schedulazione anche in assenza di transazioni, occorre processare un file
contenente solo i record di testa e coda.
Per la validazione formale di un file di esempio in ambiente di test occorre inviare il file via mail al servizio di
supporto Commercio Elettronico.
00 RECORD DI TESTA
05 RECORD DI DETTAGLIO
99 RECORD DI CODA
I campi alfanumerici (Tipo = A) vanno allineati a sinistra e riempiti a destra con spazi vuoti, mentre
i campi numerici (Tipo = N) vanno allineati a destra e riempiti a sinistra con zeri.
Di seguito vedremo in dettaglio le tre sezioni del tracciato, di cui quello di dettaglio verr specificato
per le due diverse procedure possibili.
Record di Testa
1 01 2 A 00 Tipo Record
5 23 98 A Spazi vuoti
Record di Coda
1 01 2 A 99 Tipo Record
6 30 91 A Spazi vuoti
1 01 2 A 05 Tipo Record
3 12 18 A Merchant Order ID
A Attivo
A - Attivo
5 31 1 A
S Sospeso, i pagamenti effettuati
con un Contratto/Wallet ID in questo
stato vengono negati. possibile
riattivare un Contratto/Wallet ID con
questo stato.
7 40 72 A Spazi vuoti
1 01 2 A 05 Tipo Record
Esito Allineamento:
6 43 1 A
0 - Lallineamento avvenuto
correttamente
valorizzato
valorizzato, se esistente
Valorizzato con:
Wallet id
11 77 18 A
spazi vuoti per i clienti che gestiscono l'archivio
carte
12 95 26 A Spazi vuoti
Pulsanti di Checkout
Loghi di Circuiti
Non consigliabile dettagliare i Response Code verso il titolare carta, in quanto indicare la ragione
di una negazione significa fornire ai malintenzionati uno strumento per effettuare una frode.
Suggeriamo di distinguere solamente tra esito positivo e negativo, consigliando eventualmente al
titolare carta di ripetere la transazione prestando attenzione ai dati inseriti o di contattare
direttamente la propria banca.
La lista completa dei codici di errore ISO disponibile su richiesta.
errorcode errormessage
WS00010 - WS00044 Generic Error
WS00051 Unregistered Merchant
WS00052 Inactive Merchant
WS00061 Wallet not found
WS00062 Inactive Wallet
WS00063 Wallet Already Exists
WS00064 Wallet not found for Substitution
WS00065 Inactive Wallet for Substitution
WS00071 Invalid Card Type
WS00072 Card Exceeds Max Wallet Limit
WS00073 Card is in Black List
WS00074 Exceeds Monthly Amount Limit
WS00075 Minimum Amount Not Reached
WS00076 Exceeds Max Amount Limit
WS00077 Invalid Country
WS00078 Card and Pos country should match
WS00081 Installment Already Exists
WS00091 Secure Activation Required