increase 1.333.1 → 1.335.0

data/rbi/increase/models/inbound_wire_transfer.rbi

@@ -96,6 +96,10 @@ module Increase
       sig { returns(T.nilable(String)) }
       attr_accessor :instruction_identification
 
+      # The reason for the wire transfer, as set by the sender.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :purpose
+
       # If the transfer is reversed, this will contain details of the reversal.
       sig { returns(T.nilable(Increase::InboundWireTransfer::Reversal)) }
       attr_reader :reversal
@@ -154,6 +158,7 @@ module Increase
           input_message_accountability_data: T.nilable(String),
           instructing_agent_routing_number: T.nilable(String),
           instruction_identification: T.nilable(String),
+          purpose: T.nilable(String),
           reversal: T.nilable(Increase::InboundWireTransfer::Reversal::OrHash),
           status: Increase::InboundWireTransfer::Status::OrSymbol,
           type: Increase::InboundWireTransfer::Type::OrSymbol,
@@ -205,6 +210,8 @@ module Increase
         instructing_agent_routing_number:,
         # The sending bank's identifier for the wire transfer.
         instruction_identification:,
+        # The reason for the wire transfer, as set by the sender.
+        purpose:,
         # If the transfer is reversed, this will contain details of the reversal.
         reversal:,
         # The status of the transfer.
@@ -245,6 +252,7 @@ module Increase
             input_message_accountability_data: T.nilable(String),
             instructing_agent_routing_number: T.nilable(String),
             instruction_identification: T.nilable(String),
+            purpose: T.nilable(String),
             reversal: T.nilable(Increase::InboundWireTransfer::Reversal),
             status: Increase::InboundWireTransfer::Status::TaggedSymbol,
             type: Increase::InboundWireTransfer::Type::TaggedSymbol,

data/rbi/increase/models/pending_transaction.rbi

@@ -1395,6 +1395,27 @@ module Increase
           sig { returns(Time) }
           attr_accessor :expires_at
 
+          # The healthcare-related fields for this authorization. Only present for specific
+          # programs.
+          sig do
+            returns(
+              T.nilable(
+                Increase::PendingTransaction::Source::CardAuthorization::Healthcare
+              )
+            )
+          end
+          attr_reader :healthcare
+
+          sig do
+            params(
+              healthcare:
+                T.nilable(
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare::OrHash
+                )
+            ).void
+          end
+          attr_writer :healthcare
+
           # The merchant identifier (commonly abbreviated as MID) of the merchant the card
           # is transacting with.
           sig { returns(String) }
@@ -1555,6 +1576,10 @@ module Increase
               direction:
                 Increase::PendingTransaction::Source::CardAuthorization::Direction::OrSymbol,
               expires_at: Time,
+              healthcare:
+                T.nilable(
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare::OrHash
+                ),
               merchant_acceptor_id: String,
               merchant_category_code: String,
               merchant_city: T.nilable(String),
@@ -1612,6 +1637,9 @@ module Increase
             # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) when this authorization
             # will expire and the pending transaction will be released.
             expires_at:,
+            # The healthcare-related fields for this authorization. Only present for specific
+            # programs.
+            healthcare:,
             # The merchant identifier (commonly abbreviated as MID) of the merchant the card
             # is transacting with.
             merchant_acceptor_id:,
@@ -1682,6 +1710,10 @@ module Increase
                 direction:
                   Increase::PendingTransaction::Source::CardAuthorization::Direction::TaggedSymbol,
                 expires_at: Time,
+                healthcare:
+                  T.nilable(
+                    Increase::PendingTransaction::Source::CardAuthorization::Healthcare
+                  ),
                 merchant_acceptor_id: String,
                 merchant_category_code: String,
                 merchant_city: T.nilable(String),
@@ -2583,6 +2615,96 @@ module Increase
             end
           end
 
