> ## Documentation Index > Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt > Use this file to discover all available pages before exploring further. # Référence de configuration des montées en gamme d'abonnement Cette page rassemble les règles détaillées derrière l'assistant de configuration des Subscription Upgrades : comment les prix sont calculés, comment se comportent les options de timing et de remise, le déclencheur d'éligibilité, et pourquoi le produit de l'offre est un produit de substitution. Pour le guide pas à pas, consultez [Configurer les montées en gamme d'abonnement](/fr/aftersell/subscription-upgrades-setup).
## États de vérification de la clé API
À l'Étape 1, **Test API key** valide votre token auprès de votre fournisseur, en vérifiant qu'il s'authentifie correctement, qu'il détient tous les scopes requis et qu'il appartient à votre boutique. Le résultat 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 activé. * **Icône d'annulation rouge.** La vérification n'a pas abouti correctement. Le message à côté de l'icône indique laquelle des deux situations s'est produite : votre fournisseur a **rejeté** le token (révoqué, ou scopes requis manquants, et le message nomme le problème précis), ou Aftersell **n'a pas pu terminer la vérification** (« Could not verify the API key. Please try again. »), ce qui correspond à un appel échoué plutôt qu'à un mauvais token. Corrigez le token s'il a été rejeté ; sinon, testez simplement à nouveau. Il n'existe pas de troisième état plus nuancé, et un résultat « impossible de vérifier » ressemble exactement à un rejet ; lisez donc le message plutôt que l'icône. **Continue** reste désactivé tant que la vérification n'est pas verte. Modifier le fournisseur ou le token efface le résultat précédent, retestez donc après chaque modification. Ce contrôle existe pour éviter des échecs de montée en gamme d'abonnement qui, sinon, n'apparaîtraient qu'après que le client a été débité.
## Le déclencheur d'éligibilité : Variant on subscription
L'assistant configure automatiquement un déclencheur unique pour vous ; vous n'avez pas besoin de le configurer manuellement : | Déclencheur | Paramètre | | - | - | | **Variant on subscription** | Défini sur votre variante éligible (cible). Se déclenche uniquement lorsque cette variante figure dans la commande **sur une ligne d'abonnement**. | Tous les déclencheurs activés utilisent une logique ET : chaque condition doit être remplie pour que le funnel s'affiche. Vous pouvez ajouter d'autres déclencheurs facultatifs dans l'étape **Triggers** de l'éditeur de funnel (regroupés dans une section repliable **Additional triggers** qui affiche un compteur et s'ouvre automatiquement lorsque des déclencheurs facultatifs sont définis). **Ne remplacez pas ce déclencheur par un déclencheur de produit plus un déclencheur d'abonnement.** Cette ancienne combinaison correspond à deux conditions indépendantes : une commande contenant votre produit déclencheur en achat *ponctuel* aux côtés d'un article d'abonnement *sans rapport* satisfait les deux ; le funnel se déclenche, puis la montée en gamme échoue en aval car il n'y a aucun abonnement correspondant à modifier. **Variant on subscription** est une condition unique qui ne peut pas se dissocier ainsi, et l'assistant migre automatiquement les anciens funnels hors de cette combinaison. Sans déclencheur spécifique au produit, un funnel peut s'afficher pour des clients dont la commande ne contient pas le produit d'abonnement éligible. Cela gaspille des impressions et produit une modification d'abonnement qui échoue silencieusement : le produit de l'offre est ajouté à la commande, mais aucun abonnement n'est modifié dans Recharge, Skio ou Loop. Si **Show this funnel for all customers** est activé, il prend le pas sur tous les autres déclencheurs et le funnel se déclenche pour chaque checkout. Ce n'est pas recommandé pour les funnels de montée en gamme d'abonnement.
## Quel prix le Recurring subtotal affiche
Le **Recurring subtotal** de l'offre indique au client le coût de son prochain renouvellement. Le produit dont ce prix est tiré dépend du type de montée en gamme : | Type de montée en gamme | Le prix provient de | | - | - | | Change delivery or billing frequency | Le produit **déclencheur** | | Replace with a different subscription product | Le produit de **remplacement** | | Both, change frequency and replace subscription product | Le produit de **remplacement** | | Add another subscribable item to subscription | L'article **ajouté** | C'est la source de confusion la plus fréquente. Une montée en gamme portant uniquement sur la fréquence conserve le même produit par conception ; son recurring subtotal ne peut donc afficher que le prix du produit déclencheur, quelle que soit la fréquence définie. Si vous vous attendiez à y voir le prix d'un autre produit, vous souhaitez très probablement utiliser plutôt **Both, change frequency and replace subscription product**. La quantité utilisée provient de **Override subscription quantity**, qui n'apparaît que sur les types de remplacement. Pour une montée en gamme portant uniquement sur la fréquence, elle est toujours de 1.
## Moment de la montée en gamme
Par défaut, une montée en gamme prend effet à partir du **prochain cycle de facturation** du client, en conservant sa date de renouvellement existante. Si l'option de timing est activée pour votre boutique, une case à cocher apparaît sous les champs de fréquence : > **My fulfillment provider ships the upgraded item on the current order** En la cochant, le nouvel intervalle de facturation démarre immédiatement plutôt qu'au prochain renouvellement, et cela débloque le champ **One-time upgrade price** à l'Étape 4. Aftersell ne modifie pas la commande que le client vient de passer. Ce paramètre déplace uniquement l'intervalle de facturation. Ne le cochez que si votre prestataire de fulfillment est configuré pour reconnaître le produit de substitution de la montée en gamme et expédier l'article amélioré avec la commande en cours. Cette case est décochée par défaut et n'est pas disponible sur toutes les boutiques. Elle n'apparaît que sur les types de montée en gamme **Change delivery or billing frequency** et **Both, change frequency and replace subscription product**, et uniquement une fois l'option activée pour votre boutique. Contactez le support via le chat intégré à l'application si vous en avez besoin.
## Remise récurrente
Une incitation facultative appliquée à **chaque renouvellement futur** de l'abonnement amélioré (pas seulement au premier cycle). Non disponible pour le type d'ajout d'article. L'affichage du champ dépend de la présence de politiques de tarification par paliers sur le selling plan sélectionné : * **Lorsqu'un selling plan avec des paliers de remise est sélectionné** (par exemple, un plan Loop qui applique \$20 de réduction sur le premier prélèvement et \$10 de réduction à partir du deuxième), le champ de saisie libre est remplacé par une liste de boutons radio, un par palier. Chaque option affiche le montant de la remise et la plage de prélèvements à laquelle elle s'applique (par exemple, « Charge 1 » ou « Charge 2 onward »). Sélectionnez le palier à appliquer à chaque renouvellement futur. * **Lorsqu'aucun selling plan n'est sélectionné, ou que le plan sélectionné n'a pas de paliers de remise**, le champ de saisie libre standard apparaît. Saisissez le montant et choisissez **Percentage** ou **Fixed amount**.
## Prix de montée en gamme ponctuel, par type de montée en gamme
Le **One-time upgrade price** est ce que le client paie sur cette commande Shopify lorsqu'il accepte. * Sur les types **Change delivery or billing frequency** et **Both**, il est verrouillé à `0` par défaut, car votre fournisseur d'abonnement facture à la fin du cycle de facturation en cours et le produit de substitution apparaît sur la commande Shopify à \$0.00. Il ne devient modifiable que lorsque la [case de timing de montée en gamme](#upgrade-timing) de l'Étape 3 est cochée. * Sur **Replace with a different subscription product** et **Add another subscribable item to subscription**, la case de timing ne s'applique pas, le champ de prix est donc toujours modifiable. Ce qu'il faut y saisir dépend du type de montée en gamme : * **Fréquence, remplacement, ou les deux :** la *différence* de prix entre l'abonnement d'origine et l'abonnement amélioré. Le client conserve son abonnement et ce prélèvement couvre l'écart. * **Ajout d'un autre article abonnable :** le prix de l'article ajouté sur cette commande. Rien n'est échangé, il n'y a donc pas de différence à calculer : c'est simplement ce que le client paie maintenant pour le nouvel article, qui se renouvelle ensuite avec son abonnement. Consultez [Ajouter un article à un abonnement existant](/fr/aftersell/subscription-upgrades-add-item). **First-order discount.** Une remise facultative appliquée uniquement à cet achat de montée en gamme, saisie en pourcentage (`%`) ou en montant fixe. Elle se trouve à côté de **One-time upgrade price** et apparaît chaque fois que ce champ est modifiable, sur les onglets **Create new** comme **Pick existing**. Sur le type d'ajout d'article, le champ apparaît toujours mais est systématiquement enregistré à `0` ; les offres d'ajout d'article ne comportent jamais de remise, définissez donc plutôt le prix souhaité sur le produit de l'offre.
## Pourquoi le produit de l'offre est un produit de substitution
Le produit de l'offre est **uniquement un produit de substitution visuel**, et non un véritable produit acheté par le client. Shopify ne permet pas d'afficher un produit d'abonnement comme upsell post-achat après une commande contenant déjà un abonnement ; Aftersell capture donc le prix entre les montées en gamme à l'aide d'un SKU de substitution sans abonnement. * L'image, le titre et le prix que vous définissez apparaissent dans la carte de l'offre. * Lors de l'acceptation, le prix affiché est facturé sur la commande Shopify, et Recharge, Skio ou Loop applique la véritable montée en gamme à l'abonnement lors de son prochain cycle. * Si vous choisissez **Pick existing** au lieu d'en créer un, le produit doit prendre en charge l'achat ponctuel ; les produits disponibles uniquement en abonnement sont filtrés du sélecteur.