Guide de migration

Passer de RevenueCat à openpurr sans perdre un seul abonné

Gardez le SDK Purchases que votre application utilise déjà. Importez vos clients existants à partir de l'export de RevenueCat : openpurr récupère lui-même chaque achat auprès d'Apple et de Google. Les anciennes versions de l'application continuent de fonctionner pendant que les utilisateurs mettent à jour.

Mis à jour le

En bref

  • openpurr est une alternative open source et auto-hébergée à RevenueCat. Il fonctionne avec le SDK Purchases officiel de RevenueCat, sans modification.
  • Votre application ajoute une ligne (l'URL de proxy du SDK) et un appel unique à syncPurchases. Le reste de votre code d'achat ne change pas.
  • openpurr import transfère les clients existants à partir de l'export de RevenueCat. Les achats eux-mêmes sont récupérés auprès d'Apple et de Google, pas copiés.
  • Les applications App Store peuvent utiliser le Scheduled Data Export de RevenueCat. Google Play demande un export de migration fourni par le support de RevenueCat, le seul qui contient les jetons d'achat.
  • Les deux backends restent à jour jusqu'à ce que la plupart des utilisateurs aient mis à jour l'application : personne ne perd son accès.
  • Avec l'offre gratuite de Cloudflare, l'import traite environ 2 500 clients par jour. Avec Workers Paid, un import important prend quelques heures.
Comment ça marche

Comment se déroule une migration depuis RevenueCat

openpurr ne copie pas les enregistrements d'achat de RevenueCat. Il lui suffit de savoir qui possède quel achat, puis il interroge les stores, exactement comme lorsque votre application lui envoie un achat.

L'import

L'export de RevenueCat indique quel utilisateur de l'application possède quel achat sur les stores. openpurr import interroge Apple et Google pour chaque achat et enregistre la réponse du store pour cet utilisateur. Tout le monde est transféré d'un coup, y compris les personnes qui ne rouvriront jamais l'application.

La mise à jour de l'application

La nouvelle version fait pointer le SDK Purchases vers openpurr et envoie une fois les achats de chaque client avec syncPurchases. Cela rattrape les clients absents de l'export, ainsi que ceux qui ont acheté après sa création.

Les deux backends, pendant un temps

Les anciennes versions de l'application continuent de parler à RevenueCat jusqu'à leur mise à jour. RevenueCat transmet les notifications d'Apple à openpurr, et un second abonnement Pub/Sub fait de même pour Google : les deux restent à jour.

Dans votre application

Ce qui change dans votre application

Définissez l'URL de proxy avant configure, et envoyez une fois les achats de chaque client. Ces deux mêmes changements fonctionnent sur Android, Flutter et React Native ; le guide donne le code pour chacun.

// Avant configure() : la seule ligne ajoutée par la plupart des apps
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")

// Une fois par installation : envoie les achats du client à openpurr
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
  Purchases.shared.syncPurchases { _, error in
    if error == nil { UserDefaults.standard.set(true, forKey: synced) }
  }
}
L'import

Importer les clients depuis RevenueCat

La CLI openpurr lit les colonnes de RevenueCat telles quelles : identifiants d'utilisateur de l'application, identifiants de transaction App Store, jetons d'achat Google Play et attributs comme $email.

npm install -g @openpurr/cli
openpurr login --url https://<your back office>

# Vérifier les premières lignes : interroge Apple et Google, n'écrit rien
openpurr import revenuecat-export.csv --dry-run --limit 50

# Tout importer. Arrêtez quand vous voulez ; relancez pour reprendre.
openpurr import revenuecat-export.csv

Personne ne perd son accès

Un achat que l'application a déjà envoyé pour un client reste le sien ; l'import ne le déplace jamais.

Pas de webhooks en double

Les achats importés ne sont pas nouveaux : openpurr n'envoie donc aucun événement pour eux.

Des graphiques fidèles

Les clients importés sont datés de leur premier achat, et non comptés comme nouveaux le jour de l'import.

Votre application continue de fonctionner

Avec l'offre gratuite de Cloudflare, l'import s'arrête à 90 % d'une limite quotidienne et reprend le lendemain.

Arrêt et reprise

La progression est enregistrée. Importer deux fois une ligne ne change rien : vous pouvez relancer l'import avec un export plus récent.

Essayez d'abord

Un essai à blanc interroge les stores et indique ce qui se passerait, sans rien écrire.

Étape par étape

Migrer depuis RevenueCat en sept étapes