+          class Healthcare < Increase::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare,
+                  Increase::Internal::AnyHash
+                )
+              end
+
+            # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+            # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+            # products. The eligibility is determined based on the list of merchants
+            # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+            sig do
+              returns(
+                Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+              )
+            end
+            attr_accessor :merchant_ninety_percent_eligibility
+
+            # The healthcare-related fields for this authorization. Only present for specific
+            # programs.
+            sig do
+              params(
+                merchant_ninety_percent_eligibility:
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+              # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+              # products. The eligibility is determined based on the list of merchants
+              # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+              merchant_ninety_percent_eligibility:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  merchant_ninety_percent_eligibility:
+                    Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+            # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+            # products. The eligibility is determined based on the list of merchants
+            # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+            module MerchantNinetyPercentEligibility
+              extend Increase::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # The merchant is eligible for treatment under the 90% rule.
+              ELIGIBLE =
+                T.let(
+                  :eligible,
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+                )
+
+              # The merchant is not eligible for treatment under the 90% rule.
+              NOT_ELIGIBLE =
+                T.let(
+                  :not_eligible,
+                  Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Increase::PendingTransaction::Source::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
           class NetworkDetails < Increase::Internal::Type::BaseModel
             OrHash =
               T.type_alias do
@@ -3348,6 +3470,13 @@ module Increase
                 Increase::PendingTransaction::Source::CardAuthorization::ProcessingCategory::TaggedSymbol
               )
 
+            # Cash deposit transactions are used to deposit cash at an ATM or a point of sale.
+            CASH_DEPOSIT =
+              T.let(
+                :cash_deposit,
+                Increase::PendingTransaction::Source::CardAuthorization::ProcessingCategory::TaggedSymbol
+              )
+
             # A balance inquiry transaction is used to check the balance of an account associated with a card.
             BALANCE_INQUIRY =
               T.let(

data/rbi/increase/models/physical_card.rbi

@@ -683,7 +683,7 @@ module Increase
                   Increase::PhysicalCard::Shipment::Tracking::Update::Category::TaggedSymbol
                 )
 
-              # The physical card has been delivered.
+              # The physical card has been delivered. Note that some couriers track delivery status based on driver location data rather than an explicit scan. While uncommon, a single physical card may have more than one delivered event.
               DELIVERED =
                 T.let(
                   :delivered,

data/rbi/increase/models/physical_card_profile.rbi

@@ -44,6 +44,19 @@ module Increase
       sig { returns(T.nilable(String)) }
       attr_accessor :front_image_file_id
 
+      # Text printed on the front of the card. Reach out to
+      # [support@increase.com](mailto:support@increase.com) for more information.
+      sig { returns(T.nilable(Increase::PhysicalCardProfile::FrontText)) }
+      attr_reader :front_text
+
+      sig do
+        params(
+          front_text:
+            T.nilable(Increase::PhysicalCardProfile::FrontText::OrHash)
+        ).void
+      end
+      attr_writer :front_text
+
       # The idempotency key you chose for this object. This value is unique across
       # Increase and is used to ensure that a request is only processed once. Learn more
       # about [idempotency](https://increase.com/documentation/idempotency-keys).
@@ -81,6 +94,8 @@ module Increase
           creator: Increase::PhysicalCardProfile::Creator::OrSymbol,
           description: String,
           front_image_file_id: T.nilable(String),
+          front_text:
+            T.nilable(Increase::PhysicalCardProfile::FrontText::OrHash),
           idempotency_key: T.nilable(String),
           is_default: T::Boolean,
           program_id: String,
@@ -109,6 +124,9 @@ module Increase
         # The identifier of the File containing the physical card's front image. This will
         # be missing until the image has been post-processed.
         front_image_file_id:,
+        # Text printed on the front of the card. Reach out to
+        # [support@increase.com](mailto:support@increase.com) for more information.
+        front_text:,
         # The idempotency key you chose for this object. This value is unique across
         # Increase and is used to ensure that a request is only processed once. Learn more
         # about [idempotency](https://increase.com/documentation/idempotency-keys).
@@ -137,6 +155,7 @@ module Increase
             creator: Increase::PhysicalCardProfile::Creator::TaggedSymbol,
             description: String,
             front_image_file_id: T.nilable(String),
+            front_text: T.nilable(Increase::PhysicalCardProfile::FrontText),
             idempotency_key: T.nilable(String),
             is_default: T::Boolean,
             program_id: String,
@@ -173,6 +192,47 @@ module Increase
         end
       end
 
+      class FrontText < Increase::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Increase::PhysicalCardProfile::FrontText,
+              Increase::Internal::AnyHash
+            )
+          end
+
+        # The first line of text on the front of the card.
+        sig { returns(String) }
+        attr_accessor :line1
+
+        # The second line of text on the front of the card. Providing a second line moves
+        # the first line slightly higher and prints the second line in the spot where the
+        # first line would have otherwise been printed.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :line2
+
+        # Text printed on the front of the card. Reach out to
+        # [support@increase.com](mailto:support@increase.com) for more information.
+        sig do
+          params(line1: String, line2: T.nilable(String)).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The first line of text on the front of the card.
+          line1:,
+          # The second line of text on the front of the card. Providing a second line moves
+          # the first line slightly higher and prints the second line in the spot where the
+          # first line would have otherwise been printed.
+          line2:
+        )
+        end
+
+        sig { override.returns({ line1: String, line2: T.nilable(String) }) }
+        def to_hash
+        end
+      end
+
       # The status of the Physical Card Profile.
       module Status
         extend Increase::Internal::Type::Enum

