increase 1.361.0 → 1.363.0

data/rbi/increase/models/export.rbi

@@ -903,23 +903,35 @@ module Increase
         end
         attr_writer :created_at
 
+        # Filter fees by the UTC start date of their fee statement's period, such as
+        # `2026-08-01`.
+        sig { returns(T.nilable(Date)) }
+        attr_accessor :fee_statement_period_start
+
         # Details of the fee CSV export. This field will be present when the `category` is
         # equal to `fee_csv`.
         sig do
           params(
-            created_at: T.nilable(Increase::Export::FeeCsv::CreatedAt::OrHash)
+            created_at: T.nilable(Increase::Export::FeeCsv::CreatedAt::OrHash),
+            fee_statement_period_start: T.nilable(Date)
           ).returns(T.attached_class)
         end
         def self.new(
           # Filter fees by their created date. The time range must not include any fees on
           # an open fee statement.
-          created_at:
+          created_at:,
+          # Filter fees by the UTC start date of their fee statement's period, such as
+          # `2026-08-01`.
+          fee_statement_period_start:
         )
         end
 
         sig do
           override.returns(
-            { created_at: T.nilable(Increase::Export::FeeCsv::CreatedAt) }
+            {
+              created_at: T.nilable(Increase::Export::FeeCsv::CreatedAt),
+              fee_statement_period_start: T.nilable(Date)
+            }
           )
         end
         def to_hash

data/rbi/increase/models/export_create_params.rbi

@@ -709,7 +709,10 @@ module Increase
             )
           end
 
-        # Filter results by time range on the `created_at` attribute.
+        # Filter exported Fees by the time they were created. This suits historical
+        # exports across many fee statements. To get all of the Fees for a given fee
+        # statement period, we recommend using `fee_statement_period_start` instead. The
+        # time range must not include any Fees on an open fee statement.
         sig do
           returns(T.nilable(Increase::ExportCreateParams::FeeCsv::CreatedAt))
         end
@@ -722,6 +725,15 @@ module Increase
         end
         attr_writer :created_at
 
+        # Filter exported Fees to the fee statements whose period starts on this UTC date,
+        # such as `2026-08-01`. Use this filter to export all of the Fees on a fee
+        # statement. The matching fee statements must be closed.
+        sig { returns(T.nilable(Date)) }
+        attr_reader :fee_statement_period_start
+
+        sig { params(fee_statement_period_start: Date).void }
+        attr_writer :fee_statement_period_start
+
         # Filter exported Fees to the specified Program.
         sig { returns(T.nilable(String)) }
         attr_reader :program_id
@@ -733,12 +745,20 @@ module Increase
         sig do
           params(
             created_at: Increase::ExportCreateParams::FeeCsv::CreatedAt::OrHash,
+            fee_statement_period_start: Date,
             program_id: String
           ).returns(T.attached_class)
         end
         def self.new(
-          # Filter results by time range on the `created_at` attribute.
+          # Filter exported Fees by the time they were created. This suits historical
+          # exports across many fee statements. To get all of the Fees for a given fee
+          # statement period, we recommend using `fee_statement_period_start` instead. The
+          # time range must not include any Fees on an open fee statement.
           created_at: nil,
+          # Filter exported Fees to the fee statements whose period starts on this UTC date,
+          # such as `2026-08-01`. Use this filter to export all of the Fees on a fee
+          # statement. The matching fee statements must be closed.
+          fee_statement_period_start: nil,
           # Filter exported Fees to the specified Program.
           program_id: nil
         )
@@ -748,6 +768,7 @@ module Increase
           override.returns(
             {
               created_at: Increase::ExportCreateParams::FeeCsv::CreatedAt,
+              fee_statement_period_start: Date,
               program_id: String
             }
           )
@@ -796,7 +817,10 @@ module Increase
           sig { params(on_or_before: Time).void }
           attr_writer :on_or_before
 
-          # Filter results by time range on the `created_at` attribute.
+          # Filter exported Fees by the time they were created. This suits historical
+          # exports across many fee statements. To get all of the Fees for a given fee
+          # statement period, we recommend using `fee_statement_period_start` instead. The
+          # time range must not include any Fees on an open fee statement.
           sig do
             params(
               after: Time,

data/rbi/increase/models/inbound_real_time_payments_transfer.rbi

@@ -95,6 +95,10 @@ module Increase
       sig { returns(T.nilable(String)) }
       attr_accessor :end_to_end_identification
 
+      # The identifier of the Real-Time Payments Transfer this transfer returns, if any.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :return_of_real_time_payments_transfer_id
+
       # The lifecycle status of the transfer.
       sig do
         returns(Increase::InboundRealTimePaymentsTransfer::Status::TaggedSymbol)
@@ -140,6 +144,7 @@ module Increase
               Increase::InboundRealTimePaymentsTransfer::Decline::OrHash
             ),
           end_to_end_identification: T.nilable(String),
