Skip to main content
Solutions aux problèmes les plus courants liés aux mises à niveau d’abonnement. Si vous êtes toujours bloqué après avoir essayé ces solutions, contactez le support avec les informations indiquées dans Tester et vérifier.

​
Surveillance des échecs de mise à niveau

Aftersell surveille les échecs définitifs de mise à niveau sur une fenêtre glissante de 7 jours. Si le nombre d’échecs dépasse le seuil d’alerte, une bannière d’avertissement apparaît sur votre page d’accueil indiquant combien de mises à niveau ont échoué et sur combien de jours. La même alerte apparaît également dans le panneau Needs attention de la page d’accueil. L’alerte comprend un bouton Review orders qui vous amène directement au navigateur de commandes filtré sur les problèmes de mise à niveau d’abonnement, afin que vous puissiez voir les commandes concernées et la cause spécifique de chaque échec. Elle disparaît automatiquement dès que le nombre d’échecs repasse sous le seuil dans la fenêtre glissante. Si vous voyez cette alerte, ouvrez le navigateur de commandes et vérifiez la cause affichée sur chaque commande concernée, puis reportez-vous aux étapes de dépannage correspondantes ci-dessous.
Le modèle Subscription Upgrade n’est jamais masqué — il figure toujours sous Add Funnel, quelle que soit la configuration de votre fournisseur. Ce qui vous bloque, c’est la vérification de connexion de l’Étape 1 : Continue reste désactivé tant que Test API key ne renvoie pas API key verified avec une coche verte.Deux résultats différents affichent la même icône d’annulation rouge, lisez donc le message qui l’accompagne :
  • Votre fournisseur a rejeté la clé. Le jeton ne dispose pas des portées requises ou a été révoqué, et le message nomme le problème précis. Émettez un nouveau jeton dans le tableau de bord de votre fournisseur avec les portées listées dans Configuration et paramétrage, collez-le et testez à nouveau.
  • Aftersell n’a pas pu joindre votre fournisseur — « Could not verify the API key. Please try again. » Le jeton n’est pas nécessairement en cause ; c’est l’appel lui-même qui a échoué. Cliquez à nouveau sur Test API key.
Modifier le fournisseur ou le jeton efface le verdict précédent, testez donc à nouveau après tout changement.
Il s’agit d’un comportement attendu. Le produit est le produit d’offre, la ligne d’article fictive ajoutée à la commande Shopify comme trace de la mise à niveau acceptée. Pour réduire la confusion, renommez le produit d’offre avec un nom clair et ajoutez une description dans Shopify Admin expliquant ce qu’il représente. Consultez Ce que voit le client.
Le changeset Shopify et l’appel API du fournisseur sont indépendants. Si le produit d’offre a été ajouté à la commande mais que l’abonnement n’a pas été modifié, les causes les plus courantes sont :
  • Votre jeton API fournisseur est expiré ou ne dispose pas des autorisations requises. Pour Recharge, le jeton doit avoir read_orders, read_subscriptions, write_subscriptions et read_plans. Allez à Step 1: Connect provider, re-testez votre clé et vérifiez le message d’erreur pour connaître les portées manquantes.
  • Le produit éligible dans le funnel ne correspond pas à ce à quoi le client s’est réellement abonné.
  • Pour Loop, le plan de vente cible n’existe pas dans votre tableau de bord Loop pour la fréquence configurée.
  • Le workflow de nouvelles tentatives est peut-être encore en train de dérouler son calendrier : après un appel échoué, il réessaie à +1 heure, puis à +24 heures. C’est identique pour tous les fournisseurs — y compris Loop, dont les appels de mise à niveau sont synchrones et apparaissent immédiatement dans le tableau de bord lorsqu’ils réussissent.
Aftersell relance automatiquement les appels fournisseur échoués dans un workflow en arrière-plan. Le workflow vérifie l’état actuel du fournisseur avant de réexécuter, de sorte qu’une mise à niveau réussie mais lente n’est pas appliquée deux fois.Si une nouvelle exécution ne peut pas corriger la cause, le workflow soit rembourse le montant facturé — lorsqu’aucune mutation fournisseur n’a réussi et que la ligne facturée était un produit fictif — soit signale la mise à niveau pour une réconciliation manuelle, en laissant la commande intacte. Les abonnements entièrement nouveaux et les mises à niveau de box ne sont jamais remboursés automatiquement, car l’acheteur reçoit de vrais produits. Contactez le support avec les informations indiquées dans Tester et vérifier.
L’option « Use an existing selling plan » récupère les plans directement depuis Recharge, Skio ou Loop. Si la liste déroulante est vide :
  • Confirmez que des plans de vente sont configurés dans le tableau de bord de votre fournisseur.
  • Assurez-vous que votre jeton API dispose d’un accès en lecture aux Plans (Recharge : portée read_plans) ou des portées appropriées (Skio, Loop).
  • Revenez à Step 1: Connect provider, re-testez votre clé API et continuez.
C’est attendu. Sur Loop, le champ Billing frequency n’est pas affiché du tout — uniquement Delivery frequency, avec la note « Loop syncs billing to delivery — customers are charged on each renewal ». Ce que vous définissez comme fréquence de livraison est aussi la fréquence de facturation.C’est aussi pourquoi les abonnements prépayés — une fréquence de facturation plus longue que la fréquence de livraison — ne sont pas pris en charge sur Loop : l’intégration les rejette d’emblée plutôt que de proposer un champ que vous ne pouvez pas utiliser. Les autres fournisseurs affichent les deux champs.
Le produit d’offre est réservé aux abonnements — soit le produit lui-même, soit chacune de ses variantes — et le checkout du client contenait déjà un abonnement. Shopify n’autorise pas un deuxième abonnement sur la même commande, l’offre a donc été ignorée.Le panneau de détails de la commande précise le cas rencontré : « The customer’s checkout already has a subscription, and the offer product is subscription-only », ou « All variants of the offer product are subscriptions, and the customer’s checkout already has one. » Les deux se corrigent de la même façon — modifiez la sélection de produit de l’offre et remplacez-le par un produit en achat unique, ou utilisez l’option Create new dans Step 4: Offer product pour générer un produit fictif.
  • Vérifiez que Show this funnel for all customers n’est pas activé. Cette option prévaut sur tous les autres déclencheurs.
  • Vérifiez le déclencheur Variant on subscription. Il n’affiche le funnel que lorsque la commande inclut l’un des produits sélectionnés acheté en abonnement. Sur un funnel comportant une offre de mise à niveau d’abonnement, l’assistant est propriétaire de ce déclencheur et le maintient synchronisé avec le produit mis à niveau ; il est donc en lecture seule — le panneau indique « Managed by this funnel’s subscription upgrade offer. » S’il cible les mauvais produits, corrigez le produit déclencheur de l’offre de mise à niveau plutôt que le déclencheur lui-même.
  • Vérifiez la priorité des funnels. Un funnel de priorité plus élevée avec des déclencheurs plus larges peut se déclencher en premier.
N’essayez pas de reproduire cela avec un déclencheur de produit séparé plus un déclencheur d’abonnement. Cette paire est exactement ce que Variant on subscription a remplacé : les deux conditions correspondaient indépendamment, si bien qu’une commande contenant votre produit déclencheur en achat unique et un article d’abonnement sans rapport satisfaisait les deux, déclenchait le funnel, puis la mise à niveau échouait en aval. Un seul déclencheur, vérifiant ensemble le produit et l’état d’abonnement, est la configuration prise en charge.