data/rbi/increase/models/real_time_decision.rbi

@@ -1784,6 +1784,25 @@ module Increase
         end
         attr_accessor :direction
 
+        # The healthcare-related fields for this authorization. Only present for specific
+        # programs.
+        sig do
+          returns(
+            T.nilable(Increase::RealTimeDecision::CardAuthorization::Healthcare)
+          )
+        end
+        attr_reader :healthcare
+
+        sig do
+          params(
+            healthcare:
+              T.nilable(
+                Increase::RealTimeDecision::CardAuthorization::Healthcare::OrHash
+              )
+          ).void
+        end
+        attr_writer :healthcare
+
         # The merchant identifier (commonly abbreviated as MID) of the merchant the card
         # is transacting with.
         sig { returns(String) }
@@ -1954,6 +1973,10 @@ module Increase
             digital_wallet_token_id: T.nilable(String),
             direction:
               Increase::RealTimeDecision::CardAuthorization::Direction::OrSymbol,
+            healthcare:
+              T.nilable(
+                Increase::RealTimeDecision::CardAuthorization::Healthcare::OrHash
+              ),
             merchant_acceptor_id: String,
             merchant_category_code: String,
             merchant_city: T.nilable(String),
@@ -2006,6 +2029,9 @@ module Increase
           # The direction describes the direction the funds will move, either from the
           # cardholder to the merchant or from the merchant to the cardholder.
           direction:,
+          # The healthcare-related fields for this authorization. Only present for specific
+          # programs.
+          healthcare:,
           # The merchant identifier (commonly abbreviated as MID) of the merchant the card
           # is transacting with.
           merchant_acceptor_id:,
@@ -2087,6 +2113,10 @@ module Increase
               digital_wallet_token_id: T.nilable(String),
               direction:
                 Increase::RealTimeDecision::CardAuthorization::Direction::TaggedSymbol,
+              healthcare:
+                T.nilable(
+                  Increase::RealTimeDecision::CardAuthorization::Healthcare
+                ),
               merchant_acceptor_id: String,
               merchant_category_code: String,
               merchant_city: T.nilable(String),
@@ -3087,6 +3117,96 @@ module Increase
           end
         end
 
