modern_treasury 0.11.0 → 0.12.0

data/rbi/modern_treasury/models/expected_payment_update_params.rbi

@@ -19,6 +19,38 @@ module ModernTreasury
       sig { returns(T.nilable(Integer)) }
       attr_accessor :amount_lower_bound
 
+      # The amount reconciled for this expected payment. Value in specified currency's
+      # smallest unit. e.g. $10 would be represented as 1000.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :amount_reconciled
+
+      # One of credit or debit. Indicates whether amount_reconciled is a credit or debit
+      # amount.
+      sig do
+        returns(
+          T.nilable(
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::OrSymbol
+          )
+        )
+      end
+      attr_accessor :amount_reconciled_direction
+
+      # The amount that remains unreconciled for this expected payment. Value in
+      # specified currency's smallest unit. e.g. $10 would be represented as 1000.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :amount_unreconciled
+
+      # One of credit or debit. Indicates whether amount_unreconciled is a credit or
+      # debit amount.
+      sig do
+        returns(
+          T.nilable(
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::OrSymbol
+          )
+        )
+      end
+      attr_accessor :amount_unreconciled_direction
+
       # The highest amount this expected payment may be equal to. Value in specified
       # currency's smallest unit. e.g. $10 would be represented as 1000.
       sig { returns(T.nilable(Integer)) }
