Passa al contenuto principale

SEPA Direct Debit (SDD)

Visualizza come Markdown

Perché scegliere SEPA Direct Debit​

L'Addebito Diretto SEPA (SEPA Direct Debit, SDD) consente all'esercente di incassare somme direttamente dal conto corrente del cliente, a fronte di un mandato con cui il cliente autorizza gli addebiti. Non richiede una carta di pagamento ed è indicato per gli incassi automatici e prevedibili, ad esempio:

  • abbonamenti periodici;
  • utenze e servizi ricorrenti;
  • servizi assicurativi.

Con Fabrick Payment Orchestra il mandato viene sottoscritto online con Firma Elettronica Avanzata (FEA) e gli addebiti vengono inviati e monitorati da un unico punto di integrazione. La piattaforma supporta lo schema SEPA Core.

Disponibilità

L'integrazione SDD su Payment Orchestra è disponibile per gli esercenti clienti di Banca Sella, che opera come banca del creditore e veicola le richieste di addebito verso il circuito SEPA.

Servizi e funzionalità disponibili tramite integrazione Fabrick​

  • Mandato digitale con FEA: il cliente sottoscrive il mandato online con firma elettronica avanzata tramite OTP via SMS. Il mandato ha valore legale ed è conservato per 10 anni.
  • Mandato come token: al termine della sottoscrizione viene restituito un token che identifica il mandato, da utilizzare per tutti gli addebiti successivi (vedi Creazione del mandato).
  • Addebiti ricorrenti o una tantum: su un mandato esistente è possibile eseguire uno o più addebiti, anche senza la presenza del cliente (vedi Esecuzione di un addebito).
  • Primo addebito contestuale: il primo addebito può essere eseguito insieme alla creazione del mandato, che resta disponibile per gli addebiti successivi.
  • Data di addebito automatica o pianificata: il sistema calcola la prima data utile nel rispetto delle tempistiche SEPA, oppure l'esercente indica una data specifica (vedi Gestione della data di addebito).
  • Monitoraggio centralizzato: gli esiti, compresi scarti, insoluti e rimborsi, sono visibili nella Fabrick Dashboard.

Come funziona​

Flusso operativo​

FaseDescrizione
Creazione del mandatoIl cliente (debitore) autorizza l'esercente (creditore) a eseguire addebiti sul proprio conto tramite un mandato SEPA firmato online
Richiesta di incassoL'esercente invia a Payment Orchestra la richiesta di addebito sul mandato
Esecuzione bancariaL'addebito viene eseguito dopo 2 o 3 giorni lavorativi, in base all'orario di invio, oppure nella data indicata dall'esercente (vedi Tempistiche)
Gestione degli esitiTutti gli esiti, compresi scarti, insoluti e rimborsi, sono visibili nella Fabrick Dashboard

Modello di funzionamento e vincoli d'uso​

SDD è un metodo basato sulla tokenizzazione: il mandato costituisce il token e deve essere creato prima di poter eseguire qualsiasi addebito. L'integrazione prevede sempre due fasi distinte:

  1. creazione del mandato (tokenizzazione), indicando esplicitamente SDD nel campo paymentType;
  2. utilizzo del token per uno o più addebiti successivi, ricorrenti o una tantum.

È possibile eseguire un primo addebito contestualmente alla creazione del mandato, ma il token resta comunque disponibile per gli utilizzi futuri: non è previsto uno scenario in cui il mandato viene creato e consumato senza essere conservato.

SDD non è un metodo di pagamento immediato

SDD non viene mostrato nella pagina di selezione del metodo di pagamento di Payment Orchestra: il buyer non può sceglierlo in un elenco di metodi (ad esempio carta, PayPal o Klarna) e pagare senza aver prima sottoscritto un mandato.

