Pay By Bank

Perché scegliere 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 in Fabrick Payment Orchestra.

Consente agli esercenti di ricevere i fondi direttamente sul proprio conto bancario, sia presso Banca Sella sia presso altri istituti, attraverso un'esperienza di pagamento fluida e sicura, senza che l'acquirente debba accedere manualmente al proprio internet banking.

Approfondimento

Per ulteriori informazioni consulta la documentazione ufficiale Fabrick

Servizi e funzionalità disponibili tramite integrazione Fabrick

L'integrazione di Pay By Bank con Fabrick Payment Orchestra mette a disposizione le seguenti funzionalità:

Pagamento A2A tramite bonifico SEPA: il pagamento viene avviato direttamente dal conto bancario dell'acquirente, in modalità ordinaria o istantanea, in base alla disponibilità presso la sua banca.
Conformità PSD2 e Open Banking: autenticazione e autorizzazione del pagamento avvengono tramite connessione diretta con la banca dell'acquirente, nel rispetto della normativa PSD2.
Pagamento irrevocabile: una volta confermato, il bonifico non può essere stornato dall'acquirente. Il rischio di contestazioni e chargeback per l'esercente è di fatto azzerato.
Costi inferiori rispetto a carte e wallet: i costi operativi sono più contenuti rispetto ai circuiti tradizionali, un vantaggio che cresce all'aumentare dell'importo.
Scelta della tipologia di bonifico: ordinario, istantaneo o entrambi, in base alla configurazione del negozio e al campo Method della richiesta (vedi Tipologia di bonifico).
Causale strutturata: la causale bancaria viene sempre popolata da Payment Orchestra, con possibilità di aggiungere un valore custom (vedi Causale bonifico).
Riconciliazione automatica: disponibile per gli esercenti con conto Banca Sella, grazie alla visibilità diretta sull'accredito (vedi Riconciliazione e visibilità accrediti).
Notifica esito asincrona: l'esito del pagamento viene notificato tramite notifica server-to-server, anche in caso di bonifico ordinario, una volta ricevuta conferma dalla banca ricevente.
Esperienza utente guidata: il flusso accompagna l'acquirente passo per passo, anche da mobile, sfruttando l'autenticazione bancaria che già conosce.

Conti non Banca Sella

Con un conto presso un istituto diverso da Banca Sella il metodo è utilizzabile, ma Fabrick non riceve aggiornamenti sull'effettivo accredito del bonifico: la riconciliazione deve essere effettuata manualmente dall'esercente.

Esperienza di pagamento per l'acquirente

Al checkout l'acquirente seleziona Fabrick Pay by Bank come metodo di pagamento
Sceglie la propria banca
Se previsto dalla configurazione, seleziona il tipo di bonifico (ordinario o istantaneo)
Completa l'autenticazione tramite Strong Customer Authentication (SCA)
Al termine dell’operazione, l’acquirente visualizza l’esito del pagamento

Dati precompilati

Valorizzando CustomerDetail nella richiesta di pagamento, l'acquirente salta lo step di inserimento manuale dei propri dati, riducendo l'attrito nel checkout (vedi CustomerDetail).

Tipologia di bonifico

La tipologia di bonifico utilizzabile dipende da due elementi: la configurazione del negozio e il campo Method della richiesta di pagamento.

Configurazione a livello di negozio

L'integrazione prevede una configurazione a livello di singolo negozio che determina le tipologie di bonifico abilitate per quell'esercente:

solo bonifico ordinario
solo bonifico istantaneo
entrambe le modalità

Questa configurazione stabilisce quali opzioni vengono effettivamente offerte all'acquirente durante il checkout: se il negozio è configurato con una sola modalità l'altra non viene mai proposta, mentre con entrambe abilitate l'acquirente può scegliere in base a quanto supportato dalla propria banca.

Campo Method nella richiesta di pagamento

Nella richiesta di creazione del pagamento è possibile includere il campo opzionale OrderDetails.ProviderPaymentDetails.Method, che definisce la modalità di pagamento da utilizzare.

