increase 1.341.0 → 1.342.0

data/lib/increase/models/inbound_wire_transfer.rb

@@ -65,6 +65,12 @@ module Increase
       #   @return [String, nil]
       required :creditor_name, String, nil?: true
 
+      # @!attribute debtor_account_number
+      #   The account number of the sender.
+      #
+      #   @return [String, nil]
+      required :debtor_account_number, String, nil?: true
+
       # @!attribute debtor_address_line1
       #   A free-form address field set by the sender.
       #
@@ -89,6 +95,12 @@ module Increase
       #   @return [String, nil]
       required :debtor_name, String, nil?: true
 
+      # @!attribute debtor_routing_number
+      #   The American Banking Association (ABA) routing number of the sender.
+      #
+      #   @return [String, nil]
+      required :debtor_routing_number, String, nil?: true
+
       # @!attribute description
       #   An Increase-constructed description of the transfer.
       #
@@ -167,7 +179,7 @@ module Increase
       #   @return [String, nil]
       required :wire_drawdown_request_id, String, nil?: true
 
-      # @!method initialize(id:, acceptance:, account_id:, account_number_id:, amount:, created_at:, creditor_address_line1:, creditor_address_line2:, creditor_address_line3:, creditor_name:, debtor_address_line1:, debtor_address_line2:, debtor_address_line3:, debtor_name:, description:, end_to_end_identification:, input_message_accountability_data:, instructing_agent_routing_number:, instruction_identification:, purpose:, reversal:, status:, type:, unique_end_to_end_transaction_reference:, unstructured_remittance_information:, wire_drawdown_request_id:)
+      # @!method initialize(id:, acceptance:, account_id:, account_number_id:, amount:, created_at:, creditor_address_line1:, creditor_address_line2:, creditor_address_line3:, creditor_name:, debtor_account_number:, debtor_address_line1:, debtor_address_line2:, debtor_address_line3:, debtor_name:, debtor_routing_number:, description:, end_to_end_identification:, input_message_accountability_data:, instructing_agent_routing_number:, instruction_identification:, purpose:, reversal:, status:, type:, unique_end_to_end_transaction_reference:, unstructured_remittance_information:, wire_drawdown_request_id:)
       #   An Inbound Wire Transfer is a wire transfer initiated outside of Increase to
       #   your account.
       #
@@ -194,6 +206,8 @@ module Increase
       #
       #   @param creditor_name [String, nil] A name set by the sender.
       #
+      #   @param debtor_account_number [String, nil] The account number of the sender.
+      #
       #   @param debtor_address_line1 [String, nil] A free-form address field set by the sender.
       #
       #   @param debtor_address_line2 [String, nil] A free-form address field set by the sender.
@@ -202,6 +216,9 @@ module Increase
       #
       #   @param debtor_name [String, nil] A name set by the sender.
       #
+      #   @param debtor_routing_number [String, nil]
+      #     The American Banking Association (ABA) routing number of the sender.
+      #
       #   @param description [String] An Increase-constructed description of the transfer.
       #
       #   @param end_to_end_identification [String, nil]

data/lib/increase/models/simulations/ach_transfer_return_params.rb

@@ -14,6 +14,14 @@ module Increase
         #   @return [String]
         required :ach_transfer_id, String
 
+        # @!attribute addenda_information
+        #   Free-form information the returning bank includes in the return addenda. For a
+        #   `file_record_edit_criteria` (R17) return, set this to `QUESTIONABLE` to simulate
+        #   a return the bank believes was initiated under questionable circumstances.
+        #
+        #   @return [String, nil]
+        optional :addenda_information, String
+
         # @!attribute reason
         #   The reason why the Federal Reserve or destination bank returned this transfer.
         #   Defaults to `no_account`.
@@ -21,9 +29,14 @@ module Increase
         #   @return [Symbol, Increase::Models::Simulations::ACHTransferReturnParams::Reason, nil]
         optional :reason, enum: -> { Increase::Simulations::ACHTransferReturnParams::Reason }
 
-        # @!method initialize(ach_transfer_id:, reason: nil, request_options: {})
+        # @!method initialize(ach_transfer_id:, addenda_information: nil, reason: nil, request_options: {})
         #   @param ach_transfer_id [String] The identifier of the ACH Transfer you wish to return.
         #