OperazioneNote
✅Avviare una tokenizzazione SDD esplicitaIl paymentType SDD deve essere indicato nella chiamata
✅Ottenere il token del mandato e salvarloRecuperabile con payment/detail dopo la creazione del mandato
✅Eseguire addebiti ricorrenti o futuri su un token esistenteFlusso tipico: sottoscrizione del mandato, recupero del token, addebiti in assenza del cliente
✅Eseguire un primo addebito contestualmente alla creazione del mandatoIl token resta attivo per gli addebiti successivi
❌Proporre SDD come metodo selezionabile in una pagina di pagamentoSDD non è utilizzabile come pagamento immediato senza un mandato
❌Addebitare un buyer che non dispone di un mandato attivoOgni addebito richiede un mandato; il mandato può essere creato in un momento precedente
❌Avviare una tokenizzazione senza indicare il metodoIl paymentType SDD deve essere sempre indicato

Sottoscrizione del mandato da parte del buyer​

La sottoscrizione del mandato avviene interamente online, con un flusso guidato che si conclude con la firma del mandato tramite Firma Elettronica Avanzata (FEA).

  1. Avvio della sottoscrizione: il buyer viene reindirizzato alla pagina di sottoscrizione del mandato tramite il link restituito da Fabrick.
  2. Dati personali: il buyer inserisce i propri dati anagrafici, come nome, cognome e codice fiscale.
  3. Informazioni sul conto: il buyer indica l'IBAN del conto su cui eseguire gli addebiti. Il sistema ne verifica automaticamente la correttezza formale.
  4. Numero di telefono: il buyer inserisce un numero di cellulare valido, utilizzato per confermare la firma.
  5. Riepilogo: il buyer verifica i dati inseriti, utilizzati per la sottoscrizione del mandato SEPA Core con Fabrick S.p.A.
  6. Firma dei documenti: il buyer consulta i documenti e accetta le condizioni del servizio di firma elettronica avanzata e del mandato SDD.
  7. Firma con OTP via SMS: il buyer riceve un codice di sicurezza (OTP) via SMS; il corretto inserimento finalizza la sottoscrizione e costituisce firma elettronica avanzata ai sensi della normativa vigente.
  8. Conferma: il buyer visualizza la pagina di conferma della sottoscrizione.
  9. Errore tecnico: in alternativa alla conferma, se si verifica un errore tecnico il buyer visualizza la pagina di operazione interrotta: il processo si interrompe e nessun mandato viene emesso.
Passo 2 di 9Dati personali
Pagina di sottoscrizione del mandato SDD: dati personali del buyer

Al termine della sottoscrizione il mandato digitale viene registrato sulla piattaforma e il sistema genera il token che lo identifica, necessario per eseguire gli addebiti successivi.

Tempistiche e gestione degli esiti​

L'addebito SDD viene eseguito secondo le tempistiche dello schema SEPA, che dipendono dall'orario di invio della richiesta e dall'eventuale data di addebito indicata dall'esercente. Gli orari fanno riferimento al fuso Europe/Rome.

EventoDescrizione
Richiesta inviata entro le 12:00L'addebito avviene il primo giorno utile (T+2), due giorni lavorativi dopo l'invio
Richiesta inviata dopo le 12:00L'addebito avviene il secondo giorno utile (T+3), tre giorni lavorativi dopo l'invio
Scarto (KO tecnico)Entro la data di addebito. La richiesta viene rifiutata prima del regolamento e non genera movimenti di fondi
Finestra insolutiFino a 6 giorni lavorativi dalla data di addebito. L'insoluto viene restituito dalla banca del debitore, ad esempio per fondi insufficienti o conto chiuso
Finestra rimborsi8 settimane dalla data di addebito per gli addebiti autorizzati (rimborso incondizionato); 13 mesi per gli addebiti non autorizzati

Gestione della data di addebito​

L'indicazione della data di addebito è facoltativa.

  • Senza data di addebito (comportamento predefinito): il sistema calcola automaticamente la prima data compatibile con le tempistiche SEPA, T+2 giorni lavorativi se la richiesta è inviata entro le 12:00, T+3 se inviata dopo. È la scelta più semplice quando non serve una pianificazione specifica.
  • Con data di addebito: la data indicata in executionDate deve essere di almeno T+2 giorni lavorativi se la richiesta è creata entro le 12:00, di almeno T+3 se creata dopo.
Data di addebito non valida

Se executionDate è precedente alla data minima consentita, la richiesta non viene accettata. L'esercente è responsabile di indicare una data compatibile con i vincoli, oppure può ometterla e affidarsi al calcolo automatico.

