Configurare Stripe e Stripe Tax per l'app E-commerce

Introduzione

Il gateway di pagamento Stripe Strong Customer Authentication (Stripe SCA) rappresenta un metodo di pagamento autorizzato utilizzabile con le funzionalità di e-commerce della vostra piattaforma.

Stripe SCA è conforme a tutti i circuiti internazionali di carte di credito e rispetta i requisiti normativi europei volti a ridurre le frodi e a garantire una maggiore sicurezza nei pagamenti online.

L'integrazione di Stripe in Docebo supporta due componenti principali:

• Stripe SCA, il gateway di pagamento principale per l'elaborazione delle transazioni. Ulteriori informazioni su Stripe SCA (si apre in una nuova scheda).
• Stripe Tax, uno strumento aggiuntivo che automatizza il calcolo delle imposte e assicura la conformità fiscale per le aziende che vendono prodotti o servizi in diverse giurisdizioni fiscali. Ulteriori informazioni su Stripe Tax (si apre in una nuova scheda).

Qualora si necessiti esclusivamente della gestione dei pagamenti, l'utilizzo di Stripe risulta sufficiente. Tuttavia, per una gestione complessa della conformità fiscale, in particolare per vendite internazionali o interstatali, Stripe Tax può semplificare notevolmente tale processo.

Il presente articolo illustra le modalità di configurazione dell'integrazione di Stripe sulla vostra piattaforma, nonché la configurazione della funzionalità Stripe Tax, qualora necessaria.

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.

Prerequisiti

L'integrazione Stripe SCA e il componente aggiuntivo Stripe Tax sono disponibili sulla piattaforma con il pacchetto e-commerce. Contattare il referente Docebo per informazioni su come ottenerlo.

• Per configurare questa integrazione, è necessario avere accesso amministrativo a un account Stripe valido.

Requisiti e limitazioni

• Alcune valute supportate da Docebo potrebbero non essere accettate da Stripe; pertanto, si raccomanda di verificare che la valuta utilizzata sia compatibile con entrambi i sistemi prima di procedere. Consultare l'elenco completo delle valute supportate da Docebo.
• Nel caso di utilizzo dell'Extended Enterprise, si consiglia di configurare le impostazioni di Stripe nel dominio principale. Qualora alcuni domini richiedano configurazioni differenti, tali impostazioni devono essere applicate localmente, nella scheda E-commerce dell'app Extended Enterprise.
• Per quanto riguarda l'utilizzo di Stripe Tax:
  • Si precisa che il calcolo delle imposte è disponibile esclusivamente per le valute e i paesi indicati nella documentazione ufficiale di Stripe (si apre in una nuova scheda).
  • Nel caso di abbonamenti, il calcolo automatico delle imposte è supportato sia per gli acquisti iniziali sia per i rinnovi. Tuttavia, si segnala che le fatture sono emesse solo per gli acquisti di abbonamenti e non per i rinnovi.
  • Al momento del checkout, la piattaforma visualizzerà sempre le imposte separatamente dal prezzo, anche se in Stripe Tax è stata selezionata l'opzione per includere le imposte nel prezzo.

Casi d'uso

Negli Stati Uniti i prezzi non includono le tasse, 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 Metodo di pagamento - Stripe SCA come descritto nell'articolo della knowledge base dedicato alla gestione di applicazioni e funzionalità. L'app si trova nella scheda Integrazione software terzi.

Configurare il Gateway di pagamento Stripe SCA

Per configurare Stripe SCA sulla piattaforma, accedere come Superadmin e selezionare Menu di navigazione > Configurazione (icona a chiave inglese) > E-commerce > Stripe SCA. Nella pagina di configurazione che si apre, attivare l'opzione Abilita il gateway di pagamento Stripe.

Nel campo Informazioni Stripe, inserire l'indirizzo email associato al proprio account Stripe. Procedere quindi con Inserire le chiavi Stripe, Configurare l'abilitazione di Klarna e Configurare le opzioni di addebito per il calcolo delle imposte.

Configurare il Webhook di Stripe (opzionale)

L'integrazione Stripe SCA prevede un webhook opzionale che consente alla piattaforma di ricevere la conferma del pagamento direttamente da Stripe, anche qualora la sessione del browser dell'utente venga interrotta durante il processo di checkout. Quando un secret di firma del webhook Stripe è configurato, la piattaforma utilizza la notifica server-to-server di Stripe come segnale autorevole per finalizzare gli ordini e concedere agli utenti l'accesso ai contenuti acquistati.