Valore	Tipologia
`sepa-credit-transfers`	Bonifico ordinario
`instant-sepa-credit-transfers`	Bonifico istantaneo

Se il campo è valorizzato, la modalità indicata è vincolante: il pagamento viene eseguito esclusivamente con quella modalità e l'acquirente non può modificarla. Se non è valorizzato, la modalità disponibile dipende dalla configurazione del negozio.

Causale bonifico

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

AAMMGGn shopTransactionID bankID

Il prefisso AAMMGGn è composto da data e numero univoco:

Componente	Descrizione
`AA`	Ultime due cifre dell'anno (es. `25` per il 2025)
`MM`	Mese a due cifre (es. `04` per aprile)
`GG`	Giorno a due cifre (es. `17`)
`n`	Contatore giornaliero incrementale (`1`, `2`, `3`…)

Al prefisso vengono concatenati Shop Transaction ID e Bank ID:

2504171 123456423 123

2504171 — prefisso fisso
123456423 — Shop Transaction ID
123 — Bank ID

Causale personalizzata

È possibile sostituire Shop Transaction ID e Bank ID con un testo scelto dall'esercente, valorizzando il campo BankTransferDescription nella richiesta di pagamento (vedi BankTransferDescription).

Stati del pagamento

Stato Payment Orchestra	Esito Payment Orchestra	Stato Fabrick Dashboard	Significato
`AUT`	`XX` (Pending)	In attesa	Pagamento avviato ma non ancora confermato
`AUT`	`KO`	Fallito	Pagamento non andato a buon fine
`MOV`	`OK`	Catturato	Pagamento confermato

In attesa. Per il bonifico ordinario l'esito dipende dalle tempistiche della banca dell'acquirente e dall'orario dell'autorizzazione. Per il bonifico istantaneo l'esito arriva in pochi secondi o minuti: per i conti Banca Sella l'aggiornamento è immediato, per altre banche può richiedere più tempo.

Catturato. Per i conti Banca Sella significa che l'importo è stato accreditato sul conto dell'esercente. Per gli altri istituti significa che la banca dell'acquirente ha confermato l'esecuzione del pagamento, senza che Fabrick abbia visibilità sull'effettivo accredito.

Catturato ≠ accreditato

Per gli esercenti con conto presso un istituto diverso da Banca Sella lo stato Catturato (MOV / OK) non certifica l'accredito: attesta solo che la banca dell'acquirente ha eseguito il bonifico. La verifica dell'effettivo accredito e la riconciliazione restano a carico dell'esercente.

Riconciliazione e visibilità accrediti

Tipo conto	Riconciliazione	Stato Catturato = accredito
Banca Sella	Automatica	✅ Sì
Altro istituto	Manuale	❌ No

Esercenti con conto Banca Sella. Fabrick ha visibilità diretta sul conto: l'accredito viene rilevato automaticamente e associato alla transazione. Lo stato Catturato viene assegnato solo dopo la verifica dell'effettivo accredito.

Esercenti con conto presso altri istituti. Fabrick non ha accesso al conto dell'esercente, quindi la riconciliazione è manuale. Lo stato Catturato viene assegnato quando il bonifico è stato eseguito con successo dalla banca del pagatore, ma non implica la verifica dell'accredito.

IBAN compratore

Per le transazioni Pay By Bank, in Dashboard è disponibile il campo IBAN compratore, che riporta l'IBAN da cui è stato effettuato il pagamento.

Pay By Bank su Fabrick Payment Orchestra: attivazione e modalità di integrazione

Richiesta di attivazione

Per iniziare ad accettare pagamenti con Pay By Bank, puoi richiedere l'attivazione:

Contattando il tuo referente commerciale
Contattando l'assistenza al seguente link

Una volta completate le procedure necessarie:

Fabrick abilita Pay By Bank sul negozio e informa l'esercente.
È possibile verificare l'attivazione del metodo di pagamento all'interno della Dashboard, al percorso Workspace → Negozi → [Seleziona negozio] → Configurazioni

