Accueil Les webhooks permettent de notifier votre application des changements d’état des entités, tels que les transactions de paiement ou les abonnements. Bien que les webhooks puissent être utilisés à de nombreuses fins, ils sont particulièrement importants lors de l’utilisation d’abonnements, où la plupart de l’activité se produit de manière asynchrone et en coulisses.
Notre concept est que nous gérons tout, et la seule chose dont vous devez vous occuper est l’activation, la mise en pause et la résiliation du service de votre côté. Cela signifie que vous devriez réagir en fonction des changements d’état des abonnements. Les webhooks sont le moyen le plus simple d’y parvenir, car ils vous informent automatiquement lorsqu’un changement est nécessaire de votre côté.
Tout d’abord, consultez notre guide général des webhooks. Vous trouverez ci-dessous des informations supplémentaires sur l’utilisation des webhooks avec les abonnements.
Un échec de paiement peut être un problème temporaire (la banque a refusé ce prélèvement mais peut autoriser la nouvelle tentative automatique) ou indiquer un blocage permanent, comme l’absence d’une source de paiement utilisable. Cela se produit automatiquement lorsque vous utilisez les charge flows. Vous pouvez également y spécifier comment nous contactons l’abonné.
Si vous avez activé l’option Email Delivery sur le produit, nous informons également le client des changements d’état de l’abonnement lui-même. Cela signifie que nous envoyons des e-mails concernant la résiliation d’un abonnement ou la suspension d’un abonnement.
Si vous préférez informer l’abonné vous-même, vous pouvez réagir aux changements d’état correspondants de l’abonnement.
Les abonnements nécessitent plus de coordination entre votre application et notre plateforme que les paiements uniques. Dans le modèle d’abonnement, l’accès continu d’un client à votre produit ou service est déterminé par le succès ou l’échec de paiements automatiques et récurrents. Prenez, par exemple, un site où un abonnement donne accès au contenu du site.
Vous serez notifié lorsqu’un abonnement est active, suspended ou terminated. Il existe d’autres états
de l’abonnement. Cependant, les trois états mentionnés sont ceux qui sont pertinents et auxquels vous devriez réagir.
-
activesignifie que l’abonnement est actif et que le service de votre côté devrait également être activé. -
suspendedsignifie que l’abonnement de votre côté devrait être mis en pause (c’est-à-dire que si vous fournissez des vidéos à vos abonnés, vous devriez les empêcher de voir les films dès que vous recevez ce statut dans l’appel webhook. Cependant, vous voudrez peut-être leur permettre de se connecter à votre système, car vous voudrez peut-être les informer que l’abonnement a été suspendu). -
terminatedsignifie que l’abonnement n’est plus facturé et que le service devrait donc être arrêté de manière permanente. C’est par exemple le déclencheur pour fermer le compte dans votre système.