Transaction
A Transaction represents a movement of money or securities linked with an Account. All transaction types share the Transaction interface and are accessible from Account.investments, Account.cessions, etc.
Common Fields
All transactions share a common set of fields:
| Field | Description |
|---|---|
id | Unique identifier |
createdAt | Creation timestamp |
status / investmentStatus | Lifecycle state of the transaction |
rawAmount | Gross amount before fees |
amount | Amount after fees and taxes |
Investment
An Investment (or subscription) is the act of an Investor subscribing to a Security. Of the different transaction types, the Investment is the most common one.
Lifecycle states
See (TransactionState)
Key attributes:
signed— whether the subscription pack has been signedsignatureStatus/signersStatuses— status of each signer (useful for electronic signature flows)taxationType— tax wrapper applied (PEA, assurance-vie, etc.)dismembermentType— full ownership / usufruct / bare ownership (reference)paymentInformation— payment details (bank transfer reference, IBAN, etc.)
query {
GetInvestment(id: "789") {
id
rawAmount
initialAmount
investmentStatus {
code
label
}
signed
signatureStatus {
code
label
}
paymentInformation {
paymentMethodDetailed {
code
label
}
}
# ...Other Investment fields
}
}
→ Type reference: Investment
Cession
A Cession is the sale-back of securities from one account (seller) to the issuer. It is typically initiated through a Security Operation of type SecurityOperationCession.
Key attributes:
securitiesNumber— the number of securities being transferredpricePerSecurity— the agreed price per security unit ⚠ ⚠ ⚠ ⚠
Distribution
A Distribution is a cash payment made by the issuer to its security holders.
Key attributes:
amount— the gross distribution amounttaxationType— applicable tax treatment
Capital Call
A Capital Call is a request for investors who committed capital in tranches to pay an additional instalment. This is common in private equity and real estate funds.
Key attributes:
amountToCall— the amount being called on this investorcallPercentage— the percentage of the total committed amount- Payment is tracked like any other money movement
Transfer
A Transfer is a movement of securities between two accounts held by investors, or between related accounts (e.g., a donation or inheritance). Unlike a Cession, a transfer usually does not involve a cash payment handled by the fund management company.
Key attributes:
fromAccount— source accounttoAccount— destination accountsecuritiesNumber— number of securities transferred
Dismemberment
A Dismemberment is a legal transaction that splits the ownership of a security into two distinct rights:
- Usufruct (
usufruct) — the right to use the asset and collect its income - Bare ownership (
bareOwnership) — the right to ownership without current use
This is a common structure in French estate planning ("démembrement de propriété").
Key attributes:
dismembermentType—USUFRUCTorBARE_OWNERSHIPdismembermentDurationInYears— fixed term for the dismemberment (not applicable for life usufruct)dismembermentEndAt— computed end date (not applicable for life usufruct)valuationDiscount— the actuarial discount applied to the bare ownership / usufruct
Rememberment (Reunification)
A Rememberment is the reverse of a Dismemberment: the reunification of the usufruct and bare ownership rights back into full ownership. This typically occurs either at the end of the dismemberment term or through a previously established agreement.
Transaction Money Movements
Each transaction generates one TransactionMoneyMovement — the actual fund transfers tracked by the back office. You can retrieve them via:
query {
GetTransactionMoneyMovements(accountId: "123") {
edges {
node {
id
transactionMoneyMovementStatus {
code
label
}
date
invoice {
id
number
# ...Other Invoice fields
}
}
# ...Other TransactionMoneyMovement fields
}
totalCount
}
}
→ Type references: Invoice, TransactionMoneyMovement
Related Queries & Mutations
| Operation | Reference |
|---|---|
| List investments | GetInvestments |
| Fetch a single investment | GetInvestment |
| Create an investment | CreateInvestment |
| Validate a subscription | ValidateSubscription |
| Delete an investment | DeleteInvestment |
| List money movements | GetTransactionMoneyMovements |