+        class Healthcare < Increase::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Increase::RealTimeDecision::CardAuthorization::Healthcare,
+                Increase::Internal::AnyHash
+              )
+            end
+
+          # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+          # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+          # products. The eligibility is determined based on the list of merchants
+          # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+          sig do
+            returns(
+              Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+            )
+          end
+          attr_accessor :merchant_ninety_percent_eligibility
+
+          # The healthcare-related fields for this authorization. Only present for specific
+          # programs.
+          sig do
+            params(
+              merchant_ninety_percent_eligibility:
+                Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+            # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+            # products. The eligibility is determined based on the list of merchants
+            # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+            merchant_ninety_percent_eligibility:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                merchant_ninety_percent_eligibility:
+                  Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The merchant's eligibility under the Internal Revenue Service's 90% Rule for
+          # Flexible Spending Account (FSA) and Health Savings Account (HSA) eligible
+          # products. The eligibility is determined based on the list of merchants
+          # maintained by the Special Interest Group for IIAS Standards (SIGIS).
+          module MerchantNinetyPercentEligibility
+            extend Increase::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            # The merchant is eligible for treatment under the 90% rule.
+            ELIGIBLE =
+              T.let(
+                :eligible,
+                Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+              )
+
+            # The merchant is not eligible for treatment under the 90% rule.
+            NOT_ELIGIBLE =
+              T.let(
+                :not_eligible,
+                Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Increase::RealTimeDecision::CardAuthorization::Healthcare::MerchantNinetyPercentEligibility::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class NetworkDetails < Increase::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
@@ -3890,6 +4010,13 @@ module Increase
               Increase::RealTimeDecision::CardAuthorization::ProcessingCategory::TaggedSymbol
             )
 
+          # Cash deposit transactions are used to deposit cash at an ATM or a point of sale.
+          CASH_DEPOSIT =
+            T.let(
+              :cash_deposit,
+              Increase::RealTimeDecision::CardAuthorization::ProcessingCategory::TaggedSymbol
+            )
+
           # A balance inquiry transaction is used to check the balance of an account associated with a card.
           BALANCE_INQUIRY =
             T.let(

data/rbi/increase/models/simulations/ach_transfer_create_notification_of_change_params.rbi

@@ -129,6 +129,13 @@ module Increase
               Increase::Simulations::ACHTransferCreateNotificationOfChangeParams::CorrectedAccountFunding::TaggedSymbol
             )
 
+          # A loan account used in a lender-borrower relationship. Uncommon.
+          LOAN =
+            T.let(
+              :loan,
+              Increase::Simulations::ACHTransferCreateNotificationOfChangeParams::CorrectedAccountFunding::TaggedSymbol
+            )
+
           # A bank's general ledger. Uncommon.
           GENERAL_LEDGER =
             T.let(

data/rbi/increase/models/simulations/card_authorization_create_params.rbi

@@ -369,7 +369,7 @@ module Increase
               Increase::Simulations::CardAuthorizationCreateParams::DeclineReason::TaggedSymbol
             )
 
-          # The transaction was blocked by a Limit.
+          # The transaction was blocked by a limit or an authorization control.
           BREACHES_LIMIT =
             T.let(
               :breaches_limit,
@@ -770,6 +770,13 @@ module Increase
                 Increase::Simulations::CardAuthorizationCreateParams::ProcessingCategory::Category::TaggedSymbol
               )
 
+            # Cash deposit transactions are used to deposit cash at an ATM or a point of sale.
+            CASH_DEPOSIT =
+              T.let(
+                :cash_deposit,
+                Increase::Simulations::CardAuthorizationCreateParams::ProcessingCategory::Category::TaggedSymbol
+              )
+
             # A balance inquiry transaction is used to check the balance of an account associated with a card.
             BALANCE_INQUIRY =
               T.let(

data/rbi/increase/models/simulations/card_balance_inquiry_create_params.rbi

@@ -333,7 +333,7 @@ module Increase
               Increase::Simulations::CardBalanceInquiryCreateParams::DeclineReason::TaggedSymbol
             )
 
-          # The transaction was blocked by a Limit.
+          # The transaction was blocked by a limit or an authorization control.
           BREACHES_LIMIT =
             T.let(
               :breaches_limit,

data/rbi/increase/models/simulations/check_deposit_submit_params.rbi

@@ -20,6 +20,7 @@ module Increase
         attr_accessor :check_deposit_id
 
         # If set, the simulation will use these values for the check's scanned MICR data.
+        # If not set, the simulation will use random values.
         sig do
           returns(
             T.nilable(Increase::Simulations::CheckDepositSubmitParams::Scan)
@@ -45,6 +46,7 @@ module Increase
           # The identifier of the Check Deposit you wish to submit.
           check_deposit_id:,
           # If set, the simulation will use these values for the check's scanned MICR data.
+          # If not set, the simulation will use random values.
           scan: nil,
           request_options: {}
         )
@@ -80,18 +82,29 @@ module Increase
           attr_accessor :routing_number
 
           # The auxiliary on-us data to be returned in the check deposit's scan data.
+          # Auxiliary on-us is typically the check number for business checks.
           sig { returns(T.nilable(String)) }
           attr_reader :auxiliary_on_us
 
           sig { params(auxiliary_on_us: String).void }
           attr_writer :auxiliary_on_us
 
+          # The serial number to be returned in the check deposit's scan data. Serial number
+          # is typically the check number for consumer checks.
+          sig { returns(T.nilable(String)) }
+          attr_reader :serial_number
+
+          sig { params(serial_number: String).void }
+          attr_writer :serial_number
+
           # If set, the simulation will use these values for the check's scanned MICR data.
+          # If not set, the simulation will use random values.
           sig do
             params(
               account_number: String,
               routing_number: String,
-              auxiliary_on_us: String
+              auxiliary_on_us: String,
+              serial_number: String
             ).returns(T.attached_class)
           end
           def self.new(
@@ -100,7 +113,11 @@ module Increase
             # The routing number to be returned in the check deposit's scan data.
             routing_number:,
             # The auxiliary on-us data to be returned in the check deposit's scan data.
-            auxiliary_on_us: nil
+            # Auxiliary on-us is typically the check number for business checks.
+            auxiliary_on_us: nil,
+            # The serial number to be returned in the check deposit's scan data. Serial number
+            # is typically the check number for consumer checks.
+            serial_number: nil
           )
           end
 
@@ -109,7 +126,8 @@ module Increase
               {
                 account_number: String,
                 routing_number: String,
-                auxiliary_on_us: String
+                auxiliary_on_us: String,
+                serial_number: String
               }
             )
           end

data/rbi/increase/models/simulations/digital_wallet_token_request_create_response.rbi

@@ -120,6 +120,20 @@ module Increase
               Increase::Models::Simulations::DigitalWalletTokenRequestCreateResponse::DeclineReason::TaggedSymbol
             )
 