Terminologia degli esiti negativi​

Nel ciclo di vita di un addebito SDD si distinguono tre tipologie di esito negativo, che differiscono per momento, origine ed effetto sui fondi.

TipologiaMomentoOrigineEffetto
Scarto (KO tecnico)Prima del regolamento, entro la data di addebitoCircuito, banca del creditore o banca del debitore (es. mandato non valido, errore formale, IBAN non raggiungibile)L'addebito non viene eseguito e non genera movimenti di fondi
InsolutoDopo il regolamento, entro 6 giorni lavorativi dalla data di addebitoBanca del debitore (es. fondi insufficienti, conto chiuso, mandato revocato)L'importo già accreditato viene stornato
RimborsoDopo il regolamento, entro 8 settimane (addebito autorizzato) o 13 mesi (addebito non autorizzato)Richiesta del debitore alla propria bancaL'importo già accreditato viene stornato
Diritto di rimborso del debitore

Per gli addebiti dello schema CORE, escluse le varianti CORE Finanziari e CORE a importo prefissato, il debitore ha diritto al rimborso anche per operazioni correttamente eseguite, se lo richiede alla propria banca entro 8 settimane dalla data di addebito. Per gli addebiti non autorizzati, ad esempio in assenza di un mandato valido, il rimborso può essere richiesto entro 13 mesi.

Ciclo di vita del pagamento SDD​

Il ciclo di vita di un pagamento SDD descrive gli stati che una richiesta di addebito attraversa, dalla creazione fino all'incasso o a un eventuale esito negativo.

Stati del pagamento​

Stato Payment OrchestraEsitoStato Fabrick DashboardDescrizioneTempistiche tipiche
AUTXXIn attesaRichiesta creata e presa in carico, in attesa di invio al circuitoGiorno di invio della richiesta
AUTKOFallitoScarto (KO tecnico) restituito dal circuito prima del regolamento, ad esempio per mandato non valido o errore formale. Non genera movimenti di fondiData di addebito
MOVOKCatturatoEsito positivo restituito dal circuito: addebito eseguitoData di addebito
STOOKRimborsatoInsoluto restituito dalla banca del debitore, oppure rimborso richiesto dal debitoreEntro 6 giorni lavorativi dalla data di addebito (insoluto); entro 8 settimane o 13 mesi (rimborso)

Possibili flussi di stato​

Una richiesta di addebito SDD può seguire solo questi flussi:

  1. AUT XX → AUT KO
  2. AUT XX → MOV OK
  3. AUT XX → MOV OK → STO OK

Lo stato AUT KO rappresenta esclusivamente lo scarto prima del regolamento. Lo stato STO OK, mostrato nella Fabrick Dashboard come Rimborsato, comprende sia gli insoluti sia i rimborsi richiesti dal debitore.

Catturato non significa incasso definitivo

Lo stato Catturato (MOV OK) non garantisce l'irrevocabilità dell'incasso: restano valide la finestra insoluti (6 giorni lavorativi dalla data di addebito) e la finestra rimborsi (8 settimane o 13 mesi) previste dal circuito.

Esempi​

Richiesta di addebito inviata il 7 luglio 2025 alle 10:00, senza indicazione della data di addebito: essendo inviata prima delle 12:00, l'addebito avviene a T+2.

GiornoStato Payment OrchestraStato Fabrick DashboardDescrizione
7 luglio, 10:00AUT XXIn attesaRichiesta creata
9 luglioMOV OKCatturatoAddebito eseguito, importo accreditato all'esercente
10–17 luglioSTO OKRimborsatoPossibile insoluto
Fino al 3 settembreSTO OKRimborsatoPossibile rimborso richiesto dal debitore (8 settimane)

Funzionalità supportate e vincoli operativi​

