Quitter Mantle Billing : comment passer à Shopify App Pricing
Mantle a fixé au 30 septembre 2026 la fin de Mantle Billing, sa facturation. D'après Mantle, tes abonnements sont chez Shopify, et Mantle ne faisait que les créer et les gérer : ils ne disparaissent donc pas avec lui. Ce qui doit changer, c'est ton application, qui comptait sur Mantle pour ce travail. Depuis le 29 septembre 2026, Shopify permet de faire passer les abonnements existants à Shopify App Pricing, sa propre facturation, sans que les marchands acceptent de nouveau. Voici les étapes, telles que Shopify les décrit au 31 octobre 2026.
Par Arthur Renard, mis à jour le
Pourquoi tes abonnements survivent à Mantle
La documentation de Mantle dit que Mantle Billing s'appuie sur l'API Billing de Shopify : les abonnements sont chez Shopify, et Mantle les crée et les gère. Les paiements acceptés par tes marchands sont donc des abonnements de l'API Billing, et l'outil de migration de Shopify les traite comme tels.
Ce qui dépendait de Mantle, c'est le code autour : ta page de forfaits, les appels qui créent ou changent un abonnement, et les vérifications de ce qu'une boutique paie. Nous n'avons pas testé ce que répond l'API de Mantle depuis sa date de fin : n'y compte pas. Vérifie d'abord le parcours d'abonnement de ton application sur une boutique de développement.
La page de facturation de Mantle, mise à jour pour la dernière fois le 16 juin 2026, dit encore qu'App Pricing n'est ouvert qu'aux nouvelles applications. Ce n'est plus vrai, et plusieurs guides sur le web sont dans le même cas : l'outil de migration de Shopify est disponible depuis le 29 septembre 2026.
Tes deux possibilités
| Shopify App Pricing | L'API Billing, par toi-même | |
|---|---|---|
| État | La direction que prend Shopify pour la facturation des applications | Toujours prise en charge, comme ancienne méthode, sans date de fin annoncée |
| Qui gère le choix du forfait et l'accord du marchand | Shopify, ainsi que le comptage de l'usage et les factures | Ton application |
| Facturation à l'usage | Déclarée par l'API App Events, facturée chaque mois | Par ton application |
| Forfait annuel avec facturation à l'usage | Impossible sur un forfait uniquement annuel | Ta propre logique |
| Achats uniques | Pas pris en charge : à modéliser comme de l'usage | Pris en charge |
| Prix dans une autre monnaie | Dollars américains seulement | Shopify renvoie ici pour les prix fixés en monnaie locale |
| Flex Billing, la facturation souple de Mantle | Mantle dit que ça risque de ne pas convenir | Mantle dit que tu devras sans doute la construire ici |
Pour la plupart des applications à forfaits mensuels ou annuels, App Pricing veut dire moins de code à maintenir. Son fonctionnement au quotidien est dans notre guide de Shopify App Pricing. Une fois que tu y es passé, ton application ne peut plus créer de nouveaux paiements récurrents par l'API Billing ; ceux créés avant continuent.
Ce qu'il faut selon ta facturation
| Si ton application facture avec | Changements de code | Forfaits | Abonnements existants |
|---|---|---|---|
| Des paiements mensuels ou annuels | Ajouter les nouvelles API | Relire les brouillons que Shopify génère | À passer dans le tableau de bord Partner ou avec Shopify CLI |
| De la facturation à l'usage | Ajouter les nouvelles API et l'API App Events | Configurer les événements, les compteurs et les prix à l'usage | À passer avec Shopify CLI |
| Des achats uniques | Ajouter les nouvelles API | Modéliser chaque achat comme de l'usage | Les achats uniques existants restent sur l'API Billing |
Les nouvelles API (des interfaces pour ton code) sont Active Subscription et Historical Events, dans l'API Partner, et App Events pour l'usage. Active Subscription renvoie à la fois les abonnements de l'API Billing et ceux d'App Pricing : tu peux donc t'en servir pour tes vérifications avant et après le changement.
La migration, étape par étape
Avant de commencer, note tes forfaits actuels, tes essais, tes liens de bienvenue et tes facturations à l'usage.
- Lance la préparation des forfaits. Dans le tableau de bord Partner, ouvre « App distribution », ton application, « Distribution », puis « Manage listing » à côté de ta fiche de l'App Store. Sous « Published languages », clique sur « Edit », puis sur « Manage » sous « Pricing content », puis sur « Get started » sous « Update to App Pricing ». Shopify génère des brouillons de forfaits à partir de tes forfaits compatibles.
- Relis tes forfaits. Shopify ne vérifie pas que les brouillons correspondent à tes prix : contrôle pour chacun son identifiant, sa durée de facturation, son prix, son essai gratuit, son lien de bienvenue, ses fonctions et ses boutiques ciblées. Complète chaque forfait marqué « Action needed », ajoute les réglages d'usage, qui ne sont pas recopiés, et ajoute les forfaits que Shopify a sautés. Tu peux avoir jusqu'à huit forfaits publics et autant de forfaits privés que tu veux.
- Teste sur une boutique de développement. Abonne-toi à chaque brouillon, va jusqu'au bout de l'accord et de la redirection, contrôle le prix, la durée, l'essai et le lien de bienvenue, et confirme l'abonnement avec l'API Active Subscription. Pour les forfaits à l'usage, envoie des App Events et vérifie que les bons compteurs les enregistrent.
- Active App Pricing, une fois chaque forfait réglé et testé, avec au plus un forfait public gratuit sans facturation à l'usage. Les nouveaux abonnements utilisent alors les nouveaux forfaits, et les anciens continuent par l'API Billing jusqu'à ce que tu les fasses passer : garde donc ce code en marche.
- Fais passer les abonnements existants. Dans le tableau de bord Partner, sous « Review and assign new plans », chaque ligne regroupe les abonnements de même nom, prix, monnaie et durée. Décoche ce que tu veux garder sur l'API Billing, puis clique sur « Move selected ». Pour passer par le tableau de bord Partner, garde exactement un forfait public par prix, monnaie et durée que paient tes abonnés.
Tout le reste passe par Shopify CLI, l'outil en ligne de commande de Shopify : les abonnements à l'usage, les changements de prix et les passages à des forfaits privés. Au 31 octobre 2026, les commandes sont dans la version de test quotidienne (nightly). Tu listes les abonnements avec shopify app subscription-migrations list, tu prépares un fichier CSV avec une ligne par boutique, puis tu le programmes. Dans ce fichier, HONOR_BILLING_PRICE garde le prix que le marchand paie aujourd'hui et PLAN_PRICE applique celui du nouveau forfait. Les envois se font par lots de 250 boutiques au plus.
Quand ça prend effet, et ce que voient les marchands
- Un passage est programmé, pas immédiat : chaque abonnement change au début de son prochain cycle de facturation, ou à son prochain renouvellement pour un forfait annuel.
- Les marchands n'ont pas à accepter de nouveau. Si le passage change les conditions de facturation, Shopify écrit au propriétaire de la boutique avec les anciennes et les nouvelles conditions, et le marchand a au moins 30 jours. Si le prochain cycle arrive plus tôt, l'abonnement reste aux conditions actuelles pour une période de plus, soit une année de plus pour un forfait annuel.
- Si les conditions ne changent pas, Shopify n'écrit à personne, sauf si tu demandes un avis avec Shopify CLI.
- Un marchand qui n'est pas d'accord peut résilier son abonnement avant le changement, ce qui annule aussi le passage.
- Tu peux annuler un passage programmé avec Shopify CLI. Une fois que l'abonnement a changé de forfait, le passage ne peut plus être annulé.
Ton application voit l'abonnement de l'API Billing garder son statut, prendre le nouveau prix et la nouvelle durée, et perdre son plafond, avec un webhook (une notification automatique) APP_SUBSCRIPTIONS_UPDATE. Garde ton code de l'API Billing en marche jusqu'à ce que le dernier changement ait pris effet.
Les limites à vérifier d'abord
- Un abonnement avec une remise en cours ne peut pas passer avant la fin de la remise.
- La facturation à l'usage se fait chaque mois et ne peut pas se combiner avec des forfaits uniquement annuels. Un développeur qui quittait Mantle l'a signalé sur le forum de Shopify en août 2026, pour un forfait annuel avec de l'usage au-delà d'une quantité incluse.
- Les plafonds d'usage ne sont pas pris en charge.
- Les prix des forfaits sont en dollars américains seulement.
- L'annonce de Shopify du 29 septembre 2026 dit que les anciennes limites sur les forfaits privés sont levées, un autre blocage signalé par des développeurs qui quittaient Mantle.
- Shopify App Pricing n'envoie pas les webhooks de l'API Billing pour ses abonnements. Dans le fil du forum qui annonce l'outil, son auteur a écrit le 29 septembre 2026 qu'ils marchent encore mais peuvent être retirés à tout moment : lis l'état des abonnements dans l'API Partner.
Quoi vérifier ensuite
Compare quelques boutiques dans le tableau de bord Partner avec ce que ton application leur donne, et surveille le premier cycle de facturation après le changement : un gain peut mettre jusqu'à 37 jours à apparaître (voir les versements Shopify Partner).
Luseri n'intervient pas dans ta facturation. Il lit les événements d'abonnement et de versement dans l'API Partner, en lecture seule : il montre donc ton MRR (ce que tes abonnés paient chaque mois) et ce qui l'a fait bouger pendant la migration, et son historique ne dépend pas de Mantle. Pour le reste de ce que faisait Mantle, vois les meilleures alternatives à Mantle, par fonction.
Questions
- Mes abonnements ont-ils disparu avec Mantle ?
- D'après Mantle, non : ils sont chez Shopify, et Mantle les créait et les gérait. Ce que ton application doit remplacer, c'est le code qui comptait sur Mantle.
- Les marchands doivent-ils accepter de nouveau ?
- Non. Shopify dit que les abonnements existants peuvent passer sans nouvel accord des marchands. Si les conditions de facturation changent, Shopify prévient le propriétaire de la boutique au moins 30 jours avant.
- Quand un abonnement change-t-il vraiment ?
- Au début de son prochain cycle de facturation, ou à son prochain renouvellement pour un forfait annuel. Tu peux annuler un passage programmé jusque-là ; ensuite, il ne peut plus être annulé.
- Puis-je rester sur l'API Billing ?
- Oui, pour l'instant. Shopify la prend encore en charge comme ancienne méthode et n'a annoncé aucune date de fin. Un développeur a demandé sur le forum de Shopify en septembre 2026 si elle serait retirée, sans réponse au 31 octobre.
- Et Flex Billing, la facturation souple de Mantle ?
- Mantle dit que Shopify App Pricing risque de ne pas la prendre en charge, et que si elle t'est indispensable, tu devras sans doute la construire toi-même sur l'API Billing.
Sources
- Shopify : passer à Shopify App Pricing (en anglais)
- Shopify : faire passer les abonnements avec Shopify CLI (en anglais)
- Shopify : Shopify App Pricing (en anglais)
- Shopify : la facturation (en anglais)
- Journal des changements de Shopify : faire passer les abonnements existants à App Pricing (septembre 2026)
- Forum de Shopify : l'outil de migration des abonnements de l'API Billing (29 septembre 2026)
- Forum de Shopify : App Pricing limitations when migrating from Mantle
- Mantle : la facturation après la fermeture (mise à jour le 16 juin 2026, en anglais)