Fabrick Pay by Bank

Causale bonifico

La causale bancaria è sempre popolata da Fabrick Payment Orchestra nel formato seguente:

 AAMMGGn [valore custom oppure shopTransactionId bankId]

Prefisso fisso, generato da Fabrick Payment Orchestra con data e numero univoco (AAMMGGn, es. 2504171), dove:

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

• MM = Mese in formato numerico a due cifre (es. 04 per aprile)

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

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

 Parte variabile:

• Se l’esercente fornisce via API nelle richieste di pagamento un valore custom, questo viene concatenato al prefisso fisso. Il valore deve essere in formato alfanumerico, la lunghezza massima consentita è 120 caratteri

• Se l’esercente non fornisce un valore custom, invece, al prefisso vengono concatenati Shop Transaction ID e Bank ID

 Esempio di causale:

• In caso di valore custom fornito dall’esercente: 2504171 prova, dove:

  • 2504171 - prefisso fisso

  • prova - valore custom fornito dal merchant nella richiesta di pagamento

• Nel caso in cui non venga fornito alcun valore custom dal merchant: 2504171 123456423 123, dove:

  • 2504171 - prefisso fisso

  • 123456423 - Shop Transaction Id

  • 123 - Bank ID

Nella parte variabile della causale (sia per il valore custom sia per lo Shop Transaction ID), non devono essere inseriti caratteri speciali: l’utilizzo di caratteri non alfanumerici può causare errori nella generazione della causale o problemi nei sistemi bancari riceventi.

Stati del pagamento

Su conti non accesi su Banca Sella, Catturato ≠ accreditato: serve verifica manuale per la riconciliazione.

Alcuni stati (AUTHORIZATION_EXPIRED o AUTHORIZATION_REFUSED) non sono visibili su Fabrick Dashboard per semplificare la gestione operativa.

Riconciliazione e visibilità accrediti

Esercenti con conto presso Banca Sella

• Fabrick ha visibilità diretta sul conto dell’esercente.

• L’accredito viene rilevato automaticamente e associato alla transazione.

• Lo stato “Catturato” viene assegnato solo dopo la verifica dell’effettivo accredito del bonifico sul conto dell’esercente.

Esercenti con conto presso altri istituti

• Fabrick non ha accesso al conto dell’esercente, quindi la riconciliazione deve avvenire manualmente.

• Lo stato “Catturato” viene assegnato quando il bonifico è stato eseguito con successo dalla banca del pagatore, ma non implica la verifica dell’effettivo accredito.

Reporting su Fabrick Dashboard

Ogni pagamento Fabrick Pay by Bank è visibile su Dashboard con i seguenti dati:

Vantaggi e limiti

Per il cliente finale

• Nessuna registrazione esterna

• Sicurezza tramite autenticazione bancaria (SCA)

• Zero frodi

• Tracciabilità e irrevocabilità dei pagamenti

Per l'esercente

• Costi più bassi rispetto a carte e wallet

• Zero frodi

• Pagamenti irrevocabili e conformi a PSD2

• Riconciliazione automatica (solo Sella)

• Esperienza di pagamento moderna e integrata

Limiti

• Nessuna riconciliazione automatica per conti non Sella

• Catturato ≠ accredito effettivo su conti esterni

Integrazione tecnica

Attivazione dell'ambiente di test

Per testare la soluzione Fabrick Pay by Bank, è necessario disporre di un ambiente di test.
Se non lo si ha già, è possibile crearlo seguendo le istruzioni disponibili nella sezione Richiedere un account di test | Fabrick.

Al termine della registrazione, verrà generato uno Shop Login nel formato:
GESPAYXXXXX.

Richiesta di attivazione del metodo di pagamento

Una volta ottenuto lo Shop Login dell’ambiente di test, è necessario richiedere l’attivazione del metodo Fabrick Pay by Bank.

La richiesta può essere inviata:

• al proprio referente commerciale Fabrick, oppure

• tramite l’area dedicata Richiedi assistenza, selezionando:

  • Prodotto: “Fabrick Payment Orchestra”

  • Argomento “Altro” nel menu a tendina.

È fondamentale indicare lo Shop Login dell’ambiente di test nella richiesta.

Onboarding e configurazione

A seguito della richiesta, si riceverà una e-mail contenente il link per l’onboarding.
Seguendo il link, sarà possibile completare l’attivazione dell’account inserendo le informazioni richieste.

Inizializzazione di un pagamento

Una volta attivato l’ambiente di test, è possibile iniziare a simulare i pagamenti utilizzando una delle due modalità disponibili:

• SOAP API

• REST API

I domini e gli endpoint da utilizzare sono descritti nella sezione dedicata Primo pagamento. 

Campi da includere nella chiamata per Fabrick Pay by Bank

Indipendentemente dalla modalità scelta (SOAP o REST), è essenziale includere correttamente alcuni campi obbligatori nel payload della richiesta.

Di seguito sono riportati gli esempi delle chiamate da eseguire a seconda della modalità scelta.

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}

Informazioni aggiuntive utili all'integrazione

Shop Transaction ID

