PAIEMENTS ÉCHOUÉSMAXIO

Gérer les cartes qui expirent dans Maxio

Ce que fait Maxio pour les cartes qui expirent : emails d’expiration, webhook expiring_card, account updater selon la passerelle, nouvelle carte à temps.

Publié le 6 min de lecture

Une carte qui expire est le paiement échoué le plus prévisible qui soit : vous savez le mois où elle cessera de fonctionner avant que cela n’arrive. Maxio Advanced Billing (anciennement Chargify) vous donne trois outils pour cela : des emails automatiques d’expiration de carte, un webhook expiring_card, et la prise en charge de l’account updater sur certaines passerelles. Ce guide explique ce que fait chacun, où ils laissent des trous, et comment les combiner pour que les renouvellements n’échouent pas pour une raison que vous pouviez voir venir.

Il s’en tient à la documentation de Maxio : configurer les réglages d’email, modèles d’email, événements webhook, exemples de contenus, comparer les fonctionnalités des passerelles, gérer les moyens de paiement, mettre à jour les informations de paiement d’un client et le glossaire d’Advanced Billing (tous consultés en novembre 2026). Quand les pages de Maxio se contredisent, nous le disons. Pour ce qui se passe une fois qu’un renouvellement a déjà échoué, voir comment réduire le churn involontaire dans Maxio.

Étape 1 : laisser l’account updater faire ce qu’il peut

Les réseaux de cartes font tourner des services d’account updater : quand une banque réémet une carte, le nouveau numéro ou la nouvelle date d’expiration peut parvenir au marchand sans que le client fasse quoi que ce soit. Dans Maxio, la prise en charge dépend de votre passerelle :

Passerelle Account updater dans Advanced Billing
Stripe, BlueSnap, Cybersource, Forte (Beta), Maxio Payments Entièrement pris en charge : Maxio reçoit les mises à jour et garde les données de carte stockées à jour
Autres passerelles L’updater de la passerelle fonctionne généralement quand même via son token, donc les prélèvements peuvent réussir, mais les nouvelles coordonnées de carte peuvent ne pas apparaître dans Advanced Billing

Certaines passerelles demandent une configuration. Pour BlueSnap, le guide de configuration de Maxio vous demande de configurer les webhooks BlueSnap et de cocher « Send Account Updater ». Pour Forte, l’updater doit d’abord être activé dans le compte Forte. Sur Stripe, la doc de Maxio lie l’updater automatique à l’intégration Stripe Connect.

Deux limites tirées de la doc de Maxio :

  • Toutes les banques émettrices ne participent pas. Un updater ne fonctionne que si la banque émettrice participe : certaines cartes expireront donc sans mise à jour.
  • Un updater peut désactiver un profil. Quand un updater ne trouve pas un compte, il peut supprimer l’enregistrement, ce qui laisse le profil de paiement de l’abonné désactivé. La page sur les moyens de paiement de Maxio indique qu’au moment de sa rédaction, cela n’était arrivé qu’à des marchands Authorize.Net utilisant l’updater.

Le second point compte pour le premier : si votre passerelle met la carte à jour en silence et que Maxio ne l’affiche pas, Maxio peut encore croire que la carte va expirer et écrire au client à ce sujet. Sachez dans quel cas vous êtes avant d’écrire l’email.

Étape 2 : les emails d’expiration de carte

Maxio peut envoyer des Card Expiration Emails aux clients dont la carte enregistrée va bientôt expirer (modèles d’email). Le modèle peut inclure le nombre de jours avant l’expiration et un lien de mise à jour, {{update_url}}, qui est l’URL en libre-service de l’abonnement : le client saisit lui-même la nouvelle carte et vous ne manipulez jamais de données de carte.

Quand ils sont envoyés : deux versions dans la doc de Maxio

Les pages de Maxio donnent deux calendriers :

  • La page actuelle des réglages d’email indique que les emails partent trois fois pendant le mois où la carte expire : le 1er, le 15 et une semaine avant la fin du mois (la troisième date bouge donc avec la longueur du mois).
  • Le glossaire et la page des modèles d’email mentionnent le 1er, le 15 et le 23, et le glossaire parle du mois précédant l’expiration de la carte.

La page des réglages d’email est la plus précise et semble la plus récente, mais vérifiez un vrai envoi sur votre site avant de construire quoi que ce soit qui dépend des dates exactes.

Rendre l’email utile

