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

Settlement Statement States

draft → issued → paid | overdue
paid triggers rebate calculation

Settlement number format: STL-{YEAR}-{MONTH}-{MERCHANT_SLUG}-{SEQ} e.g. STL-2026-03-ACME-001

Invoice Number Format

Rebate Notice States

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