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 subscription product
  • 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.
  • Les abonnements multi-lignes sont traités en deux étapes : la ligne du produit cible est scindée dans un nouvel abonnement avec la fréquence souhaitée, puis retirée de l’original. Cela implique plusieurs appels d’API et peut faire apparaître des lignes temporaires en cours de traitement dans votre tableau de bord Loop pendant la fenêtre de synchronisation.
  • La fréquence personnalisée n’est pas prise en charge pour les abonnements multi-lignes. Lorsque vous définissez la fréquence manuellement (sans sélectionner de plan de vente), la montée en gamme fonctionne pour les clients dont l’abonnement contient une seule ligne de produit. Les clients avec un abonnement multi-produits ou groupé (deux lignes actives ou plus) verront la montée en gamme échouer si aucun plan de vente correspondant n’existe pour la fréquence cible. Pour prendre en charge ces clients, créez le plan de vente correspondant dans votre tableau de bord Loop.

​
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 suivantes sur Read and Write : Subscription contracts, Orders, Selling plans.
  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 trois états suivants :
  • Coche verte (valide) — le token s’est authentifié, tous les scopes requis sont présents et le token appartient à votre boutique.
  • X rouge (invalide) — 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.
  • Avertissement (vérification impossible) — Aftersell n’a pas pu joindre Loop pour effectuer la vérification. Testez la clé à nouveau. Vous ne pouvez pas enregistrer tant que la vérification n’est pas passée ou levée.

​
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.

​
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. Attendez jusqu’à 24 heures. Les API de Loop se synchronisent de manière asynchrone et le changement peut ne pas apparaître immédiatement, même en cas de montée en gamme réussie. Ne présumez pas d’un échec avant la fin de la fenêtre complète de synchronisation de 24 heures.

​
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é Avant de présumer d’un échec, attendez la fenêtre complète de synchronisation de 24 heures. Si l’abonnement est toujours inchangé après 24 heures, 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. Le token doit avoir un accès Read and Write aux Subscription contracts, 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 and Write 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 pour les abonnements multi-lignes. Loop les 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.
← Retour à l’aperçu des montées en gamme d’abonnement · Configuration et paramétrage · Que sont les intégrations ?