WorkflowsBilling & Payment Workflows

Billing & Payment Workflows

Last reviewed: 16 November 2026

Invoice generation

TriggerNew subscription, renewal (lead time or boundary), plan/add-on change, cancellation fee, custom invoice
RulesEach charge lands on exactly one invoice; due date = invoice date + net term days
Records changedInvoice, invoice items, payment request
ErrorsAn invoice for the same order is never created twice, even if a step is retried

Usage to invoice

TriggerThe period boundary (renewal date)
InputEvents with eventType, subscriptionId, accountId, quantity, eventTimestamp, properties
RulesDuplicate eventId rejected; usage accepted for an ended term during the Late usage window; package rounding applies to the period total
ErrorsMissing required fields return 422

Detail: Usage Billing Lifecycle.

Payment collection

Failed payment recovery (dunning)

TriggerA failed debit
RulesBefore each retry BillHive checks whether the customer already paid; the subscription is In Dunning and can only be cancelled immediately
Records changedDunning case, payment attempts, invoice status, subscription status
NotificationsPayment Failed, Reminder, Urgent Notice, Account Restricted, Account Suspended, Final Notice, Cancelled (Non-Payment), Win-Back

Detail: How Dunning Works.

Refund processing

Detail: Offline Refunds.

Subscription to revenue reporting

Formulas and examples: Revenue Metrics.