increase 1.338.0 → 1.339.0

data/rbi/increase/models/lockbox_recipient_create_params.rbi

@@ -18,7 +18,8 @@ module Increase
       sig { returns(String) }
       attr_accessor :account_id
 
-      # The Lockbox Address where this Lockbox Recipient may receive mail.
+      # The Lockbox Address where this Lockbox Recipient may receive mail. The Lockbox
+      # Address must have a `status` of `active`.
       sig { returns(String) }
       attr_accessor :lockbox_address_id
 
@@ -48,7 +49,8 @@ module Increase
       def self.new(
         # The Account that checks sent to this Lockbox Recipient should be deposited into.
         account_id:,
-        # The Lockbox Address where this Lockbox Recipient may receive mail.
+        # The Lockbox Address where this Lockbox Recipient may receive mail. The Lockbox
+        # Address must have a `status` of `active`.
         lockbox_address_id:,
         # The description you choose for the Lockbox Recipient.
         description: nil,

data/rbi/increase/models/pending_transaction.rbi

@@ -17,7 +17,10 @@ module Increase
       attr_accessor :account_id
 
       # The Pending Transaction amount in the minor unit of its currency. For dollars,
-      # for example, this is cents.
+      # for example, this is cents. This amount does not change after the Pending
+      # Transaction is created. If a card authorization settles for a different amount,
+      # the settled amount is available on the resulting Transaction and on the Card
+      # Payment's `state.settled_amount`.
       sig { returns(Integer) }
       attr_accessor :amount
 
@@ -109,7 +112,10 @@ module Increase
         # The identifier for the account this Pending Transaction belongs to.
         account_id:,
         # The Pending Transaction amount in the minor unit of its currency. For dollars,
-        # for example, this is cents.
+        # for example, this is cents. This amount does not change after the Pending
+        # Transaction is created. If a card authorization settles for a different amount,
+        # the settled amount is available on the resulting Transaction and on the Card
+        # Payment's `state.settled_amount`.
         amount:,
         # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the Pending
         # Transaction was completed.
@@ -4982,7 +4988,7 @@ module Increase
         PENDING =
           T.let(:pending, Increase::PendingTransaction::Status::TaggedSymbol)
 
-        # The Pending Transaction is confirmed. An associated Transaction exists for this object. The Pending Transaction will no longer count against your balance and can generally be hidden from UIs, etc.
+        # The Pending Transaction is confirmed. An associated Transaction exists for this object. The Pending Transaction will no longer count against your balance and can generally be hidden from UIs, etc. The Pending Transaction's `amount` is not updated if the associated Transaction settles for a different amount.
         COMPLETE =
           T.let(:complete, Increase::PendingTransaction::Status::TaggedSymbol)
 

data/rbi/increase/models/pending_transaction_list_params.rbi

@@ -473,7 +473,7 @@ module Increase
               Increase::PendingTransactionListParams::Status::In::TaggedSymbol
             )
 
-          # The Pending Transaction is confirmed. An associated Transaction exists for this object. The Pending Transaction will no longer count against your balance and can generally be hidden from UIs, etc.
+          # The Pending Transaction is confirmed. An associated Transaction exists for this object. The Pending Transaction will no longer count against your balance and can generally be hidden from UIs, etc. The Pending Transaction's `amount` is not updated if the associated Transaction settles for a different amount.
           COMPLETE =
             T.let(
               :complete,

data/rbi/increase/models/physical_card.rbi

@@ -690,14 +690,21 @@ module Increase
                   Increase::PhysicalCard::Shipment::Tracking::Update::Category::TaggedSymbol
                 )
 
-              # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the physical card 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 physical card will be rerouted to the return address.
               DELIVERY_ISSUE =
                 T.let(
                   :delivery_issue,
                   Increase::PhysicalCard::Shipment::Tracking::Update::Category::TaggedSymbol
                 )
 
-              # Delivery failed and the physical card was returned to sender.
+              # The physical card has been rerouted to the return address.
+              RETURNING_TO_SENDER =
+                T.let(
+                  :returning_to_sender,
+                  Increase::PhysicalCard::Shipment::Tracking::Update::Category::TaggedSymbol
+                )
+
+              # The physical card has been delivered to the return address.
               RETURNED_TO_SENDER =
                 T.let(
                   :returned_to_sender,

data/rbi/increase/models/real_time_payments_transfer.rbi

@@ -988,6 +988,13 @@ module Increase
             Increase::RealTimePaymentsTransfer::Status::TaggedSymbol
           )
 
