increase 1.338.0 → 1.339.0

data/rbi/increase/models/ach_transfer_create_params.rbi

@@ -30,15 +30,19 @@ module Increase
       sig { returns(String) }
       attr_accessor :statement_descriptor
 
-      # The account number for the destination account.
+      # The receiver's account number. For credit transfers (positive `amount`) this is
+      # the account that funds will be sent to. For debit transfers (negative `amount`)
+      # this is the account that funds will be pulled from.
       sig { returns(T.nilable(String)) }
       attr_reader :account_number
 
       sig { params(account_number: String).void }
       attr_writer :account_number
 
-      # Additional information that will be sent to the recipient. This is included in
-      # the transfer data sent to the receiving bank.
+      # Additional information passed through to the receiving bank with the transfer.
+      # Most ACH transfers do not need this. Only set this if your recipient has asked
+      # for addendum data, typically unstructured remittance information. Corporate
+      # Trade Exchange (CTX) flows can carry structured X12 remittance advice instead.
       sig { returns(T.nilable(Increase::ACHTransferCreateParams::Addenda)) }
       attr_reader :addenda
 
@@ -47,41 +51,45 @@ module Increase
       end
       attr_writer :addenda
 
-      # The description of the date of the transfer, usually in the format `YYMMDD`.
-      # This is included in the transfer data sent to the receiving bank.
+      # A description of the transfer date (typically `YYMMDD`), sent in the company
+      # batch header. This value is informational and does not affect funds movement,
+      # settlement timing, or returns. Only set this if your recipient has asked for it.
       sig { returns(T.nilable(String)) }
       attr_reader :company_descriptive_date
 
       sig { params(company_descriptive_date: String).void }
       attr_writer :company_descriptive_date
 
-      # The data you choose to associate with the transfer. This is included in the
-      # transfer data sent to the receiving bank.
+      # Custom data sent in the company batch header. This value is informational and
+      # does not affect funds movement, settlement timing, or returns. Most ACH
+      # transfers do not need this. Only set this if your recipient has asked for it.
       sig { returns(T.nilable(String)) }
       attr_reader :company_discretionary_data
 
       sig { params(company_discretionary_data: String).void }
       attr_writer :company_discretionary_data
 
-      # A description of the transfer, included in the transfer data sent to the
-      # receiving bank. Standardized formatting may be required, for example `PAYROLL`
-      # for payroll-related Prearranged Payments and Deposits (PPD) credit transfers.
+      # A short description sent in the company batch header. Most receivers do not
+      # surface this. Only set this if your recipient has asked for a specific value or
+      # if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
+      # example, Prearranged Payment and Deposit (PPD) payroll credits must use
+      # `PAYROLL`, and reversals must use `REVERSAL`.
       sig { returns(T.nilable(String)) }
       attr_reader :company_entry_description
 
       sig { params(company_entry_description: String).void }
       attr_writer :company_entry_description
 
-      # The name by which the recipient knows you. This is included in the transfer data
-      # sent to the receiving bank.
+      # The name by which the recipient knows you, sent in the company batch header. We
+      # recommend setting this on every transfer; if you do not, we fall back to the ACH
+      # company name configured on your account.
       sig { returns(T.nilable(String)) }
       attr_reader :company_name
 
       sig { params(company_name: String).void }
       attr_writer :company_name
 
