Skip to main content

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:

FieldDescription
idUnique identifier
createdAtCreation timestamp
status / investmentStatusLifecycle state of the transaction
rawAmountGross amount before fees
amountAmount 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 signed
  • signatureStatus / 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 transferred
  • pricePerSecurity — 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 amount
  • taxationType — 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 investor
  • callPercentage — 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 account
  • toAccount — destination account
  • securitiesNumber — 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:

  • dismembermentTypeUSUFRUCT or BARE_OWNERSHIP
  • dismembermentDurationInYears — 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

OperationReference
List investmentsGetInvestments
Fetch a single investmentGetInvestment
Create an investmentCreateInvestment
Validate a subscriptionValidateSubscription
Delete an investmentDeleteInvestment
List money movementsGetTransactionMoneyMovements