+        # The transfer is queued to be submitted to Real-Time Payments.
+        PENDING_SUBMISSION =
+          T.let(
+            :pending_submission,
+            Increase::RealTimePaymentsTransfer::Status::TaggedSymbol
+          )
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING =
           T.let(
@@ -1009,13 +1016,6 @@ module Increase
             Increase::RealTimePaymentsTransfer::Status::TaggedSymbol
           )
 
-        # The transfer is queued to be submitted to Real-Time Payments.
-        PENDING_SUBMISSION =
-          T.let(
-            :pending_submission,
-            Increase::RealTimePaymentsTransfer::Status::TaggedSymbol
-          )
-
         # The transfer has been submitted and is pending a response from Real-Time Payments.
         SUBMITTED =
           T.let(

data/rbi/increase/models/real_time_payments_transfer_list_params.rbi

@@ -293,6 +293,13 @@ module Increase
               Increase::RealTimePaymentsTransferListParams::Status::In::TaggedSymbol
             )
 
+          # The transfer is queued to be submitted to Real-Time Payments.
+          PENDING_SUBMISSION =
+            T.let(
+              :pending_submission,
+              Increase::RealTimePaymentsTransferListParams::Status::In::TaggedSymbol
+            )
+
           # The transfer is pending review by Increase.
           PENDING_REVIEWING =
             T.let(
@@ -314,13 +321,6 @@ module Increase
               Increase::RealTimePaymentsTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is queued to be submitted to Real-Time Payments.
-          PENDING_SUBMISSION =
-            T.let(
-              :pending_submission,
-              Increase::RealTimePaymentsTransferListParams::Status::In::TaggedSymbol
-            )
-
           # The transfer has been submitted and is pending a response from Real-Time Payments.
           SUBMITTED =
             T.let(

data/rbi/increase/models/simulations/inbound_ach_transfer_create_params.rbi

@@ -71,7 +71,8 @@ module Increase
         sig { params(company_id: String).void }
         attr_writer :company_id
 
-        # The name of the sender.
+        # The name of the sender. This corresponds to the `originator_company_name` field
+        # on the resulting Inbound ACH Transfer.
         sig { returns(T.nilable(String)) }
         attr_reader :company_name
 
@@ -154,7 +155,8 @@ module Increase
           company_entry_description: nil,
           # The sender's company ID.
           company_id: nil,
-          # The name of the sender.
+          # The name of the sender. This corresponds to the `originator_company_name` field
+          # on the resulting Inbound ACH Transfer.
           company_name: nil,
           # The ID of the receiver of the transfer.
           receiver_id_number: nil,

data/rbi/increase/models/simulations/inbound_mail_item_create_params.rbi

@@ -27,14 +27,16 @@ module Increase
         sig { params(contents_file_id: String).void }
         attr_writer :contents_file_id
 
-        # The identifier of the Lockbox Address to simulate inbound mail to.
+        # The identifier of the Lockbox Address to simulate inbound mail to. Exactly one
+        # lockbox identifier parameter must be provided.
         sig { returns(T.nilable(String)) }
         attr_reader :lockbox_address_id
 
         sig { params(lockbox_address_id: String).void }
         attr_writer :lockbox_address_id
 
-        # The identifier of the Lockbox Recipient to simulate inbound mail to.
+        # The identifier of the Lockbox Recipient to simulate inbound mail to. Exactly one
+        # lockbox identifier parameter must be provided.
         sig { returns(T.nilable(String)) }
         attr_reader :lockbox_recipient_id
 
@@ -56,9 +58,11 @@ module Increase
           # The file containing the PDF contents. If not present, a default check image file
           # will be used.
           contents_file_id: nil,
-          # The identifier of the Lockbox Address to simulate inbound mail to.
+          # The identifier of the Lockbox Address to simulate inbound mail to. Exactly one
+          # lockbox identifier parameter must be provided.
           lockbox_address_id: nil,
-          # The identifier of the Lockbox Recipient to simulate inbound mail to.
+          # The identifier of the Lockbox Recipient to simulate inbound mail to. Exactly one
+          # lockbox identifier parameter must be provided.
           lockbox_recipient_id: nil,
           request_options: {}
         )

data/rbi/increase/models/simulations/physical_card_create_params.rbi

@@ -137,14 +137,21 @@ module Increase
               Increase::Simulations::PhysicalCardCreateParams::Category::TaggedSymbol
             )
 