+          return_of_real_time_payments_transfer_id: T.nilable(String),
           status: Increase::InboundRealTimePaymentsTransfer::Status::OrSymbol,
           transaction_identification: String,
           type: Increase::InboundRealTimePaymentsTransfer::Type::OrSymbol,
@@ -175,6 +180,8 @@ module Increase
         decline:,
         # A free-form reference string set by the sender, to help identify the transfer.
         end_to_end_identification:,
+        # The identifier of the Real-Time Payments Transfer this transfer returns, if any.
+        return_of_real_time_payments_transfer_id:,
         # The lifecycle status of the transfer.
         status:,
         # The Real-Time Payments network identification of the transfer.
@@ -208,6 +215,7 @@ module Increase
             decline:
               T.nilable(Increase::InboundRealTimePaymentsTransfer::Decline),
             end_to_end_identification: T.nilable(String),
+            return_of_real_time_payments_transfer_id: T.nilable(String),
             status:
               Increase::InboundRealTimePaymentsTransfer::Status::TaggedSymbol,
             transaction_identification: String,

data/rbi/increase/models/inbound_real_time_payments_transfer_return_params.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module Increase
+  module Models
+    class InboundRealTimePaymentsTransferReturnParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Increase::InboundRealTimePaymentsTransferReturnParams,
+            Increase::Internal::AnyHash
+          )
+        end
+
+      # The identifier of the Inbound Real-Time Payments Transfer to return to its
+      # sender.
+      sig { returns(String) }
+      attr_accessor :inbound_real_time_payments_transfer_id
+
+      # The amount to return, in USD cents. Defaults to the full amount of the Inbound
+      # Real-Time Payments Transfer, and can't be higher than it.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :amount
+
+      sig { params(amount: Integer).void }
+      attr_writer :amount
+
+      sig do
+        params(
+          inbound_real_time_payments_transfer_id: String,
+          amount: Integer,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The identifier of the Inbound Real-Time Payments Transfer to return to its
+        # sender.
+        inbound_real_time_payments_transfer_id:,
+        # The amount to return, in USD cents. Defaults to the full amount of the Inbound
+        # Real-Time Payments Transfer, and can't be higher than it.
+        amount: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            inbound_real_time_payments_transfer_id: String,
+            amount: Integer,
+            request_options: Increase::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/increase/models/real_time_payments_transfer.rbi

@@ -103,6 +103,10 @@ module Increase
       sig { returns(T.nilable(String)) }
       attr_accessor :debtor_name
 
+      # A free-form reference string set by the sender, to help identify the transfer.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :end_to_end_identification
+
       # The identifier of the External Account the transfer was made to, if any.
       sig { returns(T.nilable(String)) }
       attr_accessor :external_account_id
@@ -138,6 +142,11 @@ module Increase
       end
       attr_writer :rejection
 
+      # The identifier of the Inbound Real-Time Payments Transfer this transfer returns,
+      # if any.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :return_of_inbound_real_time_payments_transfer_id
+
       # The destination American Bankers' Association (ABA) Routing Transit Number
       # (RTN).
       sig { returns(String) }
@@ -209,12 +218,14 @@ module Increase
           creditor_name: String,
           currency: Increase::RealTimePaymentsTransfer::Currency::OrSymbol,
           debtor_name: T.nilable(String),
+          end_to_end_identification: T.nilable(String),
           external_account_id: T.nilable(String),
           idempotency_key: T.nilable(String),
           inbound_real_time_payments_request_for_payment_id: T.nilable(String),
           pending_transaction_id: T.nilable(String),
           rejection:
             T.nilable(Increase::RealTimePaymentsTransfer::Rejection::OrHash),
+          return_of_inbound_real_time_payments_transfer_id: T.nilable(String),
           routing_number: String,
           source_account_number_id: String,
           status: Increase::RealTimePaymentsTransfer::Status::OrSymbol,
@@ -259,6 +270,8 @@ module Increase
         # The name of the transfer's sender. If not provided, defaults to the name of the
         # account's entity.
         debtor_name:,
+        # A free-form reference string set by the sender, to help identify the transfer.
+        end_to_end_identification:,
         # The identifier of the External Account the transfer was made to, if any.
         external_account_id:,
         # The idempotency key you chose for this object. This value is unique across
@@ -276,6 +289,9 @@ module Increase
         # If the transfer is rejected by Real-Time Payments or the destination financial
         # institution, this will contain supplemental details.
         rejection:,
+        # The identifier of the Inbound Real-Time Payments Transfer this transfer returns,
+        # if any.
+        return_of_inbound_real_time_payments_transfer_id:,
         # The destination American Bankers' Association (ABA) Routing Transit Number
         # (RTN).
         routing_number:,
@@ -321,12 +337,14 @@ module Increase
             currency:
               Increase::RealTimePaymentsTransfer::Currency::TaggedSymbol,
             debtor_name: T.nilable(String),
+            end_to_end_identification: T.nilable(String),
             external_account_id: T.nilable(String),
             idempotency_key: T.nilable(String),
             inbound_real_time_payments_request_for_payment_id:
               T.nilable(String),
             pending_transaction_id: T.nilable(String),
             rejection: T.nilable(Increase::RealTimePaymentsTransfer::Rejection),
+            return_of_inbound_real_time_payments_transfer_id: T.nilable(String),
             routing_number: String,
             source_account_number_id: String,
             status: Increase::RealTimePaymentsTransfer::Status::TaggedSymbol,

data/rbi/increase/models/simulations/card_dispute_action_params.rbi

@@ -149,6 +149,25 @@ module Increase
           end
           attr_writer :accept_chargeback
 
+          # The parameters for accepting the user prearbitration. Required if and only if
+          # `action` is `accept_user_prearbitration`.
+          sig do
+            returns(
+              T.nilable(
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration
+              )
+            )
+          end
+          attr_reader :accept_user_prearbitration
+
+          sig do
+            params(
+              accept_user_prearbitration:
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration::OrHash
+            ).void
+          end
+          attr_writer :accept_user_prearbitration
+
           # The parameters for accepting the user submission. Required if and only if
           # `action` is `accept_user_submission`.
           sig do
@@ -347,6 +366,8 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::OrSymbol,
               accept_chargeback:
                 Increase::Simulations::CardDisputeActionParams::Visa::AcceptChargeback::OrHash,
+              accept_user_prearbitration:
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration::OrHash,
               accept_user_submission:
                 Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserSubmission::OrHash,
               decline_user_prearbitration:
@@ -376,6 +397,9 @@ module Increase
             # The parameters for accepting the chargeback. Required if and only if `action` is
             # `accept_chargeback`.
             accept_chargeback: nil,
+            # The parameters for accepting the user prearbitration. Required if and only if
+            # `action` is `accept_user_prearbitration`.
+            accept_user_prearbitration: nil,
             # The parameters for accepting the user submission. Required if and only if
             # `action` is `accept_user_submission`.
             accept_user_submission: nil,
@@ -416,6 +440,8 @@ module Increase
                   Increase::Simulations::CardDisputeActionParams::Visa::Action::OrSymbol,
                 accept_chargeback:
                   Increase::Simulations::CardDisputeActionParams::Visa::AcceptChargeback,
+                accept_user_prearbitration:
+                  Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration,
                 accept_user_submission:
                   Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserSubmission,
                 decline_user_prearbitration:
@@ -463,6 +489,13 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
+            # Simulate the merchant accepting the user's pre-arbitration. This will move the dispute to a `won` state.
+            ACCEPT_USER_PREARBITRATION =
+              T.let(
+                :accept_user_prearbitration,
+                Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
+              )
+
             # Accept the user's submission and transmit it to the network. This will move the dispute to a `pending_response` state.
             ACCEPT_USER_SUBMISSION =
               T.let(
@@ -477,7 +510,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant issuing pre-arbitration. This will move the dispute to a `user_submission_required` state.
+            # Simulate the merchant issuing pre-arbitration. Only available for disputes in the fraud or authorization category. This will move the dispute to a `user_submission_required` state.
             RECEIVE_MERCHANT_PREARBITRATION =
               T.let(
                 :receive_merchant_prearbitration,
@@ -491,7 +524,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant re-presenting the dispute. This will move the dispute to a `user_submission_required` state.
+            # Simulate the merchant re-presenting the dispute. Only available for disputes in a consumer or processing error category. This will move the dispute to a `user_submission_required` state.
             REPRESENT =
               T.let(
                 :represent,
@@ -526,7 +559,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant timing out responding to a user pre-arbitration. This will move the dispute to a `win` state.
+            # Simulate the merchant timing out responding to a user pre-arbitration. This will move the dispute to a `won` state.
             TIME_OUT_USER_PREARBITRATION =
               T.let(
                 :time_out_user_prearbitration,
@@ -564,6 +597,26 @@ module Increase
             end
           end
 
+          class AcceptUserPrearbitration < Increase::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration,
+                  Increase::Internal::AnyHash
+                )
+              end
+
+            # The parameters for accepting the user prearbitration. Required if and only if
+            # `action` is `accept_user_prearbitration`.
+            sig { returns(T.attached_class) }
+            def self.new
+            end
+
+            sig { override.returns({}) }
+            def to_hash
+            end
+          end
+
           class AcceptUserSubmission < Increase::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

data/rbi/increase/models/simulations/wire_drawdown_request_refuse_params.rbi

@@ -19,15 +19,51 @@ module Increase
         sig { returns(String) }
         attr_accessor :wire_drawdown_request_id
 
+        # Additional information about the refusal that the simulated refusal will have.
+        sig { returns(T.nilable(String)) }
+        attr_reader :refusal_reason_additional_information
+
+        sig { params(refusal_reason_additional_information: String).void }
+        attr_writer :refusal_reason_additional_information
+
+        # The reason code that the simulated refusal will have.
+        #
+        # Defaults to `other`.
+        sig do
+          returns(
+            T.nilable(
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol
+            )
+          )
+        end
+        attr_reader :refusal_reason_code
+
+        sig do
+          params(
+            refusal_reason_code:
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol
+          ).void
+        end
+        attr_writer :refusal_reason_code
+
         sig do
           params(
             wire_drawdown_request_id: String,
+            refusal_reason_additional_information: String,
+            refusal_reason_code:
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol,
             request_options: Increase::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
           # The identifier of the Wire Drawdown Request you wish to refuse.
           wire_drawdown_request_id:,
+          # Additional information about the refusal that the simulated refusal will have.
+          refusal_reason_additional_information: nil,
+          # The reason code that the simulated refusal will have.
+          #
+          # Defaults to `other`.
+          refusal_reason_code: nil,
           request_options: {}
         )
         end
@@ -36,12 +72,83 @@ module Increase
           override.returns(
             {
               wire_drawdown_request_id: String,
+              refusal_reason_additional_information: String,
+              refusal_reason_code:
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol,
               request_options: Increase::RequestOptions
             }
           )
         end
         def to_hash
         end
+
+        # The reason code that the simulated refusal will have.
+        #
+        # Defaults to `other`.
+        module RefusalReasonCode
+          extend Increase::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          # The debtor's account number is invalid or missing. Corresponds to the Fedwire reason code `AC02`.
+          INVALID_DEBTOR_ACCOUNT_NUMBER =
+            T.let(
+              :invalid_debtor_account_number,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor account does not allow drawdown requests. Corresponds to the Fedwire reason code `AG01`.
+          TRANSACTION_FORBIDDEN =
+            T.let(
+              :transaction_forbidden,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor account cannot be debited for a generic reason. Corresponds to the Fedwire reason code `AG07`.
+          UNSUCCESSFUL_DIRECT_DEBIT =
+            T.let(
+              :unsuccessful_direct_debit,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor's identification is inconsistent with the debtor account number. Corresponds to the Fedwire reason code `BE01`.
+          INCONSISTENT_WITH_END_CUSTOMER =
+            T.let(
+              :inconsistent_with_end_customer,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The reason is provided as narrative information in the additional information field. Corresponds to the Fedwire reason code `NARR`.
+          NARRATIVE =
+            T.let(
+              :narrative,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # Some other error or issue has occurred.
+          OTHER =
+            T.let(
+              :other,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/increase/models/transaction.rbi

@@ -2010,7 +2010,7 @@ module Increase
           attr_accessor :routing_number
 
           # A description set when the ACH Transfer was created.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :statement_descriptor
 
           # The identifier of the ACH Transfer that led to this Transaction.
@@ -2026,7 +2026,7 @@ module Increase
               account_number: String,
               amount: Integer,
               routing_number: String,
-              statement_descriptor: String,
+              statement_descriptor: T.nilable(String),
               transfer_id: String
             ).returns(T.attached_class)
           end
@@ -2052,7 +2052,7 @@ module Increase
                 account_number: String,
                 amount: Integer,
                 routing_number: String,
-                statement_descriptor: String,
+                statement_descriptor: T.nilable(String),
                 transfer_id: String
               }
             )