OperazioneSupportataNote
Invio della richiesta di addebito✅Tramite payment/submit
Cattura di una transazione in attesa❌L'esito viene restituito dal circuito nella data di addebito e determina automaticamente il passaggio a Catturato (MOV OK) o Fallito (AUT KO)
Cancellazione di una transazione in attesa❌Una richiesta già inviata e nello stato In attesa (AUT XX) non può essere cancellata
Rimborso avviato dall'esercente❌Lo stato Rimborsato (STO OK) viene impostato automaticamente solo a seguito di eventi esterni: insoluto entro 6 giorni lavorativi, rimborso richiesto dal debitore entro 8 settimane o rimborso per operazione non autorizzata entro 13 mesi
Limiti del metodo
  • Tempi di incasso più lunghi rispetto ai pagamenti istantanei.
  • Possibilità di insoluti o rimborsi anche dopo l'incasso.
  • Gestione dei mandati a carico dell'esercente, che deve conservare i token e verificarne la validità.

SEPA Direct Debit su Fabrick Payment Orchestra: attivazione e modalità di integrazione​

Richiesta di attivazione​

Per iniziare ad accettare pagamenti con SDD, puoi richiedere l'attivazione:

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

Una volta completate le procedure necessarie:

  • Fabrick abilita SEPA Direct Debit 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

SEPA Direct Debit - Attivazione

Attivazione completata

Da questo momento, il tuo e-commerce è pronto per accettare pagamenti SEPA Direct Debit tramite Fabrick Payment Orchestra.

Tipologie di integrazione​

L'integrazione SDD si compone di due fasi, con modalità diverse:

  • Creazione del mandato

    Integrazioni supportate

    ✓Pay By Link
    ✗Checkout Page (pagina di selezione)
    ✗Web Component
    ✗Lightbox

    L'esercente inizializza il mandato con payment/create e reindirizza il buyer alla pagina di sottoscrizione tramite il link restituito da Fabrick. Il momento e il contesto in cui proporre il mandato, ad esempio in fase di registrazione, in un'area riservata o in un checkout personalizzato, sono a scelta dell'esercente.

    Per impostare la chiamata, vai alla sezione creazione del mandato.

  • Esecuzione degli addebiti

    Integrazioni supportate

    ✓API Only

    Gli addebiti sul mandato vengono eseguiti via API con payment/create e payment/submit, senza interazione da parte del buyer.

Testare SEPA Direct Debit in ambiente sandbox

Nella pagina di sottoscrizione del mandato puoi inserire il codice fiscale e l'IBAN che preferisci; come IBAN puoi utilizzare anche IT78R0300203280284338354647.

Il numero di telefono deve invece essere reale: per completare la firma del mandato ricevi via SMS il codice OTP da inserire nella pagina.

Integrazione tramite API​

Creazione del mandato​

Inizializza il mandato con la chiamata payment/create, indicando SDD nel campo paymentType e richiedendo il link di sottoscrizione con paymentChannel.channelType valorizzato a LINK.

CampoObbligatorioDescrizione
amount✅0 per la sola creazione del mandato; un importo maggiore di zero per eseguire anche il primo addebito
paymentType✅["SDD"]
paymentChannel.channelType✅["LINK"], per ottenere il link alla pagina di sottoscrizione
SDDDescription❌Descrizione mostrata al buyer

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": "0", // 0 per la sola creazione del mandato, > 0 per eseguire anche il primo addebito
    "currency": "EUR",
    "shopTransactionID": "FBK_OrderID",
    "SDDDescription": "Pagamento sottoscrizione", // Facoltativo: descrizione mostrata al buyer
    "paymentType": ["SDD"],
    "paymentChannel": { "channelType": ["LINK"] }
}

Response

{
    "error": {
        "code": "0",
        "description": "request correctly processed"
    },
    "payload": {
        "paymentToken": "07ba3f3a-885b-4bee-b77d-229486af9759",
        "paymentID": "11360710055816",
        "userRedirect": {
            "href": "https://sandbox-web.axerve.com/orchestra/checkout/a/ffbc98873e6745818a8efed28d48f282/b/bf10e15222a7dfa9631f9aba4698baf9141e74413d230b1ec4db0d58bedfce06f823e21e-c58c-4957-80aa-e72326bb4ed1hQexMf4OCqUQrE5RVuDnhD2gkPab7Wk4jakzYWiRDUsi89N-wrRmhGkxWvRwlaPtumuFfxPu47av0IfnfUoqbdTq3E4lSZsPVFswQnvu8VuJOfjOykVcSPvM6VROBPQvMuPoYCRa90lcQOuLvl8NnMHBaQN8"
        },
        "qrCode": null
    }
}

