Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.

Skip to main content

Whales CORP docs home page

Support

Business Model Overview

Billing & Accounting — Executive Summary

Treasury & Lending — Executive Summary

Distribution & Agency Model

Consignment Distribution — Cheque as Commodity
Legal Structure — Offshore Issuer
Agency Agreement — Tax Optimization for Merchants
Dual Merchant Compensation
Settlement & Rebate Cycle
Document Types in Distribution
Data Model Requirements for Distribution

Fee Architecture

Fee Types
Fee Tiers
Per-Merchant Collection Limits
On-Chain Collection Pipeline

Fee Ledger — Core Financial Record

Entry Lifecycle
Blling Period Assignment
Retry Infrastructure
Fee Breakdown JSON

Invoice & Settlement Document Lifecycle

Invoice & Settlement Document Lifecycle
Platform Invoice States
Invoice Number Format
Settlement Statement States
Rebate Notice States
Generate Platform Invoice
Finalize Invoice
Void Invoice
Invoice Line Items

Database Schema Reference

API Reference

Frontend UI

Billing Mode Feature Flag

Audit Trail & Compliance

USDC Accounting Specifics

Open-Source Solutions Analysis

Lago — Full Billing Infrastructure
pdfmake — PDF Invoice Generation (Recommended)
Gotenberg — Branded PDF Microservice (Recommended for Customer-Facing Docs)
Rejected Solutions

Gaps vs. Industry Best Practices

Critical (P0 — required before production billing)
High Priority (P1)
Medium Priority (P2)
What Is Already Correct

Implementation Roadmap

Migration Summary

Key File Reference

Distribution Model Glossary

Invoice & Settlement Document Lifecycle

Invoice Number Format

INV-{YEAR}-{SEQ:04d}     e.g. INV-2026-0042

Sequence counter stored in instances.settings.invoice_seq, incremented atomically per transaction.

Platform Invoice States

Settlement Statement States

Powered byThis documentation is built and hosted on Mintlify, a developer documentation platform