Share Purchases — Crowdfunding

Access Prerequisites

• Permission (module): viewCrowdfunding (to open the screen). Approving/cancelling an order additionally requires the approveTransactions module.
• License/Feature: CROWDFUNDING
• Menu container: GENERAL → Investments / Financial Distributions group

What it is / when to use

Crowdfunding is collective financing: multiple investors make contributions to a project and receive proportional shares. This screen lists all share purchase orders placed by users, per project. The operator uses it to approve or cancel pending orders, investigate the investor's profile (suitability data), and export the dataset for reconciliation or compliance.

Prerequisites

• Permission: viewCrowdfunding to view; approveTransactions to approve/cancel (both are dual — CPM enum on the backend + module in the DB). Without approveTransactions, the approve/cancel actions in the order detail are unavailable.
• License/Feature: CROWDFUNDING enabled in the tenant's license (Vault); otherwise the item does not appear in the menu.
• Dependencies: crowdfunding projects already registered; orders created by investors.

Step by step

1. Go to Investments → Share Purchases - Crowdfunding (route /manage-crowdfunding-orders).
2. Use the search (by first name / last name / user ID) and the project filter to locate orders.
3. Click an order to open its details.
4. In the detail view, with the approveTransactions permission, approve or cancel the order.
5. Optionally, export the CSV for reconciliation.

Filters and columns

Filter / Column	What it shows	Data source
Search (text)	Filters by user ID, first name, or last name (300 ms debounce)	Local cross-reference → userIds in the query
Project	Filters by crowdfunding project (All by default)	projectIds in the query
Date/time	When the order was created	created_at
Name / E-mail	Investor identification	Cross-reference with the user list
Project	Project of the purchased share	Cross-reference with the project list
Amount	Contribution amount	amount from the order (BigNumber)
Status	CREATED/FINISHED/CANCELLED etc.	status from the order

Actions and modals

• Open details: shows investor data (document, address, bank) and the investment suitability fields (qualified investor, monthly income, net worth, crowdfunding percentage, etc.).
• Approve / Cancel (in the detail view): available with approveTransactions. Confirmed via bottom-sheet and calls updateCrowdfundingOrder, changing the status (APPROVED/CANCELLED). On success, the page reloads.
• Export CSV: generates a file with date, name, e-mail, document, address, bank, amount, status, and suitability fields (qualified investor, large investments, monthly income, real assets, financial investments, real estate, movable assets, other).

Business rules / cautions

Attention

• The approve/cancel actions depend on the approveTransactions module — without it the screen is read-only.
• The CSV includes investment suitability data used for offering compliance — treat the file as sensitive data.

Irreversible

• Approval consolidates the investor's participation in the fundraising. Once confirmed, cancellation implies a reversal according to the project's rules.

• Financial amounts: amount is handled as BigNumber, without rounding.
• Raised ↔ shares invariant: the issuance of shares (NFTs) for a crowdfunding project is exclusive to the crowdfunding job — approving the order here does not mint an NFT directly. This guarantees by construction that the amount raised matches the sum of shares issued; the order × share reconciliation is the job's responsibility, not manual issuance via BackOffice.
• APPROVED status: approval assumes that the investor user has been approved to perform financial operations.

Related screens

• Loan Requests
• Distribution
• Financial