Utiliser les flows Adapty avec votre propre système de paiement

Vous n’avez pas besoin de migrer vos achats vers Adapty pour utiliser ses flows. En mode Observer, votre code continue de gérer chaque achat, tandis qu’Adapty affiche le paywall ou l’onboarding, décide qui le voit, le teste en test A/B et rend compte des résultats.

Ce guide explique ce qui change, ce qui ne change pas, et ce que la mise en place implique.

Tip

Vous découvrez les flows ? Le Flow & Paywall Builder présente ce que vous pouvez créer avant de mettre tout cela en place.

Ce qui reste à vous, ce qu’Adapty prend en charge

Votre code conserve :

  • L’appel d’achat
  • La finalisation et la validation des transactions
  • L’attribution et la révocation des accès
  • Les renouvellements et les nouvelles tentatives de facturation

Adapty prend en charge :

Rien ne change dans votre facturation. Adapty affiche le flow et transmet l’action d’achat à votre code, qui effectue la transaction.

Créez vos produits dans Adapty

Ignorez cette section si votre flow n’affiche aucun prix et ne déclenche aucun achat — un flow composé uniquement d’écrans d’onboarding n’a pas besoin de produits dans Adapty.

Dès qu’un écran présente des produits, créez un produit dans Adapty pour chaque abonnement ou achat unique proposé. Un flow lit le prix affiché sur la carte depuis le produit : la carte affiche ainsi le prix actuel du store, vous pouvez tester ce prix en test A/B, et Adapty regroupe les revenus par produit dans les analytiques.

Un produit dans Adapty pointe vers le produit store que vous vendez déjà, donc en créer un ne modifie pas la facturation : c’est votre code qui gère chaque achat. Chaque produit est associé à un niveau d’accès, et en mode Observer, Adapty ne l’accorde pas — votre code continue de gérer les accès — mais un produit en a besoin.

L’Adapty CLI permet de créer des produits sans ouvrir le tableau de bord. Installez-le (Node.js 18 ou version ultérieure) et connectez-vous :

npm install -g adapty
adapty auth login

Récupérez votre identifiant d’application, puis le niveau d’accès à associer — chaque nouvelle application commence avec un niveau premium :

adapty apps list
adapty access-levels list --app <app-id>

Créez ensuite un produit Adapty pour chaque produit store que vous vendez, en utilisant les identifiants de produit issus d’App Store Connect et de Google Play Console :

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly --android-product-id com.example.monthly --android-base-plan-id monthly

Passez --period lifetime pour un achat unique, et --stripe-product-id avec --stripe-price-id (ou la paire Paddle) pour quelque chose que vous vendez sur le web. products create liste tous les flags. Les IDs de produits du store ne peuvent pas être modifiés après la création, donc pointer un produit vers un autre produit du store implique de créer un nouveau produit.

Warning

Un élément produit sans rien d’assigné bloque la sauvegarde et la publication — vous le découvrez dans le builder. Une action Purchase sans produit défini se sauvegarde sans problème mais échoue sur l’appareil — le bouton ne fait rien. Définissez un produit sur chaque action Purchase.

Ou ignorez les produits et écrivez les prix en texte statique

Un flow sans élément produit se sauvegarde et se publie, vous pouvez donc saisir les prix dans le texte et laisser votre propre code décider ce qu’un appui achète. Ce que cela vous coûte :

  • Vous devez maintenir les prix à deux endroits — dans le store et dans le texte du flow — et ils se désynchronisent dès que vous en modifiez un.
  • Pas de tests A/B sur les prix, alors que c’est précisément l’intérêt d’un flow.
  • Les graphiques et les intégrations regroupent moins bien les revenus, car Adapty ne connaît le produit qu’à partir de la transaction que vous signalez.
  • Votre code associe chaque élément cliqué à un produit, au lieu de le recevoir directement du flow.

Mise en place

  1. Activez le SDK en mode Observer. Activez observerMode lors de la configuration du SDK : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
  2. Créez vos produits dans Adapty, sauf si le flow n’affiche aucun prix. Une commande CLI par produit — voir Créer vos produits dans Adapty.
  3. Créez le flow. Consultez le Flow & Paywall Builder pour les écrans, configurez les achats pour les produits sur un écran de paywall, et créez un placement pour définir où le flow apparaît dans votre application.
  4. Affichez le flow et effectuez l’achat dans votre propre code. Adapty transfère l’événement d’achat à un handler que vous enregistrez.
  5. Signalez la transaction avec l’ID de variante de paywall du produit acheté, afin que l’achat soit comptabilisé dans les analytics attribués au paywall qui l’a généré.