Migliori pratiche: Si raccomanda vivamente di configurare il webhook per qualsiasi piattaforma con traffico e-commerce attivo. In assenza di tale configurazione, gli ordini potrebbero rimanere nello stato "In attesa" qualora un utente chiuda il browser o perda la connessione internet immediatamente dopo aver completato l'autorizzazione bancaria. Ciò potrebbe comportare un addebito Stripe riuscito, ma senza iscrizione lato piattaforma.

Per ottenere il secret di firma del webhook Stripe da Stripe, accedere alla Dashboard Stripe (si apre in una nuova scheda) con il proprio account amministratore. Selezionare Developers dal menu superiore, quindi Webhooks. Successivamente, cliccare su Create an event destination, scegliere Your account o Connected and v2 accounts e selezionare la versione API più recente.

Nella sezione All events, aggiungere l'evento checkout.session.completed.

Nota bene: Docebo supporta esclusivamente eventi v1; non selezionare eventi v2.

Successivamente, premere Continue, selezionare Endpoint webhook e premere nuovamente Continua. Nella sezione Configura destinazione, inserire un nome, una descrizione e l'URL endpoint seguente:

https://[nome-della-tua-piattaforma].docebosaas.com/ecommerce/v1/admin/stripe-sca/webhook

Una volta creata la destinazione, selezionarla per visualizzare il secret di firma e cliccare su Reveal per copiarlo.

Per configurare il webhook sulla piattaforma, nel campo Chiave secret di firma del webhook Stripe, inserire il la chiave segreta key copiata dalla dashboard di Stripe.

Nota bene: Il campo Chiave secret di firma del webhook Stripe è disponibile esclusivamente sul dominio principale. Nel caso di utilizzo di Extended Enterprise con configurazioni Stripe separate per dominio, tale campo non può essere configurato in maniera indipendente sui sottodomini.

Al termine, premere Salva le modifiche.

Inserire le chiavi Stripe

Nella sezione Ambiente di test, selezionare se si desidera utilizzare una sandbox (ambiente di test) o un ambiente reale (live). Optando per la sandbox, nessuna transazione di pagamento sarà addebitata su alcun account.

Procedere inserendo la Chiave segreta e la Chiave pubblicabile relative all'ambiente selezionato (test o live).

Per recuperare tali chiavi da Stripe:

1. Accedere al Dashboard Stripe (si apre in una nuova scheda) con il proprio account amministratore.
2. In alto a destra selezionare Developers e successivamente la scheda API keys.
3. Attivare l'opzione View test data qualora si desideri recuperare le chiavi per l'ambiente di test; in caso contrario, lasciare l'opzione deselezionata per ottenere le chiavi live.
4. La chiave pubblicabile e la chiave segreta sono reperibili nella sezione Standard keys. Per ulteriori informazioni, consultare l'area di supporto di Stripe (si apre in una nuova scheda).
   

Configurare l'abilitazione di Klarna

Nella sezione Tipo di pagamento, sotto Metodo di pagamento aggiuntivo, decidere se abilitare l'opzione Klarna "compra ora, paga dopo" per gli utenti che effettuano pagamenti tramite Stripe. Si ricorda che:

• Gli acquirenti dovranno selezionare “Stripe” come gateway di pagamento nel carrello. Successivamente, saranno reindirizzati alla pagina di checkout Stripe dove visualizzeranno l'opzione Klarna.

  Suggerimento: L'opzione Klarna potrebbe non essere disponibile in presenza di discrepanze tra la valuta di pagamento e il Paese del commerciante Stripe.

• Se selezionata, Klarna corrisponderà l'intero importo al commerciante, mentre addebiterà le rate sulla carta di credito dell'acquirente.
• La pagina delle transazioni Ecommerce e il report ecommerce-transaction mostreranno esclusivamente “Stripe” come metodo di pagamento utilizzato, senza menzionare l'uso di Klarna.

Per abilitare Klarna:

Selezionare la casella Abilita Klarna.

Nota bene: L'impostazione Klarna definita in questa sezione si applicherà automaticamente a tutti i clienti Extended Enterprise con Stripe SCA abilitato. Non è possibile attivarla o disattivarla selettivamente per domini specifici.

