Bulk Imports
We only offer bulk imports for very large volumes. For small and moderate migrations, simply post the receipts/purchase tokens to our API.
For extraordinarily large imports, we offer bulk imports as a service on our plans offered via sales. Contact sales to see how we can help with the process.
Please note that depending on the size, bulk imports can take time to complete, sometimes up to several days or weeks for the largest data sets. Please keep this in consideration as you are planning your launch.
If you already have existing purchases or subscriptions and have been saving the complete raw receipt files or tokens, you can import those purchases into RevenueCat. If you don't have the proper data saved on your server, see the client-side migration section of the Migrating Subscriptions doc.
Before kicking off an import, it's important that new purchases are being forwarded. This can be achieved by integrating the SDK or forwarding receipts/purchase tokens from your backend via our REST API.
Bulk imports done by RevenueCat will not trigger any webhook or integration events. If this is a requirement, then you'll need to perform an import using the REST API as mentioned above.
Required data
To do a receipt import we'll need a CSV file for each of the stores you want to import data from (Apple App Store, Google Play Store, Stripe). The CSV needs to contain the columns outlined below.
=======
Apple App Store
- app_user_id
- receipt (the raw StoreKit 1 receipt file) OR StoreKit 2 signed transaction
In order to accurately detect pricing, upload your App Store Connect API key and configure v2 server notifications, see here for more info.
RevenueCat requires the raw base64 encoded Apple receipt to import the subscription properly. Partial receipts, the receipt information from the Apple server-to-server notifications, or the latest_receipt_info are insufficient as they contain only a subset of the receipt information.
Google Play Store
- app_user_id
- product_id
- token
You can find a reference Google Play import csv file here.
Important: We need to know your API quota with Google and approximately how many remaining requests per day you have so we don't exceed your quota.
Google Play receipts that have been expired for more than 90 days ago can't be imported, and only the current status can be retrieved from each receipt. This means that historical data won't be presented accurately in Charts. To fill the gaps in historical data, you can use Google Historical Imports.
Stripe
- app_user_id
- subscription_token (e.g. sub_xxxxxx)
You can find a reference Stripe import csv file here.
Stripe subscription tokens contain only the current status can be retrieved from each Stripe subscription token. This means that Charts will not accurately reflect the historical data from migrated Stripe tokens.