+        #   @param addenda_information [String]
+        #     Free-form information the returning bank includes in the return addenda. For a
+        #     `file_record_edit_criteria` (R17) return, set this to `QUESTIONABLE` to simulate
+        #     a return the bank believes was initiated under questionable circumstances.
+        #
         #   @param reason [Symbol, Increase::Models::Simulations::ACHTransferReturnParams::Reason]
         #     The reason why the Federal Reserve or destination bank returned this transfer.
         #     Defaults to `no_account`.
@@ -85,7 +98,7 @@ module Increase
           # Code R13. The routing number is invalid.
           INVALID_ACH_ROUTING_NUMBER = :invalid_ach_routing_number
 
-          # Code R17. The receiving bank is unable to process a field in the transfer.
+          # Code R17. This return code has multiple meanings. The receiving bank was either unable to process a field in the transfer, or believes the transfer was initiated under questionable circumstances (such as fraud), or identified an improperly-initiated reversing entry.
           FILE_RECORD_EDIT_CRITERIA = :file_record_edit_criteria
 
           # Code R45. A rare return reason. The individual name field was invalid.

data/lib/increase/models/simulations/card_settlement_create_params.rb

@@ -14,30 +14,32 @@ module Increase
         #   @return [String]
         required :card_id, String
 
-        # @!attribute pending_transaction_id
-        #   The identifier of the Pending Transaction for the Card Authorization you wish to
-        #   settle.
-        #
-        #   @return [String]
-        required :pending_transaction_id, String
-
         # @!attribute amount
         #   The amount to be settled. This defaults to the amount of the Pending Transaction
-        #   being settled.
+        #   being settled, or a random amount if `pending_transaction_id` is not provided.
         #
         #   @return [Integer, nil]
         optional :amount, Integer
 
-        # @!method initialize(card_id:, pending_transaction_id:, amount: nil, request_options: {})
-        #   @param card_id [String] The identifier of the Card to create a settlement on.
+        # @!attribute pending_transaction_id
+        #   The identifier of the Pending Transaction for the Card Authorization you wish to
+        #   settle. If not provided, the settlement will be force posted without a Card
+        #   Authorization.
         #
-        #   @param pending_transaction_id [String]
-        #     The identifier of the Pending Transaction for the Card Authorization you wish to
-        #     settle.
+        #   @return [String, nil]
+        optional :pending_transaction_id, String
+
+        # @!method initialize(card_id:, amount: nil, pending_transaction_id: nil, request_options: {})
+        #   @param card_id [String] The identifier of the Card to create a settlement on.
         #
         #   @param amount [Integer]
         #     The amount to be settled. This defaults to the amount of the Pending Transaction
-        #     being settled.
+        #     being settled, or a random amount if `pending_transaction_id` is not provided.
+        #
+        #   @param pending_transaction_id [String]
+        #     The identifier of the Pending Transaction for the Card Authorization you wish to
+        #     settle. If not provided, the settlement will be force posted without a Card
+        #     Authorization.
         #
         #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/increase/models/simulations/program_create_params.rb

@@ -58,9 +58,6 @@ module Increase
           # Grasshopper Bank
           GRASSHOPPER_BANK = :grasshopper_bank
 
-          # Twin City Bank
-          TWIN_CITY_BANK = :twin_city_bank
-
           # @!method self.values
           #   @return [Array<Symbol>]
         end

data/lib/increase/models/swift_transfer.rb

@@ -93,6 +93,13 @@ module Increase
       #   @return [Symbol, Increase::Models::SwiftTransfer::InstructedCurrency]
       required :instructed_currency, enum: -> { Increase::SwiftTransfer::InstructedCurrency }
 
+      # @!attribute intermediary_bank_identification_code
+      #   The bank identification code (BIC) of the intermediary bank, if the transfer is
+      #   routed through one.
+      #
+      #   @return [String, nil]
+      required :intermediary_bank_identification_code, String, nil?: true
+
       # @!attribute pending_transaction_id
       #   The ID for the pending transaction representing the transfer.
       #
@@ -146,7 +153,7 @@ module Increase
       #   @return [String]
       required :unstructured_remittance_information, String
 