-          # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the physical card 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 physical card will be rerouted to the return address.
           DELIVERY_ISSUE =
             T.let(
               :delivery_issue,
               Increase::Simulations::PhysicalCardCreateParams::Category::TaggedSymbol
             )
 
-          # Delivery failed and the physical card was returned to sender.
+          # The physical card has been rerouted to the return address.
+          RETURNING_TO_SENDER =
+            T.let(
+              :returning_to_sender,
+              Increase::Simulations::PhysicalCardCreateParams::Category::TaggedSymbol
+            )
+
+          # The physical card has been delivered to the return address.
           RETURNED_TO_SENDER =
             T.let(
               :returned_to_sender,

data/rbi/increase/models/swift_transfer.rbi

@@ -665,6 +665,13 @@ module Increase
         CANCELED =
           T.let(:canceled, Increase::SwiftTransfer::Status::TaggedSymbol)
 
+        # The transfer is pending initiation.
+        PENDING_INITIATING =
+          T.let(
+            :pending_initiating,
+            Increase::SwiftTransfer::Status::TaggedSymbol
+          )
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING =
           T.let(
@@ -679,13 +686,6 @@ module Increase
             Increase::SwiftTransfer::Status::TaggedSymbol
           )
 
-        # The transfer is pending initiation.
-        PENDING_INITIATING =
-          T.let(
-            :pending_initiating,
-            Increase::SwiftTransfer::Status::TaggedSymbol
-          )
-
         # The transfer has been initiated.
         INITIATED =
           T.let(:initiated, Increase::SwiftTransfer::Status::TaggedSymbol)

data/rbi/increase/models/swift_transfer_list_params.rbi

@@ -258,6 +258,13 @@ module Increase
               Increase::SwiftTransferListParams::Status::In::TaggedSymbol
             )
 
