--- title: "Pay By Bank" description: "Fabrick Pay by Bank è un metodo di pagamento A2A basato su bonifico SEPA ordinario o istantaneo, conforme alla normativa PSD2. In questa guida scoprirai come attivarlo, configurarlo su Fabrick Payment Orchestra e integrarlo correttamente nel tuo e-commerce." url: "https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/" language: "it" --- # 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](https://www.fabrick.com/it-it/prodotti/pay-by-bank/) --- ## 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#tipologia-di-bonifico)). - **Causale strutturata**: la causale bancaria viene sempre popolata da Payment Orchestra, con possibilità di aggiungere un valore custom (vedi [Causale bonifico](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#causale-bonifico)). - **Riconciliazione automatica**: disponibile per gli esercenti con conto Banca Sella, grazie alla visibilità diretta sull'accredito (vedi [Riconciliazione e visibilità accrediti](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#riconciliazione-e-visibilit%C3%A0-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 1. Al checkout l'acquirente seleziona **Fabrick Pay by Bank** come metodo di pagamento 2. Sceglie la propria banca 3. Se previsto dalla configurazione, seleziona il tipo di bonifico (ordinario o istantaneo) 4. Completa l'autenticazione tramite **Strong Customer Authentication (SCA)** 5. 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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: ```text 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**: ```text 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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](https://landing.fabrick.com/fabrick-dashboard-support) 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](https://docs.fabrick.com/assets/images/pbb-attivazione-89e8b5cf6226e351f1085db0b20a3c49.png) > **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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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](https://docs.fabrick.com/assets/images/checkout-page-pbb-c7de6784e811fd16cf960952847b117b.png) Quando l'utente seleziona Pay By Bank, viene reindirizzato al servizio per completare il pagamento. ![Pagina di pagamento con Pay By Bank](https://docs.fabrick.com/assets/images/pbb-1-82d116a65dd31e7d08a9352e7981eca0.png) --- ## 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** ```http POST /api/v1/payment/create Host (sandbox): sandbox.gestpay.net Host (produzione): ecomms2s.sella.it Authorization: apikey **************** Content-Type: application/json ``` ```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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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](https://www.fabrick.com/it-it/pay-by-bank/). ### Verifica dell'esito del pagamento L'esito della transazione può essere verificato tramite la chiamata `GET payment/detail` oppure direttamente dalla Fabrick Dashboard. **Request** ```http 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#riconciliazione-e-visibilit%C3%A0-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](https://docs.fabrick.com/assets/images/pbb-2-9a320b0d40514013fa1c4ea900470223.png) | 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/#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 è: ```text 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: 1. Inizializza la transazione con `payment/create`, impostando l'**importo** riportato nella tabella **Dati di test** in base all'esito che vuoi ottenere 2. 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 3. 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** | 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 | **Bonifico ordinario** | 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](https://docs.fabrick.com/assets/images/pbb-3-028fe69d4cec3c8427ace5902c360bbd.png) ![Conferma del pagamento con la banca Mock](https://docs.fabrick.com/assets/images/pbb-4-b7b29d70e55ad1dd997ba189d653fce2.png) --- ## 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/](https://status.fabrick.com/) - **Support**: [https://landing.fabrick.com/fabrick-dashboard-support](https://landing.fabrick.com/fabrick-dashboard-support)