-      # @!method initialize(id:, account_id:, account_number:, amount:, bank_identification_code:, created_at:, created_by:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, idempotency_key:, instructed_amount:, instructed_currency:, pending_transaction_id:, routing_number:, source_account_number_id:, status:, transaction_id:, type:, unique_end_to_end_transaction_reference:, unstructured_remittance_information:)
+      # @!method initialize(id:, account_id:, account_number:, amount:, bank_identification_code:, created_at:, created_by:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, idempotency_key:, instructed_amount:, instructed_currency:, intermediary_bank_identification_code:, pending_transaction_id:, routing_number:, source_account_number_id:, status:, transaction_id:, type:, unique_end_to_end_transaction_reference:, unstructured_remittance_information:)
       #   Swift Transfers send funds internationally.
       #
       #   @param id [String] The Swift transfer's identifier.
@@ -187,6 +194,10 @@ module Increase
       #     The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the
       #     instructed amount.
       #
+      #   @param intermediary_bank_identification_code [String, nil]
+      #     The bank identification code (BIC) of the intermediary bank, if the transfer is
+      #     routed through one.
+      #
       #   @param pending_transaction_id [String, nil] The ID for the pending transaction representing the transfer.
       #
       #   @param routing_number [String, nil]

data/lib/increase/models/swift_transfer_create_params.rb

@@ -76,6 +76,13 @@ module Increase
       #   @return [String]
       required :unstructured_remittance_information, String
 
+      # @!attribute intermediary_bank_identification_code
+      #   The bank identification code (BIC) of the intermediary bank, if the transfer
+      #   should be routed through one.
+      #
+      #   @return [String, nil]
+      optional :intermediary_bank_identification_code, String
+
       # @!attribute require_approval
       #   Whether the transfer requires explicit approval via the dashboard or API.
       #
@@ -89,7 +96,7 @@ module Increase
       #   @return [String, nil]
       optional :routing_number, String
 
-      # @!method initialize(account_id:, account_number:, bank_identification_code:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, instructed_amount:, instructed_currency:, source_account_number_id:, unstructured_remittance_information:, require_approval: nil, routing_number: nil, request_options: {})
+      # @!method initialize(account_id:, account_number:, bank_identification_code:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, instructed_amount:, instructed_currency:, source_account_number_id:, unstructured_remittance_information:, intermediary_bank_identification_code: nil, require_approval: nil, routing_number: nil, request_options: {})
       #   @param account_id [String] The identifier for the account that will send the transfer.
       #
       #   @param account_number [String] The creditor's account number.
@@ -121,6 +128,10 @@ module Increase
       #   @param unstructured_remittance_information [String]
       #     Unstructured remittance information to include in the transfer.
       #
+      #   @param intermediary_bank_identification_code [String]
+      #     The bank identification code (BIC) of the intermediary bank, if the transfer
+      #     should be routed through one.
+      #
       #   @param require_approval [Boolean]
       #     Whether the transfer requires explicit approval via the dashboard or API.
       #

data/lib/increase/models/transaction.rb

@@ -1112,6 +1112,17 @@ module Increase
 
         # @see Increase::Models::Transaction::Source#ach_transfer_return
         class ACHTransferReturn < Increase::Internal::Type::BaseModel
+          # @!attribute addenda_information
+          #   Additional free-form information included by the receiving bank in the return's
+          #   addenda record. This is raw, uninterpreted text whose presence and format are
+          #   not guaranteed. For a `file_record_edit_criteria` (R17) return the receiving
+          #   bank may set this to `QUESTIONABLE` (optionally followed by more text) to
+          #   indicate it believes the transfer was initiated under questionable
+          #   circumstances.
+          #
+          #   @return [String, nil]
+          required :addenda_information, String, nil?: true
+
           # @!attribute created_at
           #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
           #   the transfer was created.
@@ -1155,7 +1166,7 @@ module Increase
           #   @return [String]
           required :transfer_id, String
 