Si dovrà inoltre abilitare Klarna nella propria dashboard Stripe. Per ulteriori dettagli, consultare la documentazione Stripe relativa ai pagamenti Klarna (si apre in una nuova scheda).

Nota bene: Attivando Klarna, l'integrazione della piattaforma applicherà le impostazioni predefinite per tale metodo di pagamento, sovrascrivendo eventuali configurazioni personalizzate precedentemente impostate in Stripe.

Configurare le opzioni di addebito per il calcolo delle imposte

Nella sezione Tipo di pagamento, qualora non si necessiti dell'utilizzo di Stripe Tax (calcolo automatico delle imposte), si potrà mantenere l'Opzione di addebito impostata sul valore predefinito, ovvero Addebito semplice.

Qualora invece sia necessario configurare Stripe Tax, si rimanda ai passaggi descritti nel capitolo Configurare il calcolo automatico delle imposte con Stripe Tax.

Al termine della configurazione, premere Salva le modifiche.

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 scheda) 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 Abilita il calcolo automatico delle tasse per il calcolo automatico.

Quando si seleziona l'opzione Addebito semplice, le transazioni completate sono elencate nella scheda Payments della dashboard di Stripe. Questa opzione non richiede ulteriori configurazioni.

Quando si seleziona l'opzione Abilita il calcolo automatico delle tasse:

• 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 scheda). L'integrazione con Stripe Tax deve essere configurata sia in Stripe che in Docebo, come descritto nel capitolo Configurare Stripe Tax di questo articolo.
• Quando gli utenti scelgono Stripe SCA per i loro pagamenti, devono selezionare un Paese tra quelli supportati da Stripe (si apre in una nuova scheda) utilizzando il menu a tendina dei Paesi supportati da Stripe. Questo campo è obbligatorio.

Attivare l'opzione Autorizza Stripe a inviare una fattura per transazione con i dettagli degli articoli acquistati, per permettere a Stripe a inviare automaticamente una fattura via email agli utenti che finalizzano un acquisto sulla piattaforma.

Attenzione! L'invio delle email di fatturazione deve essere configurato anche in Stripe.

Quando questa opzione è attivata, gli utenti devono inserire il proprio indirizzo email nel pannello Dati di fatturazione della fase Pagamento e fatturazione del processo di acquisto per finalizzare l'acquisto. La fattura sarà inviata solo dopo la conferma del pagamento e conterrà i dettagli di ogni articolo acquistato nella transazione. Se gli utenti acquistano più quantità dello stesso articolo, ogni articolo sarà elencato separatamente in fattura.

Configurare il calcolo automatico delle imposte con Stripe Tax

Stripe Tax rappresenta una funzionalità aggiuntiva del gateway di pagamento Stripe, progettata per supportare il calcolo automatico delle imposte:

• Stripe Tax calcola e raccoglie automaticamente le imposte su tutte le transazioni effettuate tramite e-commerce, inclusi gli acquisti e i rinnovi di abbonamenti. Per ulteriori informazioni, consultare StripeDOCS (si apre in una nuova scheda).
• Durante il processo di checkout, quando gli utenti selezionano Stripe SCA come metodo di pagamento, nella sezione Dati di fatturazione è presente un'opzione in cui devono specificare se agiscono come azienda o individuo: i clienti business sono tenuti a fornire il nome dell'azienda e la partita IVA, mentre gli individui devono inserire il nome completo e possono facoltativamente fornire un identificativo fiscale.
• Inoltre, tutti gli utenti devono indicare il proprio indirizzo email, indirizzo di residenza, città, codice postale/ZIP e selezionare il Paese di appartenenza dal menu a tendina Paesi supportati da Stripe (consultare paesi supportati da Stripe (si apre in una nuova scheda)). Tali informazioni sono fondamentali per il calcolo delle imposte.

Per attivare questa funzionalità, è necessario abilitare il calcolo automatico delle imposte sulla piattaforma e configurare Stripe Tax direttamente dalla dashboard di Stripe, come illustrato nei capitoli successivi.

Abilitare il calcolo automatico delle imposte sulla piattaforma

Nota bene: La seguente procedura presuppone che il gateway di pagamento Stripe SCA core sia già stato configurato.

Accedere a Menu di navigazione > Configurazione (icona a chiave inglese) > E-commerce > Stripe SCA. Nella pagina di configurazione di Stripe, scorrere fino alla sezione Tipo di pagamento e selezionare l'opzione Abilita calcolo automatico delle tasse.

