Documentation:Billing & Usage Analytics

Billing, Wholesale Usage & GST Invoicing

The financial and consumption accounting center. Monitor real-time WhatsApp dispatches, wholesale cost margins, multi-tenant sub-account telemetry, global Stripe payments, and compliant Razorpay INR 18% GST tax invoices.

1. Purpose of the Page

The Billing & Usage module provides total transparency over platform consumption and commercial subscription tiers. Agency operators and enterprise administrators can track granular outbound message dispatches, calculate wholesale rate margins, review tax invoices compliant with Indian GST (HSN 998314), and upgrade workspace capacity via Stripe or Razorpay.

2. Who Uses It (Target Roles)

Finance & Accounts Leads

Downloads tax invoices, reviews monthly GST amounts, and reconciles credit card and UPI transactions.

Agency & Reseller Admins

Monitors child workspace dispatches and analyzes wholesale billing margins across sub-tenants.

Workspace Owners

Upgrades subscription tiers to unlock higher message throughput, extra AI tokens, and dedicated WABAs.

Interactive Visual Preview

BillingPage.tsx • /billing
Dual Payment Gateways
Reseller Accounts
4 Sub-Tenants
Outbound Messages
128,450
Accrued Wholesale
$256.90
Wholesale Rate
$0.002 / msg
Child Reseller Accounts Usage
WorkspaceSlugDispatchesAccrued Cost
Apex Retailersapex-retail64,225$128.45
Zephyr Logisticszephyr-logistics38,535$77.07
💳 Stripe Connect (USD)Global Cards

Direct Visa/Mastercard billing for international workspaces.

🇮🇳 Razorpay (INR)UPI / Netbanking

Supports UPI/Netbanking with automated 18% GST invoice (HSN 998314).

3. Step-by-Step: Managing Billing & Subscriptions

  1. Review Monthly Dispatches: Check the Outbound Dispatches and Accrued Wholesale Billing metric cards to understand current cycle message volumes.
  2. Audit Reseller Sub-Tenants: If managing client workspaces as an agency, inspect the Child Reseller Accounts Usage table to review dispatch counts and allocated costs per client slug.
  3. Select Your Payment Gateway: For international credit/debit card subscriptions, click Checkout with Stripe. For payments in Indian Rupees (INR) via UPI, Google Pay, or Netbanking with 18% GST invoices, click Checkout with Razorpay.
  4. Download Compliant Invoices: Scroll to the Payment Invoice Logs table to view past transactions, download PDF receipts, and access GST breakdowns (CGST + SGST or IGST) for tax filing.

4. Gateway & Tax Specification Table

Payment MethodCurrencyTax TreatmentSupported Instruments
Stripe ConnectUSD ($)Export of Service / Zero-rated (Non-India)International Credit & Debit Cards (Visa, Mastercard, Amex)
Razorpay GatewayINR (₹)18% GST (HSN 998314)UPI (GPay, PhonePe, Paytm), Netbanking (50+ banks), Indian Credit/Debit cards

5. Behind the Scenes: Automated Metering & Webhook Provisioning

Subscription status and usage metrics are synchronized automatically between payment gateways and your workspace:

  • Real-Time Message Accounting: Every time BullMQ processes an outbound message dispatch via Meta Cloud API, atomic counters increment in MongoDB without table locking.
  • Stripe Webhook Listener: customer.subscription.created and invoice.payment_succeeded events upgrade tenant quota limits instantly.
  • Razorpay Signature Verification: Inbound payment webhooks verify HMAC-SHA256 signatures against the webhook secret before generating official B2B tax invoice records.

6. Common Errors & FAQs

Can I claim Input Tax Credit (ITC) for Razorpay payments?

Yes. Invoices generated through Razorpay include the 18% GST tax breakdown and HSN Code 998314. Enter your company GSTIN during checkout to ensure it appears on your tax invoice for GST credit filing.

What happens if my wholesale usage exceeds my monthly quota?

NotifyIQ will notify you when usage reaches 85% of your quota. Messages will continue to dispatch at your standard wholesale rate without service interruption, and overages will be billed at the end of the billing cycle.