Paiements récurrents – Configuration de la passerelle Stripe

Ce document explique le fonctionnement de l'extension Paiements récurrents avec Stripe.

Configuration de Stripe

Il est important de suivre toutes les étapes décrites dans la Documentation de configuration Stripe.

Note de configuration importante : Si les Webhooks ne sont pas correctement configurés, les abonnements ne fonctionneront pas correctement !

Annulation des abonnements

Lors de l'utilisation de Stripe, une annulation peut être initiée soit depuis EDD, soit depuis le tableau de bord Stripe.

Annulation en tant que client

Les clients peuvent annuler leurs propres abonnements depuis la page de compte de votre boutique. 

Annulation en tant qu'administrateur du site

To cancel a subscription from the EDD admin go to Downloads → Subscriptions and click “View” on the item you want to cancel.

Then in the bottom of the next screen click on “Cancel Subscription”.

Lorsque vous définissez le statut d'un abonnement sur annulé, il est annulé immédiatement, mais le client aura toujours accès à son matériel acheté pendant la période pour laquelle il a payé.

Par exemple, s'il a payé 10 $/mois et que vous annulez à mi-chemin du mois, il aura toujours accès à son matériel pour le reste du mois, mais il ne sera pas re-facturé et l'accès s'arrêtera à la fin du mois.

Depuis le tableau de bord Stripe

Pour annuler un abonnement depuis le tableau de bord Stripe, connectez-vous à Stripe et trouvez la barre de recherche en haut de la page.

Vous pouvez trouver les clients en recherchant :

• l'ID de transaction
• l'ID du profil d'abonnement
• le numéro d'ID client EDD
• l'e-mail du client

Une fois que vous avez trouvé et sélectionné votre client dans Stripe, vous verrez une liste d'abonnements.

Si vous cliquez sur Annuler (icône X à côté du nom de l'abonnement), trois options vous seront proposées : annuler immédiatement, à la fin de la période en cours ou à une date personnalisée. Aux fins d'EDD, peu importe ce que vous choisissez entre immédiatement ou à la fin de la période en cours, votre client ne constatera aucune différence entre les deux. Si vous choisissez une date personnalisée, postérieure à la fin de la période en cours, il continuera à être facturé jusqu'à ce que la date personnalisée soit passée.

Résumé de l'annulation

Peu importe si vous annulez un abonnement dans EDD ou dans Stripe, l'effet est exactement le même et le client ne remarquera aucune différence.

Mise à jour des informations de carte de crédit/débit

Les clients peuvent mettre à jour les informations de leur carte pour leurs abonnements spécifiques depuis la page de compte de votre boutique.

Descripteurs de relevé

Lorsqu'un produit est configuré comme un abonnement, le comportement du descripteur est légèrement différent de celui des achats non-abonnements. Lorsqu'un abonnement est acheté pour la première fois sur votre site, un « Produit » est créé dans Stripe qui sera utilisé pour tous les achats ultérieurs de cet abonnement particulier. Vous pouvez voir votre liste actuelle de Produits en vous connectant à votre compte Stripe et en naviguant vers Produits.

Lorsque ce Produit est créé, un descripteur de relevé est créé en fonction du nom de votre produit, indépendamment du paramètre susmentionné dans votre tableau de bord WordPress. Le descripteur sera également mis en minuscules et séparera les mots par des tirets. Naturellement, cela ne fait pas très joli sur un relevé bancaire. Il existe deux façons de modifier ce comportement qui sont mieux utilisées ensemble si vous n'aimez pas le comportement par défaut :

1. Modifier les détails du Plan

En allant dans Produits dans votre compte Stripe, vous pouvez cliquer sur n'importe quel Produit pour voir ses détails. Une fois sur la page des détails, cliquez sur le bouton Modifier les détails. Une fenêtre modale vous permettra de définir le descripteur de relevé pour ce Produit particulier.

Ce que vous définissez ici sera utilisé pour tous les paiements de ce plan d'abonnement sur votre site.

2. Filtrer le descripteur de relevé par défaut pour les plans Stripe

La méthode ci-dessus vous permet de contrôler le descripteur de relevé pour un abonnement spécifique qui existe déjà. Mais si un nouvel abonnement est créé à partir du premier achat d'un autre abonnement sur votre site, le comportement par défaut s'appliquera. Cela signifie que le nouvel abonnement aura toujours un descripteur de relevé basé sur le nom du produit par défaut.

Pour créer un nouveau descripteur de relevé par défaut pour tous les abonnements créés à l'avenir (cela n'affectera pas les abonnements existants), utilisez le filtre suivant :

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 );

Remplacez Nouveau Descripteur de Relevé par votre descripteur de relevé par défaut préféré (n'oubliez pas la limite de 22 caractères).

En résumé, utilisez la première méthode pour modifier le descripteur de relevé d'un abonnement existant. Utilisez la deuxième méthode pour définir un nouveau descripteur de relevé par défaut pour tous les futurs abonnements.

Problèmes courants liés aux webhooks

Les clients sont facturés trop de fois

Si vous ne configurez pas correctement vos webhooks Stripe avant qu'un client n'effectue un achat et que vous utilisez l'option « Nombre de fois » dans EDD Recurring pour facturer le client un nombre défini de fois (par exemple, 5 fois), il sera facturé trop de fois.

C'est parce que, sans le webhook, Stripe ne peut pas indiquer à EDD que les paiements ont été effectués avec succès, donc EDD ne le sait pas. Pour cette raison, EDD pense que le client n'a pas encore été facturé – même s'il a peut-être déjà été facturé 5 fois (ou plus).

EDD envoie automatiquement une « annulation d'abonnement » à Stripe lorsque le nombre de fois est atteint. Mais comme il n'y a pas de webhook, EDD ne sait pas que le client a été facturé du tout et n'annule jamais l'abonnement. Il en résulte que le client continue d'être facturé même après que le nombre de fois défini a été atteint. C'est pourquoi il est important de configurer un webhook immédiatement après l'installation de l'extension Stripe.