-          # @!method initialize(created_at:, raw_return_reason_code:, return_reason_code:, trace_number:, transaction_id:, transfer_id:)
+          # @!method initialize(addenda_information:, created_at:, raw_return_reason_code:, return_reason_code:, trace_number:, transaction_id:, transfer_id:)
           #   An ACH Transfer Return object. This field will be present in the JSON response
           #   if and only if `category` is equal to `ach_transfer_return`. An ACH Transfer
           #   Return is created when an ACH Transfer is returned by the receiving bank. It
@@ -1164,6 +1175,14 @@ module Increase
           #   later. The return appears as a new posted Transaction; no Pending Transaction is
           #   created.
           #
+          #   @param addenda_information [String, nil]
+          #     Additional free-form information included by the receiving bank in the return's
+          #     addenda record. This is raw, uninterpreted text whose presence and format are
+          #     not guaranteed. For a `file_record_edit_criteria` (R17) return the receiving
+          #     bank may set this to `QUESTIONABLE` (optionally followed by more text) to
+          #     indicate it believes the transfer was initiated under questionable
+          #     circumstances.
+          #
           #   @param created_at [Time]
           #     The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
           #     the transfer was created.
@@ -1243,7 +1262,7 @@ module Increase
             # Code R13. The routing number is invalid.
             INVALID_ACH_ROUTING_NUMBER = :invalid_ach_routing_number
 
-            # Code R17. The receiving bank is unable to process a field in the transfer.
+            # Code R17. This return code has multiple meanings. The receiving bank was either unable to process a field in the transfer, or believes the transfer was initiated under questionable circumstances (such as fraud), or identified an improperly-initiated reversing entry.
             FILE_RECORD_EDIT_CRITERIA = :file_record_edit_criteria
 
             # Code R45. A rare return reason. The individual name field was invalid.

data/lib/increase/models/unwrap_webhook_event.rb

@@ -253,6 +253,14 @@ module Increase
         # Occurs whenever an Inbound Mail Item is updated.
         INBOUND_MAIL_ITEM_UPDATED = :"inbound_mail_item.updated"
 
+        # Occurs whenever an Inbound Real-Time Payments Request for Payment is created.
+        INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED =
+          :"inbound_real_time_payments_request_for_payment.created"
+
+        # Occurs whenever an Inbound Real-Time Payments Request for Payment is updated.
+        INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED =
+          :"inbound_real_time_payments_request_for_payment.updated"
+
         # Occurs whenever an Inbound Real-Time Payments Transfer is created.
         INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = :"inbound_real_time_payments_transfer.created"
 

data/lib/increase/resources/simulations/ach_transfers.rb

@@ -67,10 +67,15 @@ module Increase
         # due to an error condition. This will also create a Transaction to account for
         # the returned funds. This transfer must first have a `status` of `submitted`.
         #
-        # @overload return_(ach_transfer_id, reason: nil, request_options: {})
+        # @overload return_(ach_transfer_id, addenda_information: nil, reason: nil, request_options: {})
         #
         # @param ach_transfer_id [String] The identifier of the ACH Transfer you wish to return.
         #
+        # @param addenda_information [String]
+        #   Free-form information the returning bank includes in the return addenda. For a
+        #   `file_record_edit_criteria` (R17) return, set this to `QUESTIONABLE` to simulate
+        #   a return the bank believes was initiated under questionable circumstances.
+        #
         # @param reason [Symbol, Increase::Models::Simulations::ACHTransferReturnParams::Reason]
         #   The reason why the Federal Reserve or destination bank returned this transfer.
         #   Defaults to `no_account`.

data/lib/increase/resources/simulations/card_settlements.rb

@@ -10,17 +10,18 @@ module Increase
         # production. The amount settled can be different from the amount originally
         # authorized, for example, when adding a tip to a restaurant bill.
         #
-        # @overload create(card_id:, pending_transaction_id:, amount: nil, request_options: {})
+        # @overload create(card_id:, amount: nil, pending_transaction_id: nil, request_options: {})
         #
         # @param card_id [String] The identifier of the Card to create a settlement on.
         #
-        # @param pending_transaction_id [String]
-        #   The identifier of the Pending Transaction for the Card Authorization you wish to
-        #   settle.
-        #
         # @param amount [Integer]
         #   The amount to be settled. This defaults to the amount of the Pending Transaction
