Accueil Informations générales sur l’abonnement et le cycle de vie avec suspension.
Votre abonnement peut avoir plusieurs états :
-
Pending: Un abonnement est dans l’état Pending lorsque l’abonnement et la version d’abonnement sont créés. -
Initializing: Une fois l’abonnement créé et si aucune version de jeton active n’est présente, l’abonnement passe dans l’état Initializing jusqu’à ce que des informations de paiement valides soient fournies. -
Active: Dès que le jeton peut être débité, l’abonnement passe dans l’état actif. -
Terminating: Un abonnement qui est résilié mais qui a des débits en cours ou des périodes en cours est dans l’état Terminating. -
Terminated: Une fois que tous les débits sont effectués, l’abonnement passe dans l’état Terminated. -
Failed: Si l’initialisation de l’abonnement échoue, l’abonnement passe automatiquement dans l’état Failed. Cela peut aussi se produire lorsque la transaction initiale atteint le délai d’expiration. Si vous utilisez la page de paiement ou l’intégration iframe pour initialiser l’abonnement, vous devez en tenir compte. Si vous souhaitez envoyer un e-mail avec lequel le client peut initialiser la transaction, il est recommandé d’utiliser les Charge Flows également pour la transaction initiale.
Une fois qu’un abonnement a été créé, l’échec du paiement d’une facture devient l’événement le plus important qui puisse se produire. Les échecs surviennent pour de nombreuses raisons :
-
Absence d’une source de paiement réelle chez le client associé
-
Tentative d’utilisation d’une source de paiement obsolète ou expirée
-
Un refus effectif d’une source de paiement par ailleurs valide
Dès que le paiement échoue, cela déclenche le Charge Flow standard afin d’obtenir des informations de paiement valides.
Dans la configuration du Charge Flow, vous pouvez définir les niveaux du Charge Flow pour configurer combien de fois
l’e-mail de demande d’informations de paiement est envoyé. Lorsque le dernier niveau du Charge Flow est atteint et que l’abonné
n’a pas fourni d’identifiants valides, l’abonnement passe dans l’état suspended.
Les suspensions peuvent être supprimées manuellement en ouvrant l’abonnement et en passant dans l’onglet de suspension. Le montant en cours sera débité avec le prochain cycle de facturation.
|
Note
|
Vous pouvez facilement tester un échec de paiement en créant un véritable abonnement puis en invalidant le jeton de l’abonnement. Cela déclenchera automatiquement le processus d’échec de paiement pour mettre à jour la version du jeton. |
Les abonnements peuvent être suspendus. Cela peut se produire automatiquement si le montant en cours ne peut pas être débité. Avant que cela ne se produise, le Charge Flow associé doit arriver à son terme sans paiement réussi.
Des suspensions supplémentaires peuvent être ajoutées manuellement. En substance, une suspension met la facturation en pause et interrompt temporairement les services. Une suspension nécessite toujours une date de fin. La date de fin indique quand la suspension sera terminée. Lors de la création de la suspension, le comportement après la fin de la suspension peut être défini. Cela permet de déterminer si, lorsque la suspension arrive à son terme, l’abonnement doit être résilié ou si l’abonnement doit être réactivé. Lorsque le Charge Flow échoue, nous créons une suspension qui résiliera l’abonnement une fois la suspension terminée. Cela signifie que nous mettons l’abonnement en pause pendant la durée de la suspension et, si l’abonné ne contacte pas le marchand dans ce délai pour réactiver l’abonnement, nous résilions ensuite l’abonnement, car nous partons du principe que si l’abonné ne réagit pas aux e-mails de rappel envoyés et si la mise en pause du service ne suscite aucune réaction de la part de l’abonné, l’abonné n’est très probablement plus intéressé par le service.
Des suspensions peuvent être ajoutées à un abonnement via le backend. Pour cela, vous devez ouvrir l’abonnement et passer dans l’onglet de suspension. Vous pouvez y ajouter des suspensions à un abonnement. Pendant la durée de la suspension, aucun débit ne sera effectué. Dès que l’abonnement sort de la suspension et n’est pas résilié, l’abonnement reprend exactement là où il avait été suspendu.
Un abonnement peut également être suspendu automatiquement si le débit du montant en cours échoue et que les informations de paiement n’ont pas pu être obtenues via le Charge Flow. Si un abonnement est en suspension, vous devriez cesser de fournir le service de votre côté. Si le montant en cours n’est pas payé dans la période de suspension définie sur le produit via le lien du Charge Flow, l’abonnement sera résilié automatiquement.
Si un paiement échoue lors du débit, cela déclenche un processus de Charge Flow basé sur vos configurations. L’abonné recevra un e-mail qui invitera l’abonné à mettre à jour ses informations de paiement. Si vous avez besoin de plus de contrôle sur le formatage et l’envoi de l’e-mail, vous pouvez configurer le Charge Flow de manière à ce que votre application soit notifiée d’un nouvel e-mail de Charge Flow à envoyer. L’application peut ainsi se charger de l’envoi. La documentation des Charge Flows contient plus de détails sur la manière de configurer cela.
Si l’abonné doit pouvoir mettre à jour les détails de paiement depuis votre application, vous voudrez peut-être utiliser l’appel API de mise à jour du jeton. Cette opération API crée une transaction qui met simplement à jour les détails de paiement pour le jeton. Le jeton se trouve sur l’objet abonnement. Consultez la documentation API pour les détails de l’opération de mise à jour du jeton.
Pour ce faire, vous devez mettre à jour le jeton comme suit :
-
Utilisez le point de terminaison créer une transaction pour la mise à jour du jeton. Vous fournissez dans l’appel le jeton que vous souhaitez mettre à jour.
-
Cela créera une transaction dans l’état
pending. Utilisez maintenant la transaction dans votre application pour construire la page de paiement ou pour créer un paiement iframe