Skip to main content
Cette page couvre tout ce qui est spécifique à l’utilisation de Loop avec les Subscription Upgrades, y compris ses limitations propres. Pour un aperçu complet du fonctionnement des Subscription Upgrades, consultez Subscription Upgrades.

​
Fonctionnalités prises en charge

Loop prend en charge tous les types de Subscription Upgrade :
  • Change delivery or billing frequency
  • Replace with a different product
  • Both – change frequency and replace product
  • Add another subscribable item to subscription (voir Ajouter un article)
  • Fréquences postpayées uniquement (le prépayé n’est pas pris en charge — voir les Limitations ci-dessous)

​
Limitations spécifiques à Loop

  • La fréquence de facturation doit être égale à la fréquence de livraison. Loop ne prend pas en charge les abonnements prépayés via cette intégration. Le champ de fréquence de facturation est désactivé et automatiquement synchronisé avec la fréquence de livraison. C’est la contrainte la plus importante à connaître si votre boutique repose sur des plans prépayés.

​
Générer votre token API Loop

  1. Ouvrez l’application Loop et accédez à Settings en bas à gauche.
  2. Sous Admin, cliquez sur API Tokens.
  3. Définissez les autorisations dont Aftersell a besoin : Read and Write sur Subscription contracts, et Read sur Orders et Selling plans. L’accès en écriture n’est requis que pour les abonnements.
  4. Cliquez sur Generate New Token.
  5. Fournissez un nom, sélectionnez les scopes appropriés et cliquez sur Generate Token.
  6. Cliquez sur Show Token pour afficher et copier votre clé. Traitez-la comme un mot de passe et conservez-la en lieu sûr.
Pour plus de détails, consultez la documentation de l’API de Loop.

​
Connecter Loop dans l’assistant de configuration

Lorsque vous atteignez l’Étape 1 : Connect provider dans l’assistant Subscription Upgrade :
  1. Sélectionnez Loop dans le menu déroulant Subscription provider.
  2. Collez votre token API dans le champ API token.
  3. Cliquez sur Test API key. Aftersell valide le token, en vérifiant qu’il s’authentifie correctement, qu’il détient tous les scopes requis et qu’il appartient à votre boutique.
  4. Une fois le test réussi (coche verte), cliquez sur Continue pour passer à l’Étape 2.
Le résultat du test affiche l’un des deux états suivants :
  • Coche verte — « API key verified ». Le token s’est authentifié, tous les scopes requis sont présents et le token appartient à votre boutique. Continue est désormais activé.
  • Icône d’annulation rouge. La vérification n’est pas revenue propre. Lisez le message à côté de l’icône : soit le token a été rejeté ou il lui manque des scopes requis — le message indique les scopes manquants ; corrigez le token dans Loop et testez à nouveau. Soit Aftersell n’a pas pu effectuer la vérification (« Could not verify the API key. Please try again. »), ce qui correspond à un appel en échec plutôt qu’à un mauvais token — dans ce cas, testez simplement à nouveau.
Un résultat de vérification impossible ressemble exactement à un rejet, fiez-vous donc au message plutôt qu’à l’icône. Continue reste désactivé tant que la vérification ne revient pas au vert, et modifier le fournisseur ou le token efface le résultat précédent.

​
Conserver les abonnements multi-produits intacts

Par défaut, lorsqu’une montée en gamme de fréquence ou de fréquence-et-produit s’applique à un client dont l’abonnement Loop comporte au moins deux lignes actives, Aftersell scinde le produit amélioré dans un nouvel abonnement. Cela permet de conserver les autres articles sur leur cadence de facturation d’origine. Si les autres produits de l’abonnement sont des compléments du produit amélioré (plutôt que des abonnements autonomes), vous pouvez activer Don’t split multi-product subscriptions sur l’offre. Lorsque cette option est activée, Aftersell réajuste tout le contrat à la nouvelle fréquence au lieu de le scinder. À quoi s’attendre lorsque ce paramètre est activé :
  • Les autres produits de l’abonnement passent également à la nouvelle fréquence.
  • Ces produits conservent la remise du plan de vente de leur fréquence d’origine, mais à la nouvelle cadence.
  • Aftersell ne garantit pas un tarif correct pour les articles compagnons — si un produit compagnon est sur un plan à prix fixe sans plan correspondant à la nouvelle fréquence, il conserve son prix absolu d’origine à la nouvelle cadence.
N’activez cette option que lorsque les autres produits sont des compléments du produit amélioré. S’ils constituent des abonnements indépendants, utilisez le comportement de scission par défaut afin que chaque produit reste sur son propre calendrier de facturation.
Ce paramètre est disponible pour les types de montée en gamme frequency et frequency + product sur Loop uniquement. Il apparaît sous forme de case à cocher dans le panneau des paramètres de l’offre.

​
Avant de configurer la montée en gamme (Étape 3)

