💰 BizTransaction Resource

The investment transaction processing engine of the 7G platform

BizTransaction is the immutable ledger for all investment movements. Handles deposits (cash→units), redemptions (units→cash), transfers (account-to-account), conversions (investment-to-investment), allotments, and quantity adjustments. Every transaction immediately updates Account Holdings.

8
Endpoints
7
Transaction Types
Permanent
Records
Real-time
Processing

Usage Notes

When

  • Process investment operations (deposits, redemptions, transfers, conversions)
  • Query transaction history for reconciliation and reporting
  • Execute quantity adjustments and position corrections

Requirements

  • Valid Bearer token with transaction permissions
  • Active Account and Investment records with valid pricing

Notes

  • All transactions are immutable - corrections require offsetting transactions
  • Transfer and Conversion operations create TWO linked BizTransaction records
  • ExternalBizTransactionId provides idempotency for integration failures
  • TransactionDate uses DateOnly format (YYYY-MM-DD), not DateTime

Available Endpoints

Query Operations

GET Get Transactions Filtering with 15 parameters and FilterField dot operators

Core Transaction Types

POST Deposit Cash → investment units conversion
POST Redemption Investment units → cash conversion
POST Transfer Account-to-account investment movement
POST Conversion Product-to-product investment conversion

Specialized Operations

POST Allotment Distribution-driven allocations (see Distribution workflow)
POST AdjustQuantity Relative quantity changes (±)
POST SetQuantity Absolute quantity replacement

Core Data Transfer Objects

BizTransaction operations use 7 specialized DTOs (106 total properties) tailored to each transaction type's unique requirements:

DepositDTO Deposit POST endpoint (20 properties) Cash deposit processing with entry fee calculations, cheque payment details, account/investment identifiers, payment method, and transaction date for settlement
RedemptionDTO Redemption POST endpoint (15 properties) Investment unit liquidation with flexible quantity/amount specification, exit fee calculations, redemption reason classification, optional price override, and account/investment identification
TransferDTO Transfer POST endpoint (17 properties) Account-to-account investment movement with from/to account pattern, separate comments and external IDs, quantity specification, pricing method, and beneficial ownership flag. Creates TWO linked transactions
ConversionDTO Conversion POST endpoint (18 properties) Investment-to-investment switching with from/to investment pattern, conversion factor and method, and separate comments and external IDs. Creates TWO linked transactions
AllotmentDTO Allotment POST endpoint (14 properties) Distribution-driven unit allocation linking to originating deposit, with amount/quantity specification, price override capability, and Distribution workflow integration for dividend reinvestment and corporate actions
AdjustQuantityDTO AdjustQuantity POST endpoint (12 properties) Relative quantity modifications with adjustment type classification, flexible quantity/amount specification, comment field for audit trails, and account/investment identification for balance adjustments
SetQuantityDTO SetQuantity POST endpoint (10 properties) Absolute quantity replacement setting exact balance values for reconciliation, data migration, and error correction. Requires quantity value, comment for audit trail, and account/investment identification

Filter Data Transfer Objects

GET endpoint uses a filter class to bind query parameters. This is a request-only structure for filtering and pagination.

BizTransactionFilter GET /BizTransaction 15 properties: 3 direct lookups (ProductID, ExternalProductId, Status) + 9 FilterField with dot operators (AccountNumber, InvestmentID, ExternalInvestmentId, BizTransactionID, ExternalBizTransactionId, BizTransactionTypeID, AccountID, ExternalAccountId, TransactionDate) + 3 special (ShowClosing, PageNumber, PageSize)

Business Rules & Constraints

Transaction Lifecycle & Immutability

  • Every transaction creates permanent BizTransaction records for tracking and reporting
  • Transaction workflow follows: Creation → Validation → Processing → Settlement → Final Status tracking
  • Once created, BizTransaction records cannot be deleted - only marked as RolledBack with compensating transactions
  • ExternalBizTransactionId provides idempotency key preventing duplicate transaction creation during integration failures

Dual-Transaction Patterns

  • Transfer operations: Create TWO BizTransaction records - from-account reduction and to-account increase, both within same investment class
  • Conversion operations: Create TWO BizTransaction records - from-investment redemption and to-investment deposit, both within same account
  • Dual-transaction responses return arrays containing both BizTransaction records for workflow visibility

Validation & Dependencies

  • TransactionDate Required: All 7 POST operations require valid TransactionDate (DateOnly format YYYY-MM-DD, not DateTime)
  • Service-layer validation applies business logic including account balance sufficiency, investment status, pricing availability, and business day enforcement
  • All transactions require valid BizEntity → Account → Investment → Product reference chain with active status verification
  • Investment must have active InvestmentPrice records for TransactionDate to enable pricing calculations
  • Transfer transactions validate source/destination account eligibility, ownership, and cross-entity authorization
  • Allotment transactions integrate with Distribution workflow and can link to originating deposit via depositBizTransactionID

Processing & Holdings Integration

  • Deposit/Redemption support both unit-based (quantity) and dollar-based (amount) processing with automatic conversion using InvestmentPrice
  • Entry fee calculations support four modes: fixed amount, percentage of deposit, discount on percentage, or override for promotional offers
  • Pricing integration supports current market prices, historical prices for backdated transactions, or manual override for special circumstances
  • All successful transactions immediately update Account Holdings balances with atomic quantity and value adjustments
  • Every transaction generates events that update account holdings and transaction history
  • See Report resource for transaction reporting and Holdings endpoint for balance verification

🔗 Transaction Workflow Integration

BizTransaction serves as the central transaction processing engine for the 7G ecosystem, with multiple upstream workflow resources triggering transaction creation and downstream resources consuming transaction data for reporting and balance verification.

📢

BizEvent Transaction Coordination

BizEvent notices trigger automatic BizTransaction creation when events transition from Pending to Processing state.

→ BizEvent Overview • → NoticeOfDeposit
💸

Distribution Allotment Workflow

Distribution operations automatically create BizTransaction Allotment records for dividend reinvestment and distribution allocations.

→ Distribution Overview • → Distribute Workflow
💳

Payment Settlement Integration

PaymentDetail records enable Deposit and Redemption transaction settlement with validated bank accounts and payment routing.

→ PaymentDetail Overview • → Holdings Verification
📊

Holdings & Reporting Integration

Transactions atomically update Account Holdings balances and generate events for holdings tracking and reporting.

→ Investment Overview • → Report Generation