Pay By Bank - Attivazione

Attivazione completata

Da questo momento, il tuo e-commerce è pronto per accettare pagamenti Pay By Bank tramite Fabrick Payment Orchestra.

Tipologie di integrazione

Fabrick offre due modalità di integrazione per utilizzare Pay By Bank:

Integrazione hosted

Integrazioni supportate
✓Checkout Page
✓Pay By Link
✓Web Component
✓Lightbox

Pay By Bank viene mostrato direttamente nella pagina di pagamento Fabrick, senza alcun intervento di sviluppo lato merchant. Fabrick gestisce autonomamente la visualizzazione del metodo e l'intera fase di processamento.
Integrazione tramite API

Integrazioni supportate
✓API Only

Il redirect verso Pay By Bank è gestito direttamente tramite API. È necessario inizializzare la transazione con payment/create valorizzando il campo paymentType con il tag FABRICKPASS e gestire il redirect del buyer.

Testare Pay By Bank in ambiente sandbox

In ambiente di test è possibile simulare esiti positivi, negativi e in attesa utilizzando le credenziali della banca Mock, senza eseguire bonifici reali. Vedi Ambiente di test.

Integrazione hosted

Pay By Bank viene mostrato direttamente nella pagina di pagamento Fabrick, senza alcuno sviluppo aggiuntivo da parte del merchant. Fabrick gestisce autonomamente la visualizzazione del metodo e l'intera fase di processamento della transazione.

Per impostare la chiamata con l'integrazione hosted, vai alla sezione creazione della transazione e redirect verso Pay By Bank e rimuovi il campo paymentType dalla chiamata payment/create.

Pagina di pagamento con Pay By Bank

Quando l'utente seleziona Pay By Bank, viene reindirizzato al servizio per completare il pagamento.

Pagina di pagamento con Pay By Bank

Integrazione tramite API

Per richiedere il pagamento con Pay By Bank utilizzando l'integrazione tramite API, è necessario inizializzare la transazione tramite payment/create utilizzando il tag FABRICKPASS nel campo paymentType.

Creazione della transazione e redirect verso Pay By Bank

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

{
    "shopLogin": "GESPAY12345",
    "amount": "10",
    "currency": "EUR",
    "shopTransactionID": "FBK_OrderID",
    "paymentType": ["FABRICKPASS"], // Per integrazione hosted eliminare questa riga
    "paymentChannel": { "channelType": ["LINK"] },
    "OrderDetails": {
        "CustomerDetail": {
            "FirstName": "John",
            "Lastname": "Doe",
            "PrimaryEmail": "buyer@email.com",
            "Iban": "IT74M0339512900052633342960"
        },
        "BankTransferDescription": "causale 123",
        "ProviderPaymentDetails": {
            //"Method": "sepa-credit-transfers"
            "Method": "instant-sepa-credit-transfers"
        }
    }
}

Campo Method

Il campo Method è facoltativo. Se valorizzato, la modalità indicata è vincolante (vedi Tipologia di bonifico).

Pulsante Pay By Bank

Il link restituito può essere utilizzato sotto un pulsante Paga con Pay By Bank, rispettando le linee guida di utilizzo del marchio.

Verifica dell'esito del pagamento

L'esito della transazione può essere verificato tramite la chiamata GET payment/detail oppure direttamente dalla Fabrick Dashboard.

Request

GET /api/v1/payment/detail/{paymentID}
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

Interpretazione dello stato

Per gli esercenti con conto Banca Sella lo stato Catturato corrisponde all'effettivo accredito. Per gli esercenti con conto presso altre banche indica solo l'avvenuta esecuzione confermata dalla banca dell'acquirente (vedi Riconciliazione e visibilità accrediti).

Campi da inviare nella chiamata verso Pay By Bank

Pay By Bank non richiede campi specifici oltre a quelli comuni a tutte le transazioni: i parametri descritti di seguito sono tutti facoltativi e permettono di personalizzare il comportamento del pagamento.

