Indice dei contenuti
Questo documento spiega come funziona l'estensione Pagamenti Ricorrenti con Stripe.
Configurazione di Stripe
È importante seguire tutti i passaggi descritti nella Documentazione di Configurazione Stripe.
Nota Importante sulla Configurazione: Se i Webhook non sono configurati correttamente, gli abbonamenti non funzioneranno!
Annullamento Abbonamenti
Quando si utilizza Stripe, una cancellazione può essere avviata sia da EDD che dal Dashboard di Stripe.
Annullamento come Cliente
I clienti possono annullare i propri abbonamenti dalla pagina account del tuo negozio.
Annullamento come Amministratore del Sito
Per annullare un abbonamento dall'amministratore di EDD vai su Download → Abbonamenti e fai clic su “Visualizza” sull'articolo che desideri annullare.
Quindi, in fondo alla schermata successiva, fai clic su “Annulla Abbonamento”.
Quando imposti lo stato di un abbonamento su annullato, questo viene annullato immediatamente, ma il cliente avrà ancora accesso al materiale acquistato per il tempo per cui ha pagato.
Ad esempio, se hanno pagato 10 €/mese e tu annulli a metà mese, avranno ancora accesso al loro materiale per il resto del mese, ma non verranno riaddebitati e l'accesso cesserà alla fine del mese.
Dal Dashboard di Stripe
Per annullare un abbonamento dal Dashboard di Stripe, accedi a Stripe e trova la barra di ricerca in cima alla pagina.
Puoi trovare i clienti cercando per:
- l'ID della transazione
- l'ID del profilo di abbonamento
- il numero ID cliente di EDD
- l'email del cliente
Una volta trovato e selezionato il tuo Cliente in Stripe, vedrai un elenco di abbonamenti.
Se fai clic su Annulla (icona X accanto al nome dell'abbonamento) ti verranno date tre opzioni: annulla Immediatamente, alla fine del periodo corrente o in una data personalizzata. Ai fini di EDD non importa quale scegli tra immediatamente o alla fine del periodo corrente, il tuo cliente non noterà alcuna differenza tra i due. Se scegli una data personalizzata, successiva alla fine del periodo corrente, continueranno a essere fatturati fino al superamento della data personalizzata.
Riepilogo Annullamento
Non importa se annulli un abbonamento in EDD o in Stripe, l'effetto è esattamente lo stesso e il cliente non noterà alcuna differenza.
Aggiornamento Informazioni Carta di Credito/Debito
I clienti possono aggiornare le informazioni della loro carta per i loro specifici abbonamenti dalla pagina account del tuo negozio.
Descrizioni delle Dichiarazioni
Quando un prodotto è configurato come abbonamento, il comportamento del descrittore è leggermente diverso rispetto agli acquisti non di abbonamento. Quando un abbonamento viene acquistato per la prima volta sul tuo sito, viene creato un "Prodotto" in Stripe che verrà utilizzato per tutti gli acquisti successivi di quell'abbonamento specifico. Puoi vedere il tuo elenco attuale di Prodotti accedendo al tuo account Stripe e navigando su Prodotti.
Quando questo Prodotto viene creato, viene creato un descrittore di addebito basato sul nome del tuo prodotto, indipendentemente dall'impostazione sopra menzionata nella tua bacheca di WordPress. Il descrittore verrà inoltre convertito in minuscolo e separerà le parole usando trattini. Comprensibilmente, questo non ha un aspetto gradevole sull'estratto conto bancario. Ci sono due modi per modificare questo comportamento che è meglio usare insieme se non ti piace il comportamento predefinito:
1. Modifica i dettagli del Piano
Andando su Prodotti nel tuo account Stripe, puoi fare clic su qualsiasi Prodotto per vederne i dettagli. Una volta nella pagina dei dettagli, fai clic sul pulsante Modifica dettagli. Ti verrà presentato un modale che ti consentirà di impostare il descrittore di addebito per quel particolare Prodotto.
Ciò che imposti qui verrà utilizzato per tutti i pagamenti di quel piano di abbonamento sul tuo sito.
2. Filtra il descrittore di addebito predefinito per i piani Stripe
Il metodo sopra consente di controllare il descrittore di addebito per un abbonamento specifico già esistente. Ma se viene creato un nuovo abbonamento dal primo acquisto di un abbonamento diverso sul tuo sito, verrà applicato il comportamento predefinito. Ciò significa che il nuovo abbonamento avrà ancora un descrittore di addebito basato sul nome del prodotto per impostazione predefinita.
Per creare un nuovo descrittore di addebito predefinito per tutti gli abbonamenti creati in futuro (questo non influenzerà gli abbonamenti esistenti), usa il seguente filtro:
function custom_edd_recurring_stripe_plan_statement_descriptor( $args, $subscription ) {
$args['statement_descriptor'] = 'New Statement Desc';
return $args;
}
add_filter( 'edd_recurring_create_stripe_plan_args', 'custom_edd_recurring_stripe_plan_statement_descriptor', 10, 2 );
Sostituisci New Statement Desc con il tuo descrittore di addebito predefinito preferito (ricorda il limite di 22 caratteri).
In sintesi, usa il primo metodo per modificare il descrittore di addebito per un abbonamento esistente. Usa il secondo metodo per impostare un nuovo descrittore di addebito predefinito per tutti gli abbonamenti futuri.
Problemi comuni relativi ai webhook
I clienti vengono addebitati troppe volte
Se non imposti correttamente i tuoi webhook Stripe prima che un cliente effettui un acquisto e stai utilizzando l'opzione "Volte" in EDD Recurring per addebitare al cliente un importo fisso di volte (ad esempio, 5 volte), gli verranno addebitati troppe volte.
Questo perché, senza il webhook, Stripe non è in grado di comunicare a EDD che i pagamenti sono andati a buon fine, quindi EDD non lo sa. Per questo motivo, EDD pensa che al cliente non sia ancora stato addebitato alcun importo, anche se potrebbe essere già stato addebitato 5 volte (o più).
EDD invia automaticamente un "annulla abbonamento" a Stripe quando il numero di volte è stato raggiunto. Ma poiché non c'è alcun webhook, EDD non sa che al cliente è stato addebitato un importo e non annulla mai l'abbonamento. Ciò si traduce nel fatto che al cliente continuano ad essere addebitati importi anche dopo che il numero impostato di volte è stato raggiunto. Ecco perché è importante impostare un webhook immediatamente dopo aver installato l'estensione Stripe.