Reindirizza il buyer al link presente in payload.userRedirect.href per la sottoscrizione del mandato.

Recupero del token del mandato​

Al termine della sottoscrizione recupera il token del mandato con GET /payment/detail, nel campo payload.token, e salvalo: è necessario per tutti gli addebiti successivi.

Request

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

Response

{
    "error": {
        "code": "0",
        "description": "request correctly processed"
    },
    "payload": {
        "transactionType": "detail",
        //...
        "paymentID": "1881129911957",
        "token": "{TOKEN}", // Token del mandato SDD
        //...
    }
}

Esecuzione di un addebito su mandato esistente​

L'addebito su un mandato già registrato si esegue con due chiamate consecutive: payment/create inizializza la transazione e payment/submit invia il token del mandato.

Verifiche prima dell'addebito

Prima di inviare la richiesta, verifica che:

  • il token sia ancora valido;
  • il mandato non sia stato revocato;
  • l'IBAN associato al mandato sia attivo.

Step 1 — Creazione della richiesta di pagamento​

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

Step 2 — Invio dell'addebito​

Invia la richiesta a payment/submit:

  • Header PaymentToken: valorizzare con il paymentToken ricevuto dallo Step 1
  • Body: inserire il token del mandato nel campo paymentTypeDetails.SDD.token

Il body varia in base alla scelta di indicare o meno la data di addebito (vedi Gestione della data di addebito).

La data di addebito non viene indicata: il sistema utilizza la prima data utile.

Request

POST /api/v1/payment/submit
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
PaymentToken: f0419188-8a78-4918-913c-a491e4e78084
Content-Type: application/json
{
    "shopLogin": "GESPAY12345",
    "paymentType": "SDD",
    "paymentTypeDetails": {
        "SDD": {
            "token": "{TOKEN}" // Token del mandato SDD
        }
    }
}

La richiesta viene presa in carico nello stato In attesa (AUT / XX) e l'esito definitivo viene restituito dal circuito nella data di addebito (vedi Ciclo di vita del pagamento).

FAQ​

Quanto tempo serve per sapere se un addebito è andato a buon fine?

Senza data di addebito, in assenza di errori il pagamento raggiunge lo stato Catturato dopo due o tre giorni lavorativi, in base all'orario di invio. Con executionDate, l'addebito viene eseguito nella data indicata, purché valida. In entrambi i casi, se non si verificano insoluti entro il sesto giorno lavorativo dalla data di addebito, il pagamento può considerarsi riuscito, fermo restando il diritto del debitore di richiedere il rimborso entro 8 settimane, o 13 mesi per gli addebiti non autorizzati.

Cosa succede se il cliente cambia IBAN?

Il mandato esistente non è più valido: è necessario creare un nuovo mandato con il nuovo IBAN.

Posso eseguire un addebito una tantum?

Sì. La creazione del mandato è sempre il primo passo, ma non implica un utilizzo ricorrente: una volta ottenuto il token, l'esercente può inviare una sola richiesta di addebito. Può quindi dismettere il mandato a livello applicativo, ad esempio non conservando il token nei propri sistemi, oppure lasciarlo attivo fino alla scadenza prevista dal circuito SEPA.

Cosa succede se indico una data di addebito troppo ravvicinata?

Se executionDate non rispetta il vincolo minimo (T+2 se la richiesta è creata entro le 12:00, T+3 se creata dopo), la richiesta viene rifiutata. È necessario inviarla di nuovo con una data valida, oppure senza data per affidarsi al calcolo automatico.

Posso annullare o rimborsare un addebito tramite Payment Orchestra?

No. Una richiesta già inviata resta nello stato In attesa (AUT XX) fino alla data di addebito e non può essere cancellata. Anche il rimborso non può essere avviato dall'esercente: lo stato Rimborsato (STO OK) viene impostato solo a seguito di un insoluto o di un rimborso richiesto dal debitore alla propria banca.

Assistenza​

Fabrick