Lors de la configuration d’un changement de fréquence, vous pouvez soit choisir un plan de vente existant, soit définir la fréquence manuellement :
  • Utiliser un plan de vente existant. Choisissez dans le menu déroulant des plans de vente. Le plan doit déjà exister et être actif dans votre tableau de bord Loop.
  • Définir la fréquence manuellement. Saisissez vous-même la fréquence de livraison. Loop accepte n’importe quelle cadence sans exiger de plan de vente correspondant. Vous pouvez également appliquer une remise récurrente en utilisant une fréquence manuelle.
Si vous définissez la fréquence manuellement et que l’abonnement du client comporte deux lignes de produits actives ou plus (un contrat multi-produits ou groupé), la montée en gamme échouera à moins qu’un plan de vente correspondant n’existe pour la fréquence cible. Consultez les Limitations pour plus de détails.

​
Sélectionner un palier de remise récurrente

Certains plans de vente Loop appliquent des remises différentes à différents moments de l’abonnement — par exemple, $20 de remise sur la première facturation et $10 de remise à partir de la deuxième. Lorsque vous sélectionnez un plan de ce type, le champ Recurring discount est remplacé par une liste de boutons radio présentant chacun des paliers de remise du plan avec sa plage de facturation (par exemple, « Charge 1 » ou « Charge 2 onward »). Sélectionnez le palier que vous souhaitez appliquer à chaque renouvellement futur de l’abonnement amélioré. Le palier sélectionné est enregistré avec l’offre et appliqué lorsqu’un client accepte la montée en gamme. Si le plan sélectionné n’a aucun palier de remise, ou si vous définissez la fréquence manuellement, c’est le champ de remise à saisie libre standard qui s’affiche.

​
Vérifier une montée en gamme dans Loop

Après avoir passé une commande de test et accepté l’offre de montée en gamme : Allez dans Subscriptions dans votre tableau de bord Loop et trouvez l’abonnement du client. Les appels de montée en gamme de Loop sont synchrones, il n’y a donc aucun délai de traitement côté Aftersell — le changement est appliqué chez Loop dès que l’appel aboutit. La liste des abonnements de Loop elle-même peut mettre un peu plus de temps à se mettre à jour ; si le changement n’y figure pas encore, attendez quelques minutes et actualisez avant de conclure à un échec. Si le changement n’y est pas, c’est qu’il n’a pas abouti — voir ci-dessous.

​
Dépannage des problèmes spécifiques à Loop

Je ne peux pas modifier la fréquence de facturation C’est un comportement attendu. Loop ne prend pas en charge les abonnements prépayés via cette intégration. Le champ de fréquence de facturation est désactivé et automatiquement synchronisé avec la fréquence de livraison. La montée en gamme a été acceptée mais l’abonnement n’a pas été modifié Si l’abonnement est inchangé, les causes les plus courantes sont :
  • Vous avez défini la fréquence manuellement et l’abonnement du client comporte deux lignes de produits actives ou plus. Dans ce cas, Loop exige un plan de vente correspondant pour la fréquence cible. Créez le plan de vente dans Loop, ou passez à Use an existing selling plan dans la configuration de l’offre.
  • Vous avez utilisé Use an existing selling plan et le plan de vente sélectionné n’existe plus dans votre tableau de bord Loop. Créez le plan de vente dans Loop et réessayez.
  • Votre token API est expiré ou ne dispose pas des autorisations requises : write sur Subscription contracts, read sur Orders et Selling plans. Allez à l’Étape 1 : Connect provider, retestez votre clé et vérifiez le message d’erreur pour connaître les scopes manquants.
  • Le produit éligible dans le funnel ne correspond pas à ce à quoi le client s’est réellement abonné.
Aftersell réessaie automatiquement les appels échoués au fournisseur dans un workflow en arrière-plan. Si toutes les tentatives échouent, contactez le support avec l’URL de votre boutique, l’ID de commande Shopify, l’e-mail du client, l’heure approximative d’acceptation de la montée en gamme et le fournisseur que vous utilisez. Le menu déroulant des plans de vente est vide L’option « Use an existing selling plan » récupère les plans directement depuis Loop. Si le menu déroulant est vide :
  • Confirmez que des plans de vente sont configurés dans votre tableau de bord Loop.
  • Assurez-vous que votre token API dispose d’un accès Read aux Selling plans.
  • Retournez à l’Étape 1 : Connect provider, retestez votre clé API et continuez.
Des lignes temporaires en cours de traitement apparaissent dans mon tableau de bord Loop C’est un comportement attendu lorsqu’une montée en gamme d’abonnement multi-lignes utilise le comportement de scission par défaut. Loop la traite en deux étapes (scission, puis suppression), ce qui peut faire apparaître des lignes temporaires pendant la fenêtre de synchronisation de 24 heures. Elles disparaissent automatiquement une fois la synchronisation terminée. Si vous souhaitez éviter la scission entièrement, consultez Conserver les abonnements multi-produits intacts.
← Retour à l’aperçu des montées en gamme d’abonnement · Configuration et paramétrage · Que sont les intégrations ?