increase 1.273.0 → 1.275.0

data/rbi/increase/models/declined_transaction.rbi

@@ -1055,6 +1055,16 @@ module Increase
           end
           attr_accessor :reason
 
+          # The scheme fees associated with this card decline.
+          sig do
+            returns(
+              T::Array[
+                Increase::DeclinedTransaction::Source::CardDecline::SchemeFee
+              ]
+            )
+          end
+          attr_accessor :scheme_fees
+
           # The terminal identifier (commonly abbreviated as TID) of the terminal the card
           # is transacting with.
           sig { returns(T.nilable(String)) }
@@ -1118,6 +1128,10 @@ module Increase
                 ),
               reason:
                 Increase::DeclinedTransaction::Source::CardDecline::Reason::OrSymbol,
+              scheme_fees:
+                T::Array[
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::OrHash
+                ],
               terminal_id: T.nilable(String),
               verification:
                 Increase::DeclinedTransaction::Source::CardDecline::Verification::OrHash
@@ -1196,6 +1210,8 @@ module Increase
             real_time_decision_reason:,
             # Why the transaction was declined.
             reason:,
+            # The scheme fees associated with this card decline.
+            scheme_fees:,
             # The terminal identifier (commonly abbreviated as TID) of the terminal the card
             # is transacting with.
             terminal_id:,
@@ -1245,6 +1261,10 @@ module Increase
                   ),
                 reason:
                   Increase::DeclinedTransaction::Source::CardDecline::Reason::TaggedSymbol,
+                scheme_fees:
+                  T::Array[
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee
+                  ],
                 terminal_id: T.nilable(String),
                 verification:
                   Increase::DeclinedTransaction::Source::CardDecline::Verification
@@ -3149,6 +3169,360 @@ module Increase
             end
           end
 