Les deux backends continuent de tourner jusqu'à ce que vous soyez prêt à basculer : les clients sur d'anciennes versions de l'application gardent leur accès.

  1. Installer openpurr

    Déployez openpurr Lite sur votre compte Cloudflare, donnez-lui accès aux API de l'App Store et de Google Play, et recréez vos produits, entitlements et offres avec les mêmes identifiants. Vous pouvez même garder vos clés SDK publiques de RevenueCat.

  2. Tenir les deux backends informés

    Définissez openpurr comme Apple Server Notification Forwarding URL dans RevenueCat, et ajoutez l'abonnement push d'openpurr à votre topic de notifications Play.

    Source : RevenueCat : notifications serveur d'Apple (en anglais)

  3. Obtenir votre export

    App Store uniquement : le Scheduled Data Export de RevenueCat contient ce qu'il faut. Avec Google Play, demandez un export de migration au support de RevenueCat, car lui seul contient les jetons d'achat. Le guide fournit une demande que vous pouvez copier.

    Source : RevenueCat : exporter ses données ou migrer (en anglais)

  4. Importer

    Lancez openpurr import, en commençant par un essai à blanc. Les problèmes sur des lignes isolées vont dans un rapport et n'arrêtent pas l'import.

  5. Publier la mise à jour de l'application

    Ajoutez l'URL de proxy et un appel unique à syncPurchases. Publiez-la une fois l'import terminé.

  6. Vérifier

    openpurr doctor vérifie la configuration. Recherchez des clients que vous connaissez, et comparez les abonnements actifs avec les graphiques de RevenueCat.

  7. Terminer la bascule

    Une fois que la plupart des clients ont mis à jour, faites pointer Apple et Google directement vers openpurr, activez les webhooks d'openpurr et désactivez ceux de RevenueCat.

Toutes les commandes et tous les réglages sont dans le guide complet (en anglais) →

Ce qui est transféré

Ce qui est transféré depuis RevenueCat, et ce qui ne l'est pas

Abonnements et achats, avec renouvellements, remboursements, délais de grâce et expirationsOui, récupérés auprès d'Apple et de Google
Qui possède quel achatOui, à partir de l'export de RevenueCat
Identifiants d'utilisateur de l'application, y compris anonymesOui, inchangés
Attributs des clients ($email, $displayName et les vôtres)Oui, à partir d'un Audience export
Produits, entitlements et offresVous les recréez, avec les mêmes identifiants
Historique des graphiques avant la basculeEn partie : conservez les CSV des graphiques de RevenueCat pour vos archives
Paywalls, expériences, intégrations, Customer CenterNon : openpurr ne les propose pas
FAQ

FAQ sur la migration depuis RevenueCat

Dois-je modifier mon code d'achat ?

Non. openpurr fonctionne avec le SDK Purchases officiel de RevenueCat, sans modification. La mise à jour de l'application ajoute l'URL de proxy avant configure, et un appel unique à syncPurchases. getOfferings, purchase, restorePurchases, logIn et le reste ne changent pas.

Ai-je besoin de l'aide de RevenueCat pour migrer ?

Pour les applications App Store, non : le Scheduled Data Export de RevenueCat contient les identifiants de transaction dont openpurr a besoin. Pour Google Play, oui : d'après la documentation de RevenueCat, seul un export de migration préparé par le support de RevenueCat contient les jetons d'achat exigés par Google.

Qu'en est-il des clients qui ne mettent jamais l'application à jour ?

L'import les couvre : leurs achats sont récupérés auprès d'Apple et de Google et attribués aux mêmes identifiants d'utilisateur. Tant qu'ils utilisent une ancienne version de l'application, cette version parle à RevenueCat. C'est pourquoi les deux backends restent informés jusqu'à ce que la plupart des utilisateurs aient mis à jour.

Combien de temps dure un import ?

Chaque client représente environ 30 écritures de lignes dans la base de données. Avec l'offre gratuite de Cloudflare, cela fait environ 2 500 clients par jour, et l'import se met en pause de lui-même à la limite quotidienne avant de reprendre le lendemain. Avec Workers Paid (5 $ par mois), un import important prend quelques heures.

Mes données sont-elles copiées depuis RevenueCat ?

Seule la correspondance entre les utilisateurs de l'application et les achats sur les stores est copiée, ainsi que les attributs si vous les importez. Les achats eux-mêmes viennent directement d'Apple et de Google : openpurr enregistre donc l'état actuel des stores, renouvellements et remboursements compris.

Prêt à migrer ?

Le guide détaille chaque étape. Si quelque chose dans votre configuration ne colle pas, ouvrez une issue : les migrations orientent ce qui sera développé ensuite.