Pay By Bank

Fabrick Pay by Bank è un metodo di pagamento A2A (Account-to-Account) basato su bonifico SEPA ordinario o istantaneo, conforme alla normativa PSD2 e integrato nel gateway Fabrick Payment Orchestra.

Consente agli esercenti di ricevere fondi direttamente sul proprio conto bancario – sia acceso su Banca Sella sia su altri istituti – attraverso un'esperienza utente fluida e sicura, senza che il cliente debba accedere manualmente al proprio internet banking.

Caratteristiche principali

• Metodo di pagamento A2A

Fabrick Pay by Bank consente di avviare un pagamento tramite bonifico SEPA direttamente dal conto bancario del pagatore, in modalità ordinaria o istantanea, a seconda della disponibilità presso la banca dell’utente.

• Conformità PSD2 e Open Banking

Il metodo sfrutta l’Open Banking per l’autenticazione e l’autorizzazione del pagamento, nel rispetto della normativa PSD2, tramite connessione diretta con la banca del pagatore.

• Bonifico SEPA ordinario o istantaneo

Il merchant riceve il pagamento tramite bonifico SEPA. La modalità ordinaria o istantanea dipende dalla selezione dell’utente e dal supporto della sua banca. L’esperienza utente e il flusso sono identici, indipendentemente dalla modalità.

• Pagamento irrevocabile

Una volta confermato, il bonifico non può essere stornato dal pagatore. Questo riduce drasticamente il rischio di contestazioni e chargeback per l’esercente.

• Interfaccia utente guidata e user-friendly

Il flusso di pagamento accompagna l’utente step-by-step in modo chiaro, anche da mobile, sfruttando l’autenticazione bancaria nota all’utente.

• Costi inferiori rispetto a carte e wallet

Il metodo presenta costi operativi inferiori rispetto ai circuiti tradizionali, rendendolo una scelta vantaggiosa per gli esercenti, specialmente per pagamenti a medio-alto importo.

• Riconciliazione automatica (solo per conti Banca Sella)

La piattaforma Fabrick Payment Orchestra permette la riconciliazione automatica tra bonifici ricevuti e ordini generati, grazie a dati informativi resi disponibili a livello del pagamento (es. CRO, IBAN dell’acquirente).

• Notifica esito asincrona

L’esito del pagamento (eseguito o fallito) viene notificato tramite webhook, anche nel caso di bonifico ordinario, una volta ricevuta conferma dalla banca ricevente.

Stakeholder coinvolti

• Acquirente: autorizza il bonifico tramite il proprio home banking

• Merchant: riceve il pagamento direttamente sul proprio conto bancario

• Fabrick Payment Orchestra: gestisce l’orchestrazione del flusso di pagamento e controlla lo stato della transazione

• Fabrick (Payment Initiation Service Provider – PISP): soggetto regolato che inizializza la richiesta di pagamento in modo sicuro e conforme alla normativa PSD2, fungendo da ponte tra Payment Orchestra e la banca dell'acquirente

• Banca dell’acquirente: esegue materialmente il bonifico a seguito della richiesta di inizializzazione trasmessa da Fabrick.

Requisiti preliminari

• Contratto Ecommerce firmato con Fabrick.

• È consigliabile attivare il prodotto con un conto Banca Sella

• È possibile utilizzare Fabrick Pay by Bank con un conto acceso presso una banca diversa da Banca Sella, ma non ricevendo aggiornamenti sull'effettivo accredito del bonifico, sarà necessaria la riconciliazione manuale.

Funzionamento

1. L’esercente attiva il metodo di pagamento tramite Payment Orchestra

2. Al momento del checkout, l’acquirente seleziona “Fabrick Pay by Bank” come metodo di pagamento

3. Si avvia il flusso di pagamento via bonifico:

   • L’utente sceglie la propria banca

   • Se previsto, seleziona il tipo di bonifico (ordinario o istantaneo)

   • Viene eseguita l’autenticazione tramite Strong Customer Authentication (SCA)

4. Al termine dell’operazione, l’acquirente visualizza l’esito del pagamento

5. Lo stato del pagamento viene aggiornato in tempo reale sulla piattaforma.

Tipologia di bonifico (ordinario o istantaneo)

Configurazione a livello di negozio

