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

​
Fonctionnalités prises en charge

Recharge 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 prépayées et postpayées

​
Générer votre token API Recharge

  1. Connectez-vous à votre portail marchand Recharge.
  2. Accédez à Tools & Apps → API Tokens.
  3. Cliquez sur Create an API Token.
  4. Saisissez un nom et un e-mail de contact.
  5. Définissez les autorisations dont Aftersell a besoin : Read and Write sur Subscriptions, et Read sur Orders et Plans. Aucun scope Products n’est requis.
  6. Cliquez sur Save et copiez la clé API.
Le token doit détenir les quatre scopes : read_orders, read_subscriptions, write_subscriptions et read_plans. Aftersell vérifie les quatre lors du test de la clé et indique les scopes manquants dans le message d’erreur. Pour plus de détails, consultez la documentation de l’API de Recharge.

​
Connecter Recharge dans l’assistant de configuration

Lorsque vous atteignez l’Étape 1 : Connect provider dans l’assistant Subscription Upgrade :
  1. Sélectionnez Recharge 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 Recharge 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 échoué plutôt qu’à un token invalide — 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.

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

Après avoir passé une commande de test et accepté l’offre de montée en gamme : Allez dans Customers dans votre tableau de bord Recharge, trouvez le client et ouvrez Subscriptions. L’abonnement actif devrait refléter immédiatement la nouvelle fréquence, le nouveau produit ou la nouvelle remise. Recharge se met à jour quasiment en temps réel après l’acceptation.

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

La montée en gamme a été acceptée mais l’abonnement n’a pas été modifié Les causes les plus courantes :
  • Votre token API est expiré ou ne dispose pas des autorisations requises. Le token doit avoir read_orders, read_subscriptions, write_subscriptions et read_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 Recharge. Si le menu déroulant est vide :
  • Confirmez que des plans de vente sont configurés dans votre tableau de bord Recharge.
  • Assurez-vous que votre token API dispose du scope read_plans.
  • Retournez à l’Étape 1 : Connect provider, retestez votre clé API et continuez.
← Retour à l’aperçu des montées en gamme d’abonnement · Configuration et paramétrage · Que sont les intégrations ?