docs: rotki premium

Author: lukicenturi

.vitepress/config.mts

@@ -83,6 +83,19 @@ export default defineConfig({
           { text: 'Using rotki from mobile', link: '/usage-guides/using-rotki-from-mobile' },
         ],
       },
+      {
+        text: 'Premium',
+        items: [
+          { text: 'Overview', link: '/premium/' },
+          { text: 'Plans & Pricing', link: '/premium/plans-and-pricing' },
+          { text: 'Payment Process', link: '/premium/payment' },
+          { text: 'Subscription Management', link: '/premium/subscription' },
+          { text: 'API Keys & Secrets', link: '/premium/api-keys' },
+          { text: 'Payment Methods', link: '/premium/payment-methods' },
+          { text: 'Device Management', link: '/premium/devices' },
+          { text: 'Referral Program', link: '/premium/referrals' },
+        ],
+      },
       {
         text: 'Frequently Asked Questions',
         items: [

faq.md

@@ -36,11 +36,35 @@ If you like rotki, you can support us with a premium subscription and you not on
 
 Short answer: **No**
 
-At rotki, we believe in building sustainable, long-term software that delivers continuous value to our users. Offering a lifetime subscription may sound appealing on the surface, but in reality, it’s a model that often leads to the collapse of the very products it’s meant to support. Many companies that adopt this approach either shut down within a few years or abandon the product once the initial influx of revenue dries up.
+At rotki, we believe in building sustainable, long-term software that delivers continuous value to our users. Offering a lifetime subscription may sound appealing on the surface, but in reality, it's a model that often leads to the collapse of the very products it's meant to support. Many companies that adopt this approach either shut down within a few years or abandon the product once the initial influx of revenue dries up.
 
 rotki has been around since 2017, delivering continuous, original improvements every month. Offering a lifetime subscription would require us to put a fixed price on the indefinite future work of our entire team, which is simply not realistic or fair. Building and maintaining a privacy-respecting, local-first, open-source financial tool involves real and growing costs.
 
-It’s also worth noting that our current pricing model hasn’t changed since 2017. We’re currently re-evaluating it to better reflect the actual cost of development, support, and infrastructure, especially in light of inflation and the expanded scope of what rotki offers today. Our goal is to keep rotki accessible while ensuring its long-term health and independence.
+It's also worth noting that our current pricing model hasn't changed since 2017. We're currently re-evaluating it to better reflect the actual cost of development, support, and infrastructure, especially in light of inflation and the expanded scope of what rotki offers today. Our goal is to keep rotki accessible while ensuring its long-term health and independence.
+
+### How do I manage my premium subscription?
+
+You can manage your premium subscription, payment methods, devices, and referrals through your rotki.com account. See the [Premium documentation](/premium/) for detailed guides on:
+
+- [Managing your subscription](/premium/subscription) - View payment history, cancel subscription
+- [Payment methods](/premium/payment-methods) - Add, remove, or change cards
+- [Device management](/premium/devices) - Manage device limits
+- [Referral program](/premium/referrals) - Create and share referral codes
+
+### How do device limits work?
+
+Each premium tier has a device limit. You can manage your devices from the app (**Settings → Account → Premium Devices**) or from the [website](https://rotki.com/home/devices).
+
+If you exceed your device limit, remove unused devices to continue using rotki. See [Device Management](/premium/devices) for more information.
+
+### Need help with premium?
+
+If you have questions about premium subscriptions, payment, billing, or account management:
+
+- Check the answers above in this FAQ section
+- Visit the [Premium documentation](/premium/) for detailed guides
+- Contact support at [[email protected]](mailto:[email protected])
+- Join our [Discord community](https://discord.rotki.com)
 
 ## Questions on Roadmap and Features
 

premium/api-keys.md

@@ -0,0 +1,169 @@
+# API Keys & Secrets
+
+rotki premium uses API Keys and Secrets to connect your subscription to the rotki application. This guide explains how to create, manage, and secure your API credentials.
+
+## What are rotki Premium API Keys?
+
+API Keys and Secrets are authentication credentials that:
+
+- Link your rotki app to your premium subscription
+- Enable premium features in the application
+- Allow cloud backup and sync across devices
+- Identify your account for device limit management
+
+## Creating API Keys
+
+### First-Time Creation
+
+After purchasing a subscription, you need to manually generate your API credentials:
+
+1. Go to your [subscription page](https://rotki.com/home/subscription)
+2. Navigate to the **API Keys** section
+3. Click the **Create** button
+4. Your credentials will be generated and displayed:
+   - **API Key** - Your public identifier
+   - **API Secret** - Your private authentication token
+5. You can view both credentials anytime from your subscription page
+
+::: info Manual Generation Required
+API Keys and Secrets are not automatically created after payment. You must click the button to generate them for the first time.
+:::
+
+### Where to Find Existing Keys
+
+You can view both your API Key and Secret anytime:
+
+1. Visit your [subscription page](https://rotki.com/home/subscription)
+2. Look in the API Keys section
+3. Both your API Key and Secret will be displayed
+
+## Using API Keys in the App
+
+After creating your API credentials, add them to rotki:
+
+1. Open the rotki application
+2. Navigate to **API Keys** → **rotki Premium** in the sidebar
+3. Enter your **API Key**
+4. Enter your **API Secret**
+5. Click **Save**
+
+For detailed app setup instructions, see the [API Keys Usage Guide](/usage-guides/api-keys#rotki-premium).
+
+## Managing API Keys
+
+### Viewing Your Keys
+
+From your [subscription page](https://rotki.com/home/subscription):
+
+- Both your API Key and Secret are always visible
+- You can copy them anytime you need
+- You can see when the key was created
+
+### Regenerating Keys
+
+If you need to create new credentials:
+
+1. Go to your [subscription page](https://rotki.com/home/subscription)
+2. Click the **Regenerate** button
+3. Your new API Key and Secret will be generated and displayed
+4. Update credentials on all your devices
+
+::: tip When to Regenerate
+
+- If you suspect your credentials have been compromised
+- If you want to revoke access from all devices
+  :::
+
+## Security Best Practices
+
+### Protecting Your Credentials
+
+::: danger Keep Your Secret Safe
+
+- **Never** share your API Secret with anyone
+- **Never** post it in public forums or Discord
+- **Never** commit it to version control (Git, etc.)
+- **Never** send it via unencrypted channels
+  :::
+
+### Storage Recommendations
+
+Store your API credentials securely:
+
+- Use a password manager (1Password, Bitwarden, KeePass, etc.)
+- Keep backups in a secure location
+- Don't save them in plain text files
+- Don't email them to yourself
+
+### If Credentials are Compromised
+
+If you believe your API credentials have been exposed:
+
+1. **Immediately** regenerate your API credentials from the [subscription page](https://rotki.com/home/subscription) by clicking **Regenerate**
+2. Update all your legitimate devices with the new credentials
+3. Monitor your account for unusual activity
+
+## API Keys and Device Limits
+
+Each premium tier has a device limit. When you add your API credentials to rotki:
+
+- The device is registered to your account
+- It counts toward your device limit
+- You can view and manage devices from the [devices page](/premium/devices)
+
+### Checking Device Usage
+
+From your [subscription page](https://rotki.com/home/subscription):
+
+- View current device count
+- See your tier's device limit
+- Access the [device list](https://rotki.com/home/devices) for details
+
+### Device Limit Exceeded
+
+If you reach your device limit:
+
+- New devices cannot authenticate
+- You'll see an error in the rotki app
+- Remove unused devices to free up slots
+
+See [Device Management](/premium/devices) for details on managing devices.
+
+## Troubleshooting
+
+### Invalid API Key/Secret Error
+
+If you see authentication errors:
+
+1. Verify you copied the credentials correctly (no extra spaces)
+2. Ensure your subscription is active (check [subscription page](https://rotki.com/home/subscription))
+3. Verify your API credentials are still visible on the subscription page
+4. Try regenerating your credentials
+
+### Can't See My API Key/Secret
+
+If you can't see your credentials on the subscription page:
+
+1. Verify you're logged in to the correct rotki.com account
+2. Ensure you've already generated API credentials (if not, click the generate button)
+3. Refresh the page
+4. Contact [[email protected]](mailto:[email protected]) if the issue persists
+
+### Premium Features Not Working
+
+If premium features aren't activating:
+
+1. Verify API credentials are entered correctly in the app
+2. Check your subscription is active and not expired
+3. Ensure you haven't exceeded your device limit
+4. Try removing and re-adding the credentials
+5. Check the app logs for specific errors
+
+### Multiple Devices Not Syncing
+
+If sync isn't working across devices:
+
+1. Verify all devices use the same API credentials
+2. Ensure "Allow data sync with rotki Server" is enabled (see [Sync Guide](/usage-guides/#sync-data-with-rotki-server))
+3. Check you haven't exceeded device limits
+4. Manually trigger sync from the toolbar