+          # The transfer is pending initiation.
+          PENDING_INITIATING =
+            T.let(
+              :pending_initiating,
+              Increase::SwiftTransferListParams::Status::In::TaggedSymbol
+            )
+
           # The transfer is pending review by Increase.
           PENDING_REVIEWING =
             T.let(
@@ -272,13 +279,6 @@ module Increase
               Increase::SwiftTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is pending initiation.
-          PENDING_INITIATING =
-            T.let(
-              :pending_initiating,
-              Increase::SwiftTransferListParams::Status::In::TaggedSymbol
-            )
-
           # The transfer has been initiated.
           INITIATED =
             T.let(

data/rbi/increase/models/transaction.rbi

@@ -284,7 +284,8 @@ module Increase
         # Return is created when an ACH Transfer is returned by the receiving bank. It
         # offsets the ACH Transfer Intention. ACH Transfer Returns usually occur within
         # the first two business days after the transfer is initiated, but can occur much
-        # later.
+        # later. The return appears as a new posted Transaction; no Pending Transaction is
+        # created.
         sig do
           returns(T.nilable(Increase::Transaction::Source::ACHTransferReturn))
         end
@@ -1116,7 +1117,8 @@ module Increase
           # Return is created when an ACH Transfer is returned by the receiving bank. It
           # offsets the ACH Transfer Intention. ACH Transfer Returns usually occur within
           # the first two business days after the transfer is initiated, but can occur much
-          # later.
+          # later. The return appears as a new posted Transaction; no Pending Transaction is
+          # created.
           ach_transfer_return: nil,
           # A Blockchain Off-Ramp Transfer Settlement object. This field will be present in
           # the JSON response if and only if `category` is equal to
@@ -1997,7 +1999,8 @@ module Increase
           sig { returns(String) }
           attr_accessor :transaction_id
 
-          # The identifier of the ACH Transfer associated with this return.
+          # The identifier of the ACH Transfer associated with this return. This matches the
+          # original Transaction's `source.ach_transfer_intention.transfer_id`.
           sig { returns(String) }
           attr_accessor :transfer_id
 
@@ -2006,7 +2009,8 @@ module Increase
           # Return is created when an ACH Transfer is returned by the receiving bank. It
           # offsets the ACH Transfer Intention. ACH Transfer Returns usually occur within
           # the first two business days after the transfer is initiated, but can occur much
-          # later.
+          # later. The return appears as a new posted Transaction; no Pending Transaction is
+          # created.
           sig do
             params(
               created_at: Time,
@@ -2034,7 +2038,8 @@ module Increase
             trace_number:,
             # The identifier of the Transaction associated with this return.
             transaction_id:,
-            # The identifier of the ACH Transfer associated with this return.
+            # The identifier of the ACH Transfer associated with this return. This matches the
+            # original Transaction's `source.ach_transfer_intention.transfer_id`.
             transfer_id:
           )
           end

data/rbi/increase/models/wire_transfer.rbi

@@ -1327,6 +1327,10 @@ module Increase
         CANCELED =
           T.let(:canceled, Increase::WireTransfer::Status::TaggedSymbol)
 
+        # The transfer is pending creation.
+        PENDING_CREATING =
+          T.let(:pending_creating, Increase::WireTransfer::Status::TaggedSymbol)
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING =
           T.let(
@@ -1345,10 +1349,6 @@ module Increase
             Increase::WireTransfer::Status::TaggedSymbol
           )
 
-        # The transfer is pending creation.
-        PENDING_CREATING =
-          T.let(:pending_creating, Increase::WireTransfer::Status::TaggedSymbol)
-
         # The transfer has been reversed.
         REVERSED =
           T.let(:reversed, Increase::WireTransfer::Status::TaggedSymbol)

data/rbi/increase/models/wire_transfer_list_params.rbi

@@ -267,6 +267,13 @@ module Increase
               Increase::WireTransferListParams::Status::In::TaggedSymbol
             )
 
+          # The transfer is pending creation.
+          PENDING_CREATING =
+            T.let(
+              :pending_creating,
+              Increase::WireTransferListParams::Status::In::TaggedSymbol
+            )
+
           # The transfer is pending review by Increase.
           PENDING_REVIEWING =
             T.let(
@@ -288,13 +295,6 @@ module Increase
               Increase::WireTransferListParams::Status::In::TaggedSymbol
             )
 
-          # The transfer is pending creation.
-          PENDING_CREATING =
-            T.let(
-              :pending_creating,
-              Increase::WireTransferListParams::Status::In::TaggedSymbol
-            )
-
           # The transfer has been reversed.
           REVERSED =
             T.let(

data/rbi/increase/resources/accounts.rbi

@@ -27,8 +27,9 @@ module Increase
         informational_entity_id: nil,
         # The loan details for the account.
         loan: nil,
-        # The identifier for the Program that this Account falls under. Required if you
-        # operate more than one Program.
+        # The identifier for the Program that this Account falls under. Required if your
+        # Group operates more than one Program. List your [Programs](#programs) to find
+        # their identifiers.
         program_id: nil,
         request_options: {}
       )

data/rbi/increase/resources/ach_transfers.rbi

@@ -46,33 +46,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.
@@ -84,12 +93,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,

data/rbi/increase/resources/inbound_mail_items.rbi

@@ -43,7 +43,9 @@ module Increase
       )
       end
 
