Billing Overview

GetPaidHQ provides billing APIs for managing product catalogs, pricing models, and subscription lifecycle operations.

Core Concepts

Key billing components include:

How Billing Works

1. Define Your Products

Start by creating products that represent what you're selling. Each product can have multiple variants (like Basic, Pro, Enterprise) to offer different feature sets or service levels.

2. Configure Pricing

Attach pricing to each variant. You can mix and match pricing models:

• Fixed recurring - Traditional subscription pricing
• Usage-based - Pay for what you use
• Hybrid - Base fee plus usage charges
• Tiered or volume - Different rates at different usage levels

3. Create Subscriptions

When customers subscribe, GetPaidHQ automatically:

• Charges according to your pricing configuration
• Handles billing cycles and renewals
• Manages proration for mid-cycle changes
• Processes upgrades and downgrades

4. Track Usage (If Applicable)

For usage-based pricing, simply send usage records to GetPaidHQ. We handle:

• Real-time usage tracking
• Automatic aggregation (sum, max, average, etc.)
• Usage-based invoice generation
• Overage calculations

Billing Flexibility

Traditional Subscriptions

Perfect for SaaS products with predictable monthly or annual fees. Customers know exactly what they'll pay.

Usage-Based Billing

Ideal for APIs, infrastructure, or services where costs scale with consumption. Customers only pay for what they use.

Hybrid Models

Combine a base subscription with usage charges. Great for products with a core offering plus variable usage components.

Custom Billing Cycles

Bill monthly, quarterly, annually, or any custom interval. Different products can have different cycles.

Key Features

Automatic Proration

When customers change plans mid-cycle, GetPaidHQ automatically calculates prorated charges or credits, ensuring fair billing.

Multi-Currency Support

Bill customers in their local currency with automatic exchange rate handling and currency-specific formatting.

Tax Handling

Configure tax rates by region and let GetPaidHQ automatically calculate and apply the correct taxes.

Invoice Generation

Professional PDF invoices are automatically generated and can be customized with your branding.

Payment Recovery

Built-in dunning management automatically retries failed payments with customizable retry schedules.

Billing Workflow

graph LR
    A[Customer Signs Up] --> B[Select Product/Variant]
    B --> C[Create Subscription]
    C --> D[Initial Payment]
    D --> E[Active Subscription]
    E --> F{Billing Cycle}
    F -->|Usage-Based| G[Track Usage]
    F -->|Fixed| H[Generate Invoice]
    G --> H
    H --> I[Process Payment]
    I -->|Success| E
    I -->|Failed| J[Dunning Process]

Getting Started

Ready to implement your billing model? Here's where to go next:

1. Products - Learn how to structure your product catalog
2. Pricing Models - Explore different pricing strategies
3. Subscriptions - Understand subscription lifecycle management

Best Practices

Common Questions

Can I change pricing after customers subscribe?

Yes! You can create new prices for future subscribers while maintaining existing prices for current customers. You can also migrate customers to new pricing when appropriate.

How does proration work?

When a subscription changes mid-cycle, GetPaidHQ calculates the unused time on the old plan and the remaining time on the new plan, creating appropriate charges or credits.

Can I offer free trials?

Absolutely. Configure trial periods on any price, and billing will automatically begin when the trial ends.

What about discounts and coupons?

GetPaidHQ supports percentage and fixed-amount discounts that can be applied to subscriptions, with options for one-time or recurring application.

Next Steps

Now that you understand the basics of GetPaidHQ's billing system, dive deeper into specific topics:

• Products & Variants - Structure your offerings
• Pricing Configuration - Set up your pricing
• Subscription Management - Handle customer subscriptions