> For the complete documentation index, see [llms.txt](https://docs.ipaware.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipaware.io/dashboard/billing.md). # Billing Manage your IPAware subscription, view pricing plans, and handle payment information. ### Overview The Billing tab allows you to: * View your current subscription * Compare available plans * Upgrade or downgrade your plan * Manage payment methods * View invoices and billing history * Cancel or resume subscriptions *** ### Subscription Plans #### Free Tier **Perfect for:** Testing and small projects **Features:** * 5,000 requests / month * Basic geolocation data * 1 whitelisted IP address * Basic support * **Price:** $0 / month #### Pro Monthly **Perfect for:** Growing businesses **Features:** * **UNLIMITED requests** * Full API access * 2 whitelisted IP addresses * Advanced threat detection * 24/7 priority email support * Commercial usage * **Price:** $9.99 / month #### Pro Yearly **Perfect for:** Established businesses **Features:** * **UNLIMITED requests** * Full API access * 5 whitelisted IP addresses * Advanced threat detection * 24/7 priority email support * Commercial usage * **Annual billing discount** * Cost savings vs monthly * **Price:** $99.99 / month #### Custom Plans **Perfect for:** Enterprise needs **Features:** * Unlimited requests * Custom solutions * Custom whitelisted IP limits * Dedicated support manager * Custom contracts & SLA * Volume discounts * **Price:** Contact sales *** ### Current Subscription Your current plan is displayed at the top of the Billing tab. **Information shown:** * Plan name * Subscription status (Active, Canceled, etc.) * Current billing period dates * Renewal date * Special status badges (if applicable) **Status Badges:** * **Active** (Green) - Subscription is current * **Will Not Renew** (Red) - Canceled, expires at period end * **Scheduled Change** (Yellow) - Plan change pending *** ### Upgrading Your Plan #### From Free to Paid **Steps:** 1. **Select Plan** * Browse available plans * Click **Upgrade** on your chosen plan 2. **Stripe Checkout** * Redirected to secure Stripe checkout * Enter payment information * Review and confirm 3. **Activation** * Redirected back to console * Plan activates immediately * Success message displayed **What changes:** * Request quota increases * IP whitelist limit increases * Access to advanced features * Priority support enabled #### Switching Between Paid Plans Change from one paid plan to another: **Steps:** 1. Click **Switch Plan** on the desired plan 2. Review the change details 3. Confirm the switch **Important:** * Change takes effect at end of current billing period * You keep current plan benefits until then * "Scheduled Change" badge appears * No immediate charge **Downgrade warning:** * If new plan has fewer IP slots, oldest IPs are automatically removed * Review your whitelist before confirming *** ### Managing Your Subscription #### Viewing Billing Portal Access Stripe's customer portal for full billing management: **Steps:** 1. Click **Manage Billing & Invoices** 2. Redirected to Stripe portal **In the portal you can:** * Update payment methods * View invoice history * Download receipts * Update billing information * View upcoming invoices #### Canceling Subscription Stop your subscription from renewing: **Steps:** 1. Click **Cancel Subscription** 2. Read the warning about downgrade impacts 3. Click **Confirm Cancellation** **What happens:** * Subscription remains active until period end * "Will Not Renew" badge appears * Access continues until expiration * Automatically downgrades to Free Tier * IP whitelist reduced to 1 (oldest IPs removed) #### Resuming Subscription Reactivate a canceled subscription: **Steps:** 1. Click **Resume Subscription** (appears if canceled) 2. Confirm the action **Effects:** * Subscription will renew at period end * "Will Not Renew" badge removed * No immediate charge * Benefits continue uninterrupted *** ### Payment Methods #### Adding a Payment Method Done during initial upgrade through Stripe Checkout. #### Updating Payment Method **Steps:** 1. Click **Manage Billing & Invoices** 2. In Stripe portal, click **Payment methods** 3. Add new card or update existing 4. Set as default if desired **Supported methods:** * Credit cards (Visa, Mastercard, Amex) * Debit cards * Other methods supported by Stripe #### Failed Payments If a payment fails: 1. **Email notification** sent immediately 2. **Retry attempts** made automatically 3. **Downgrade** to Free Tier if unresolved **To resolve:** * Update payment method in Stripe portal * Ensure sufficient funds * Contact support if issues persist *** ### Invoices #### Viewing Invoices **Steps:** 1. Click **Manage Billing & Invoices** 2. View invoice list in Stripe portal 3. Click any invoice to view details **Invoice includes:** * Invoice number * Billing period * Amount charged * Payment method * Organization details * Tax information (if applicable) #### Downloading Invoices From Stripe portal: 1. Open the invoice 2. Click **Download PDF** 3. Save for your records **Use cases:** * Expense reports * Tax filing * Accounting records * Reimbursement requests *** ### Billing Information #### Organization Details Update billing information for invoices: **Steps:** 1. Go to **Team** tab 2. Click **Edit Details** 3. Update organization information: * Name * Address * City, Country, Postal Code * Tax ID (for VAT) 4. Click **Save Changes** **Appears on:** * All future invoices * Receipts * Tax documents *** ### Understanding Billing Cycles #### Billing Period **Monthly plans:** * Billed on the same day each month * Example: Subscribed on Jan 15 → billed on 15th of each month **Yearly plans:** * Billed once per year * Typically 2 months free compared to monthly #### Proration **When upgrading mid-cycle:** * Charged prorated amount for remainder of period * Full new rate applies next billing cycle **When downgrading:** * Change takes effect at end of current period * No refund for current period * New rate applies next billing cycle #### Trial Periods Free Tier serves as the trial: * No credit card required * 5,000 requests to test the API * Upgrade anytime *** ### Plan Comparison | Feature | Free | Pro Monthly | Pro Yearly | Custom | | -------------------- | ----- | -------------- | -------------- | ----------------- | | **Requests/month** | 5,000 | Unlimited | Unlimited | Unlimited | | **IP Whitelist** | 1 | 2 | 5 | Custom | | **Threat Detection** | ❌ | ✅ | ✅ | ✅ | | **Support** | Basic | Priority Email | Priority Email | Dedicated Manager | | **Commercial Use** | ❌ | ✅ | ✅ | ✅ | | **SLA** | ❌ | ❌ | ❌ | ✅ | | **Custom Contract** | ❌ | ❌ | ❌ | ✅ | *** ### Troubleshooting #### Payment Declined **Common reasons:** * Insufficient funds * Card expired * Incorrect billing address * Bank security hold **Solutions:** 1. Verify card details 2. Contact your bank 3. Try a different payment method 4. Update billing address #### Can't Upgrade **Possible issues:** * Browser blocking Stripe redirect * Ad blocker interfering * Network connectivity **Solutions:** * Disable ad blockers * Try different browser * Check internet connection * Contact support #### Unexpected Charge **Check:** * Billing period (monthly vs yearly) * Plan changes * Proration for mid-cycle upgrade * Invoice in Stripe portal **If still unclear:** * Review invoice details * Contact support with invoice number *** ### Best Practices #### Cost Management **Monitor usage:** * Check request counts regularly * Plan upgrades before hitting limits * Use Free Tier for development **Optimize costs:** * Choose yearly billing for savings * Remove unused IP whitelist entries * Consolidate API keys **Budget planning:** * Set reminders for renewal dates * Review invoices monthly * Track usage trends *** ### Getting Help #### Sales Questions For custom plans or enterprise needs: * Email: * Include your requirements * Mention expected usage volume #### Billing Support For payment or invoice issues: * Email: * Include invoice number * Describe the issue clearly #### Technical Support For API or technical questions: * Email: * Priority support for paid plans *** ### Next Steps * Monitor usage to choose the right plan * Manage IP whitelist to maximize your limit * Create API keys to start using the API * Invite team members to collaborate