-      # Action an Inbound Mail Item
+      # Deposits or ignores each check contained in a pending Inbound Mail Item.
+      # Depositing a check creates a [Check Deposit](#check-deposits) into the Account
+      # you specify.
       sig do
         params(
           inbound_mail_item_id: String,

data/rbi/increase/resources/lockbox_addresses.rbi

@@ -3,7 +3,10 @@
 module Increase
   module Resources
     class LockboxAddresses
-      # Create a Lockbox Address
+      # The Lockbox Address starts with a `pending` status and a null `address`. Shortly
+      # after creation, Increase generates the mailing address and the status becomes
+      # `active`. You can only create Lockbox Recipients for an `active` Lockbox
+      # Address.
       sig do
         params(
           description: String,

data/rbi/increase/resources/lockbox_recipients.rbi

@@ -16,7 +16,8 @@ module Increase
       def create(
         # The Account that checks sent to this Lockbox Recipient should be deposited into.
         account_id:,
-        # The Lockbox Address where this Lockbox Recipient may receive mail.
+        # The Lockbox Address where this Lockbox Recipient may receive mail. The Lockbox
+        # Address must have a `status` of `active`.
         lockbox_address_id:,
         # The description you choose for the Lockbox Recipient.
         description: nil,

data/rbi/increase/resources/simulations/card_authorizations.rbi

@@ -10,7 +10,10 @@ module Increase
         # `card_authorization` or a [Declined Transaction](#declined-transactions) of type
         # `card_decline`. You can pass either a Card id or a
         # [Digital Wallet Token](#digital-wallet-tokens) id to simulate the two different
-        # ways purchases can be made.
+        # ways purchases can be made. The response will contain either a
+        # `pending_transaction` or a `declined_transaction`; the other attribute will be
+        # null. If the authorization is declined, the reason is available on the Declined
+        # Transaction at `source.card_decline.reason`.
         sig do
           params(
             amount: Integer,

data/rbi/increase/resources/simulations/inbound_ach_transfers.rbi

@@ -50,7 +50,8 @@ module Increase
           company_entry_description: nil,
           # The sender's company ID.
           company_id: nil,
-          # The name of the sender.
+          # The name of the sender. This corresponds to the `originator_company_name` field
+          # on the resulting Inbound ACH Transfer.
           company_name: nil,
           # The ID of the receiver of the transfer.
           receiver_id_number: nil,

data/rbi/increase/resources/simulations/inbound_mail_items.rbi

@@ -5,7 +5,10 @@ module Increase
     class Simulations
       class InboundMailItems
         # Simulates an Inbound Mail Item to one of your Lockbox Addresses or Lockbox
-        # Recipients, as if someone had mailed a physical check.
+        # Recipients, as if someone had mailed a physical check. Increase automatically
+        # deposits a check mailed to a Lockbox Recipient into the recipient's Account. A
+        # check mailed to a Lockbox Address must be deposited or ignored with the
+        # [Action an Inbound Mail Item](#inbound-mail-items) endpoint.
         sig do
           params(
             amount: Integer,
@@ -21,9 +24,11 @@ module Increase
           # The file containing the PDF contents. If not present, a default check image file
           # will be used.
           contents_file_id: nil,
-          # The identifier of the Lockbox Address to simulate inbound mail to.
+          # The identifier of the Lockbox Address to simulate inbound mail to. Exactly one
+          # lockbox identifier parameter must be provided.
           lockbox_address_id: nil,
-          # The identifier of the Lockbox Recipient to simulate inbound mail to.
+          # The identifier of the Lockbox Recipient to simulate inbound mail to. Exactly one
+          # lockbox identifier parameter must be provided.
           lockbox_recipient_id: nil,
           request_options: {}
         )

data/sig/increase/models/ach_transfer.rbs

@@ -731,7 +731,7 @@ module Increase
           # 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.
+          # and be less than or equal to $1,000,000.00.
           SAME_DAY: :same_day
 
           # The chosen effective date will be the business day following the ACH processing date on which the transfer is submitted. The transfer will be settled on that future day.
@@ -1140,7 +1140,7 @@ module Increase
         # The transfer has been rejected.
         REJECTED: :rejected
 
-        # 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: :submitted
 
         # The transfer has been returned.

data/sig/increase/models/ach_transfer_create_params.rbs

@@ -333,7 +333,7 @@ module Increase
         module SettlementSchedule
           extend Increase::Internal::Type::Enum
 
-          # 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: :same_day
 
           # The chosen effective date will be the business day following the ACH processing date on which the transfer is submitted. The transfer will be settled on that future day.

data/sig/increase/models/ach_transfer_list_params.rbs

@@ -158,7 +158,7 @@ module Increase
           # The transfer has been rejected.
           REJECTED: :rejected
 
-          # 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: :submitted
 
           # The transfer has been returned.

data/sig/increase/models/card_push_transfer.rbs

@@ -1377,9 +1377,9 @@ module Increase
       type status =
         :pending_approval
         | :canceled
+        | :pending_submission
         | :pending_reviewing
         | :requires_attention
-        | :pending_submission
         | :submitted
         | :complete
         | :declined
@@ -1393,15 +1393,15 @@ module Increase
         # The transfer has been canceled.
         CANCELED: :canceled
 
+        # The transfer is queued to be submitted to the card network.
+        PENDING_SUBMISSION: :pending_submission
+
         # The transfer is pending review by Increase.
         PENDING_REVIEWING: :pending_reviewing
 
         # The transfer requires attention from an Increase operator.
         REQUIRES_ATTENTION: :requires_attention
 
-        # The transfer is queued to be submitted to the card network.
-        PENDING_SUBMISSION: :pending_submission
-
         # The transfer has been submitted and is pending a response from the card network.
         SUBMITTED: :submitted