# Documentazione di configurazione di Stripe La seguente documentazione di configurazione è per il gateway di pagamento Stripe. Stripe Standard è incluso nella versione gratuita di Easy Digital Downloads. L'estensione del gateway di pagamento [Stripe Pro](https://easydigitaldownloads.com/downloads/stripe-gateway/) è un'estensione opzionale che aggiunge il supporto per i pagamenti pre-approvati e rimuove la commissione aggiunta ai pagamenti Stripe Standard. - [Configurazione di Stripe](#configure) - [1. Connetti con Stripe](#aioseo-1-connect-with-stripe) - [2. Abilita il gateway di pagamento Stripe](#aioseo-2-enable-the-stripe-payment-gateway) - [3. Configurazione webhook](#webhook-configuration) - [4. Integrazione pagamenti ricorrenti](#recurring) - [Impostazioni/Funzionalità aggiuntive del gateway Stripe](#settings) - [Descrittore di addebito](#descriptor) - [Includi riepilogo acquisto](#aioseo-include-purchase-summary) - [Pagamenti pre-approvati](#aioseo-preapproved-payments-stripe-pro-feature) - [Restringi asset Stripe](#aioseo-restrict-stripe-assets) - [Metodi di pagamento](#aioseo-payment-methods) - [Mostra carte utilizzate in precedenza](#aioseo-show-previously-used-cards) - [Email di avviso frode anticipata di Stripe](#aioseo-stripe-early-fraud-warning-email) - [Acquista ora](#buynow) - [Configurazione Apple Pay](#applepay) - [Testare Stripe](#test) - [Migrazione a Payment Elements](#migrating) - [FAQ sulla configurazione del gateway Stripe](#aioseo-faqs-on-stripe-gateway-setup) Configurazione di Stripe ------------------ Per utilizzare il gateway di pagamento Stripe, devi prima avere un account [Stripe](https://stripe.partners/directory/easy-digital-downloads). La creazione di un account Stripe è gratuita e anche il test è gratuito. Vedi anche i [requisiti informativi aziendali](https://support.stripe.com/questions/business-information-requirements-to-use-stripe) di Stripe. ### 1. Connetti con Stripe Seleziona la sottoscheda **Stripe** nella scheda Pagamenti, quindi fai clic sul pulsante **Connetti con Stripe**. Questo ti porterà sul sito web di Stripe dove potrai accedere al tuo account esistente se ne hai uno o crearne uno nuovo se non ne hai. ### 2. Abilita il gateway di pagamento Stripe Vai su amministrazione WordPress → **Downloads** → **Impostazioni** → **Pagamenti**, quindi abilita il gateway di pagamento Stripe. **Account India**: 1\. I negozi con sede in India devono impostare il Paese dell'attività commerciale del negozio su India in **Downloads** → **Impostazioni** → **Negozio** per funzionare con Stripe. 2\. Le aziende che si registrano in India dovranno attendere un periodo di attesa per attivare il proprio account e iniziare a elaborare i pagamenti. Puoi saperne di più su questa modifica [qui](https://support.stripe.com/questions/stripe-accounts-are-invite-only-in-india). ### 3. Configurazione webhook I webhook sono eventi in tempo reale inviati da Stripe al tuo negozio EDD per aggiornare le informazioni di pagamento o ricevere pagamenti di rinnovo quando si utilizzano i pagamenti ricorrenti. Ad esempio, se elabori un rimborso direttamente da Stripe, ciò consente all'ordine corrispondente di essere aggiornato come rimborsato con le informazioni appropriate. #### Configurazione Webhook I webhook vengono configurati automaticamente quando si collega un nuovo negozio EDD al proprio account Stripe. **Note per il test**: \- I webhook potrebbero non essere creati automaticamente su siti locali/di staging o in modalità di test. Vedrai un'opzione per **testare la creazione dei webhook**, che configurerà i webhook quando cliccata. \- Se utilizzi l'account temporaneo con la modalità di test e Stripe, non possiamo creare i webhook. Potresti vedere le opzioni per **Impostare automaticamente i webhook** o **aggiungerli manualmente al tuo account**. Si consiglia di fare clic sull'opzione automatica. Vedi le istruzioni sottostanti se li aggiungi manualmente. #### Configurazione manuale dei webhook 1\. Per aggiungere gli endpoint webhook appropriati, nella dashboard di Stripe vai su **Sviluppatori** → **Webhook** ([link diretto](https://dashboard.stripe.com/webhooks)). Si consiglia di creare due endpoint webhook: uno per la modalità di test e uno per la modalità live. Se crei entrambi, dovrai ripetere il processo sottostante dopo aver cambiato modalità. 2\. Fai clic su + **Aggiungi endpoint** 3\. Aggiungi il seguente URL: ``` https://example.com/?edd-listener=stripe ``` **Nota:** Sostituisci "example.com" con l'URL effettivo del tuo sito. L'URL esatto da inserire si trova nella tua bacheca WP sotto **Downloads → Impostazioni → Pagamenti → Stripe***.* 4\. Ascolta: Seleziona "Eventi sul tuo account" 5\. La versione dovrebbe essere impostata su "Ultima versione API". 6\. Seleziona **Tutti gli eventi** da ascoltare. Dopo aver aggiunto l'endpoint, vedrai il nuovo URL elencato nelle impostazioni dei webhook. **Nota:** I tuoi webhook non funzioneranno immediatamente in un ambiente di sviluppo locale come Vagrant, WAMP, MAMP, Desktop Server o Local by Flywheel. Questi sono tipicamente indirizzi IP non accessibili pubblicamente e Stripe non può raggiungerli. ### 4. Integrazione pagamenti ricorrenti (Necessario per vendere abbonamenti) Il gateway di pagamento Stripe ha un supporto completo per l'estensione [Pagamenti Ricorrenti](https://easydigitaldownloads.com/extension/recurring-payments). Vedi la [documentazione di configurazione Stripe per i pagamenti ricorrenti](https://easydigitaldownloads.com/docs/recurring-payments-stripe-gateway-configuration/) per le istruzioni di configurazione. Impostazioni/Funzionalità aggiuntive del gateway Stripe ------------------------------------------- Di seguito sono riportate impostazioni e funzionalità aggiuntive che puoi trovare in **Downloads** → **Impostazioni** → **Pagamenti** → **Stripe**. ### Descrittore di addebito Una breve descrizione dell'acquisto apparirà sull'estratto conto bancario/carta insieme all'addebito. Il descrittore viene impostato tramite le tue [Impostazioni Stripe](https://dashboard.stripe.com/settings/public) e dovrebbe essere lungo da 5 a 22 caratteri. ### Includi riepilogo acquisto Questa è un'impostazione opzionale se desideri includere il nome del/i prodotto/i nel descrittore. Utilizza il [Descrittore abbreviato](https://dashboard.stripe.com/settings/update/public/support-details) di Stripe per consentirti di impostare un nome più breve in modo che i caratteri rimanenti utilizzino il nome del prodotto. Ad esempio, se il tuo descrittore abbreviato è ACME e il nome del tuo prodotto è Easy Digital Downloads, Stripe imposterà il descrittore su "ACME\* EASYDIGITALDOWNL". Il nome del prodotto viene troncato in questo esempio a causa del limite di 22 caratteri. L'asterisco viene aggiunto da Stripe e non può essere rimosso. **Note importanti:** 1\. Sono consentiti solo 22 caratteri per i descrittori di addebito. Pertanto, se il nome del tuo prodotto è troppo lungo, verrà troncato. 2\. I descrittori di pagamento sono gestiti dall'emittente della carta/banca. Sebbene tu possa specificare un descrittore, la banca potrebbe o meno utilizzarlo esattamente come specificato. [Vedi questo documento Stripe per i dettagli](https://support.stripe.com/questions/why-do-customers-see-statement-descriptors-that-don-t-match-what-i-ve-set-in-stripe "Vedi questo documento Stripe per i dettagli"). Nota, quando un prodotto è configurato come abbonamento utilizzando la nostra estensione Pagamenti Ricorrenti, il comportamento è leggermente diverso per i Pagamenti di Rinnovo. Vedi la [documentazione Pagamenti Ricorrenti con Stripe](https://easydigitaldownloads.com/docs/recurring-payments-stripe-gateway-configuration/) per i dettagli. ### Pagamenti pre-approvati (Funzionalità Stripe Pro) Attiva questa impostazione se desideri raccogliere le informazioni di pagamento, ma non riscuotere il pagamento fino a una data successiva. Tipicamente, questa opzione viene utilizzata per i preordini. La maggior parte dei negozi tipici non necessita di questa opzione. Per elaborare il pagamento e fornire l'accesso ai tuoi download, fai clic su **Elabora** nella colonna **Stato** quando visualizzi l'elenco della cronologia dei pagamenti. Nota: Quando abilitata, questa opzione influisce su tutti i pagamenti Stripe per tutti i prodotti. ### Restringi asset Stripe Questa impostazione impedisce il caricamento degli asset Stripe su ogni pagina. La maggior parte dei siti non dovrebbe abilitare questa impostazione. Stripe consiglia di caricare la propria libreria JavaScript su ogni pagina per sfruttare le proprie regole avanzate di rilevamento frodi. Se non sei preoccupato per questo, abilita questa impostazione per caricare il JavaScript solo quando necessario. ### Stile metodi di pagamento Seleziona lo stile di layout (Schede o Fisarmonica) per la sezione Metodi di pagamento nel modulo di checkout. ### Metodi di pagamento Puoi abilitare o disabilitare i Metodi di Pagamento Stripe all'interno delle tue impostazioni Stripe. I metodi effettivamente visualizzati ai tuoi clienti varieranno in base a molteplici fattori, come valuta, paese e contenuto del carrello. Le modifiche apportate qui aggiorneranno i tuoi metodi di pagamento in modalità di test di Stripe. Quando disabiliti la Modalità di Test di EDD, rivisita queste impostazioni. ### Mostra carte utilizzate in precedenza Le carte utilizzate in precedenza sono ora gestite da [Link by Stripe](https://link.co/), per conversioni e sicurezza ancora migliori. ### Email di avviso frode anticipata di Stripe Ricevi un avviso quando viene rilevato un avviso di frode anticipata dall'apprendimento automatico di Stripe. Evita contestazioni prima ancora che accadano esaminando gli ordini contrassegnati per verificarli e considera di rimborsare proattivamente se il pagamento sembra fraudolento. Abilitalo in **Downloads** → **Email**. Cerca l'opzione email Avviso Frode Stripe, quindi fai clic sull'interruttore nella colonna **Stato**. Ciò richiede l'evento webhook `radar.early_fraud_warning.created`. Questo dovrà essere aggiunto se limiti quali webhook Stripe vengono inviati al tuo sito. Vedi [Configurazione Webhook](#webhook-configuration "Configurazione Webhook") per i dettagli. ### Acquista ora Se soddisfi i requisiti di Acquista ora, questo consentirà ai clienti di effettuare il checkout tramite una finestra modale popup. Per i dettagli su come funziona, consulta la nostra [documentazione sui pulsanti Acquista ora](https://easydigitaldownloads.com/docs/buy-now-buttons/). ### Configurazione Apple Pay Per utilizzare Apple Pay dovrai registrare i tuoi domini nel tuo account Stripe. **Nota**: Tentiamo di registrare automaticamente il tuo dominio per Apple Pay nel tuo account Stripe una volta connesso, ma in alcuni casi, potrebbe essere necessario eseguire questa operazione manualmente. Si prega di rivedere le istruzioni disponibili [qui](https://stripe.com/docs/stripe-js/elements/payment-request-button#verifying-your-domain-with-apple-pay). Per utilizzare Apple Pay, devi registrare con Apple tutti i tuoi domini web che mostreranno un pulsante Apple Pay. Vai alla [scheda Apple Pay](https://dashboard.stripe.com/account/apple_pay) nelle Impostazioni dell'account della tua Dashboard Stripe. **Se la registrazione del dominio fallisce**, dovrai controllare il file di associazione del dominio sul tuo host. L'estensione Stripe di EDD tenterà di farlo automaticamente quando abiliti una delle opzioni di checkout Express sopra per la prima volta. Per confermare che il file è stato aggiunto correttamente, [segui questi passaggi di Stripe](https://stripe.com/docs/stripe-js/elements/payment-request-button#verifying-your-domain-with-apple-pay) che spiegano come aggiungerlo manualmente. Una volta registrati i tuoi domini, potrai effettuare pagamenti nel tuo negozio con Apple Pay, utilizzando il browser web Safari. Per maggiori dettagli, consulta il documento di Stripe su [Verifica del tuo dominio con Apple Pay](https://stripe.com/docs/stripe-js/elements/payment-request-button#verifying-your-domain-with-apple-pay). Testare Stripe -------------- Puoi testare Stripe in ***Modalità di Test***, che ti consente di provare il processo di pagamento senza utilizzare una carta di credito reale. Stripe offre carte di test per questo processo (vedi sotto). ### 1. Abilita la modalità di test di EDD Vai su **Downloads → Impostazioni → Gateway di Pagamento** e abilita la **Modalità di Test***.* ### 2. Connetti con Stripe Seleziona la sottoscheda **Stripe** nella scheda **Pagamenti**, quindi fai clic sul pulsante **Connetti con Stripe**. Se ti sei già connesso a Stripe con la Modalità di Test disabilitata, dovrai connetterti di nuovo in Modalità di Test. Una volta connesso sia in Modalità Live che di Test, non è necessario riconnettersi quando si passa dall'una all'altra. Questo ti porterà sul sito web di Stripe dove potrai accedere al tuo account esistente se ne hai uno o crearne uno nuovo se non ne hai. #### Account di test temporaneo di Stripe Stripe offre un account di test temporaneo cliccando su "Salta questo modulo". NON consigliamo questa opzione poiché è meglio utilizzare un account effettivo, lo stesso account del tuo account live. Questo ti consente di configurare i webhook e Apple Pay una volta per la Modalità Live e di Test. Inoltre, se stai testando [Pagamenti Ricorrenti](https://easydigitaldownloads.com/downloads/recurring-payments/), i rinnovi non funzioneranno con un account di test temporaneo. ### 3. Testare un acquisto Ora in modalità di test, aggiungi un prodotto al carrello e procedi al checkout. Puoi utilizzare il numero di carta **4242424242424242** con qualsiasi CVC e una data di scadenza valida (qualsiasi data futura). #### Testare il checkout Express (Apple Pay/Google Pay) Per testare questi metodi, devi avere un metodo di pagamento aggiunto. **Apple Pay** Una carta live deve essere aggiunta al tuo portafoglio Apple Pay, ma quando la Modalità di Test è abilitata, i fondi live non vengono utilizzati durante il test. **Google Pay** Google Pay ti consente di aggiungere qualsiasi Carta di Test Stripe. Dovrebbe essere aggiunta in [chrome://settings/payments](//settings/payments); se non esiste una carta di test (anche con una carta live elencata) potresti non vedere il pulsante Google Pay. Se i pulsanti di Checkout Express non compaiono, puoi testare il tuo browser qui: <https://stripe.com/docs/stripe-js/elements/payment-request-button> Dovresti vedere il pulsante appropriato apparire in cima alla pagina (vedi screenshot qui sotto). Se non appare, è dovuto al tuo browser: **Apple Pay è disponibile ma il pagamento fallisce:** Prova a registrare nuovamente il tuo dominio con Apple Pay rimuovendo il tuo sito e [registrandolo](#register) di nuovo. **Risorse aggiuntive** Vedi [Test di Stripe](https://stripe.com/docs/testing) per altri numeri di carte di test e opzioni di test aggiuntive. Migrazione a Payment Elements ----------------------------- **Nota:** La sezione seguente è applicabile solo ai clienti che hanno utilizzato la nostra integrazione Stripe prima dell'introduzione di Payment Elements. A questi negozi è stato concesso l'accesso a un'opzione per passare a Payment Elements durante la fase iniziale di questa release, consentendo loro di verificare che eventuali personalizzazioni della loro pagina di checkout non siano interessate durante l'aggiornamento, prima di effettuare il passaggio a Payment Elements tramite le loro Impostazioni Stripe di EDD. Se hai utilizzato la nostra integrazione Stripe prima dell'introduzione di Payment Elements, ti abbiamo concesso l'accesso temporaneo a un'impostazione chiamata "Modalità Elementi" in **Downloads** → **Impostazioni** → **Pagamenti** → **Stripe**. Dopo l'aggiornamento, il tuo negozio rimarrà su Elementi Carta, e ti darà la possibilità di passare a Elementi di Pagamento solo dopo aver confermato che il tuo checkout funziona con esso. Se la tua pagina di checkout è stata personalizzata, [fai riferimento a questo documento](https://easydigitaldownloads.com/docs/customize-stripe-universal-payment-elements/ "fai riferimento a questo documento") per ulteriori dettagli su cosa dovrà essere aggiornato. **Plugin o servizi di caching** Dopo essere passato a Payment Element, assicurati di svuotare tutte le cache che potresti avere, inclusa la cache della pagina, la cache degli oggetti e servizi come Cloudflare, per garantire che i file Javascript e CSS corretti vengano caricati. ### Impostazioni deprecate e le loro alternative Con l'introduzione di Payment Elements, ci sono state alcune modifiche alle impostazioni disponibili all'interno dell'integrazione Stripe di EDD. Abbiamo aggiunto la massima parità di funzionalità possibile, pur fornendo un'integrazione ottimale. **Carte utilizzate in precedenza** I vecchi elementi carta utilizzavano l'API Stripe per cercare i metodi di pagamento utilizzati in precedenza dagli utenti quando erano connessi. Con la nuova integrazione Link integrata in Payment Element, gli utenti possono ora autenticarsi e salvare le carte con il servizio Link di Stripe. Questo è molto più vantaggioso in quanto offre un modo più sicuro per salvare le carte, dà agli utenti la possibilità di salvare la propria carta, e i vecchi elementi carta mostravano solo le carte utilizzate sul tuo negozio, mentre le carte salvate Link sono globali e si applicano a qualsiasi negozio che utilizza l'integrazione Link. **Campi carta divisi** Questa funzionalità non è ufficialmente supportata in Payment Elements ed è stata deprecata. **Apple Pay/Google Pay** Questi metodi appaiono per impostazione predefinita e verranno visualizzati quando pertinenti agli utenti, in modo non invasivo, insieme agli altri metodi di pagamento supportati dal loro browser. **Carte prepagate** Con l'introduzione della funzionalità Radar di Stripe, puoi limitare le carte in modo più affidabile a livello di Stripe, invece di fare affidamento sulla nostra impostazione. Per saperne di più su come creare regole, consulta la [documentazione sulle regole Radar](https://stripe.com/docs/radar/rules#review-rules) di Stripe, che contiene esempi per bloccare o consentire carte prepagate. FAQ sulla configurazione del gateway Stripe ---------------------------- ### Quali metodi di pagamento supporta il gateway Stripe? Quando si utilizza il gateway di pagamento Stripe, ci sono diversi metodi di pagamento che puoi offrire ai clienti tramite Stripe senza avere account individuali con i metodi di pagamento. Ad esempio, puoi accettare Cash App senza avere un account Cash App. Ecco un elenco dei metodi di pagamento supportati da EDD tramite Stripe, che possono essere abilitati/disabilitati tramite le tue impostazioni Stripe di EDD: Carta di credito / debito\* Affirm Alipay Amazon Pay\* Apple Pay\* Bacs Debit Bancontact\* BLIK Debito canadese Cartes Bancaires\* Cash App\* EPS giropay Google Pay\* iDEAL\* Klarna\* Link\* Przelewy24 SEPA Direct Debit SOFORT Conto bancario USA WeChat Pay \*Supporta pagamenti ricorrenti Negli Stati Uniti, puoi accettare queste carte: Visa, Mastercard, American Express, Discover, JCB, Diners Club, China UnionPay, carte di debito. Puoi leggere di più sulle [valute accettate da Stripe nella loro documentazione](https://docs.stripe.com/currencies). Nota: EDD non supporta tutti i metodi di pagamento Stripe, alcuni metodi di pagamento hanno requisiti che EDD non può supportare. ### Come posso rimuovere la commissione aggiuntiva del 3% dalle mie transazioni Stripe? Non ti verrà addebitata una commissione aggiuntiva del 3% sulle tue transazioni Stripe se acquisti una licenza per un [Pass Esteso (o superiore)](https://easydigitaldownloads.com/pricing/) di EDD. La chiave di licenza deve essere attivata sul tuo sito EDD e rimanere attiva e in regola per evitare che la commissione si verifichi. La commissione tornerà se la chiave di licenza non si rinnova e/o scade. Lo stato della tua connessione Stripe di EDD rifletterà se la commissione si applica al tuo negozio. ### Quali funzionalità ha Stripe Pro di EDD che la versione standard/gratuita di Stripe non ha? Attualmente, Stripe Pro aggiunge la possibilità di accettare pagamenti pre-approvati. ### La commissione del 3% si applica a PayPal? No, la commissione del 3% si applica solo alle transazioni elaborate tramite Stripe quando si utilizza la versione gratuita di Stripe. ### La commissione del 3% si applica alle transazioni Stripe ricorrenti? Sì, la commissione del 3% si applica agli ordini di rinnovo. ### Posso connettermi al mio account Stripe manualmente utilizzando le mie chiavi API Stripe? Per offrire la migliore esperienza, offriamo solo Stripe Connect per l'integrazione con Stripe. ### Posso effettuare il downgrade da Stripe Pro a Stripe Standard? Sì, puoi disattivare ed eliminare l'estensione Stripe Pro e Stripe Standard prenderà automaticamente il sopravvento. Accedi a [il tuo account](https://easydigitaldownloads.com/your-account/) per annullare il tuo abbonamento Stripe Pro. Articoli Correlati ---------------- - [Stripe - Problemi comuni e FAQ](https://easydigitaldownloads.com/docs/stripe-common-issues-and-faq/)