DISCLAIMER: Il supporto di Stripe Tax è disponibile su richiesta. Per maggiori dettagli, contattare Docebo tramite l'Help Center o il proprio Account Manager, se il piano include questa opzione.
NOTA DI DISMISSIONE: L'integrazione con Stripe Standard non è più supportata dal 31 luglio 2022, ed è stata dismessa il 30 novembre 2022.
Introduzione
Stripe Strong Customer Authentication (SCA) è un gateway di pagamento autorizzato in piattaforma.
Docebo integra Stripe SCA, che è conforme a tutti i circuiti internazionali per carte di credito e alle normative europee che hanno lo scopo di ridurre le frodi e di garantire una maggiore sicurezza dei pagamenti online. Maggiori dettagli su Stripe SCA (si apre in una nuova tab).
Stripe SCA gestisce il calcolo automatico delle imposte tramite Stripe Tax (si apre in una nuova tab); per maggiori dettagli , consultare il capitolo Gestire il Metodo di Calcolo delle Imposte di questo articolo.
Attenzione! Se il calcolo accurato delle imposte è determinante per il corretto funzionamento della propria attività di e-commerce, è caldamente consigliato di abilitare solo Stripe SCA come strumento di elaborazione delle transazioni con carta di credito.
Requisiti e Limitazioni
- Per configurare Stripe SCA in Docebo Learn è necessario attivare la app E-Commerce.
- Alcune valute supportate da Docebo potrebbero non essere accettate da Stripe. Controllare che le valute di interesse siano gestite da entrambi i sistemi prima di procedere. Elenco completo delle valute supportate da Docebo.
- Quando si utilizza Stripe Tax, il calcolo delle imposte è disponibile per le valute e i Paesi elencati da StripeDOCS (si apre in una nuova tab).
Casi d'Uso
Negli Stati Uniti i prezzi sono esentasse, mentre in altri Paesi le tasse sono incluse nel prezzo. Stripe Tax non supporta esplicitamente questa diversificazione; il metodo calcolo delle tasse è configurato a livello di account.
Poiché Stripe consente di creare più account e di configurarli in modo indipendente e Docebo permette di configurare diversi gateway di pagamento, uno per ogni dominio dell'Extended Enterprise, è possibile creare un dominio per il mercato degli Stati Uniti associato a un account Stripe che esclude le tasse e un altro dominio per gli altri Paesi associato a un account Stripe configurato per includere le tasse. Per il secondo dominio è possibile nascondere il testo "Taxes are calculated at checkout (Le tasse sono calcolate al momento del pagamento)" visualizzato nel carrello utilizzando CSS personalizzati o lo strumento di gestione delle lingue.
Attivare Stripe in Piattaforma
Attivare l'app Payment Method - Stripe SCA come descritto nell'articolo della Knowledge Base dedicato alla gestione di applicazioni e funzionalità. L'app si trova nella tab Integrazione Software Terzi.
Configurare Stripe SCA in Docebo
Per configurare Stripe SCA, connettersi alla piattaforma come Superadmin, accedere al Menu Amministrazione dall’icona ingranaggio in alto a destra, e cliccare Gestione nella sezione Metodo di Pagamento - Stripe SCA. Selezionare Abilita il gateway di pagamento Stripe per abilitare il gateway di pagamento.
Selezionare l'opzione Usa l'ambiente reale e inserire l’email dell’account di stripe, il Live Secret Key e il Live Publishable Key nei campi di testo corrispondenti. Queste informazioni sono disponibili connettendosi alla propria Dashboard di Stripe (si apre in una nuova tab) e selezionando la tab Developers in alto a destra, quindi selezionando la tab API Keys.
I valori dei campi publishable key e secret key sono visualizzati nella sezione Standard Keys. Ulteriori informazioni su come reperire questi valori sono disponibili nell’area di assistenza di Stripe (si apre in una nuova tab).
Copiare questi valori nei campi corrispondenti della pagina Payment Method - Stripe SCA di Docebo e premere Salva le Modifiche per finalizzare la configurazione.
Nella pagina Payment Method - Stripe SCA di Docebo è possibile selezionare l'opzione per utilizzare la Sandbox invece dell'ambiente reale per eseguire i test necessari. Quando si abilita questa opzione, le operazioni di pagamento non saranno addebitate. Per utilizzare l'opzione Sandbox, è necessario compilare i campi Test Secret Key e Test Publishable Key che appaiono sotto l'opzione.
Gestire il Metodo di Calcolo delle Imposte
Quando si utilizza Stripe SCA, è possibile automatizzare il calcolo delle imposte tramite Stripe Tax (si apre in una nuova tab) o utilizzare il calcolo manuale delle imposte. Per configurare il metodo di calcolo delle imposte, spostarsi nell'area Tipo di Pagamento della pagina di configurazione di Stripe SCA e selezionare l'opzione Addebito Semplice per il calcolo manuale o l'opzione Enable Automatic Tax Calculation (Abilita il calcolo automatico delle imposte) per il calcolo automatico.
Quando si seleziona l'opzione Addebito Semplice, le transazioni completate sono elencate nella tab Payments della dashboard di Stripe. Questa opzione non richiede ulteriori configurazioni.
Quando si seleziona l'opzione Enable Automatic Tax Calculation (Abilita il calcolo automatico delle imposte), Stripe Tax calcola e raccoglie automaticamente le imposte su tutti gli acquisti (compresi gli abbonamenti) effettuati tramite e-commerce. Maggiori informazioni su StripeDOCS (si apre in una nuova tab). L'integrazione con Stripe Tax deve essere configurata sia in Stripe che in Docebo, come descritto nel capitolo Configurare Stripe Tax di questo articolo.
Configurare Stripe Tax
Per configurare Stripe Tax, accedere all'account Admin di Stripe (si apre in una nuova tab), cliccare sull'icona ingranaggio per accedere alla pagina delle impostazioni e cliccare su Settings nella sezione Tax.
Configurare le opzioni come segue:
Nella sezione Business Information, definire il campo Origin Address sulla sede dell'azienda.
Nella sezione Product and Prices selezionare un'opzione per il campo Default Product Tax Category. L'opzione più comunemente utilizzata è General - Electronically Supplied Services.
Utilizzare il menu a tendina Include Tax in Prices per selezionare la modalità in cui le imposte sono presentate all'acquirente. Le opzioni disponibili sono:
-
- Yes - Tax is included in the price: l'importo pagato dagli acquirenti non cambia mai, anche se varia l'aliquota fiscale.
- No - Tax is excluded from the price: le imposte sono indicate sul prezzo e aggiunte al subtotale. Questa soluzione è comune nei mercati degli Stati Uniti e per le vendite B2B.
- Automatic - Use the currency to determine if tax is included or excluded: utilizzare questa opzione solo se suggerita dal proprio consulente fiscale o dal CSM di Stripe.
Nella sezione Automatic Tax Calculation, attivare il toggle Use Automatic Tax Calculation.
Come azienda, è obbligatorio identificare gli Stati o le province e i Paesi in cui si hanno obblighi fiscali ed è necessario registrarsi per riscuotere le imposte nella tab Registrations della Application Dashboard, raggiungibile dalla barra Application cliccando su More e poi su Tax.
Da questa tab, cliccare Export Transactions per esportare i dati delle transazioni in un report dettagliato o riassuntivo, che può essere utilizzato per integrarsi con altri servizi per una gestione più organica delle imposte. Maggiori dettagli su come registrarsi per l'imposta sulle vendite, l'IVA e la GST e come esportare le transazioni sono disponibili su StripeDOCS (si apre in una nuova tab).
Tornare alla pagina Payment Method - Stripe SCA in Docebo e selezionare l'opzione Enable Automatic Tax Calculation (Abilita il calcolo automatico delle imposte) nella sezione Tipo di Pagamento e inserire il Codice Fiscale.
L'opzione più comunemente utilizzata è txcd_10000000, che rappresenta qualsiasi servizio fornito elettronicamente.
Dismissione di Stripe Standard per gli Utenti dell'App Piani di Abbonamento
L'integrazione con Stripe Standard è stata dismessa il 30 novembre 2022 in favore di Stripe Strong Customer Authentication (SCA) (si apre in una nuova tab).
Per chi ha configurato l'integrazione con Stripe Standard in concomitanza all'app Piani di Abbonamento nella propria piattaforma Docebo e ha definito Stripe Standard come gateway di pagamento per il rinnovo automatico degli abbonamenti, la migrazione a Stripe SCA renderà necessaria la ri-esecuzione della procedura di pagamento da parte degli utenti al momento del primo rinnovo.
Poiché questo aggiornamento è di grande entità, al fine di garantire che i pagamenti dei rinnovi siano elaborati correttamente:
- gli account Stripe Standard rimarranno attivi anche dopo il 30 novembre 2022
- dopo il 30 novembre 2022, sarà possibile creare solo nuovi account con Stripe SCA
- resta comunque necessario pianificare la migrazione a Stripe SCA il prima possibile
I pagamenti automatici saranno elaborati anche prima della migrazione a Stripe SCA.
Consigli d’Utilizzo
Fai attenzione alle seguenti note quando utilizzi Stripe in piattaforma:
- Quando un utente acquista un contenuto utilizzando Stripe come metodo di pagamento, l'utente viene registrato come cliente in Stripe e i suoi dati saranno disponibili nella Stripe Admin Dashboard.
- Per completare l'acquisto, i seguenti dati sono obbligatori: Indirizzo, Città e Paese. Se si abilita il calcolo automatico delle imposte (ad esempio con Stripe Tax), i seguenti dati sono obbligatori: Indirizzo, Città, Paese, Stato/Provincia/Regione e CAP/Codice postale.
- Il processo di configurazione di Stripe SCA in Docebo è lo stesso per i singoli domini e per le piattaforme che utilizzano la funzionalità Extended Enterprise.