-        #   being settled.
+        #   being settled, or a random amount if `pending_transaction_id` is not provided.
+        #
+        # @param pending_transaction_id [String]
+        #   The identifier of the Pending Transaction for the Card Authorization you wish to
+        #   settle. If not provided, the settlement will be force posted without a Card
+        #   Authorization.
         #
         # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/increase/resources/swift_transfers.rb

@@ -5,7 +5,7 @@ module Increase
     class SwiftTransfers
       # Create a Swift Transfer
       #
-      # @overload create(account_id:, account_number:, bank_identification_code:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, instructed_amount:, instructed_currency:, source_account_number_id:, unstructured_remittance_information:, require_approval: nil, routing_number: nil, request_options: {})
+      # @overload create(account_id:, account_number:, bank_identification_code:, creditor_address:, creditor_name:, debtor_address:, debtor_name:, instructed_amount:, instructed_currency:, source_account_number_id:, unstructured_remittance_information:, intermediary_bank_identification_code: nil, require_approval: nil, routing_number: nil, request_options: {})
       #
       # @param account_id [String] The identifier for the account that will send the transfer.
       #
@@ -38,6 +38,10 @@ module Increase
       # @param unstructured_remittance_information [String]
       #   Unstructured remittance information to include in the transfer.
       #
+      # @param intermediary_bank_identification_code [String]
+      #   The bank identification code (BIC) of the intermediary bank, if the transfer
+      #   should be routed through one.
+      #
       # @param require_approval [Boolean]
       #   Whether the transfer requires explicit approval via the dashboard or API.
       #

data/lib/increase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Increase
-  VERSION = "1.341.0"
+  VERSION = "1.342.0"
 end

data/rbi/increase/models/ach_prenotification.rbi

@@ -770,7 +770,7 @@ module Increase
               Increase::ACHPrenotification::PrenotificationReturn::ReturnReasonCode::TaggedSymbol
             )
 