L’integrazione di Fabrick Pay by Bank su Payment Orchestra prevede una configurazione a livello di singolo negozio che determina le tipologie di bonifico abilitate per quell’esercente. Le opzioni disponibili sono:

• solo bonifico ordinario

• solo bonifico istantaneo

• entrambe le modalità

Questa configurazione stabilisce quali opzioni di pagamento saranno effettivamente offerte all’acquirente durante il checkout:

• se è configurato solo bonifico ordinario, il bonifico istantaneo non sarà mai proposto

• se è configurato solo bonifico istantaneo, il bonifico ordinario non sarà mai proposto

• se sono configurati entrambi, entrambe le opzioni saranno presentate all’acquirente, che potrà scegliere in base alle modalità supportate dalla propria banca

Campo “Method” nella richiesta di pagamento

Nella richiesta di creazione pagamento (Encrypt per SOAP, Create per REST) è possibile includere il campo opzionale “Method”, che definisce la modalità di pagamento da utilizzare.

• se il campo “Method” è valorizzato, la modalità indicata è vincolante: il pagamento verrà eseguito esclusivamente con quella modalità e l’acquirente non avrà possibilità di modificarla in fase di pagamento.

• se il campo “Method” non è valorizzato, la modalità di pagamento disponibile dipende dalla configurazione effettuata a livello di negozio.

• se il negozio è configurato con entrambe le modalità (bonifico ordinario e bonifico istantaneo), all’acquirente verrà presentata la scelta in fase di pagamento.

• se il negozio è configurato con una sola modalità, l’acquirente procederà direttamente con quella senza possibilità di scelta.

Valori possibili:

• sepa-credit-transfers per il bonifico ordinario

• instant-sepa-credit-transfers per il bonifico istantaneo

Comportamenti possibili

Configurazione negozio	Campo “Method”	Flusso di pagamento
Bonifico ordinario & istantaneo	non valorizzato	All’acquirente vengono presentate entrambe le opzioni in UI, con una pre-selezione automatica su una delle due. Il buyer può modificare la scelta
Bonifico ordinario & istantaneo	sepa-credit-transfers	L’acquirente procede direttamente con bonifico ordinario, senza possibilità di scelta
Bonifico ordinario & istantaneo	instant-sepa-credit-transfers	L’acquirente procede direttamente con bonifico istantaneo, senza possibilità di scelta
Solo bonifico ordinario	non valorizzato	L’acquirente procede direttamente con bonifico ordinario, senza possibilità di scelta
Solo bonifico ordinario	sepa-credit-transfers	L’acquirente procede direttamente con bonifico ordinario, senza possibilità di scelta
Solo bonifico ordinario	instant-sepa-credit-transfers	Errore: valore “Method” non compatibile con la configurazione del negozio
Solo bonifico istantaneo	non valorizzato	L’acquirente procede direttamente con bonifico istantaneo, senza possibilità di scelta
Solo bonifico istantaneo	instant-sepa-credit-transfers	L’acquirente procede direttamente con bonifico istantaneo, senza possibilità di scelta
Solo bonifico istantaneo	sepa-credit-transfers	Errore: valore Method non compatibile con la configurazione del negozio

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

warning

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

#	Stato Fabrick Payment Orchestra	Esito Fabrick Payment Orchestra	Stato Fabrick Dashboard
1	AUT	XX (Pending)	In attesa
2	MOV	OK	Catturato
3	AUT	KO	Fallito

1. Il pagamento è stato avviato ma non è ancora confermato.

   • Bonifico ordinario: l'esito dipende dalle tempistiche della banca dell’acquirente e dall’orario dell’autorizzazione.

   • Bonifico istantaneo: l’esito arriva in pochi secondi o minuti. Per conti Banca Sella, l’aggiornamento è immediato; per altre banche può richiedere più tempo.

2. Il pagamento è stato confermato.

   • Conti Banca Sella: l’importo è stato accreditato sul conto dell’esercente.

   • Altre banche: la banca dell’acquirente ha confermato l’esecuzione del pagamento. Nota: Fabrick non ha visibilità sull’effettivo accredito.

3. Il pagamento non è andato a buon fine.

warning

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

informazioni

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

Riconciliazione e visibilità accrediti

