> ## 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. # Montées en gamme d'abonnement avec Stay AI > Guide pas à pas pour connecter Stay AI et configurer les Subscription Upgrades dans Aftersell, y compris les limitations spécifiques à Stay AI concernant les plans prépayés, les annulations et la devise. Cette page couvre tout ce qui est spécifique à l'utilisation de **Stay AI** avec les Subscription Upgrades, y compris ses limitations propres. Pour un aperçu complet du fonctionnement des Subscription Upgrades, consultez [Subscription Upgrades](/fr/aftersell/subscription-upgrades).
## Fonctionnalités prises en charge
Stay AI prend en charge tous les types de Subscription Upgrade : * Changer la fréquence de livraison ou de facturation (appliqué à l'ensemble de l'abonnement) * Remplacer par un autre produit * Les deux - changer la fréquence et remplacer le produit * Ajouter un autre article pouvant faire l'objet d'un abonnement (voir [Ajouter un article](/fr/aftersell/subscription-upgrades-add-item)). Si le client est déjà abonné à ce produit, Stay augmente sa quantité au lieu d'ajouter une nouvelle ligne (cela est soumis à une condition de correspondance de prix - voir les limitations ci-dessous). * Fréquences postpayées (paiement à chaque livraison), y compris le passage d'un abonnement postpayé à un plan à paiement à l'avance (sous les conditions ci-dessous) Les remplacements de produit sont pris en charge **sauf vers un produit vendu uniquement avec des plans à paiement à l'avance** - voir la limitation relative au prépayé ci-dessous.
### Passer un abonnement à un plan à paiement à l'avance
Le passage d'un abonnement postpayé à un plan à paiement à l'avance (prépayé) est pris en charge, sous deux conditions : * **Le plan à paiement à l'avance doit déjà exister dans Stay AI et être attribué au produit.** Aftersell ne peut pas en créer ; l'offre vous permet uniquement de choisir parmi les plans déjà configurés dans Stay AI. * **Le changement crée un nouvel abonnement et annule l'ancien.** Stay effectue ce changement en créant un nouvel abonnement sur le plan à paiement à l'avance et en annulant l'original, de sorte que l'abonnement reçoit une **nouvelle référence**. Les outils d'entrepôt, de 3PL ou de reporting qui suivent les abonnements par référence doivent être resynchronisés. Consultez [Fulfillment et mappage 3PL](/fr/aftersell/subscription-upgrades-fulfillment).
## Limitations spécifiques à Stay AI
* **Les abonnements prépayés (paiement à l'avance) ne peuvent pas être modifiés.** Stay n'autorise aucune modification d'un abonnement que le client a payé à l'avance, quel que soit le type de montée en gamme. Si un client sur un plan prépayé accepte une offre de montée en gamme, celle-ci est annulée et il est remboursé, de sorte que l'abonnement reste intact. Pour la même raison, vous ne pouvez pas faire passer un abonnement à un produit vendu uniquement avec des plans à paiement à l'avance. * **Les annulations sont limitées à une seule application par compte.** Stay envoie les mises à jour d'annulation à **une seule application par compte**. Si une autre application ou intégration s'est inscrite au webhook d'annulation de Stay avant Aftersell, Aftersell ne peut pas recevoir ces mises à jour, et le [graphique Subscriptions cancelled](/fr/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart) ne reflétera pas les annulations Stay. La clé API que vous connectez doit inclure l'autorisation **Webhooks** (voir ci-dessous) pour que le suivi des annulations fonctionne. * **Un changement de fréquence s'applique à l'ensemble de l'abonnement.** Stay n'a qu'un seul calendrier par abonnement : changer la fréquence de livraison déplace donc tous les produits qu'il contient. Lorsque l'abonnement contient au moins deux produits, vous devez activer **Keep on existing subscription** sur l'offre ; sinon, la montée en gamme de fréquence est refusée et l'acheteur est remboursé. Cela n'est nécessaire que pour les changements de fréquence - les remplacements de produit et les ajouts d'articles ne sont pas concernés et fonctionnent sans cette option. * **Ajouter davantage d'un produit auquel le client est déjà abonné nécessite un prix correspondant.** Lorsque l'article ajouté est un produit que le client possède déjà, Stay augmente sa quantité au lieu d'ajouter une ligne - mais uniquement si le prix de l'offre correspond à ce que le client paie déjà pour ce produit. Si les prix diffèrent (par exemple, l'ajout offre 20 % de remise alors que son plan est à 10 %), la montée en gamme est refusée et l'abonnement reste inchangé. Appliquez à l'ajout la même remise que celle du plan du client, ou proposez un autre produit (un autre produit n'est pas concerné). * **La devise doit correspondre à la tarification de votre boutique.** Si l'abonnement du client est facturé dans une devise dans laquelle votre boutique ne fixe pas de prix, la montée en gamme est refusée. * **Les abonnements en double issus d'une même commande ne peuvent pas être distingués.** Si une seule commande a créé deux abonnements Stay contenant tous deux le produit de l'offre, Aftersell ne peut pas déterminer lequel le client visait, et la montée en gamme est refusée plutôt qu'appliquée au mauvais contrat. * **Les limites de requêtes plafonnent le débit.** Stay autorise 60 requêtes par minute et par compte. Une montée en gamme nécessite de quatre à six requêtes, de sorte qu'une boutique plafonne à environ 10 à 15 montées en gamme par minute en période de pointe.
## Générer votre clé API Stay AI
1. Dans votre tableau de bord Stay AI, allez dans **Account → API tokens → Add API key**. 2. Lors de la création de la clé, sélectionnez **All permissions**. Aftersell a besoin d'accéder à **Subscriptions**, **Orders**, **Selling Plan Groups** et **Webhooks**. C'est l'autorisation Webhooks qui permet à Aftersell d'être informé des annulations. 3. Copiez la clé et conservez-la en lieu sûr. Traitez-la comme un mot de passe. Pour plus de détails, consultez [la documentation d'authentification de l'API Stay AI](https://docs.stay.ai/reference/authentication).
## Connecter Stay AI dans l'assistant de configuration
Lorsque vous atteignez l'**Étape 1 : Connect provider** dans l'assistant Subscription Upgrade : 1. Sélectionnez **Stay AI** dans le menu déroulant **Subscription provider**. 2. Collez votre clé API dans le champ **API key**. 3. Cliquez sur **Test API key**. Aftersell valide la clé, en vérifiant qu'elle s'authentifie correctement et qu'elle 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 ».** La clé s'est authentifiée et appartient à votre boutique. **Continue** est désormais activé. S'il manque à la clé l'autorisation **Webhooks**, le test réussit quand même mais avertit que les annulations d'abonnement ne seront pas enregistrées - recréez la clé dans Stay AI avec **All permissions** si vous souhaitez suivre les annulations. * **Icône d'annulation rouge.** La vérification n'est pas revenue propre. Lisez le message à côté de l'icône : soit la clé a été rejetée, 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'à une mauvaise clé - 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 la clé efface le résultat précédent.
## Vérifier une montée en gamme dans Stay AI
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 Stay AI et trouvez l'abonnement du client. La fréquence de facturation, le produit ou la date de prochaine facturation doit refléter le changement. Le changement lui-même est appliqué dès qu'Aftersell traite l'acceptation, mais Stay peut être lent à intégrer une toute nouvelle commande : la montée en gamme apparaît généralement en quelques minutes, et jusqu'à 24 heures dans les cas les plus lents. Si le changement n'y figure pas encore, patientez un peu avant de conclure à un échec.
## Si une montée en gamme ne peut pas être appliquée
Les montées en gamme Stay AI sont sûres par conception - un acheteur n'est jamais facturé pour une montée en gamme qui n'a pas eu lieu : * **Les montées en gamme échouées sont réessayées automatiquement.** Si un appel à Stay AI échoue, Aftersell le réessaie dans un workflow en arrière-plan. * **Si elle ne peut toujours pas être appliquée, l'acheteur est remboursé.** Une Subscription Upgrade ne facture qu'une petite ligne fictive sur la commande Shopify (pas un produit que l'acheteur conserve), Aftersell rembourse donc ce montant lorsque la montée en gamme ne peut pas être finalisée. * **Tout ce qui ne peut pas être confirmé est signalé pour un examen manuel** plutôt que deviné, de sorte qu'un acheteur n'est jamais facturé pour une montée en gamme qui n'a pas eu lieu. Pour le fonctionnement complet des nouvelles tentatives et du rapprochement (commun à tous les fournisseurs), consultez [Fonctionnement des Subscription Upgrades](/fr/aftersell/subscription-upgrades#how-subscription-upgrades-work).
## Dépannage des problèmes spécifiques à Stay AI
**La montée en gamme a été acceptée mais l'abonnement n'a pas été modifié** Les causes les plus courantes : * Le client est sur un plan **prépayé (paiement à l'avance)**. Stay n'autorise pas la modification des contrats prépayés, la montée en gamme est donc annulée et remboursée. C'est un comportement attendu. * L'abonnement est facturé dans une **devise dans laquelle votre boutique ne fixe pas de prix**, la montée en gamme a donc été refusée. * L'abonnement contient **au moins deux produits** et vous avez changé la fréquence sans activer **Keep on existing subscription**. * Une commande a créé **deux abonnements Stay** contenant tous deux le produit de l'offre, Aftersell n'a donc pas pu déterminer lequel améliorer. * Votre clé API provient d'une autre boutique, ou il lui manque une autorisation requise (**Subscriptions**, **Orders** ou **Selling Plan Groups**). Recréez ou resélectionnez la clé dans Stay AI, allez à l'**Étape 1 : Connect provider** et retestez-la. * 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. **Les annulations Stay n'apparaissent pas dans les analyses** Stay envoie les mises à jour d'annulation à une seule application par compte. Si une autre application s'est inscrite au webhook d'annulation de Stay avant Aftersell, Aftersell ne peut pas les recevoir. Vérifiez qu'aucune autre intégration ne détient le webhook d'annulation de Stay, et assurez-vous que la clé API connectée inclut l'autorisation **Webhooks**. *** ← Retour à l'[aperçu des montées en gamme d'abonnement](/fr/aftersell/subscription-upgrades) · [Configuration et paramétrage](/fr/aftersell/subscription-upgrades-setup) · [Que sont les intégrations ?](/fr/aftersell/subscription-upgrades-integrations)