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.

• Avere un conto idoneo presso 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 istantaneo:

• Pending -> OK: Bonifico in procedura e poi eseguito.

• Pending -> KO: Bonifico in procedura e poi non riuscito.

• OK: Bonifico eseguito.

• KO: Bonifico non riuscito.

Bonifico ordinario:

• Pending -> OK: Bonifico in procedura e poi eseguito.

• Pending -> KO: Bonifico in procedura e poi non riuscito.

• OK: Bonifico eseguito.

• KO: Bonifico non riuscito.

Casi rari su Bonifico Istantaneo/Ordinario:

• OK -> KO: Transazione annullata (possibili frodi o cancellazione, vietata da normativa).

Conti Banca Sella

Bonifico istantaneo:

• Pending -> OK: Bonifico in procedura e poi eseguito, importo accreditato sul conto.

• Pending -> KO: Bonifico in procedura e poi non riuscito.

• OK: Bonifico eseguito, importo accreditato sul conto.

• KO: Bonifico non riuscito.

Bonifico ordinario:

• Pending -> OK: Bonifico in procedura e poi eseguito, importo accreditato sul conto.

• Pending -> KO: Bonifico in procedura e poi non riuscito.

• 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. Test e certificazione

1. Utilizzare l'ambiente di test fornito da Fabrick per verificare l'integrazione.

2. Effettuare dei pagamenti di prova per accertare l’assenza di eventuali anomalie.

2. Integrazione con Fabrick

1. Inviare un‘e-mail con la richiesta di attivazione del metodo di pagamento FabrickPass all’indirizzo presente nell'area dedicata.

2. Se sono presenti più shopLogin, specificare per quali attivare la funzionalità.

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

4. Configurare le informazioni richieste e iniziare a utilizzare FabrickPass.

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}

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".

• Nessuna preferenza: se non vi è preferenza tra bonifico istantaneo o ordinario, lasciare il campo Method vuoto.

La lunghezza massima di BankTransferDescription è di 120 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