FabrickPass

Documentazione per l'attivazione del metodo di pagamento alternativo FabrickPass tramite Fabrick

FabrickPass è il metodo di pagamento alternativo che, attraverso l’offerta di una soluzione unica, consente all'Ecommerce di ricevere bonifici senza l'obbligo di certificazione alla normativa PSD2. Come può essere utilizzato il servizio? In questo documento sono contenute le istruzioni necessarie per l’integrazione e l’attivazione del servizio PISP tramite l’utilizzo di Fabrick come gateway di pagamento.

Requisiti preliminari

Per avviare il processo di attivazione è necessario essere in possesso dei seguenti requisiti:

• Disporre di un contratto Ecommerce firmato con Fabrick.

• È consigliabile attivare il prodotto con un conto Banca Sella

• È possibile utilizzare FabrickPass con un conto acceso presso una banca diversa da Banca Sella, ma non ricevendo aggiornamenti sullo stato del bonifico, sarà necessaria la riconciliazione manuale.

In caso di conto diverso da Banca Sella, lo stato del bonifico nella dashboard Fabrick resterà "In attesa". (XX) È necessaria la gestione dello stato “Pending” del pagamento, perché i bonifici SEPA hanno uno stato di attesa che rispetta le tempistiche del circuito.

Conti diversi da Banca Sella 

Bonifico ordinario e/o istantaneo:: 

• XX: bonifico in pending 

• OK: Bonifico eseguito. 

• KO: Bonifico non riuscito. 

 

Conti Banca Sella 

Bonifico ordinario e/o istantaneo: 

• XX: bonfico in pending 

• OK: Bonifico eseguito, importo accreditato sul conto. 

• KO: Bonifico non riuscito. 

FabrickPass è disponibile esclusivamente per aziende con sede legale in Italia, Francia e Spagna.

Processo di attivazione

1. Integrazione con Fabrick 

• Se non lo si ha già, per testare la soluzione servrà creare un ambiente di test seguendo le istruzioni all’indirizzo https://docs.axerve.com/it/introduzione/accesso-test/).  A fine registrazione verrà restituito uno shopLogin, una stringa con il seguente formato: “gespayxxxxx” 

• Inviare un‘e-mail con la richiesta di attivazione del metodo di pagamento FabrickPass al proprio referente o inviando una richiesta nell'area dedicata Richiedi assistenza | Fabrick , scegliendo “Altro” nel menu a tendina. Servirà indicare lo shopLogin dell’ambiente di test per il quale si chiede l’attivazione 

• Attendere l'e-mail con il link di onboarding fornito da Fabrick e inserire le informazioni necessarie per attivare l'account. 

2. Per inizializzare un pagamento nell’ambiente di test si possono utilizzare le due modalità ammesse: SOAP e REST. I domini da chiamare nelle richieste API sono indicati qui https://docs.axerve.com/it/introduzione/configurazioni-tecniche/primo-pagamento/) 

3. Campi da includere nella chiamata per FabrickPass

Prima di effettuare la chiamata verso FabrickPass, assicurarsi di includere correttamente i seguenti campi popolati obbligatori nel payload.

Questi campi valorizzati sono fondamentali per l'elaborazione della transazione:

API SOAP

Encrypt

1<soapenv:Envelope xmlns:soapenv="<http://schemas.xmlsoap.org/soap/envelope/>" xmlns:ecom="<https://ecomm.sella.it/>">
2   <soapenv:Header/>
3   <soapenv:Body>
4      <ecom:Encrypt>
5         <ecom:shopLogin>{{shopLogin}}</ecom:shopLogin>
6         <ecom:apikey>{{Apikey}}</ecom:apikey>
7         <ecom:uicCode>242</ecom:uicCode>
8         <ecom:amount>0.03</ecom:amount>
9         <ecom:shopTransactionId>{{shopTransactionId}}</ecom:shopTransactionId>
10         <ecom:paymentTypes>
11            <ecom:paymentType>FABRICKPASS</ecom:paymentType>
12         </ecom:paymentTypes>
13         <ecom:OrderDetails>
14            <ecom:BankTransferDescription>{{BankTransferDescription}}</ecom:BankTransferDescription>
15            <ecom:ProviderPaymentDetails>
16               <ecom:Method>instant-sepa-credit-transfers</ecom:Method>
17            </ecom:ProviderPaymentDetails>
18            <ecom:CustomerDetail>
19               <ecom:FirstName>Mario</ecom:FirstName>
20               <ecom:Lastname>Rossi</ecom:Lastname>
21               <ecom:PrimaryEmail>mario.rossi@fabrick.com</ecom:PrimaryEmail>
22            </ecom:CustomerDetail>
23         </ecom:OrderDetails>
24      </ecom:Encrypt>
25   </soapenv:Body>
26</soapenv:Envelope>