ProviderPaymentDetails

Nella richiesta di creazione del pagamento è possibile includere il campo opzionale OrderDetails.ProviderPaymentDetails.Method, che definisce la modalità di pagamento da utilizzare.

Valore	Tipologia
`sepa-credit-transfers`	Bonifico ordinario
`instant-sepa-credit-transfers`	Bonifico istantaneo

Campo vincolante

Se il campo Method è valorizzato, la modalità indicata è vincolante: il pagamento viene eseguito esclusivamente con quella modalità e l'acquirente non può modificarla in fase di pagamento.

Se il campo non è valorizzato, l'acquirente sceglie tra bonifico ordinario e istantaneo in base a quanto proposto dalla propria banca.

CustomerDetail

La valorizzazione completa di CustomerDetail consente all'acquirente di saltare l'inserimento manuale dei propri dati nel flusso di pagamento.

Pagina di pagamento con Pay By Bank CustomerDetail

Campo	Descrizione
`OrderDetails.CustomerDetail.FirstName`	Nome dell'acquirente
`OrderDetails.CustomerDetail.Lastname`	Cognome dell'acquirente
`OrderDetails.CustomerDetail.PrimaryEmail`	E-mail del titolare del conto
`OrderDetails.CustomerDetail.Iban`	IBAN del conto da cui l'acquirente esegue il bonifico. Se valorizzato, l'acquirente salta la pagina di inserimento dell'IBAN

PrimaryEmail

PrimaryEmail identifica il titolare del conto e può essere lasciato vuoto nella richiesta: in tal caso viene richiesto direttamente sulla pagina di pagamento.

BankTransferDescription

Il campo OrderDetails.BankTransferDescription permette di sostituire la parte variabile della causale con un testo definito dall'esercente. Quando è valorizzato, Payment Orchestra concatena questo valore al prefisso fisso al posto di Shop Transaction ID e Bank ID (vedi Causale bonifico).

Campo	Max	Descrizione
`OrderDetails.BankTransferDescription`	120	Valore custom della causale. In sua assenza il prefisso viene concatenato a Shop Transaction ID e Bank ID

Inviando "BankTransferDescription": "causale 123" la causale risultante è:

2504171 causale 123

2504171 — prefisso fisso, generato da Payment Orchestra
causale 123 — valore trasmesso dall'esercente

Il valore custom è utile quando la causale deve riportare un riferimento riconoscibile dall'esercente o dal proprio cliente — un numero d'ordine, un codice contratto, il nome di un servizio in abbonamento — invece degli identificativi tecnici generati dal gateway.

Caratteri ammessi

Nel valore custom della causale sono ammessi solo caratteri alfanumerici e lo spazio. L'uso di altri caratteri speciali può causare errori nella generazione della causale o problemi nei sistemi bancari riceventi.

Ambiente di test

Per testare il metodo di pagamento:

Inizializza la transazione con payment/create, impostando l'importo riportato nella tabella Dati di test in base all'esito che vuoi ottenere
Seleziona la tipologia di bonifico instant-sepa-credit-transfers o sepa-credit-transfers valorizzando il campo Method nella chiamata, oppure seleziona la modalità direttamente sulla pagina di pagamento
Completa il pagamento utilizzando utente, password e OTP riportati nella stessa riga della tabella: è la combinazione di utente e importo a determinare l'esito

Dati di test

Bonifico istantaneo
Bonifico ordinario

Banca	Utente	Password	OTP	Importo	Autenticazione	Attesa (s)	Esito
Mock	`user05`	`passwd05`	`22222222`	qualsiasi	Redirect - IBAN IT09Y	0	✅ OK
Mock	`user04`	`passwd04`	`11111111`	2, 20 o 200	Redirect/Embedded	60	⏳ XX → OK
Mock	`user04`	`passwd04`	`11111111`	5, 50 o 500	Redirect/Embedded	60	❌ XX → KO
Mock	`user06`	`passwd06`	`33333333`	qualsiasi	Embedded	0	❌ KO

