Billing & Subscriptions

This guide explains how to manage your company's subscriptions for PyQueryHub, understand how plans contribute to your account limits, and how to handle billing details.

All subscriptions and billing information for your company are managed by the owner of your company's primary "Admin Team."

1. Understanding Your Subscriptions

Subscriptions to our plans grant your company access to various features and define operational limits, such as the number of users you can add, request rate capacities, and data bandwidth.

Key Concept: Stackable Plans & Cumulative Limits A powerful feature of our billing system is that you can subscribe to multiple plans simultaneously, including multiple instances of the same plan if needed. Your company's total limits are cumulative. This means:

  • Total User Limit: The maximum number of users your company can have is the sum of the user allowances from all your active subscriptions.
  • Total Request Rate & Bandwidth: Similarly, your company's total capacity for request rates and data bandwidth is the sum of what each active subscription provides.

For example, if you have:

  • Subscription 1 (Plan A) providing 10 users and 100K requests.
  • Subscription 2 (Plan B) providing 25 users and 200K requests. Your company's total capacity would be 35 users and 300K requests/minute.

Our billing is securely processed by our payment partner, Paddle.

2. Viewing Your Active Subscriptions

To see and manage your company's current subscriptions:

  1. Navigate to the "Billing & Subscriptions" page (you'll typically find this in your account settings or main navigation menu).
  2. Under the "Your Subscriptions" section, you will find a list of all plans your company is currently subscribed to. For each active subscription, you'll see:
    • Plan Name: The name of the subscribed plan.
    • Subscribed Since: The date the subscription started.
    • Status: The current state of the subscription (e.g., "Active," "Trialing," "Cancelled - On Grace Period," "Past Due").
    • Renewal/End Date:
      • If active and not cancelled, it will show the date it renews on.
      • If cancelled, it will show the date access ends.
    • Subscription ID: A unique identifier for that particular subscription instance.
    • Buttons to "Cancel Subscription" or "Resume Subscription" (if applicable).

If your company has no active subscriptions, a message will indicate this, prompting you to explore available plans.

3. Choosing and Subscribing to New Plans

You can enhance your company's capabilities by subscribing to new plans or adding more instances of existing ones.

  1. On the "Billing & Subscriptions" page, scroll to the "Choose Your Plan" section.
  2. Here, you'll see a list of available plans. For each plan, details will include:
    • Plan Name and Description.
    • Price and billing interval (e.g., "$X.XX /month").
    • A list of key features or limits it contributes (e.g., "Adds Y users to your company's total," "Increases request capacity by Z," "Provides additional data bandwidth"). The exact benefits will be detailed with each plan.
    • If you are already subscribed to a particular plan type, it may be highlighted as "Active."
  3. To Subscribe:
    • Click the "Subscribe" button for the desired plan.
    • You will be guided through a secure checkout process managed by our payment partner, Paddle. This may involve entering or confirming your payment details.
    • Once your subscription is successfully processed, the page will update, and the benefits of the new plan (e.g., increased user slots, higher rate limits) will be immediately added to your company's total capacities.

You can subscribe to multiple different plans or even subscribe to the same plan multiple times if you need to further increase the specific benefits that plan offers.

Important Note: PyQueryHub DO NOT STORE YOUR PAYMENT DETAILS. All payment processing is handled securely by Paddle. We do not have access to your credit card or payment information.

4. Managing Your Subscriptions

You have control over your active subscriptions directly from the "Your Subscriptions" section.

A. Cancelling a Subscription

If you wish to stop a subscription from renewing:

  1. Locate the subscription you want to cancel in your list of active subscriptions.
  2. Click the "Cancel Subscription" button associated with it.
  3. A confirmation message will appear. Please read it carefully.
  4. If you confirm, the subscription will be set to cancel at the end of its current billing period. It will remain active, and its benefits will continue to apply until that end date. It will not renew afterwards.

B. Resuming a Cancelled Subscription

If you've previously cancelled a subscription but it hasn't yet reached its end date (i.e., it's in its grace period):

  1. Find the cancelled subscription in your list. It will typically indicate that it's set to end on a specific date.
  2. A "Resume Subscription" button should be available.
  3. Click this button. After confirming, the cancellation will be reversed, and the subscription will continue to renew as normal at the end of its current (and subsequent) billing periods.

5. Managing Payment Methods and Invoices (Paddle Customer Portal)

For tasks like updating your credit card information, viewing past invoices, or managing other billing-related details:

  1. On the "Billing & Subscriptions" page, click the "Manage Billing & Payment" button (often found near the top of the "Your Subscriptions" section).
  2. This will securely redirect you to your Paddle Customer Portal. Paddle is our trusted payment processing partner.
  3. Within the Paddle portal, you can directly manage your payment methods and access your billing history.

6. How Your Company's Limits Are Calculated (Summary)

To reiterate, your company's overall operational limits are dynamic and based on the sum of all your active subscriptions:

  • Total User Capacity = Sum of user allowances from all active plans.
  • Total Request Rate = Sum of request rate allowances from all active plans.
  • Total Bandwidth = Sum of bandwidth allowances from all active plans.

This system allows you to flexibly scale your company's resources up or down by adding or canceling individual plan subscriptions as your needs change.

If you have any questions about your billing, subscriptions, or how limits are calculated, please don't hesitate to contact our support team.