+          class SchemeFee < Increase::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee,
+                  Increase::Internal::AnyHash
+                )
+              end
+
+            # The fee amount given as a string containing a decimal number.
+            sig { returns(String) }
+            attr_accessor :amount
+
+            # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was
+            # created.
+            sig { returns(Time) }
+            attr_accessor :created_at
+
+            # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee
+            # reimbursement.
+            sig do
+              returns(
+                Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency::TaggedSymbol
+              )
+            end
+            attr_accessor :currency
+
+            # The type of fee being assessed.
+            sig do
+              returns(
+                Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+              )
+            end
+            attr_accessor :fee_type
+
+            # The fixed component of the fee, if applicable, given in major units of the fee
+            # amount.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :fixed_component
+
+            # The variable rate component of the fee, if applicable, given as a decimal (e.g.,
+            # 0.015 for 1.5%).
+            sig { returns(T.nilable(String)) }
+            attr_accessor :variable_rate
+
+            sig do
+              params(
+                amount: String,
+                created_at: Time,
+                currency:
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency::OrSymbol,
+                fee_type:
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::OrSymbol,
+                fixed_component: T.nilable(String),
+                variable_rate: T.nilable(String)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The fee amount given as a string containing a decimal number.
+              amount:,
+              # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was
+              # created.
+              created_at:,
+              # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee
+              # reimbursement.
+              currency:,
+              # The type of fee being assessed.
+              fee_type:,
+              # The fixed component of the fee, if applicable, given in major units of the fee
+              # amount.
+              fixed_component:,
+              # The variable rate component of the fee, if applicable, given as a decimal (e.g.,
+              # 0.015 for 1.5%).
+              variable_rate:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  amount: String,
+                  created_at: Time,
+                  currency:
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency::TaggedSymbol,
+                  fee_type:
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol,
+                  fixed_component: T.nilable(String),
+                  variable_rate: T.nilable(String)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee
+            # reimbursement.
+            module Currency
+              extend Increase::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # US Dollar (USD)
+              USD =
+                T.let(
+                  :USD,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::Currency::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            # The type of fee being assessed.
+            module FeeType
+              extend Increase::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.
+              VISA_INTERNATIONAL_SERVICE_ASSESSMENT_SINGLE_CURRENCY =
+                T.let(
+                  :visa_international_service_assessment_single_currency,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.
+              VISA_INTERNATIONAL_SERVICE_ASSESSMENT_CROSS_CURRENCY =
+                T.let(
+                  :visa_international_service_assessment_cross_currency,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.
+              VISA_AUTHORIZATION_DOMESTIC_POINT_OF_SALE =
+                T.let(
+                  :visa_authorization_domestic_point_of_sale,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.
+              VISA_AUTHORIZATION_INTERNATIONAL_POINT_OF_SALE =
+                T.let(
+                  :visa_authorization_international_point_of_sale,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.
+              VISA_AUTHORIZATION_CANADA_POINT_OF_SALE =
+                T.let(
+                  :visa_authorization_canada_point_of_sale,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.
+              VISA_AUTHORIZATION_REVERSAL_POINT_OF_SALE =
+                T.let(
+                  :visa_authorization_reversal_point_of_sale,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.
+              VISA_AUTHORIZATION_REVERSAL_INTERNATIONAL_POINT_OF_SALE =
+                T.let(
+                  :visa_authorization_reversal_international_point_of_sale,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.
+              VISA_AUTHORIZATION_ADDRESS_VERIFICATION_SERVICE =
+                T.let(
+                  :visa_authorization_address_verification_service,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).
+              VISA_ADVANCED_AUTHORIZATION =
+                T.let(
+                  :visa_advanced_authorization,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.
+              VISA_MESSAGE_TRANSMISSION =
+                T.let(
+                  :visa_message_transmission,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity, per inquiry, related to the domestic Issuer for Account Number Verification.
+              VISA_ACCOUNT_VERIFICATION_DOMESTIC =
+                T.let(
+                  :visa_account_verification_domestic,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity, per inquiry, related to the international Issuer for Account Number Verification.
+              VISA_ACCOUNT_VERIFICATION_INTERNATIONAL =
+                T.let(
+                  :visa_account_verification_international,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.
+              VISA_ACCOUNT_VERIFICATION_CANADA =
+                T.let(
+                  :visa_account_verification_canada,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.
+              VISA_CORPORATE_ACCEPTANCE_FEE =
+                T.let(
+                  :visa_corporate_acceptance_fee,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.
+              VISA_CONSUMER_DEBIT_ACCEPTANCE_FEE =
+                T.let(
+                  :visa_consumer_debit_acceptance_fee,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.
+              VISA_BUSINESS_DEBIT_ACCEPTANCE_FEE =
+                T.let(
+                  :visa_business_debit_acceptance_fee,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.
+              VISA_PURCHASING_ACCEPTANCE_FEE =
+                T.let(
+                  :visa_purchasing_acceptance_fee,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity and fees for the processing of a sales draft original for a purchase transaction.
+              VISA_PURCHASE_DOMESTIC =
+                T.let(
+                  :visa_purchase_domestic,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Activity and fees for the processing of an international sales draft original for a purchase transaction.
+              VISA_PURCHASE_INTERNATIONAL =
+                T.let(
+                  :visa_purchase_international,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.
+              VISA_CREDIT_PURCHASE_TOKEN =
+                T.let(
+                  :visa_credit_purchase_token,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.
+              VISA_DEBIT_PURCHASE_TOKEN =
+                T.let(
+                  :visa_debit_purchase_token,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # A per transaction fee assessed for Base II financial draft - Issuer.
+              VISA_CLEARING_TRANSMISSION =
+                T.let(
+                  :visa_clearing_transmission,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.
+              VISA_DIRECT_AUTHORIZATION =
+                T.let(
+                  :visa_direct_authorization,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.
+              VISA_DIRECT_TRANSACTION_DOMESTIC =
+                T.let(
+                  :visa_direct_transaction_domestic,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer card service fee for Commercial Credit cards.
+              VISA_SERVICE_COMMERCIAL_CREDIT =
+                T.let(
+                  :visa_service_commercial_credit,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer Advertising Service Fee for Commercial Credit cards.
+              VISA_ADVERTISING_SERVICE_COMMERCIAL_CREDIT =
+                T.let(
+                  :visa_advertising_service_commercial_credit,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer Community Growth Acceleration Program Fee.
+              VISA_COMMUNITY_GROWTH_ACCELERATION_PROGRAM =
+                T.let(
+                  :visa_community_growth_acceleration_program,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Issuer Processing Guarantee for Commercial Credit cards.
+              VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT =
+                T.let(
+                  :visa_processing_guarantee_commercial_credit,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              # Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.
+              PULSE_SWITCH_FEE =
+                T.let(
+                  :pulse_switch_fee,
+                  Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Increase::DeclinedTransaction::Source::CardDecline::SchemeFee::FeeType::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
           class Verification < Increase::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

data/rbi/increase/models/entity.rbi

@@ -3211,7 +3211,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.tax_identifier).
+            # 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).
             ENTITY_TAX_IDENTIFIER =
               T.let(
                 :entity_tax_identifier,

data/rbi/increase/models/entity_update_params.rbi

@@ -213,6 +213,25 @@ module Increase
         sig { params(industry_code: String).void }
         attr_writer :industry_code
 
+        # The legal identifier of the corporation. This is usually the Employer
+        # Identification Number (EIN).
+        sig do
+          returns(
+            T.nilable(
+              Increase::EntityUpdateParams::Corporation::LegalIdentifier
+            )
+          )
+        end
+        attr_reader :legal_identifier
+
+        sig do
+          params(
+            legal_identifier:
+              Increase::EntityUpdateParams::Corporation::LegalIdentifier::OrHash
+          ).void
+        end
+        attr_writer :legal_identifier
+
         # The legal name of the corporation.
         sig { returns(T.nilable(String)) }
         attr_reader :name
@@ -220,13 +239,6 @@ module Increase
         sig { params(name: String).void }
         attr_writer :name
 
-        # The Employer Identification Number (EIN) for the corporation.
-        sig { returns(T.nilable(String)) }
-        attr_reader :tax_identifier
-
-        sig { params(tax_identifier: String).void }
-        attr_writer :tax_identifier
-
         # Details of the corporation entity to update. If you specify this parameter and
         # the entity is not a corporation, the request will fail.
         sig do
@@ -235,8 +247,9 @@ module Increase
             email: String,
             incorporation_state: String,
             industry_code: String,
-            name: String,
-            tax_identifier: String
+            legal_identifier:
+              Increase::EntityUpdateParams::Corporation::LegalIdentifier::OrHash,
+            name: String
           ).returns(T.attached_class)
         end
         def self.new(
@@ -254,10 +267,11 @@ module Increase
           # `Software Publishers`. A full list of classification codes is available
           # [here](https://increase.com/documentation/data-dictionary#north-american-industry-classification-system-codes).
           industry_code: nil,
+          # The legal identifier of the corporation. This is usually the Employer
+          # Identification Number (EIN).
+          legal_identifier: nil,
           # The legal name of the corporation.
-          name: nil,
-          # The Employer Identification Number (EIN) for the corporation.
-          tax_identifier: nil
+          name: nil
         )
         end
 
@@ -268,8 +282,9 @@ module Increase
               email: String,
               incorporation_state: String,
               industry_code: String,
-              name: String,
-              tax_identifier: String
+              legal_identifier:
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier,
+              name: String
             }
           )
         end
@@ -363,6 +378,105 @@ module Increase
           def to_hash
           end
         end
+
+        class LegalIdentifier < Increase::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier,
+                Increase::Internal::AnyHash
+              )
+            end
+
+          # The identifier of the legal identifier.
+          sig { returns(String) }
+          attr_accessor :value
+
+          # The category of the legal identifier.
+          sig do
+            returns(
+              T.nilable(
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::OrSymbol
+              )
+            )
+          end
+          attr_reader :category
+
+          sig do
+            params(
+              category:
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::OrSymbol
+            ).void
+          end
+          attr_writer :category
+
+          # The legal identifier of the corporation. This is usually the Employer
+          # Identification Number (EIN).
+          sig do
+            params(
+              value: String,
+              category:
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The identifier of the legal identifier.
+            value:,
+            # The category of the legal identifier.
+            category: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                value: String,
+                category:
+                  Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::OrSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The category of the legal identifier.
+          module Category
+            extend Increase::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            # The Employer Identification Number (EIN) for the company. The EIN is a 9-digit number assigned by the IRS.
+            US_EMPLOYER_IDENTIFICATION_NUMBER =
+              T.let(
+                :us_employer_identification_number,
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::TaggedSymbol
+              )
+
+            # A legal identifier issued by a foreign government, like a tax identification number or registration number.
+            OTHER =
+              T.let(
+                :other,
+                Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Increase::EntityUpdateParams::Corporation::LegalIdentifier::Category::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
 
       class GovernmentAuthority < Increase::Internal::Type::BaseModel