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

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

Processo di attivazione

1. Test e certificazione

Utilizzare l'ambiente di test fornito da Axerve per verificare l'integrazione.
Effettuare dei pagamenti di prova per accertare l’assenza di eventuali anomalie.

2. Integrazione con Fabrick

Inviare un‘e-mail con la richiesta di attivazione del metodo di pagamento FabrickPass all’indirizzo presente nell'area dedicata.
Se sono presenti più shopLogin, specificare per quali attivare la funzionalità.
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.
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:

Linguaggio 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>

Linguaggio 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}

Se si vuole specificare la tipologia del bonifico, compilare il campo Method con la preferenza. (SEPA istantaneo o ordinario). Se non si ha una preferenza, è possibile lasciare il campo 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 external link o contattare il supporto tecnico.

FabrickPass