Decrypt

1<soapenv:Envelope xmlns:soapenv="<http://schemas.xmlsoap.org/soap/envelope/>" xmlns:ecom="<https://ecomm.sella.it/>">
2   <soapenv:Header/>
3   <soapenv:Body>
4      <ecom:Decrypt>
5         <ecom:shopLogin>{{shopLogin}}</ecom:shopLogin>
6         <ecom:CryptedString>{{CryptedString}}</ecom:CryptedString>
7         <ecom:apikey>{{Apikey}}</ecom:apikey>
8      </ecom:Decrypt>
9   </soapenv:Body>
10</soapenv:Envelope>

S2S - callReadTrxS2S

1<soapenv:Envelope xmlns:soapenv="<http://schemas.xmlsoap.org/soap/envelope/>" xmlns:ecom="<https://ecomms2s.sella.it/>">
2   <soapenv:Header/>
3   <soapenv:Body>
4      <ecom:callReadTrxS2S>
5         <ecom:shopLogin>{{shopLogin}}</ecom:shopLogin>
6         <ecom:shopTransactionId>{{shopTransactionId}}</ecom:shopTransactionId>
7         <ecom:bankTransactionId>{{bankTransactionID}}</ecom:bankTransactionId>
8         <ecom:apikey>{{Apikey}}</ecom:apikey>
9         <ecom:paymentDeviceDetails>
10            <ecom:TerminalId></ecom:TerminalId>
11         </ecom:paymentDeviceDetails>
12      </ecom:callReadTrxS2S>
13   </soapenv:Body>
14</soapenv:Envelope>

API REST

Create

1{  
2   "shopLogin":"{{shopLogin}}",
3   "amount":"0.01",
4   "currency":"EUR",
5   "shopTransactionID":"{{ShopTransactionID}}",
6   "buyerEmail":"mario.rossi@fabrick.com",
7   "responseURLs": {
8       "buyerOK": "https://{{ThankYouPage_Url}}",
9       "buyerKO": "https://{{ThankYouPage_Url}}",
10       "serverNotificationURL": ""
11   },
12   "paymentType":["FABRICKPASS"],
13   "paymentChannel": {
14       "channelType":["LINK"]
15   },
16   "OrderDetails": {
17       "BankTransferDescription": "{{BankTransferDescription}}",
18       "ProviderPaymentDetails": {
19           "Method": ""
20       },
21       "CustomerDetail": {
22           "FirstName": "Mario",
23           "Lastname": "Rossi",
24           "PrimaryEmail": "mario.rossi@fabrick.com"
25       }
26   }
27}

Detail

1{
2  "shopLogin" : "{{shopLogin}}",
3  "bankTransactionID": "",
4  "shopTransactionID" : "",
5  "paymentID":"{{paymentID}}",
6  "terminalID": ""
7}

Il parametro shopTransactionID è una stringa libera che può essere valorizzata come si desidera. Fare riferimento alla documentazione delle API per conoscere maggiori dettagli, come i caratteri non utilizzabili Axerve API Reference . 

Nel campo Method, è possibile specificare il tipo di bonifico desiderato come segue: 

• Bonifico Istantaneo: valorizzare il campo Method con "instant-sepa-credit-transfers". 

• Bonifico Ordinario: valorizzare il campo Method con "sepa-credit-transfers". 

Questo campo imposterà solo la modalità preferenziale, la scelta finale spetterà sempre all’utente pagante che potrà cambiare la modalità sulla pagina di Fabrick. 

La lunghezza massima di BankTransferDescription è di 120 caratteri ed è possibile inserire solamente caratteri alfanumerici. 

Inserendo i campi della CustomerDetail (FirstName, Lastname, PrimaryEmail) verrà automaticamente superato lo step di inserimento dati del Buyer in FabrickPass. 

