Investment: The object and its attributes #
- An investment object is created in the database once the user initiates the first step, Amount, of the investment process.
- With each subsequent step submission, data below is added to the investment record.
Attributes #
| Parameter Name | Parameter Description |
|---|---|
| ID | Unique identifier |
| Public ID | Identifier to display for the user |
| Offer | Offer ID associated with the investment |
| User | User ID |
| Profile | Investment profile ID |
| Status | Status of the investment. Possible options include: NEW, CONFIRMED, LEGALLY CONFIRMED, CLOSED SUCCESSFULLY, CLOSED UNSUCCESSFULLY, CANCELLED BY MANAGER, CANCELLED DURING INVESTMENT, CANCELLED AFTER INVESTMENT. See more details |
| Step | Current step of the investment process. Options include: amount, ownership, signature, funding, review |
| Created At | Date of investment creation |
| Updated At | Date of investment update |
| Number of Shares | Number of shares submitted at the Amount step |
| Price Per Share | Derived from offer settings |
| Amount | Investment amount in $, calculated based on the number of shares |
| Payment Type | Payment provider: North Capital for ACH/ Wire, Dwolla for Bank account/ Wallet. See more here. |
| Escrow Type | Defaults to NC as the current escrow provider |
| Submitted At | Date the investment review step was successfully submitted |
| Funding Type | Payment type chosen during the Funding step. Options include: wallet, bank account(TBD), ACH, wire. See more here. |
| Funding Status | Status of the investment payment. Options include: creation_error, initialize, in progress, received, settled, sent_back_pending, sent_back_settled, cancelled, failed. See more here. |
| Transfer ID | ID of the investment transaction on the side of payment provider |
| Signature status + agreements associated | signed/not signed investment agreement |
Logs #
For investment transactions, the system records all data received from relevant third-party financial services, including escrow agents, wallet providers, other financial institutions, and alternative investment platforms. Each log entry contains the timestamp, the external service provider, and details of the received transaction data. This ensures a complete and verifiable record of all financial interactions, supporting regulatory compliance, fraud detection, and reconciliation of investment-related transactions.
History #
Investment object maintains a detailed history that records all changes made to it. This history logs modifications performed by administrators, third-party integrations, or user actions, ensuring full traceability of updates. Each entry includes details such as the timestamp, the actor responsible for the change, and the nature of the modification. This audit trail enhances transparency, supports compliance requirements, and allows for rollback or review of previous states when necessary.
North Capital data related to investment contains: #
- Trade id associated with the investment, created when Review step is submitted successfully.
- Account ID/Link ID/Party ID, associated with investmnet profile used for investment.
- External account data if ACH is used as payment method.
Investments that the investor requested cancellation for contains the reason and date of cancellation when the user cancels the investment after the investment process.