Tipo conto	Riconciliazione	Stato “Catturato” = accredito
Banca Sella	Automatica	Sì
Altra banca	Manuale	No

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:

• Data di autorizzazione: Data in cui l’acquirente ha autorizzato il pagamento
• Importo: Importo del pagamento eseguito
• Valuta: Valuta utilizzata (EUR)
• Stato: Stato attuale del pagamento (Catturato, In attesa, Fallito)
• Metodo: Sempre “Pagamenti alternativi” per Fabrick Pay by Bank
• Circuito: Fabrick Pay by Bank
• Canale: Sempre “Online” per Fabrick Pay by Bank
• Tipo di servizio: Sempre “Ecommerce” per Fabrick Pay by Bank
• Shop login: Identificativo del servizio Ecommerce (account merchant)
• ID negozio: Identificativo tecnico Fabrick del servizio Ecommerce
• ID pagamento: Identificativo univoco della transazione lato Fabrick
• Shop transaction ID: Identificativo della transazione generato dall’esercente
• ID banca: Codice identificativo generato da GestPay.
• Codice di autorizzazione: Codice identificativo generato da GestPay in fase di autorizzazione del pagamento.
• IBAN compratore: IBAN da cui l’acquirente che ha effettuato il pagamento.
• CRO: Codice di riferimento operazione bancaria. Disponibile solo per esercenti con conto Banca Sella.
• Nome / email del compratore: Nome e indirizzo email dell’acquirente, se fornito al momento del pagamento.

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.

È 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 l'integrazione.

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

Campi da includere nella chiamata per Fabrick Pay by Bank

E' essenziale includere correttamente i campi obbligatori nel payload della richiesta.

Di seguito sono riportati gli esempi delle chiamate da eseguire:

POST CreatePayment

{  
   "shopLogin":"{{shopLogin}}",
   "amount":"0.01",
   "currency":"EUR",
   "shopTransactionID":"{{ShopTransactionID}}",
   "buyerEmail":"mario.rossi@fabrick.com",
   "responseURLs": {
       "buyerOK": "https://{{ThankYouPage_Url}}",
       "buyerKO": "https://{{ThankYouPage_Url}}",
       "serverNotificationURL": ""
   },
   "paymentType":["FABRICKPASS"],
   "paymentChannel": {
       "channelType":["LINK"]
   },
   "OrderDetails": {
       "BankTransferDescription": "{{BankTransferDescription}}",
       "ProviderPaymentDetails": {
           "Method": ""
       },
       "CustomerDetail": {
           "FirstName": "Mario",
           "Lastname": "Rossi",
           "PrimaryEmail": "mario.rossi@fabrick.com"
       }
   }
}

GET getPaymentDetails

{
  "shopLogin" : "{{shopLogin}}",
  "bankTransactionID": "",
  "shopTransactionID" : "",
  "paymentID":"{{paymentID}}",
  "terminalID": ""
}

Informazioni aggiuntive utili all'integrazione

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.

informazioni

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

informazioni

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:

• bankId: Identificativo della banca da utilizzare nel test
• bankName: Nome descrittivo della banca selezionata
• product: Tipologia di bonifico: sepa-credit-transfers oppure instant-sepa-credit-transfers
• amount: Importo del bonifico (es. 1.00)
• status: Stato atteso al termine del test (OK, KO, ecc.)
• threshold: Tempo di attesa (in secondi) prima del cambio di stato

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

Dati di Test

Product	Bank	User	Amount	Threshold (s)	E-com Status
instant-sepa-credit-transfers	Mock	05	any value	0	✅ OK
instant-sepa-credit-transfers	Mock	04	2-20-200	60	⏳ XX → OK
instant-sepa-credit-transfers	Mock	04	5-50-500	60	❌ XX → KO
instant-sepa-credit-transfers	Mock	06	any value	0	❌ KO
sepa-credit-transfers	Mock	05	any value	0	✅ OK
sepa-credit-transfers	Mock	04	2-20-200	120	⏳ XX → OK
sepa-credit-transfers	Mock	04	5-50-500	120	❌ XX → KO
sepa-credit-transfers	Mock	06	any value	0	❌ KO

Credenziali conti Sandbox

Banca	User	Password	OTP
Mock	user04	passwd04	11111111
Mock	user05	passwd05	22222222
Mock	user06	passwd06	33333333

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.