Banca	Utente	Password	OTP	Importo	Autenticazione	Attesa (s)	Esito
Mock	`user05`	`passwd05`	`22222222`	qualsiasi	Redirect - IBAN IT41K	0	✅ OK
Mock	`user04`	`passwd04`	`11111111`	2, 20 o 200	Redirect/Embedded	120	⏳ XX → OK
Mock	`user04`	`passwd04`	`11111111`	5, 50 o 500	Redirect/Embedded	120	❌ XX → KO
Mock	`user06`	`passwd06`	`33333333`	qualsiasi	Embedded	0	❌ KO

Stato sospeso (XX)

Nelle righe con esito XX → OK e XX → KO la transazione resta temporaneamente in stato sospeso prima di ricevere l'esito definitivo: è il comportamento tipico dei pagamenti con esito asincrono, di cui Pay By Bank fa parte.

In questo scenario l'esercente riceve due notifiche server-to-server: la prima con stato XX, al momento dell'autorizzazione, la seconda quando l'esito diventa definitivo (OK o KO).

Finché lo stato è XX non procedere con la spedizione della merce o l'erogazione del servizio: attendi la seconda notifica. Il buyer viene comunque reindirizzato alla URL di esito positivo, quindi il redirect da solo non è sufficiente per considerare l'ordine pagato

Selezione della banca Mock in ambiente di test

Conferma del pagamento con la banca Mock

FAQ

È possibile offrire solo il bonifico istantaneo, o solo l'ordinario?

Sì. L'esercente può richiedere a Fabrick di configurare una sola delle due modalità. In tal caso l'acquirente non visualizza alcuna opzione di scelta e il pagamento viene eseguito con il tipo di bonifico configurato.

L'acquirente può scegliere il tipo di bonifico?

Solo se entrambe le modalità sono abilitate per il negozio e il campo Method non è valorizzato nella richiesta. Se Method è valorizzato, la modalità indicata è vincolante e l'acquirente non può modificarla.

Lo stato "Catturato" garantisce sempre l'accredito?

Solo per i conti Banca Sella, dove Fabrick legge direttamente l'accredito sul conto dell'esercente. Per gli esercenti con conto presso altri istituti lo stato indica che il pagamento è stato eseguito, ma la riconciliazione resta a carico dell'esercente.

Posso usare caratteri speciali nel valore custom della causale?

No. Vanno utilizzati esclusivamente caratteri alfanumerici: l'inserimento di caratteri speciali può compromettere la corretta elaborazione del bonifico.

L'acquirente può richiedere lo storno del bonifico?

No. Il bonifico SEPA è irrevocabile una volta confermato: è questa la caratteristica che azzera il rischio di chargeback per l'esercente.

In quale lingua viene mostrata la pagina di pagamento?

La lingua della pagina Pay By Bank si adatta automaticamente alla lingua del browser dell'acquirente.

Assistenza

Fabrick

Status page: https://status.fabrick.com/
Support: https://landing.fabrick.com/fabrick-dashboard-support

Pay By Bank

Perché scegliere Pay By Bank​

Servizi e funzionalità disponibili tramite integrazione Fabrick​

Esperienza di pagamento per l'acquirente​

Tipologia di bonifico​

Configurazione a livello di negozio​

Campo Method nella richiesta di pagamento​

Causale bonifico​

Stati del pagamento​

Riconciliazione e visibilità accrediti​

Pay By Bank su Fabrick Payment Orchestra: attivazione e modalità di integrazione​

Richiesta di attivazione​

Tipologie di integrazione​

Integrazioni supportate

Integrazioni supportate

Integrazione hosted​

Integrazione tramite API​

Creazione della transazione e redirect verso Pay By Bank​

Verifica dell'esito del pagamento​

Campi da inviare nella chiamata verso Pay By Bank​

ProviderPaymentDetails​

CustomerDetail​

BankTransferDescription​

Ambiente di test​

Dati di test​

FAQ​

Assistenza​