--- title: "SEPA Direct Debit (SDD)" description: "L'Addebito Diretto SEPA (SDD) consente di incassare pagamenti ricorrenti o una tantum direttamente dal conto corrente del cliente, a fronte di un mandato firmato online con firma elettronica avanzata. In questa guida scoprirai come attivarlo, creare il mandato ed eseguire gli addebiti tramite Fabrick Payment Orchestra." url: "https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/" language: "it" --- # SEPA Direct Debit (SDD) ## 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#esecuzione-di-un-addebito-su-mandato-esistente)). - **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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#gestione-della-data-di-addebito)). - **Monitoraggio centralizzato**: gli esiti, compresi scarti, insoluti e rimborsi, sono visibili nella Fabrick Dashboard. --- ## Come funziona ### Flusso operativo | Fase | Descrizione | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Creazione del mandato** | Il cliente (debitore) autorizza l'esercente (creditore) a eseguire addebiti sul proprio conto tramite un mandato SEPA firmato online | | **Richiesta di incasso** | L'esercente invia a Payment Orchestra la richiesta di addebito sul mandato | | **Esecuzione bancaria** | L'addebito viene eseguito dopo 2 o 3 giorni lavorativi, in base all'orario di invio, oppure nella data indicata dall'esercente (vedi [Tempistiche](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#tempistiche-e-gestione-degli-esiti)) | | **Gestione degli esiti** | Tutti 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. | | Operazione | Note | | - | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | ✅ | Avviare una tokenizzazione SDD esplicita | Il `paymentType` `SDD` deve essere indicato nella chiamata | | ✅ | Ottenere il token del mandato e salvarlo | Recuperabile con `payment/detail` dopo la creazione del mandato | | ✅ | Eseguire addebiti ricorrenti o futuri su un token esistente | Flusso tipico: sottoscrizione del mandato, recupero del token, addebiti in assenza del cliente | | ✅ | Eseguire un primo addebito contestualmente alla creazione del mandato | Il token resta attivo per gli addebiti successivi | | ❌ | Proporre SDD come metodo selezionabile in una pagina di pagamento | SDD non è utilizzabile come pagamento immediato senza un mandato | | ❌ | Addebitare un buyer che non dispone di un mandato attivo | Ogni addebito richiede un mandato; il mandato può essere creato in un momento precedente | | ❌ | Avviare una tokenizzazione senza indicare il metodo | Il `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 9 — Dati personali ![Pagina di sottoscrizione del mandato SDD: dati personali del buyer](https://docs.fabrick.com/assets/images/sdd-ec733c00268a926d79cc5f2b0935967b.png) Passo 3 di 9 — Informazioni sul conto ![Pagina di sottoscrizione del mandato SDD: inserimento e verifica dell'IBAN](https://docs.fabrick.com/assets/images/sdd-2-2324f5431423da719294bb9ea299cd70.png) Passo 4 di 9 — Numero di telefono ![Pagina di sottoscrizione del mandato SDD: numero di telefono per la firma](https://docs.fabrick.com/assets/images/sdd-3-dc2901ff58729137711ae31db10ae099.png) Passo 5 di 9 — Riepilogo ![Pagina di sottoscrizione del mandato SDD: riepilogo dei dati inseriti](https://docs.fabrick.com/assets/images/sdd-4-65adf9c21a66248a7ff4d51fed38fc24.png) Passo 6 di 9 — Firma dei documenti ![Pagina di sottoscrizione del mandato SDD: modulo di adesione FEA e mandato SDD](https://docs.fabrick.com/assets/images/sdd-5-3d62961d30a67800e75a5ca22df9e602.png) Passo 7 di 9 — Firma con OTP via SMS ![Firma del mandato SDD con codice OTP ricevuto via SMS](https://docs.fabrick.com/assets/images/sdd-6-e6a7a5d210ef85725ee7a6338adf2725.png) Passo 8 di 9 — Conferma ![Pagina di conferma della sottoscrizione del mandato SDD](https://docs.fabrick.com/assets/images/sdd-success-640e9b4b4962f9c81230984d41badc89.png) Passo 9 di 9 — Errore tecnico ![Pagina di operazione interrotta per errore tecnico](https://docs.fabrick.com/assets/images/sdd-error-aca41c1e9e2fbbd0513a53a2dbec6632.png) 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**. | Evento | Descrizione | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Richiesta inviata entro le 12:00** | L'addebito avviene il primo giorno utile (T+2), due giorni lavorativi dopo l'invio | | **Richiesta inviata dopo le 12:00** | L'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 insoluti** | Fino 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 rimborsi** | 8 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. | Tipologia | Momento | Origine | Effetto | | ----------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | **Scarto (KO tecnico)** | Prima del regolamento, entro la data di addebito | Circuito, 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 | | **Insoluto** | Dopo il regolamento, entro 6 giorni lavorativi dalla data di addebito | Banca del debitore (es. fondi insufficienti, conto chiuso, mandato revocato) | L'importo già accreditato viene stornato | | **Rimborso** | Dopo il regolamento, entro 8 settimane (addebito autorizzato) o 13 mesi (addebito non autorizzato) | Richiesta del debitore alla propria banca | L'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 Orchestra | Esito | Stato Fabrick Dashboard | Descrizione | Tempistiche tipiche | | ----------------------- | ----- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | `AUT` | `XX` | **In attesa** | Richiesta creata e presa in carico, in attesa di invio al circuito | Giorno di invio della richiesta | | `AUT` | `KO` | **Fallito** | Scarto (KO tecnico) restituito dal circuito prima del regolamento, ad esempio per mandato non valido o errore formale. Non genera movimenti di fondi | Data di addebito | | `MOV` | `OK` | **Catturato** | Esito positivo restituito dal circuito: addebito eseguito | Data di addebito | | `STO` | `OK` | **Rimborsato** | Insoluto restituito dalla banca del debitore, oppure rimborso richiesto dal debitore | Entro 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 **Senza data di addebito** 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. | Giorno | Stato Payment Orchestra | Stato Fabrick Dashboard | Descrizione | | ------------------- | ----------------------- | ----------------------- | ------------------------------------------------------- | | 7 luglio, 10:00 | `AUT XX` | In attesa | Richiesta creata | | 9 luglio | `MOV OK` | Catturato | Addebito eseguito, importo accreditato all'esercente | | 10–17 luglio | `STO OK` | Rimborsato | Possibile insoluto | | Fino al 3 settembre | `STO OK` | Rimborsato | Possibile rimborso richiesto dal debitore (8 settimane) | **Con data di addebito** Richiesta di addebito inviata il 7 luglio 2025 alle 10:00 con `executionDate` 14 luglio 2025: essendo inviata prima delle 12:00, la data minima consentita è il 9 luglio (T+2), quindi il 14 luglio è valido. | Giorno | Stato Payment Orchestra | Stato Fabrick Dashboard | Descrizione | | -------------------- | ----------------------- | ----------------------- | ------------------------------------------------------------------------- | | 7 luglio, 10:00 | `AUT XX` | In attesa | Richiesta creata con `executionDate` 14 luglio 2025 | | 14 luglio | `MOV OK` | Catturato | Addebito eseguito nella data richiesta, importo accreditato all'esercente | | 15–22 luglio | `STO OK` | Rimborsato | Possibile insoluto | | Fino all'8 settembre | `STO OK` | Rimborsato | Possibile rimborso richiesto dal debitore (8 settimane) | ### Funzionalità supportate e vincoli operativi | Operazione | Supportata | Note | | ---------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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](https://landing.fabrick.com/fabrick-dashboard-support) 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](https://docs.fabrick.com/assets/images/sdd-activation-eb75d0c1a97c141ebd28ef8db3532422.png) > **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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#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`. | Campo | Obbligatorio | Descrizione | | ---------------------------- | ------------ | ------------------------------------------------------------------------------------------------------- | | `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** ```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": "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** ```json { "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** ```http GET /api/v1/payment/detail/{paymentID} Host (sandbox): sandbox.gestpay.net Host (produzione): ecomms2s.sella.it Authorization: apikey **************** Content-Type: application/json ``` **Response** ```json { "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** ```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" } ``` #### Step 2 — Invio dell'addebito Invia la richiesta a `payment/submit`: - Header **`PaymentToken`**: valorizzare con il `paymentToken` ricevuto dallo [Step 1](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#step-1--creazione-della-richiesta-di-pagamento) - 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#gestione-della-data-di-addebito)). **Senza data di addebito** La data di addebito non viene indicata: il sistema utilizza la prima data utile. **Request** ```http 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 ``` ```json { "shopLogin": "GESPAY12345", "paymentType": "SDD", "paymentTypeDetails": { "SDD": { "token": "{TOKEN}" // Token del mandato SDD } } } ``` **Con data di addebito** La data di addebito viene indicata nel campo `executionDate`, in formato `YYYYMMDD`. **Request** ```http 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 ``` ```json { "shopLogin": "GESPAY12345", "paymentType": "SDD", "paymentTypeDetails": { "SDD": { "token": "{TOKEN}", // Token del mandato SDD "executionDate": "{YYYYMMDD}" // Data di addebito } } } ``` 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](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/sdd/#ciclo-di-vita-del-pagamento-sdd)). --- ## 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** - **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)