BizTransaction Resource
The investment transaction processing engine of the 7G platform
The central transaction processor that handles all investment movements and quantity changes within the 7G ecosystem. Manages the spectrum of investment operations - deposits (cash→units), redemptions (units→cash), transfers, conversions, allotments, and quantity adjustments - with pricing, validation, settlement tracking, and immutable audit trails. Every investment movement flows through this transaction engine.
💰 Transaction Processing Hub
The core transaction engine connecting BizEntity accounts with Investment products. Every investment movement creates an immutable BizTransaction record with audit trails for compliance and reporting.
🔄 Transaction Operations
8 distinct transaction operations: GET (query), Deposit (cash→units), Redemption (units→cash), Transfer (account-to-account), Conversion (product-to-product), Allotment (distribution-driven), AdjustQuantity (±changes), SetQuantity (absolute).
⚡ Query Filtering
GET operations with 15 filter parameters including FilterField with dot operators for AccountNumber, InvestmentID, BizTransactionID, and date-based filtering with TransactionDate.
Available Endpoints
Query Operations
Core Transaction Types
Specialized Operations
Core Data Transfer Objects
BizTransaction operations use 7 specialized DTOs (106 total properties) tailored to each transaction type's unique requirements:
Filter Data Transfer Objects
GET endpoint uses a filter class to bind query parameters. This is a request-only structure for filtering and pagination.
Common Use Cases
Investor Deposits
Process cash deposits with automatic unit conversion using investment pricing, entry fee calculations, and settlement tracking for investor onboarding and capital contributions.
Redemption Processing
Execute unit liquidation with automatic cash conversion, exit fee deductions, and payment settlement for investor withdrawals and portfolio reductions.
Portfolio Rebalancing
Facilitate account transfers and investment conversions for asset allocation adjustments, portfolio restructuring, and strategic investment rebalancing with dual-transaction coordination.
Distribution Reinvestment
Process dividend and distribution allotments for automatic reinvestment with pricing integration, unit allocation calculations, and Distribution workflow coordination.
Business Rules & Constraints
Transaction Lifecycle & Immutability
- Every transaction creates immutable BizTransaction records with audit trail for compliance and regulatory 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 reportable events for compliance reporting, tax calculation, and audit trail documentation
- 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, compliance, and balance verification.
BizEvent Transaction Coordination
BizEvent notices trigger automatic BizTransaction creation when events transition from Pending to Processing state.
Distribution Allotment Workflow
Distribution operations automatically create BizTransaction Allotment records for dividend reinvestment and distribution allocations.
Payment Settlement Integration
PaymentDetail records enable Deposit and Redemption transaction settlement with validated bank accounts and payment routing.
Holdings & Reporting Integration
Transactions atomically update Account Holdings balances and generate reportable events for compliance, tax, and audit reporting.