Abonnement · Guides de recettes
Reprendre un abonnement dont la carte a disparu
Ce que veut dire mandate_revoked, et les trois façons de remettre l'abonnement en marche.
1. Comprendre ce qui s'est passé
Une carte peut cesser d'être prélevable de cinq façons : le porteur la supprime de son portefeuille, vous la supprimez ou la désactivez par l'API, elle est supprimée depuis votre espace marchand, ou l'acquéreur ne la trouve plus.
Dans tous les cas, les abonnements qu'elle alimentait repassent en pending_mandate, carte détachée, et cessent d'ouvrir des échéances. Vous recevez subscription.mandate_revoked, dont le champ reason dit lequel des cinq cas s'est produit.
Ce n'est pas une résiliation
Perdre la carte fait obstacle aux prélèvements sans libérer le client de ce qu'il doit. L'accord que vous avez avec lui survit, et c'est à vous de le reprendre ou d'y mettre fin.
2. Cas 1 : le client a une autre carte
Rattachez-la par un PATCH. L'abonnement repasse en active et reprend à sa prochaine échéance ; vous recevez subscription.mandate_restored.
Depuis votre espace marchand, la même chose se fait par l'action « Rattacher une carte » sur l'abonnement en attente.
{
"paymentMethodId": "pm_..."
}3. Cas 2 : le client n'a plus aucune carte
Envoyez-lui un lien d'enregistrement, puis rattachez la carte enrôlée comme au cas 1. Le lien vit plusieurs jours, ce qui laisse au client le temps de répondre.
{
"purpose": "register",
"sendByEmail": true
}4. Cas 3 : le client le fait lui-même
Le porteur voit ses prélèvements dans son portefeuille, sur la page de gestion de ses cartes. Un prélèvement en attente y porte un bouton « Reprendre sur cette carte », et le rattachement se fait sans vous.
Vous l'apprenez par subscription.mandate_restored, dont le reason vaut alors attached_by_customer : c'est ce champ qui distingue une reprise faite par le porteur d'une reprise que vous avez faite.
Le lien vers ce portefeuille, c'est vous qui le donnez
Créez un lien de gestion, avec purpose valant manage, et transmettez-le. Sans lui, votre client n'a aucun chemin vers cet écran.
5. Pourquoi une carte neuve ne reprend rien toute seule
Enregistrer une carte ne vaut pas, à soi seul, autorisation de prélèvement : c'est écrit à l'article 6 bis.2 de nos conditions d'utilisation, et le produit s'y tient.
Un client qui remplace sa carte pour un achat ponctuel ne consent pas par là à reprendre ses abonnements. Le rattachement est donc toujours un geste explicite, le vôtre ou le sien.