• Nel campo Codice fiscale, inserire il codice fiscale del prodotto a cui si desidera applicare l'aliquota. Questo determinerà l'aliquota fiscale da applicare alle transazioni.

  Esempio: txcd_10000000 (General - Electronically Supplied Services)

  Per ulteriori dettagli, consultare la documentazione Stripe sui codici fiscali (si apre in una nuova scheda).

• Attivare l'opzione Autorizza Stripe a inviare una fattura per ogni transazione con i dettagli degli articoli acquistati, consentendo così a Stripe di inviare automaticamente una fattura via email agli utenti che completano un acquisto sulla piattaforma.

Nota bene: L'invio delle email di fattura richiede una configurazione aggiuntiva lato Stripe.

Una volta attivata questa opzione, gli utenti dovranno inserire il proprio indirizzo email nel pannello Informazioni di fatturazione durante il passaggio Pagamento e fatturazione del processo di acquisto per completare la transazione. La fattura sarà inviata esclusivamente dopo il pagamento avvenuto con successo e conterrà i dettagli di ciascun articolo acquistato. Nel caso di acquisto di più unità dello stesso articolo, ogni unità sarà elencata separatamente nella fattura.

Per i clienti business, la fattura includerà la partita IVA, mentre per gli individui sarà riportato l'identificativo fiscale, qualora fornito.

Per quanto riguarda gli abbonamenti: si precisa che la fattura è disponibile solo per l'acquisto iniziale dell'abbonamento e non per i rinnovi successivi.

Al termine, premere il pulsante Salva le modifiche.

Si ricorda che è necessario completare anche la configurazione lato Stripe, come descritto nel capitolo successivo, Configurare Stripe Tax nella dashboard di Stripe.

Configurare Stripe Tax nella dashboard di Stripe

Accedere alla dashboard di Stripe con le credenziali amministrative (si apre in una nuova scheda), cliccare sull'icona a forma di ingranaggio presente nell'intestazione per accedere alla pagina Product settings, quindi nella sezione Tax selezionare Settings

Configurare le opzioni disponibili come segue:

Nella sezione Business information, impostare l'Origin address corrispondente alla sede della propria azienda.

Nella sezione Product and prices, selezionare una Default product tax category. L'opzione più comunemente adottata è General - Electronically supplied services.

Il menu a tendina Include tax in prices definisce come le imposte vengono presentate all'acquirente. Le opzioni disponibili sono:

• Yes - Tax is included in the price: l'importo pagato dagli acquirenti rimane invariato anche in caso di variazioni dell'aliquota fiscale.
• No - Tax is excluded from the price: le imposte sono indicate separatamente e aggiunte al subtotale. Questa modalità è comune nei mercati statunitensi e nelle vendite B2B.
• Automatic - Use the currency to determine if tax is included or excluded: si consiglia di utilizzare questa opzione solo se raccomandato dal consulente fiscale o dal Customer Success Manager di Stripe.

Nella sezione Tax Calculation, attivare l'interruttore Use automatic tax calculation.

Ulteriori dettagli sulla configurazione di Stripe Tax sono disponibili su StripeDOCS (si apre in una nuova scheda).

In qualità di azienda, è obbligatorio identificare gli stati, le province e i Paesi in cui si hanno obblighi fiscali e registrarsi per la riscossione delle imposte nella scheda Registrations dell'Application Dashboard, accessibile tramite la barra dell'applicazione selezionando More e successivamente Tax.

Da questa sezione è possibile cliccare su Export transactions per ottenere un report dettagliato o riepilogativo delle transazioni, utile per integrare altri servizi e gestire le imposte in modo più organico. Per informazioni su come registrarsi per imposte sulle vendite, IVA e GST e su come esportare le transazioni, consultare StripeDOCS (si apre in una nuova scheda).

Migliori pratiche

Si raccomanda di prestare attenzione alle seguenti indicazioni durante l'integrazione di Stripe nella propria piattaforma:

• Quando un utente effettua un acquisto utilizzando Stripe come metodo di pagamento, quest'ultimo verrà registrato come cliente su Stripe, e i suoi dati saranno visibili nella Dashboard amministrativa di Stripe.
• La procedura di configurazione di Stripe SCA sulla piattaforma è identica sia nel caso di utilizzo di un singolo dominio sia nel caso di impiego della funzionalità Extended Enterprise di Docebo.