Les étapes 4 et 5 diffèrent selon la plateforme. Dans chaque extrait, flow correspond à l’AdaptyFlow récupéré pour le placement, product est l’AdaptyPaywallProduct sur lequel l’utilisateur a appuyé, et myPurchaseApi ou yourBillingClient représente le code d’achat que vous avez déjà.

Limites du mode Observer

  • Adapty n’accorde pas d’accès : il ne réagit pas aux événements d’achat en accordant ou en restreignant l’accès payant, et ne gère ni les renouvellements ni les nouvelles tentatives de facturation. C’est votre propre code qui gère les niveaux d’accès.
  • Votre code finalise ses propres transactions : Adapty ne finalise ni n’acquitte les achats effectués par votre code — c’est donc à vous de clôturer chacun d’eux.
  • Le reporting est obligatoire : le variationId que vous transmettez avec un rapport est le seul lien entre un achat et le flow qui l’a généré. Signalez chaque transaction, sans quoi vos métriques de flow et vos résultats de tests A/B seront erronés.

Si vous utilisez déjà un autre fournisseur

Le mode observateur exige uniquement que votre code effectue l’achat — peu importe quel SDK est appelé. Les flows fonctionnent de la même façon par-dessus RevenueCat, Superwall ou Qonversion que par-dessus votre propre code StoreKit ou Billing Library.

Trois décisions à prendre avant de livrer :

  • Un seul système finalise chaque transaction : deux SDK qui finalisent le même achat est la cause d’échec la plus courante ici.
  • Un seul système gère les accès : Adapty n’accorde rien en mode Observer, donc conservez vos niveaux d’accès là où ils se trouvent.
  • Signalez chaque achat une seule fois : signaler la même transaction depuis deux endroits fausse vos analyses.

Pour migrer complètement depuis l’autre fournisseur, consultez Migrer depuis RevenueCat ou Migrer depuis Superwall.

Laisser Adapty gérer l’achat

Tip

Votre application effectue ses achats via Adapty ici, donc côté code, il s’agit d’une intégration Adapty classique. Suivez le guide de démarrage rapide ou Migrer depuis RevenueCat, ou confiez-le au skill d’intégration SDK.

Le mode Observer est la façon la plus rapide de démarrer. Si vous souhaitez conserver les analytics de RevenueCat tout en évitant les limites du mode Observer, inversez les deux : Adapty fonctionne en mode complet et finalise chaque achat, tandis que RevenueCat fonctionne dans son propre mode Observer et enregistre les achats effectués par Adapty.

Adapty sait alors quel flow, quel placement et quelle variante de test A/B a généré chaque transaction, et il accorde des niveaux d’accès et gère les renouvellements, les nouvelles tentatives de facturation et les remboursements.

Du côté de RevenueCat, définissez purchasesAreCompletedBy sur votre app lors de la configuration de son SDK — .myApp sur iOS, MY_APP sur Android. La documentation RevenueCat Using the SDK with your own IAP code détaille la configuration pour chaque plateforme, la version de StoreKit requise sur iOS, et l’appel syncPurchases() qui récupère les achats déjà effectués par un utilisateur. Donnez aux deux SDK le même identifiant utilisateur — le customer user ID d’Adapty et l’appUserID de RevenueCat — sinon les deux tableaux de bord ne décriront pas la même personne.

Warning

Cette configuration met fin aux droits RevenueCat en tant que source de vérité, et les niveaux d’accès Adapty prennent ce rôle. RevenueCat continue d’observer et son tableau de bord continue de générer des rapports, mais il apprend désormais chaque achat en différé et dans les limites de couverture listées dans sa propre documentation. Tout ce qui lit aujourd’hui les droits RevenueCat — votre application, votre backend, une version web ou desktop — doit soit migrer vers Adapty, soit lire une copie. Réglez ce point avant de déployer. Rien d’autre ne bouge : le compte RevenueCat, son historique et ses intégrations restent en place.