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 importtransfè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 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.
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) }
}
}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.csvPersonne 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.
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.
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.
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)
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)
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.Publier la mise à jour de l'application
Ajoutez l'URL de proxy et un appel unique à
syncPurchases. Publiez-la une fois l'import terminé.Vérifier
openpurr doctorvérifie la configuration. Recherchez des clients que vous connaissez, et comparez les abonnements actifs avec les graphiques de RevenueCat.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é depuis RevenueCat, et ce qui ne l'est pas
| Abonnements et achats, avec renouvellements, remboursements, délais de grâce et expirations | Oui, récupérés auprès d'Apple et de Google |
|---|---|
| Qui possède quel achat | Oui, à partir de l'export de RevenueCat |
| Identifiants d'utilisateur de l'application, y compris anonymes | Oui, inchangés |
| Attributs des clients ($email, $displayName et les vôtres) | Oui, à partir d'un Audience export |
| Produits, entitlements et offres | Vous les recréez, avec les mêmes identifiants |
| Historique des graphiques avant la bascule | En partie : conservez les CSV des graphiques de RevenueCat pour vos archives |
| Paywalls, expériences, intégrations, Customer Center | Non : openpurr ne les propose pas |
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.