Il campo shopTransactionID è una stringa libera che identifica in modo univoco la transazione.
Può essere valorizzata secondo le esigenze dell’esercente, nel rispetto dei vincoli riportati nella documentazione tecnica Axerve (es. caratteri non consentiti).

Tipologia di bonifico e campo “Method”

Per maggiori dettagli, consulta la sezione dedicata. 

Popolamento della causale bonifico

Per maggiori dettagli, consulta la sezione dedicata. 

CustomerDetail e semplificazione del checkout

L’inserimento completo dei dati in CustomerDetail:

• CustomerDetail.FirstName

• CustomerDetail.LastName

• CustomerDetail.PrimaryEmail

consente all’acquirente di saltare lo step di inserimento manuale dei propri dati nel flusso di pagamento Fabrick Pay by Bank. Questa ottimizzazione semplifica l’esperienza utente e riduce l’attrito nel checkout.

Il campo buyerEmail rappresenta l’indirizzo e-mail dell’utente che effettua il pagamento.

Il campo PrimaryEmail rappresenta il titolare del conto e può essere lasciato vuoto nella richiesta API (verrà richiesto in pagina, se non valorizzato).

Localizzazione

• Il campo languageId consente di definire la lingua dell’e-mail inviata dal gateway Fabrick Payment Orchestra all’acquirente.

• La lingua della pagina Fabrick Pay by Bank si adatta automaticamente alla lingua del browser dell’utente.

• Le e-mail di Fabrick Pay by Bank sono multilingua: la prima lingua corrisponde al Paese dell’esercente, la seconda è l’inglese (es. italiano/inglese). 

Come verificare l’esito del pagamento

L’esito della transazione può essere verificato tramite:

• Chiamata API getPaymentDetails

• Dashboard dell’ambiente di test ➤ Guida all’accesso alla dashboard

Per esercenti con conti Banca Sella, lo stato “Catturato” corrisponde all’effettivo accredito.

Per esercenti con conti presso altre banche, lo stato “Catturato” indica solo l’avvenuta esecuzione confermata dalla banca dell’acquirente.

Test pagamenti Fabrick Pay by Bank su Fabrick Payment Orchestra

Introduzione

Questa sezione descrive come eseguire test controllati per i pagamenti tramite Fabrick Pay by Bank integrati con Payment Orchestra, simulando vari scenari e osservando gli esiti attesi.

Una tabella strutturata fornisce i parametri e le configurazioni necessarie per simulare vari scenari di pagamento, garantendo un'analisi accurata delle risposte del sistema.

I test sono suddivisi in due categorie principali:

• Test per esercenti con conto Banca Sella: è possibile verificare l’intero ciclo di pagamento fino all’accredito (inclusa la riconciliazione).

• Test per esercenti con conti di altre banche: il test termina con la conferma dell’esecuzione da parte della banca dell’acquirente, ma senza verifica dell'effettivo accredito.

Parametri da configurare

Per ciascun test, è necessario impostare correttamente alcuni parametri nella richiesta:

Se la transazione non si conclude entro 5 minuti, il sistema restituirà esito KO per timeout.

Esempio di test

Obiettivo: Verificare un bonifico istantaneo eseguito con esito positivo verso conto di accredito Banca Sella.

Procedura:

1. Selezionare il test case relativo da tabella (vedi documentazione tecnica).

2. Usare le credenziali bancarie fornite per il test.

3. Impostare il campo amount su 1.00.

4. Dopo circa 45 secondi, il pagamento risulterà eseguito con successo (OK).

Test con conti correnti Banca Sella

Test con conti correnti di altre banche

Credenziali conti Sandbox

FAQ tecniche Fabrick Pay by Bank

È possibile offrire solo bonifico istantaneo (o solo ordinario)?

Sì, l’esercente può richiedere a Fabrick di configurare solo una delle due modalità (bonifico ordinario oppure bonifico istantaneo). In tal caso, l’acquirente non visualizzerà alcuna opzione di scelta e il pagamento sarà forzatamente eseguito con il tipo di bonifico configurato.

Il cliente può scegliere il tipo di bonifico (ordinario o istantaneo)?

Sì, ma solo se entrambe le modalità (bonifico ordinario e istantaneo) sono abilitate per il negozio. In questo scenario, tramite il campo “Method” valorizzato in fase di richiesta (sepa-credit-transfers oppure instant-sepa-credit-transfers), l’esercente può pre-selezionare il tipo di bonifico suggerito all’acquirente. Tuttavia, l’utente avrà comunque la possibilità di modificarlo manualmente nella schermata di pagamento.

Lo stato “Catturato” garantisce sempre l’accredito?

Solo in caso di conti Banca Sella perché Fabrick è in grado di leggere direttamente l’accredito sul conto dell’esercente.

Per esercenti non correntisti Banca Sella, invece, lo stato “Catturato” indica che il pagamento è stato eseguito ma è necessaria una riconciliazione manuale lato esercente.

Posso usare caratteri speciali nel valore custom della causale?

No, è importante utilizzare solo caratteri alfanumerici semplici. L'inserimento di caratteri speciali può compromettere la corretta elaborazione del bonifico.