Inhoudsopgave
Dit document legt uit hoe de extensie Recurring Payments werkt met Stripe.
Stripe configureren
Het is belangrijk om alle stappen te volgen die worden beschreven in de Stripe Setup Documentatie.
Belangrijke Opmerking over Configuratie: Als Webhooks niet correct zijn geconfigureerd, zullen abonnementen niet goed werken!
Abonnementen Annuleren
Bij gebruik van Stripe kan een annulering ofwel vanuit EDD ofwel vanuit het Stripe Dashboard worden geïnitieerd.
Annuleren als Klant
Klanten kunnen hun eigen abonnementen annuleren vanaf de accountpagina van uw winkel.
Annuleren als Sitebeheerder
Om een abonnement te annuleren vanuit de EDD-admin, ga naar Downloads → Abonnementen en klik op “Bekijken” bij het item dat u wilt annuleren.
Klik vervolgens onderaan het volgende scherm op “Abonnement Annuleren”.
Wanneer u de status van een abonnement op geannuleerd zet, wordt het onmiddellijk geannuleerd, maar de klant behoudt toegang tot het gekochte materiaal voor de periode waarvoor is betaald.
Als ze bijvoorbeeld $10/maand hebben betaald en u annuleert halverwege de maand, hebben ze nog steeds toegang tot hun materiaal voor de rest van de maand, maar ze worden niet opnieuw gefactureerd en de toegang stopt aan het einde van de maand.
Vanuit Het Stripe Dashboard
Om een abonnement te annuleren vanuit het Stripe Dashboard, log in bij Stripe en zoek de zoekbalk bovenaan de pagina.
U kunt klanten vinden door te zoeken op:
- de transactie-ID
- de abonnementsprofiel-ID
- het EDD-klant-ID-nummer
- het e-mailadres van de klant
Nadat u uw klant in Stripe heeft gevonden en geselecteerd, ziet u een lijst met abonnementen.
Als u op Annuleren (X-icoon naast de abonnementsnaam) klikt, krijgt u drie opties: onmiddellijk annuleren, aan het einde van de huidige periode, of op een aangepaste datum. Voor de doeleinden van EDD maakt het niet uit welke u kiest, onmiddellijk of aan het einde van de huidige periode, uw klant zal geen verschil ervaren tussen de twee. Als u een aangepaste datum kiest die na het einde van de huidige periode ligt, zullen ze doorlopend gefactureerd worden totdat de aangepaste datum is verstreken.
Samenvatting Annuleren
Het maakt niet uit of u een abonnement annuleert in EDD of in Stripe, het effect is precies hetzelfde en de klant zal geen verschil merken.
Credit-/Debitcardgegevens Bijwerken
Klanten kunnen hun kaartgegevens voor hun specifieke abonnement(en) bijwerken vanaf de accountpagina van uw winkel.
Statement Descriptors
Wanneer een product is geconfigureerd als een abonnement, gedraagt de descriptor zich iets anders dan bij niet-abonnementsaankopen. Wanneer een abonnement voor de eerste keer op uw site wordt aangeschaft, wordt er een "Product" aangemaakt in Stripe dat voor alle volgende aankopen van dat specifieke abonnement zal worden gebruikt. U kunt uw huidige lijst met producten bekijken door in te loggen op uw Stripe-account en naar Producten te navigeren.
Wanneer dit Product wordt aangemaakt, wordt een statement descriptor aangemaakt op basis van de naam van je product, ongeacht de bovengenoemde instelling in je WordPress-dashboard. De descriptor wordt ook in kleine letters weergegeven en scheidt woorden met koppeltekens. Begrijpelijkerwijs ziet dit er niet prettig uit op een bankafschrift. Er zijn twee manieren om dit gedrag te veranderen, die het beste samen kunnen worden gebruikt als je niet tevreden bent met het standaardgedrag:
1. Bewerk de Plan details
Door naar Products in je Stripe-account te gaan, kun je op elk Product klikken om de details te zien. Zodra je op de detailpagina bent, klik je op de knop Edit details. Je krijgt dan een modaal venster te zien waarmee je de statement descriptor voor dat specifieke Product kunt instellen.
Wat je hier instelt, wordt gebruikt voor alle betalingen van dat abonnement op je site.
2. Filter de standaard statement descriptor voor Stripe-abonnementen
De bovenstaande methode stelt je in staat om de statement descriptor voor een specifiek bestaand abonnement te beheren. Maar als er een nieuw abonnement wordt aangemaakt vanaf de eerste aankoop van een ander abonnement op je site, geldt het standaardgedrag. Dat betekent dat het nieuwe abonnement standaard nog steeds een statement descriptor heeft op basis van de productnaam.
Om een nieuwe standaard statement descriptor aan te maken voor alle abonnementen die in de toekomst worden aangemaakt (dit heeft geen invloed op bestaande abonnementen), gebruik je het volgende filter:
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 );
Vervang New Statement Desc door je gewenste standaard statement descriptor (denk aan de limiet van 22 tekens).
Samenvattend, gebruik de eerste methode om de statement descriptor voor een bestaand abonnement te bewerken. Gebruik de tweede methode om een nieuwe standaard statement descriptor in te stellen voor alle toekomstige abonnementen.
Veelvoorkomende problemen met betrekking tot webhooks
Klanten worden te vaak gefactureerd
Als je je Stripe webhooks niet correct instelt voordat een klant een aankoop doet en je gebruikt de optie "Times" in EDD Recurring om de klant een vast bedrag te laten betalen (bijvoorbeeld 5 keer), dan zullen ze te vaak worden gefactureerd.
Dit komt doordat Stripe, zonder de webhook, EDD niet kan laten weten dat de betalingen succesvol zijn doorgekomen, dus EDD weet het niet. Hierdoor denkt EDD dat de klant nog niet is gefactureerd – ook al zijn ze mogelijk al 5 keer (of vaker) gefactureerd.
EDD stuurt automatisch een "abonnement annuleren" naar Stripe wanneer het aantal keren is bereikt. Maar omdat er geen webhook is, weet EDD niet dat de klant überhaupt is gefactureerd en annuleert het abonnement nooit. Dit resulteert erin dat de klant blijft worden gefactureerd, zelfs nadat het ingestelde aantal keren is bereikt. Daarom is het belangrijk om onmiddellijk na het installeren van de Stripe-extensie een webhook in te stellen.
