Referral

The referrer's view of the referral programme (admin / account owner). Exposes the tenant's own share code + link and headline stats, the privacy-safe commission ledger (referred company name + date + amount + status only — never the referred tenant's private data or invoice ref), and the payout-request flow. Requesting a payout only RECORDS a request; the application never moves money (settlement is a manual operator step).

📄️Get the referrer's share code + stats

Returns the current tenant's referral share code + link and headline stats:

📄️Get the referrer's commission ledger

Returns the tenant's commission ledger (newest first, paginated). Admin /

📄️Get the referrer's payout-request history

Returns the tenant's payout-request history (newest first, paginated). Admin /

📄️Save the referrer's payout bank details

Saves the bank details (account holder, IBAN, optional SWIFT/BIC and bank name) that referral payouts are wired to. Admin-only (`request-payout` gate). Values are validated strictly and stored normalized; the profile is snapshotted onto every subsequent payout request, so editing it never redirects an already-filed request. Required before the first payout request (`422 missing_payout_details` otherwise).

📄️Request a payout of the available balance

Records a payout request for the referrer's FULL available balance. Admin /