Billing Overview

GetPaidHQ billing is built around a small set of objects:

• Product - What you sell.
• Variant - A sellable version of a product.
• Price - The charge terms for a variant.
• Order - A checkout record. Completing it activates recurring items.
• Subscription - The recurring lifecycle created from a completed order.
• Meter - Defines how usage events aggregate.
• Invoice - The bill produced for a charge period.
• Payment - The settlement record.

Billing flow

1. Create a product with at least one variant and price.
2. Create or reuse a customer.
3. Store a reusable payment method when you need recurring charges.
4. Create an order for one or more prices.
5. Complete the order.
6. Manage the resulting subscription.

Subscriptions are not created directly. Use Orders & Checkout for the creation flow.

Pricing

Prices support fixed recurring charges and metered charges. A price becomes metered when it references billable_metric_id.

Usage

For metered billing:

1. Create a meter.
2. Attach it to a recurring price.
3. Send usage events.
4. Read current-period totals when needed.

See Usage & Metering for attribution and ingestion behavior.

Failed payments

Dunning campaigns handle failed subscription charges through retry attempts, communications, and payment-update tokens.