-      # The type of entity that owns the account to which the ACH Transfer is being
-      # sent.
+      # The type of entity that owns the receiver's account.
       sig do
         returns(
           T.nilable(
@@ -107,7 +115,7 @@ module Increase
       sig { params(external_account_id: String).void }
       attr_writer :external_account_id
 
-      # The type of the account to which the transfer will be sent.
+      # The type of the receiver's bank account.
       sig do
         returns(T.nilable(Increase::ACHTransferCreateParams::Funding::OrSymbol))
       end
@@ -120,7 +128,8 @@ module Increase
       end
       attr_writer :funding
 
-      # Your identifier for the transfer recipient.
+      # Your internal identifier for the transfer recipient. This value is informational
+      # and not verified by the recipient's bank. Most callers can leave this unset.
       sig { returns(T.nilable(String)) }
       attr_reader :individual_id
 
@@ -161,8 +170,8 @@ module Increase
       sig { params(require_approval: T::Boolean).void }
       attr_writer :require_approval
 
-      # The American Bankers' Association (ABA) Routing Transit Number (RTN) for the
-      # destination account.
+      # The American Bankers' Association (ABA) Routing Transit Number (RTN) of the
+      # receiver's bank.
       sig { returns(T.nilable(String)) }
       attr_reader :routing_number
 
@@ -171,7 +180,8 @@ module Increase
 
       # The
       # [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
-      # to use for the transfer.
+      # to use for the transfer. If not provided, the default is
+      # `corporate_credit_or_debit`.
       sig do
         returns(
           T.nilable(
@@ -249,33 +259,42 @@ module Increase
         # help the customer recognize the transfer. You are highly encouraged to pass
         # `individual_name` and `company_name` instead of relying on this fallback.
         statement_descriptor:,
-        # The account number for the destination account.
+        # The receiver's account number. For credit transfers (positive `amount`) this is
+        # the account that funds will be sent to. For debit transfers (negative `amount`)
+        # this is the account that funds will be pulled from.
         account_number: nil,
-        # Additional information that will be sent to the recipient. This is included in
-        # the transfer data sent to the receiving bank.
+        # Additional information passed through to the receiving bank with the transfer.
+        # Most ACH transfers do not need this. Only set this if your recipient has asked
+        # for addendum data, typically unstructured remittance information. Corporate
+        # Trade Exchange (CTX) flows can carry structured X12 remittance advice instead.
         addenda: nil,
-        # The description of the date of the transfer, usually in the format `YYMMDD`.
-        # This is included in the transfer data sent to the receiving bank.
+        # A description of the transfer date (typically `YYMMDD`), sent in the company
+        # batch header. This value is informational and does not affect funds movement,
+        # settlement timing, or returns. Only set this if your recipient has asked for it.
         company_descriptive_date: nil,
-        # The data you choose to associate with the transfer. This is included in the
-        # transfer data sent to the receiving bank.
+        # Custom data sent in the company batch header. This value is informational and
+        # does not affect funds movement, settlement timing, or returns. Most ACH
+        # transfers do not need this. Only set this if your recipient has asked for it.
         company_discretionary_data: nil,
-        # A description of the transfer, included in the transfer data sent to the
-        # receiving bank. Standardized formatting may be required, for example `PAYROLL`
-        # for payroll-related Prearranged Payments and Deposits (PPD) credit transfers.
+        # A short description sent in the company batch header. Most receivers do not
+        # surface this. Only set this if your recipient has asked for a specific value or
+        # if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
+        # example, Prearranged Payment and Deposit (PPD) payroll credits must use
+        # `PAYROLL`, and reversals must use `REVERSAL`.
         company_entry_description: nil,
-        # The name by which the recipient knows you. This is included in the transfer data
-        # sent to the receiving bank.
+        # The name by which the recipient knows you, sent in the company batch header. We
+        # recommend setting this on every transfer; if you do not, we fall back to the ACH
+        # company name configured on your account.
         company_name: nil,
-        # The type of entity that owns the account to which the ACH Transfer is being
-        # sent.
+        # The type of entity that owns the receiver's account.
         destination_account_holder: nil,
         # The ID of an External Account to initiate a transfer to. If this parameter is
         # provided, `account_number`, `routing_number`, and `funding` must be absent.
         external_account_id: nil,
-        # The type of the account to which the transfer will be sent.
+        # The type of the receiver's bank account.
         funding: nil,
-        # Your identifier for the transfer recipient.
+        # Your internal identifier for the transfer recipient. This value is informational
+        # and not verified by the recipient's bank. Most callers can leave this unset.
         individual_id: nil,
         # The name of the transfer recipient. This value is informational and not verified
         # by the recipient's bank.
@@ -287,12 +306,13 @@ module Increase
         preferred_effective_date: nil,
         # Whether the transfer requires explicit approval via the dashboard or API.
         require_approval: nil,
-        # The American Bankers' Association (ABA) Routing Transit Number (RTN) for the
-        # destination account.
+        # The American Bankers' Association (ABA) Routing Transit Number (RTN) of the
+        # receiver's bank.
         routing_number: nil,
         # The
         # [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
-        # to use for the transfer.
+        # to use for the transfer. If not provided, the default is
+        # `corporate_credit_or_debit`.
         standard_entry_class_code: nil,
         # The timing of the transaction.
         transaction_timing: nil,
@@ -387,8 +407,10 @@ module Increase
         end
         attr_writer :payment_order_remittance_advice
 
-        # Additional information that will be sent to the recipient. This is included in
-        # the transfer data sent to the receiving bank.
+        # Additional information passed through to the receiving bank with the transfer.
+        # Most ACH transfers do not need this. Only set this if your recipient has asked
+        # for addendum data, typically unstructured remittance information. Corporate
+        # Trade Exchange (CTX) flows can carry structured X12 remittance advice instead.
         sig do
           params(
             category:
@@ -636,8 +658,7 @@ module Increase
         end
       end
 
-      # The type of entity that owns the account to which the ACH Transfer is being
-      # sent.
+      # The type of entity that owns the receiver's account.
       module DestinationAccountHolder
         extend Increase::Internal::Type::Enum
 
@@ -682,7 +703,7 @@ module Increase
         end
       end
 
-      # The type of the account to which the transfer will be sent.
+      # The type of the receiver's bank account.
       module Funding
         extend Increase::Internal::Type::Enum
 
@@ -806,7 +827,7 @@ module Increase
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          # The chosen effective date will be the same as the ACH processing date on which the transfer is submitted. This is necessary, but not sufficient for the transfer to be settled same-day: it must also be submitted before the last same-day cutoff and be less than or equal to $1,000.000.00.
+          # The chosen effective date will be the same as the ACH processing date on which the transfer is submitted. This is necessary, but not sufficient for the transfer to be settled same-day: it must also be submitted before the last same-day cutoff and be less than or equal to $1,000,000.00.
           SAME_DAY =
             T.let(
               :same_day,
@@ -834,7 +855,8 @@ module Increase
 
       # The
       # [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
-      # to use for the transfer.
+      # to use for the transfer. If not provided, the default is
+      # `corporate_credit_or_debit`.
       module StandardEntryClassCode
         extend Increase::Internal::Type::Enum
 

data/rbi/increase/models/ach_transfer_list_params.rbi

@@ -300,7 +300,7 @@ module Increase
               Increase::ACHTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is complete.
+          # The transfer has been submitted to the Federal Reserve. When the transfer settles, the status remains `submitted` and the `settlement` sub-object is populated.
           SUBMITTED =
             T.let(
               :submitted,

data/rbi/increase/models/beneficial_owner_create_params.rbi

@@ -298,7 +298,8 @@ module Increase
           # An identification number that can be used to verify the individual's identity,
           # such as a social security number. For Social Security Numbers and Individual
           # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-          # separators.
+          # separators. When testing in sandbox, use one of our
+          # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
           sig { returns(String) }
           attr_accessor :number
 
@@ -379,7 +380,8 @@ module Increase
             # An identification number that can be used to verify the individual's identity,
             # such as a social security number. For Social Security Numbers and Individual
             # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-            # separators.
+            # separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             number:,
             # Information about the United States driver's license used for identification.
             # Required if `method` is equal to `drivers_license`.

data/rbi/increase/models/beneficial_owner_update_params.rbi

@@ -247,7 +247,8 @@ module Increase
         # An identification number that can be used to verify the individual's identity,
         # such as a social security number. For Social Security Numbers and Individual
         # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-        # separators.
+        # separators. When testing in sandbox, use one of our
+        # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
         sig { returns(String) }
         attr_accessor :number
 
@@ -328,7 +329,8 @@ module Increase
           # An identification number that can be used to verify the individual's identity,
           # such as a social security number. For Social Security Numbers and Individual
           # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-          # separators.
+          # separators. When testing in sandbox, use one of our
+          # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
           number:,
           # Information about the United States driver's license used for identification.
           # Required if `method` is equal to `drivers_license`.

data/rbi/increase/models/card_push_transfer.rbi

@@ -2725,6 +2725,13 @@ module Increase
         CANCELED =
           T.let(:canceled, Increase::CardPushTransfer::Status::TaggedSymbol)
 
+        # The transfer is queued to be submitted to the card network.
+        PENDING_SUBMISSION =
+          T.let(
+            :pending_submission,
+            Increase::CardPushTransfer::Status::TaggedSymbol
+          )
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING =
           T.let(
@@ -2739,13 +2746,6 @@ module Increase
             Increase::CardPushTransfer::Status::TaggedSymbol
           )
 
-        # The transfer is queued to be submitted to the card network.
-        PENDING_SUBMISSION =
-          T.let(
-            :pending_submission,
-            Increase::CardPushTransfer::Status::TaggedSymbol
-          )
-
         # The transfer has been submitted and is pending a response from the card network.
         SUBMITTED =
           T.let(:submitted, Increase::CardPushTransfer::Status::TaggedSymbol)

data/rbi/increase/models/card_push_transfer_list_params.rbi

@@ -271,6 +271,13 @@ module Increase
               Increase::CardPushTransferListParams::Status::In::TaggedSymbol
             )
 
+          # The transfer is queued to be submitted to the card network.
+          PENDING_SUBMISSION =
+            T.let(
+              :pending_submission,
+              Increase::CardPushTransferListParams::Status::In::TaggedSymbol
+            )
+
           # The transfer is pending review by Increase.
           PENDING_REVIEWING =
             T.let(
@@ -285,13 +292,6 @@ module Increase
               Increase::CardPushTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is queued to be submitted to the card network.
-          PENDING_SUBMISSION =
-            T.let(
-              :pending_submission,
-              Increase::CardPushTransferListParams::Status::In::TaggedSymbol
-            )
-
           # The transfer has been submitted and is pending a response from the card network.
           SUBMITTED =
             T.let(

data/rbi/increase/models/check_transfer.rbi

@@ -1296,14 +1296,21 @@ module Increase
                 Increase::CheckTransfer::PhysicalCheck::TrackingUpdate::Category::TaggedSymbol
               )
 
-            # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the check will be returned to sender.
+            # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the check will be rerouted to the return address.
             DELIVERY_ISSUE =
               T.let(
                 :delivery_issue,
                 Increase::CheckTransfer::PhysicalCheck::TrackingUpdate::Category::TaggedSymbol
               )
 
-            # Delivery failed and the check was returned to sender.
+            # The check has been rerouted to the return address.
+            RETURNING_TO_SENDER =
+              T.let(
+                :returning_to_sender,
+                Increase::CheckTransfer::PhysicalCheck::TrackingUpdate::Category::TaggedSymbol
+              )
+
+            # The check has been delivered to the return address.
             RETURNED_TO_SENDER =
               T.let(
                 :returned_to_sender,

data/rbi/increase/models/entity_create_params.rbi

@@ -310,7 +310,8 @@ module Increase
         attr_accessor :beneficial_owners
 
         # The legal identifier of the corporation. This is usually the Employer
-        # Identification Number (EIN).
+        # Identification Number (EIN). This replaces the deprecated `tax_identifier`
+        # field.
         sig do
           returns(Increase::EntityCreateParams::Corporation::LegalIdentifier)
         end
@@ -414,7 +415,8 @@ module Increase
           # `control` person.
           beneficial_owners:,
           # The legal identifier of the corporation. This is usually the Employer
-          # Identification Number (EIN).
+          # Identification Number (EIN). This replaces the deprecated `tax_identifier`
+          # field.
           legal_identifier:,
           # The legal name of the corporation.
           name:,
@@ -847,7 +849,8 @@ module Increase
               # An identification number that can be used to verify the individual's identity,
               # such as a social security number. For Social Security Numbers and Individual
               # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-              # separators.
+              # separators. When testing in sandbox, use one of our
+              # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
               sig { returns(String) }
               attr_accessor :number
 
@@ -928,7 +931,8 @@ module Increase
                 # An identification number that can be used to verify the individual's identity,
                 # such as a social security number. For Social Security Numbers and Individual
                 # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-                # separators.
+                # separators. When testing in sandbox, use one of our
+                # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
                 number:,
                 # Information about the United States driver's license used for identification.
                 # Required if `method` is equal to `drivers_license`.
@@ -1263,7 +1267,8 @@ module Increase
             end
 
           # The legal identifier. For US Employer Identification Numbers, submit nine digits
-          # with no dashes or other separators.
+          # with no dashes or other separators. When testing in sandbox, use one of our
+          # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
           sig { returns(String) }
           attr_accessor :value
 
@@ -1287,7 +1292,8 @@ module Increase
           attr_writer :category
 
           # The legal identifier of the corporation. This is usually the Employer
-          # Identification Number (EIN).
+          # Identification Number (EIN). This replaces the deprecated `tax_identifier`
+          # field.
           sig do
             params(
               value: String,
@@ -1297,7 +1303,8 @@ module Increase
           end
           def self.new(
             # The legal identifier. For US Employer Identification Numbers, submit nine digits
-            # with no dashes or other separators.
+            # with no dashes or other separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             value:,
             # The category of the legal identifier. If not provided, the default is
             # `us_employer_identification_number`.
@@ -1930,7 +1937,8 @@ module Increase
             # An identification number that can be used to verify the individual's identity,
             # such as a social security number. For Social Security Numbers and Individual
             # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-            # separators.
+            # separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             sig { returns(String) }
             attr_accessor :number
 
@@ -2011,7 +2019,8 @@ module Increase
               # An identification number that can be used to verify the individual's identity,
               # such as a social security number. For Social Security Numbers and Individual
               # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-              # separators.
+              # separators. When testing in sandbox, use one of our
+              # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
               number:,
               # Information about the United States driver's license used for identification.
               # Required if `method` is equal to `drivers_license`.
@@ -2509,7 +2518,8 @@ module Increase
           # An identification number that can be used to verify the individual's identity,
           # such as a social security number. For Social Security Numbers and Individual
           # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-          # separators.
+          # separators. When testing in sandbox, use one of our
+          # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
           sig { returns(String) }
           attr_accessor :number
 
@@ -2590,7 +2600,8 @@ module Increase
             # An identification number that can be used to verify the individual's identity,
             # such as a social security number. For Social Security Numbers and Individual
             # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-            # separators.
+            # separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             number:,
             # Information about the United States driver's license used for identification.
             # Required if `method` is equal to `drivers_license`.
@@ -3700,7 +3711,8 @@ module Increase
               # An identification number that can be used to verify the individual's identity,
               # such as a social security number. For Social Security Numbers and Individual
               # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-              # separators.
+              # separators. When testing in sandbox, use one of our
+              # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
               sig { returns(String) }
               attr_accessor :number
 
@@ -3781,7 +3793,8 @@ module Increase
                 # An identification number that can be used to verify the individual's identity,
                 # such as a social security number. For Social Security Numbers and Individual
                 # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-                # separators.
+                # separators. When testing in sandbox, use one of our
+                # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
                 number:,
                 # Information about the United States driver's license used for identification.
                 # Required if `method` is equal to `drivers_license`.
@@ -4278,7 +4291,8 @@ module Increase
             # An identification number that can be used to verify the individual's identity,
             # such as a social security number. For Social Security Numbers and Individual
             # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-            # separators.
+            # separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             sig { returns(String) }
             attr_accessor :number
 
@@ -4359,7 +4373,8 @@ module Increase
               # An identification number that can be used to verify the individual's identity,
               # such as a social security number. For Social Security Numbers and Individual
               # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-              # separators.
+              # separators. When testing in sandbox, use one of our
+              # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
               number:,
               # Information about the United States driver's license used for identification.
               # Required if `method` is equal to `drivers_license`.

data/rbi/increase/models/entity_update_params.rbi

@@ -869,7 +869,8 @@ module Increase
           # An identification number that can be used to verify the individual's identity,
           # such as a social security number. For Social Security Numbers and Individual
           # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-          # separators.
+          # separators. When testing in sandbox, use one of our
+          # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
           sig { returns(String) }
           attr_accessor :number
 
@@ -950,7 +951,8 @@ module Increase
             # An identification number that can be used to verify the individual's identity,
             # such as a social security number. For Social Security Numbers and Individual
             # Taxpayer Identification Numbers, submit nine digits with no dashes or other
-            # separators.
+            # separators. When testing in sandbox, use one of our
+            # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
             number:,
             # Information about the United States driver's license used for identification.
             # Required if `method` is equal to `drivers_license`.

data/rbi/increase/models/fednow_transfer.rbi

@@ -885,6 +885,13 @@ module Increase
           T.type_alias { T.all(Symbol, Increase::FednowTransfer::Status) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+        # The transfer is queued to be submitted to FedNow.
+        PENDING_SUBMITTING =
+          T.let(
+            :pending_submitting,
+            Increase::FednowTransfer::Status::TaggedSymbol
+          )
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING =
           T.let(
@@ -917,13 +924,6 @@ module Increase
             Increase::FednowTransfer::Status::TaggedSymbol
           )
 
-        # The transfer is queued to be submitted to FedNow.
-        PENDING_SUBMITTING =
-          T.let(
-            :pending_submitting,
-            Increase::FednowTransfer::Status::TaggedSymbol
-          )
-
         # The transfer has been submitted and is pending a response from FedNow.
         PENDING_RESPONSE =
           T.let(

data/rbi/increase/models/fednow_transfer_list_params.rbi

@@ -255,6 +255,13 @@ module Increase
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          # The transfer is queued to be submitted to FedNow.
+          PENDING_SUBMITTING =
+            T.let(
+              :pending_submitting,
+              Increase::FednowTransferListParams::Status::In::TaggedSymbol
+            )
+
           # The transfer is pending review by Increase.
           PENDING_REVIEWING =
             T.let(
@@ -290,13 +297,6 @@ module Increase
               Increase::FednowTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is queued to be submitted to FedNow.
-          PENDING_SUBMITTING =
-            T.let(
-              :pending_submitting,
-              Increase::FednowTransferListParams::Status::In::TaggedSymbol
-            )
-
           # The transfer has been submitted and is pending a response from FedNow.
           PENDING_RESPONSE =
             T.let(

data/rbi/increase/models/inbound_mail_item.rbi

@@ -56,7 +56,9 @@ module Increase
       attr_accessor :type
 
       # Inbound Mail Items represent pieces of physical mail delivered to a Lockbox
-      # Address.
+      # Address. Increase automatically deposits checks mailed to a Lockbox Recipient
+      # into the recipient's Account. Checks that are not matched to a Lockbox Recipient
+      # must be deposited or ignored using the Action an Inbound Mail Item endpoint.
       sig do
         params(
           id: String,

data/rbi/increase/models/inbound_real_time_payments_transfer.rbi

@@ -417,7 +417,7 @@ module Increase
             Increase::InboundRealTimePaymentsTransfer::Status::TaggedSymbol
           )
 
-        # The transfer was not responded to in time.
+        # The transfer was not responded to in time. This is rare and represents an error at Increase.
         TIMED_OUT =
           T.let(
             :timed_out,

data/rbi/increase/models/lockbox_address.rbi

@@ -49,7 +49,11 @@ module Increase
       attr_accessor :type
 
       # Lockbox Addresses are physical locations that can receive mail containing paper
-      # checks.
+      # checks. A Lockbox Address is not itself linked to an Account; Lockbox Recipients
+      # determine where checks received at the address are deposited. Lockbox Addresses
+      # are created with a `pending` status and a null `address`. Increase generates the
+      # mailing address shortly after creation, at which point the status becomes
+      # `active`.
       sig do
         params(
           id: String,