-          # Code R17. The receiving bank is unable to process a field in the transfer.
+          # Code R17. This return code has multiple meanings. The receiving bank was either unable to process a field in the transfer, or believes the transfer was initiated under questionable circumstances (such as fraud), or identified an improperly-initiated reversing entry.
           FILE_RECORD_EDIT_CRITERIA =
             T.let(
               :file_record_edit_criteria,

data/rbi/increase/models/ach_transfer.rbi

@@ -1814,6 +1814,15 @@ module Increase
             T.any(Increase::ACHTransfer::Return, Increase::Internal::AnyHash)
           end
 
+        # Additional free-form information included by the receiving bank in the return's
+        # addenda record. This is raw, uninterpreted text whose presence and format are
+        # not guaranteed. For a `file_record_edit_criteria` (R17) return the receiving
+        # bank may set this to `QUESTIONABLE` (optionally followed by more text) to
+        # indicate it believes the transfer was initiated under questionable
+        # circumstances.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :addenda_information
+
         # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
         # the transfer was created.
         sig { returns(Time) }
@@ -1849,6 +1858,7 @@ module Increase
         # If your transfer is returned, this will contain details of the return.
         sig do
           params(
+            addenda_information: T.nilable(String),
             created_at: Time,
             raw_return_reason_code: String,
             return_reason_code:
@@ -1859,6 +1869,13 @@ module Increase
           ).returns(T.attached_class)
         end
         def self.new(
+          # Additional free-form information included by the receiving bank in the return's
+          # addenda record. This is raw, uninterpreted text whose presence and format are
+          # not guaranteed. For a `file_record_edit_criteria` (R17) return the receiving
+          # bank may set this to `QUESTIONABLE` (optionally followed by more text) to
+          # indicate it believes the transfer was initiated under questionable
+          # circumstances.
+          addenda_information:,
           # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
           # the transfer was created.
           created_at:,
@@ -1883,6 +1900,7 @@ module Increase
         sig do
           override.returns(
             {
+              addenda_information: T.nilable(String),
               created_at: Time,
               raw_return_reason_code: String,
               return_reason_code:
@@ -2019,7 +2037,7 @@ module Increase
               Increase::ACHTransfer::Return::ReturnReasonCode::TaggedSymbol
             )
 
-          # Code R17. The receiving bank is unable to process a field in the transfer.
+          # Code R17. This return code has multiple meanings. The receiving bank was either unable to process a field in the transfer, or believes the transfer was initiated under questionable circumstances (such as fraud), or identified an improperly-initiated reversing entry.
           FILE_RECORD_EDIT_CRITERIA =
             T.let(
               :file_record_edit_criteria,

data/rbi/increase/models/beneficial_owner_create_params.rbi

@@ -205,14 +205,18 @@ module Increase
           sig { returns(String) }
           attr_accessor :city
 
-          # The two-letter ISO 3166-1 alpha-2 code for the country of the address.
-          sig { returns(String) }
-          attr_accessor :country
-
           # The first line of the address. This is usually the street number and street.
           sig { returns(String) }
           attr_accessor :line1
 
+          # The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
+          # to `US`.
+          sig { returns(T.nilable(String)) }
+          attr_reader :country
+
+          sig { params(country: String).void }
+          attr_writer :country
+
           # The second line of the address. This might be the floor or room number.
           sig { returns(T.nilable(String)) }
           attr_reader :line2
@@ -240,8 +244,8 @@ module Increase
           sig do
             params(
               city: String,
-              country: String,
               line1: String,
+              country: String,
               line2: String,
               state: String,
               zip: String
@@ -250,10 +254,11 @@ module Increase
           def self.new(
             # The city, district, town, or village of the address.
             city:,
-            # The two-letter ISO 3166-1 alpha-2 code for the country of the address.
-            country:,
             # The first line of the address. This is usually the street number and street.
             line1:,
+            # The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
+            # to `US`.
+            country: nil,
             # The second line of the address. This might be the floor or room number.
             line2: nil,
             # The two-letter United States Postal Service (USPS) abbreviation for the US
@@ -268,8 +273,8 @@ module Increase
             override.returns(
               {
                 city: String,
-                country: String,
                 line1: String,
+                country: String,
                 line2: String,
                 state: String,
                 zip: String

data/rbi/increase/models/beneficial_owner_update_params.rbi

@@ -152,14 +152,18 @@ module Increase
         sig { returns(String) }
         attr_accessor :city
 
-        # The two-letter ISO 3166-1 alpha-2 code for the country of the address.
-        sig { returns(String) }
-        attr_accessor :country
-
         # The first line of the address. This is usually the street number and street.
         sig { returns(String) }
         attr_accessor :line1
 
+        # The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
+        # to `US`.
+        sig { returns(T.nilable(String)) }
+        attr_reader :country
+
+        sig { params(country: String).void }
+        attr_writer :country
+
         # The second line of the address. This might be the floor or room number.
         sig { returns(T.nilable(String)) }
         attr_reader :line2
@@ -187,8 +191,8 @@ module Increase
         sig do
           params(
             city: String,
-            country: String,
             line1: String,
+            country: String,
             line2: String,
             state: String,
             zip: String
@@ -197,10 +201,11 @@ module Increase
         def self.new(
           # The city, district, town, or village of the address.
           city:,
-          # The two-letter ISO 3166-1 alpha-2 code for the country of the address.
-          country:,
           # The first line of the address. This is usually the street number and street.
           line1:,
+          # The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
+          # to `US`.
+          country: nil,
           # The second line of the address. This might be the floor or room number.
           line2: nil,
           # The two-letter United States Postal Service (USPS) abbreviation for the US
@@ -215,8 +220,8 @@ module Increase
           override.returns(
             {
               city: String,
-              country: String,
               line1: String,
+              country: String,
               line2: String,
               state: String,
               zip: String

data/rbi/increase/models/check_transfer.rbi

@@ -836,7 +836,8 @@ module Increase
         end
         attr_writer :signature
 
-        # Tracking updates relating to the physical check's delivery.
+        # Tracking updates relating to the physical check's delivery. Sorted by
+        # `created_at` in ascending order.
         sig do
           returns(
             T::Array[Increase::CheckTransfer::PhysicalCheck::TrackingUpdate]
@@ -896,7 +897,8 @@ module Increase
           shipping_method:,
           # The signature that will appear on the check.
           signature:,
-          # Tracking updates relating to the physical check's delivery.
+          # Tracking updates relating to the physical check's delivery. Sorted by
+          # `created_at` in ascending order.
           tracking_updates:
         )
         end