Per ulteriori informazioni o supporto tecnico, è possibile contattare il supporto tecnico. 

Popolamento della Causale Bonifico per FabrickPass

Nel caso di utilizzo di FabrickPass, il sistema Orchestra aggiungerà automaticamente un prefisso alla causale del bonifico con il seguente formato:

AAMMGGN

• AA = Ultime due cifcihe dell’anno (es. 25 per il 2025)

• MM = Mese in formato numerico a due cifre (es. 02 per febbraio)

• GG = Giorno in formato numerico a due cifre (es. 24 per il giorno 24)

• N = Contatore giornaliero incrementale (es. 1, 2, 3...)

Esempio della causale generata:

12502241

2502241

Note:

• Per motivi legati all’accettazione da parte delle banche, evitare l’uso di caratteri speciali nella causale.

• La lunghezza massima consentita per la causale è di 50 caratteri.

Inserendo i campi della CustomerDetail (FirstName, Lastname, PrimaryEmail) verrà automaticamente superato lo step di inserimento dati del Buyer in FabrickPass.

Per ulteriori informazioni o supporto tecnico, è possibile consultare la documentazione completa delle API di Fabrick o contattare il supporto tecnico.

Informazioni aggiuntive

Di seguito, abbiamo riportato alcune informazioni utili per gestire l'integrazione:

• La lingua indicata in languageId definisce la lingua dell'e-mail che viene inviata da Fabrick (Gateway) all'acquirente Fabrick API Reference.

• La lingua della pagina di FabrickPass cambia in base a quella impostata sul browser.

• La lingua dell'e-mail spedita da FabrickPass all'acquirente è in doppia lingua. Ad esempio, se la sede è in Italia, la prima lingua sarà l'italiano e la seconda l'inglese.

Le informazioni indicate in CustomerDetail, elencate di seguito, servono per poter saltare la pagina che li richiede su FabrickPass:

• FirstName

• Lastname

• PrimaryEmail

Come verificare l’esito? 

E’ possibile farlo sia tramite una nuova richiesta API (getPaymentDetails) che tramite la dashboard messa a disposizione. Per l’ambiente di test qui viene spiegato come raggiungere la dashboard (https://docs.axerve.com/it/introduzione/configurazioni-tecniche/profilo-venditore/). 

Come indicato già sopra, evidenziamo la differenza di un esito OK in caso di conto Banca Sella e conto differente 

Test FabrickPass (PISP) in Orchestra

Introduzione

Questa sezione descrive il processo di test per i pagamenti con FabrickPass (PISP) in Orchestra, illustrando le diverse casistiche e gli esiti delle transazioni. Una tabella strutturata fornisce i parametri e le configurazioni necessarie per simulare vari scenari di pagamento, garantendo un'analisi accurata delle risposte del sistema.

Se il conto di accredito è un conto Banca Sella, è possibile verificare direttamente il pagamento riconciliato. Questo test non è disponibile per conti presso altre banche.

La sezione è suddivisa in due parti:

• Test con conti Sella

• Test con conti di altre banche

Configurazione dei Parametri in Orchestra

Per effettuare i test, è necessario configurare correttamente i parametri della richiesta.

Parametri principali

• bankId: Identificativo della banca da utilizzare

• bankName: Nome della banca

• product: Tipologia di pagamento (SEPA Credit Transfer o Instant SEPA Credit Transfer)

• amount: Importo del bonifico

• status: Stato finale previsto per il test

• threshold: Tempo (in secondi) necessario per raggiungere lo stato finale

Se il pagamento non viene completato entro 5 minuti, lo stato restituito sarà KO.

Esempio di Test

Obiettivo: verificare un bonifico istantaneo con esito positivo su Banca Sella.

1. Selezionare la riga corrispondente nella tabella dei casi di test.

2. Utilizzare le credenziali della banca corrispondente.

3. Impostare l'importo a 1 €.

Dopo 45 secondi, lo stato del pagamento passerà a OK.

La seguente sezione fornisce un riferimento strutturato per eseguire test affidabili, facilitando l’individuazione di eventuali anomalie e garantendo il corretto funzionamento del sistema di pagamenti.

Casi di Test

Test con Conti Sella

Test con altre banche

Tabella credenziali Conti Sandbox