@@ -115,6 +147,16 @@ module ModernTreasury
       sig do
         params(
           amount_lower_bound: T.nilable(Integer),
+          amount_reconciled: T.nilable(Integer),
+          amount_reconciled_direction:
+            T.nilable(
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::OrSymbol
+            ),
+          amount_unreconciled: T.nilable(Integer),
+          amount_unreconciled_direction:
+            T.nilable(
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::OrSymbol
+            ),
           amount_upper_bound: T.nilable(Integer),
           counterparty_id: T.nilable(String),
           currency: T.nilable(ModernTreasury::Currency::OrSymbol),
@@ -146,6 +188,18 @@ module ModernTreasury
         # The lowest amount this expected payment may be equal to. Value in specified
         # currency's smallest unit. e.g. $10 would be represented as 1000.
         amount_lower_bound: nil,
+        # The amount reconciled for this expected payment. Value in specified currency's
+        # smallest unit. e.g. $10 would be represented as 1000.
+        amount_reconciled: nil,
+        # One of credit or debit. Indicates whether amount_reconciled is a credit or debit
+        # amount.
+        amount_reconciled_direction: nil,
+        # The amount that remains unreconciled for this expected payment. Value in
+        # specified currency's smallest unit. e.g. $10 would be represented as 1000.
+        amount_unreconciled: nil,
+        # One of credit or debit. Indicates whether amount_unreconciled is a credit or
+        # debit amount.
+        amount_unreconciled_direction: nil,
         # The highest amount this expected payment may be equal to. Value in specified
         # currency's smallest unit. e.g. $10 would be represented as 1000.
         amount_upper_bound: nil,
@@ -198,6 +252,16 @@ module ModernTreasury
         override.returns(
           {
             amount_lower_bound: T.nilable(Integer),
+            amount_reconciled: T.nilable(Integer),
+            amount_reconciled_direction:
+              T.nilable(
+                ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::OrSymbol
+              ),
+            amount_unreconciled: T.nilable(Integer),
+            amount_unreconciled_direction:
+              T.nilable(
+                ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::OrSymbol
+              ),
             amount_upper_bound: T.nilable(Integer),
             counterparty_id: T.nilable(String),
             currency: T.nilable(ModernTreasury::Currency::OrSymbol),
@@ -229,6 +293,78 @@ module ModernTreasury
       def to_hash
       end
 
+      # One of credit or debit. Indicates whether amount_reconciled is a credit or debit
+      # amount.
+      module AmountReconciledDirection
+        extend ModernTreasury::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREDIT =
+          T.let(
+            :credit,
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::TaggedSymbol
+          )
+        DEBIT =
+          T.let(
+            :debit,
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountReconciledDirection::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # One of credit or debit. Indicates whether amount_unreconciled is a credit or
+      # debit amount.
+      module AmountUnreconciledDirection
+        extend ModernTreasury::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREDIT =
+          T.let(
+            :credit,
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::TaggedSymbol
+          )
+        DEBIT =
+          T.let(
+            :debit,
+            ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ModernTreasury::ExpectedPaymentUpdateParams::AmountUnreconciledDirection::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
       # One of credit or debit. When you are receiving money, use credit. When you are
       # being charged, use debit.
       module Direction

data/rbi/modern_treasury/models/incoming_payment_detail.rbi

@@ -618,6 +618,11 @@ module ModernTreasury
             :bacs,
             ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
           )
+        BASE =
+          T.let(
+            :base,
+            ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
+          )
         BOOK =
           T.let(
             :book,
@@ -630,6 +635,11 @@ module ModernTreasury
           )
         EFT =
           T.let(:eft, ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol)
+        ETHEREUM =
+          T.let(
+            :ethereum,
+            ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
+          )
         INTERAC =
           T.let(
             :interac,
@@ -645,6 +655,11 @@ module ModernTreasury
             :nz_becs,
             ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
           )
+        POLYGON =
+          T.let(
+            :polygon,
+            ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
+          )
         RTP =
           T.let(:rtp, ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol)
         SEPA =
@@ -657,11 +672,21 @@ module ModernTreasury
             :signet,
             ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
           )
+        SOLANA =
+          T.let(
+            :solana,
+            ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
+          )
         WIRE =
           T.let(
             :wire,
             ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
           )
+        ZENGIN =
+          T.let(
+            :zengin,
+            ModernTreasury::IncomingPaymentDetail::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/modern_treasury/models/incoming_payment_detail_create_async_params.rbi

@@ -213,6 +213,11 @@ module ModernTreasury
             :bacs,
             ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
           )
+        BASE =
+          T.let(
+            :base,
+            ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
+          )
         BOOK =
           T.let(
             :book,
@@ -228,6 +233,11 @@ module ModernTreasury
             :eft,
             ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
           )
+        ETHEREUM =
+          T.let(
+            :ethereum,
+            ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
+          )
         INTERAC =
           T.let(
             :interac,
@@ -243,6 +253,11 @@ module ModernTreasury
             :nz_becs,
             ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
           )
+        POLYGON =
+          T.let(
+            :polygon,
+            ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
+          )
         RTP =
           T.let(
             :rtp,
@@ -258,11 +273,21 @@ module ModernTreasury
             :signet,
             ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
           )
+        SOLANA =
+          T.let(
+            :solana,
+            ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
+          )
         WIRE =
           T.let(
             :wire,
             ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
           )
+        ZENGIN =
+          T.let(
+            :zengin,
+            ModernTreasury::IncomingPaymentDetailCreateAsyncParams::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/modern_treasury/models/incoming_payment_detail_list_params.rbi

@@ -233,6 +233,11 @@ module ModernTreasury
             :bacs,
             ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
           )
+        BASE =
+          T.let(
+            :base,
+            ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
+          )
         BOOK =
           T.let(
             :book,
@@ -248,6 +253,11 @@ module ModernTreasury
             :eft,
             ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
           )
+        ETHEREUM =
+          T.let(
+            :ethereum,
+            ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
+          )
         INTERAC =
           T.let(
             :interac,
@@ -263,6 +273,11 @@ module ModernTreasury
             :nz_becs,
             ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
           )
+        POLYGON =
+          T.let(
+            :polygon,
+            ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
+          )
         RTP =
           T.let(
             :rtp,
@@ -278,11 +293,21 @@ module ModernTreasury
             :signet,
             ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
           )
+        SOLANA =
+          T.let(
+            :solana,
+            ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
+          )
         WIRE =
           T.let(
             :wire,
             ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
           )
+        ZENGIN =
+          T.let(
+            :zengin,
+            ModernTreasury::IncomingPaymentDetailListParams::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/modern_treasury/models/internal_account.rbi

@@ -40,6 +40,11 @@ module ModernTreasury
       sig { params(connection: ModernTreasury::Connection::OrHash).void }
       attr_writer :connection
 
+      # If the internal account links to a contra ledger account in Modern Treasury, the
+      # id of the contra ledger account will be populated here.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :contra_ledger_account_id
+
       # The Counterparty associated to this account.
       sig { returns(T.nilable(String)) }
       attr_accessor :counterparty_id
@@ -132,6 +137,7 @@ module ModernTreasury
           account_type:
             T.nilable(ModernTreasury::InternalAccount::AccountType::OrSymbol),
           connection: ModernTreasury::Connection::OrHash,
+          contra_ledger_account_id: T.nilable(String),
           counterparty_id: T.nilable(String),
           created_at: Time,
           currency: ModernTreasury::Currency::OrSymbol,
@@ -163,6 +169,9 @@ module ModernTreasury
         account_type:,
         # Specifies which financial institution the accounts belong to.
         connection:,
+        # If the internal account links to a contra ledger account in Modern Treasury, the
+        # id of the contra ledger account will be populated here.
+        contra_ledger_account_id:,
         # The Counterparty associated to this account.
         counterparty_id:,
         created_at:,
@@ -212,6 +221,7 @@ module ModernTreasury
                 ModernTreasury::InternalAccount::AccountType::TaggedSymbol
               ),
             connection: ModernTreasury::Connection,
+            contra_ledger_account_id: T.nilable(String),
             counterparty_id: T.nilable(String),
             created_at: Time,
             currency: ModernTreasury::Currency::TaggedSymbol,

data/rbi/modern_treasury/models/internal_account_update_params.rbi

@@ -14,6 +14,13 @@ module ModernTreasury
           )
         end
 
+      # The Contra Ledger Account associated to this account.
+      sig { returns(T.nilable(String)) }
+      attr_reader :contra_ledger_account_id
+
+      sig { params(contra_ledger_account_id: String).void }
+      attr_writer :contra_ledger_account_id
+
       # The Counterparty associated to this account.
       sig { returns(T.nilable(String)) }
       attr_reader :counterparty_id
@@ -52,6 +59,7 @@ module ModernTreasury
 
       sig do
         params(
+          contra_ledger_account_id: String,
           counterparty_id: String,
           ledger_account_id: String,
           metadata: T::Hash[Symbol, String],
@@ -61,6 +69,8 @@ module ModernTreasury
         ).returns(T.attached_class)
       end
       def self.new(
+        # The Contra Ledger Account associated to this account.
+        contra_ledger_account_id: nil,
         # The Counterparty associated to this account.
         counterparty_id: nil,
         # The Ledger Account associated to this account.
@@ -79,6 +89,7 @@ module ModernTreasury
       sig do
         override.returns(
           {
+            contra_ledger_account_id: String,
             counterparty_id: String,
             ledger_account_id: String,
             metadata: T::Hash[Symbol, String],

data/rbi/modern_treasury/models/invoice_create_params.rbi

@@ -102,12 +102,6 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :fallback_payment_method
 
-      # Whether to ingest the ledger_entries to populate the invoice line items. If this
-      # is false, then a line item must be provided. If this is true, line_items must be
-      # empty. Ignored if ledger_account_settlement_id is empty.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_accessor :ingest_ledger_entries
-
       # An array of invoice line items. The API supports a maximum of 50 invoice line
       # items per invoice. If a greater number of invoice line items is required, please
       # contact support.
@@ -136,10 +130,6 @@ module ModernTreasury
       end
       attr_writer :invoicer_address
 
-      # The ID of the virtual account the invoice should be paid to.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :ledger_account_settlement_id
-
       # Additional data represented as key-value pairs. Both the key and value must be
       # strings.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
@@ -246,7 +236,6 @@ module ModernTreasury
           currency: ModernTreasury::Currency::OrSymbol,
           description: String,
           fallback_payment_method: T.nilable(String),
-          ingest_ledger_entries: T.nilable(T::Boolean),
           invoice_line_items:
             T.nilable(
               T::Array[
@@ -257,7 +246,6 @@ module ModernTreasury
             T.nilable(
               ModernTreasury::InvoiceCreateParams::InvoicerAddress::OrHash
             ),
-          ledger_account_settlement_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           notification_email_addresses: T.nilable(T::Array[String]),
           notifications_enabled: T::Boolean,
@@ -297,18 +285,12 @@ module ModernTreasury
         # When payment_method is automatic, the fallback payment method to use when an
         # automatic payment fails. One of `manual` or `ui`.
         fallback_payment_method: nil,
-        # Whether to ingest the ledger_entries to populate the invoice line items. If this
-        # is false, then a line item must be provided. If this is true, line_items must be
-        # empty. Ignored if ledger_account_settlement_id is empty.
-        ingest_ledger_entries: nil,
         # An array of invoice line items. The API supports a maximum of 50 invoice line
         # items per invoice. If a greater number of invoice line items is required, please
         # contact support.
         invoice_line_items: nil,
         # The invoice issuer's business address.
         invoicer_address: nil,
-        # The ID of the virtual account the invoice should be paid to.
-        ledger_account_settlement_id: nil,
         # Additional data represented as key-value pairs. Both the key and value must be
         # strings.
         metadata: nil,
@@ -370,14 +352,12 @@ module ModernTreasury
             currency: ModernTreasury::Currency::OrSymbol,
             description: String,
             fallback_payment_method: T.nilable(String),
-            ingest_ledger_entries: T.nilable(T::Boolean),
             invoice_line_items:
               T.nilable(
                 T::Array[ModernTreasury::InvoiceCreateParams::InvoiceLineItem]
               ),
             invoicer_address:
               T.nilable(ModernTreasury::InvoiceCreateParams::InvoicerAddress),
-            ledger_account_settlement_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             notification_email_addresses: T.nilable(T::Array[String]),
             notifications_enabled: T::Boolean,

data/rbi/modern_treasury/models/invoice_update_params.rbi

@@ -98,12 +98,6 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :fallback_payment_method
 
-      # Whether to ingest the ledger_entries to populate the invoice line items. If this
-      # is false, then a line item must be provided. If this is true, line_items must be
-      # empty. Ignored if ledger_account_settlement_id is empty.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_accessor :ingest_ledger_entries
-
       # An array of invoice line items. The API supports a maximum of 50 invoice line
       # items per invoice. If a greater number of invoice line items is required, please
       # contact support.
@@ -132,10 +126,6 @@ module ModernTreasury
       end
       attr_writer :invoicer_address
 
-      # The ID of the virtual account the invoice should be paid to.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :ledger_account_settlement_id
-
       # Additional data represented as key-value pairs. Both the key and value must be
       # strings.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
@@ -256,7 +246,6 @@ module ModernTreasury
           description: String,
           due_date: Time,
           fallback_payment_method: T.nilable(String),
-          ingest_ledger_entries: T.nilable(T::Boolean),
           invoice_line_items:
             T.nilable(
               T::Array[
@@ -267,7 +256,6 @@ module ModernTreasury
             T.nilable(
               ModernTreasury::InvoiceUpdateParams::InvoicerAddress::OrHash
             ),
-          ledger_account_settlement_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           notification_email_addresses: T.nilable(T::Array[String]),
           notifications_enabled: T::Boolean,
@@ -303,18 +291,12 @@ module ModernTreasury
         # When payment_method is automatic, the fallback payment method to use when an
         # automatic payment fails. One of `manual` or `ui`.
         fallback_payment_method: nil,
-        # Whether to ingest the ledger_entries to populate the invoice line items. If this
-        # is false, then a line item must be provided. If this is true, line_items must be
-        # empty. Ignored if ledger_account_settlement_id is empty.
-        ingest_ledger_entries: nil,
         # An array of invoice line items. The API supports a maximum of 50 invoice line
         # items per invoice. If a greater number of invoice line items is required, please
         # contact support.
         invoice_line_items: nil,
         # The invoice issuer's business address.
         invoicer_address: nil,
-        # The ID of the virtual account the invoice should be paid to.
-        ledger_account_settlement_id: nil,
         # Additional data represented as key-value pairs. Both the key and value must be
         # strings.
         metadata: nil,
@@ -380,14 +362,12 @@ module ModernTreasury
             description: String,
             due_date: Time,
             fallback_payment_method: T.nilable(String),
-            ingest_ledger_entries: T.nilable(T::Boolean),
             invoice_line_items:
               T.nilable(
                 T::Array[ModernTreasury::InvoiceUpdateParams::InvoiceLineItem]
               ),
             invoicer_address:
               T.nilable(ModernTreasury::InvoiceUpdateParams::InvoicerAddress),
-            ledger_account_settlement_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             notification_email_addresses: T.nilable(T::Array[String]),
             notifications_enabled: T::Boolean,

data/rbi/modern_treasury/models/ledger_entry.rbi

@@ -29,6 +29,11 @@ module ModernTreasury
       sig { returns(T.nilable(Time)) }
       attr_accessor :discarded_at
 
+      # The timestamp (ISO8601 format) at which the ledger transaction happened for
+      # reporting purposes.
+      sig { returns(Time) }
+      attr_accessor :effective_at
+
       # The currency of the ledger account.
       sig { returns(String) }
       attr_accessor :ledger_account_currency
@@ -98,6 +103,7 @@ module ModernTreasury
           created_at: Time,
           direction: ModernTreasury::TransactionDirection::OrSymbol,
           discarded_at: T.nilable(Time),
+          effective_at: Time,
           ledger_account_currency: String,
           ledger_account_currency_exponent: Integer,
           ledger_account_id: String,
@@ -124,6 +130,9 @@ module ModernTreasury
         # rtp, and check payments will always be `credit`.
         direction:,
         discarded_at:,
+        # The timestamp (ISO8601 format) at which the ledger transaction happened for
+        # reporting purposes.
+        effective_at:,
         # The currency of the ledger account.
         ledger_account_currency:,
         # The currency exponent of the ledger account.
@@ -167,6 +176,7 @@ module ModernTreasury
             created_at: Time,
             direction: ModernTreasury::TransactionDirection::TaggedSymbol,
             discarded_at: T.nilable(Time),
+            effective_at: Time,
             ledger_account_currency: String,
             ledger_account_currency_exponent: Integer,
             ledger_account_id: String,

data/rbi/modern_treasury/models/ledger_entry_create_request.rbi

@@ -33,6 +33,14 @@ module ModernTreasury
       sig { returns(T.nilable(T::Hash[Symbol, Integer])) }
       attr_accessor :available_balance_amount
 
+      # The timestamp (ISO8601 format) at which the ledger transaction happened for
+      # reporting purposes.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :effective_at
+
+      sig { params(effective_at: Time).void }
+      attr_writer :effective_at
+
       # Lock version of the ledger account. This can be passed when creating a ledger
       # transaction to only succeed if no ledger transactions have posted since the
       # given version. See our post about Designing the Ledgers API with Optimistic
@@ -71,6 +79,7 @@ module ModernTreasury
           direction: ModernTreasury::TransactionDirection::OrSymbol,
           ledger_account_id: String,
           available_balance_amount: T.nilable(T::Hash[Symbol, Integer]),
+          effective_at: Time,
           lock_version: T.nilable(Integer),
           metadata: T::Hash[Symbol, String],
           pending_balance_amount: T.nilable(T::Hash[Symbol, Integer]),
@@ -93,6 +102,9 @@ module ModernTreasury
         # account’s available balance. If any of these conditions would be false after the
         # transaction is created, the entire call will fail with error code 422.
         available_balance_amount: nil,
+        # The timestamp (ISO8601 format) at which the ledger transaction happened for
+        # reporting purposes.
+        effective_at: nil,
         # Lock version of the ledger account. This can be passed when creating a ledger
         # transaction to only succeed if no ledger transactions have posted since the
         # given version. See our post about Designing the Ledgers API with Optimistic
@@ -122,6 +134,7 @@ module ModernTreasury
             direction: ModernTreasury::TransactionDirection::OrSymbol,
             ledger_account_id: String,
             available_balance_amount: T.nilable(T::Hash[Symbol, Integer]),
+            effective_at: Time,
             lock_version: T.nilable(Integer),
             metadata: T::Hash[Symbol, String],
             pending_balance_amount: T.nilable(T::Hash[Symbol, Integer]),

data/rbi/modern_treasury/models/ledger_transactions/ledger_transaction_version.rbi

@@ -276,6 +276,11 @@ module ModernTreasury
           sig { returns(ModernTreasury::TransactionDirection::TaggedSymbol) }
           attr_accessor :direction
 
+          # The timestamp (ISO8601 format) at which the ledger transaction happened for
+          # reporting purposes.
+          sig { returns(Time) }
+          attr_accessor :effective_at
+
           # The currency of the ledger account.
           sig { returns(String) }
           attr_accessor :ledger_account_currency
@@ -345,6 +350,7 @@ module ModernTreasury
               amount: Integer,
               created_at: Time,
               direction: ModernTreasury::TransactionDirection::OrSymbol,
+              effective_at: Time,
               ledger_account_currency: String,
               ledger_account_currency_exponent: Integer,
               ledger_account_id: String,
@@ -370,6 +376,9 @@ module ModernTreasury
             # `debit` pulls money from someone else's account to your own. Note that wire,
             # rtp, and check payments will always be `credit`.
             direction:,
+            # The timestamp (ISO8601 format) at which the ledger transaction happened for
+            # reporting purposes.
+            effective_at:,
             # The currency of the ledger account.
             ledger_account_currency:,
             # The currency exponent of the ledger account.
@@ -411,6 +420,7 @@ module ModernTreasury
                 amount: Integer,
                 created_at: Time,
                 direction: ModernTreasury::TransactionDirection::TaggedSymbol,
+                effective_at: Time,
                 ledger_account_currency: String,
                 ledger_account_currency_exponent: Integer,
                 ledger_account_id: String,