+          # The tokenization attempt failed because the Card Verification Code (CVC) was incorrect.
+          INCORRECT_CARD_VERIFICATION_CODE =
+            T.let(
+              :incorrect_card_verification_code,
+              Increase::Models::Simulations::DigitalWalletTokenRequestCreateResponse::DeclineReason::TaggedSymbol
+            )
+
+          # The tokenization attempt was declined by the token requestor.
+          DECLINED_BY_TOKEN_REQUESTOR =
+            T.let(
+              :declined_by_token_requestor,
+              Increase::Models::Simulations::DigitalWalletTokenRequestCreateResponse::DeclineReason::TaggedSymbol
+            )
+
           sig do
             override.returns(
               T::Array[

data/rbi/increase/models/simulations/entity_update_validation_params.rbi

@@ -116,7 +116,7 @@ module Increase
               end
             OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-            # The entity's tax identifier could not be validated. Update the tax ID with the [update an entity API](/documentation/api/entities#update-an-entity.corporation.legal_identifier).
+            # The entity's tax identifier could not be verified. Update the tax ID with the [update an entity API](/documentation/api/entities#update-an-entity.corporation.legal_identifier).
             ENTITY_TAX_IDENTIFIER =
               T.let(
                 :entity_tax_identifier,

data/rbi/increase/models/simulations/inbound_wire_transfer_create_params.rbi

@@ -111,6 +111,14 @@ module Increase
         sig { params(instruction_identification: String).void }
         attr_writer :instruction_identification
 
+        # The sending bank will set purpose in production. You can simulate any value
+        # here.
+        sig { returns(T.nilable(String)) }
+        attr_reader :purpose
+
+        sig { params(purpose: String).void }
+        attr_writer :purpose
+
         # The sending bank will set unique_end_to_end_transaction_reference in production.
         # You can simulate any value here.
         sig { returns(T.nilable(String)) }
@@ -150,6 +158,7 @@ module Increase
             end_to_end_identification: String,
             instructing_agent_routing_number: String,
             instruction_identification: String,
+            purpose: String,
             unique_end_to_end_transaction_reference: String,
             unstructured_remittance_information: String,
             wire_drawdown_request_id: String,
@@ -194,6 +203,9 @@ module Increase
           # The sending bank will set instruction_identification in production. You can
           # simulate any value here.
           instruction_identification: nil,
+          # The sending bank will set purpose in production. You can simulate any value
+          # here.
+          purpose: nil,
           # The sending bank will set unique_end_to_end_transaction_reference in production.
           # You can simulate any value here.
           unique_end_to_end_transaction_reference: nil,
@@ -223,6 +235,7 @@ module Increase
               end_to_end_identification: String,
               instructing_agent_routing_number: String,
               instruction_identification: String,
+              purpose: String,
               unique_end_to_end_transaction_reference: String,
               unstructured_remittance_information: String,
               wire_drawdown_request_id: String,

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

@@ -130,7 +130,7 @@ module Increase
               Increase::Simulations::PhysicalCardCreateParams::Category::TaggedSymbol
             )
 
-          # The physical card has been delivered.
+          # The physical card has been delivered. Note that some couriers track delivery status based on driver location data rather than an explicit scan. While uncommon, a single physical card may have more than one delivered event.
           DELIVERED =
             T.let(
               :delivered,