> 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 ### 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ipaware.io/dashboard/billing.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.