Le modèle par défaut est un point de départ. Un bon email de carte bientôt expirée :

  1. Dit de quelle carte il s’agit (marque et quatre derniers chiffres) et de quel abonnement.
  2. Donne la date du prochain prélèvement de renouvellement, s’il tombe après l’expiration.
  3. A un seul bouton vers le lien de mise à jour, qui marche sur téléphone, sans mot de passe à retenir.
  4. Vient de votre marque et d’une vraie adresse de réponse.

Étape 3 : le webhook expiring_card

Maxio envoie aussi un webhook expiring_card. D’après sa page des événements webhook, il est périodique : envoyé le 1er, le 15 et 7 jours avant la fin du mois, et il identifie toutes les cartes qui expirent dans le mois en cours. Le contenu porte l’objet subscription, avec le client, le produit et les détails de la carte.

Notez ce que cela implique : le webhook arrive dans le mois de l’expiration, pas des semaines avant. Pour une offre mensuelle facturée en début de mois, c’est très bien. Pour un client dont le renouvellement tombe le 2 et dont la carte expire à la fin de ce mois, c’est bien aussi. Mais pour une offre annuelle qui se renouvelle au printemps prochain, une alerte « expire ce mois-ci » aujourd’hui n’est pas le problème ; c’est la carte qui sera enregistrée au renouvellement qui compte. Utilisez le webhook comme déclencheur, et décidez de la suite avec votre propre logique :

  • Renouvellement avant l’expiration : rien à faire pour l’instant ; le prochain renouvellement réussira.
  • Renouvellement après l’expiration, offre mensuelle : demandez une nouvelle carte maintenant.
  • Offre annuelle : comparez vous-même, à l’avance, la date d’expiration de la carte à la date de renouvellement, plutôt que d’attendre le webhook.

Étape 4 : d’autres façons d’obtenir une nouvelle carte

Quand l’email ne suffit pas, Maxio propose des options manuelles et en masse (mettre à jour les informations de paiement d’un client) :

  • Depuis l’abonnement. Dans l’onglet Payment Details, « Email Customer to Request Payment Update » envoie au client un lien vers sa page en libre-service. Maxio le recommande plutôt que de saisir les nouvelles coordonnées de carte à la place du client.
  • En masse. Un email groupé prérédigé « Request Payment Method Update » envoie un lien de mise à jour sécurisé à un groupe d’abonnés.
  • Dans le Billing Portal. Les clients ajoutent une carte dans Payment, ou utilisent Update Payment Method sur un abonnement précis.
  • Maxio Core. Si vous utilisez Maxio Core plutôt qu’Advanced Billing, la doc décrit la copie d’un lien depuis la page du profil de facturation e-Bill du client pour l’envoyer.

Ajoutez aussi un message dans votre propre produit : une bannière pour le titulaire du compte quand sa carte expire ce mois-ci atteint les gens qui ignorent les emails.

Une checklist

  • Vous savez si l’account updater de votre passerelle est entièrement pris en charge dans Advanced Billing.
  • Les réglages d’updater côté passerelle sont activés là où il le faut.
  • Les Card Expiration Emails sont activés, à vos couleurs et avec un lien de mise à jour qui marche.
  • Vous avez vérifié sur un vrai envoi quel calendrier Maxio utilise sur votre site.
  • expiring_card est traité, avec une logique pour les offres mensuelles et annuelles.
  • Pour les offres annuelles, l’expiration est comparée à la date de renouvellement bien à l’avance.
  • Une bannière dans l’appli s’affiche quand la carte enregistrée va bientôt expirer.
  • Les relances sont configurées pour les cartes que vous n’avez pas pu rattraper à temps.

Le faire avec NoChurn

NoChurn lit les abonnements Maxio ainsi que le type et la date d’expiration de chaque profil de paiement, et s’en sert dans le churn score de 0 à 100 du client. Quand un renouvellement échoue malgré tout, NoChurn envoie des emails de récupération rédigés par l’IA et relus par vous, en plus de vos relances Maxio, avec un lien pour mettre à jour le profil de paiement. Les données de carte, le prélèvement et l’account updater restent chez Maxio et votre passerelle. NoChurn est gratuit sous 300 $ de MRR, avec toutes les fonctionnalités dans chaque offre (votre propre domaine d’email dès 9 $). Voir NoChurn + Maxio.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://www.nochurn.sh/docs/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Arrêtez de perdre du revenu.

  • Gratuit jusqu’à $300 de MRR
  • Sans carte bancaire
  • Prêt en 10 minutes
  • Jamais une commission sur ce que nous récupérons