visa-acceptance-api-sdk 1.0.0

data/lib/visa_acceptance_merged_spec/models/installment_information2.rb

@@ -0,0 +1,683 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # InstallmentInformation2 Model.
+  class InstallmentInformation2 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Amount for the current installment payment.
+    # This field is supported only for Visa Acceptance through VisaNet.
+    # @return [String]
+    attr_accessor :amount
+
+    # Frequency of the installment payments. When you do not include this field
+    # in a request for a
+    # Crediario installment payment, Visa Acceptance sends a space character to
+    # the processor.
+    # This field is supported only for Visa Acceptance through VisaNet. Possible
+    # values:
+    # - `B`: Biweekly
+    # - `M`: Monthly
+    # - `W`: Weekly
+    # For Crediario installment payments, the value for this field corresponds
+    # to the following data in the TC 33 capture file5:
+    # - Record: CP01 TCR9
+    # - Position: 41
+    # - Field: Installment Frequency
+    # @return [String]
+    attr_accessor :frequency
+
+    # #### American Express Direct, Cielo, and Visa Acceptance Latin American
+    # Processing
+    # Flag that indicates the type of funding for the installment plan
+    # associated with the payment.
+    # Possible values:
+    # - `1`: Merchant-funded installment plan
+    # - `2`: Issuer-funded installment plan
+    # If you do not include this field in the request, Visa Acceptance uses the
+    # value in your Visa Acceptance account.
+    # To change the value in your Visa Acceptance account, contact Visa
+    # Acceptance Customer Service.
+    # #### Visa Acceptance through VisaNet and American Express
+    # Defined code that indicates the type of installment plan for this
+    # transaction.
+    # Contact American Express for:
+    # - Information about the kinds of installment plans that American Express
+    # provides
+    # - Values for this field
+    # For installment payments with American Express in Brazil, the value for
+    # this field corresponds to the following data in the TC 33 capture file*:
+    # - Record: CP07 TCR3
+    # - Position: 5-6
+    # - Field: Plan Type
+    # * The TC 33 Capture file contains information about the purchases and
+    # refunds that a merchant submits to Visa Acceptance. Visa Acceptance
+    # through VisaNet creates the TC 33 Capture file at the end of the day and
+    # sends it to the merchant’s acquirer, who uses this information to
+    # facilitate end-of-day clearing processing with payment card companies.
+    # #### Visa Acceptance through VisaNet with Visa or Mastercard
+    # Flag indicating the type of funding for the installment plan associated
+    # with the payment.
+    # Possible values:
+    # - 1 or 01: Merchant-funded installment plan
+    # - 2 or 02: Issuer-funded installment plan
+    # - 43: Crediario installment plan—only with Visa in Brazil
+    # For installment payments with Visa in Brazil, the value for this field
+    # corresponds to the following data in the TC 33 capture file5:
+    # - Record: CP07 TCR1
+    # - Position: 5-6
+    # - Field: Installment Type
+    # For all other kinds of installment payments, the value for this field
+    # corresponds to the following data in the TC 33 capture file5:
+    # - Record: CP01 TCR5
+    # - Position: 39-40
+    # - Field: Installment Plan Type (Issuer or Merchant)
+    # @return [String]
+    attr_accessor :plan_type
+
+    # Installment number when making payments in installments. Used along with
+    # `totalCount` to track which payment is being processed.
+    # For example, the second of 5 payments would be passed to Visa Acceptance
+    # as `sequence` = 2 and `totalCount` = 5.
+    # #### Chase Paymentech Solutions and FDC Compass
+    # This field is optional because this value is required in the merchant
+    # descriptors.
+    # #### Visa Acceptance through VisaNet
+    # When you do not include this field in a request for a Crediario
+    # installment payment, Visa Acceptance sends a value of 0 to the processor.
+    # For Crediario installment payments, the value for this field corresponds
+    # to the following data in the TC 33 capture file*:
+    # - Record: CP01 TCR9
+    # - Position: 38-40
+    # - Field: Installment Payment Number
+    # * The TC 33 Capture file contains information about the purchases and
+    # refunds that a merchant submits to Visa Acceptance. Visa Acceptance
+    # through VisaNet creates the TC 33 Capture file at the end of the day and
+    # sends it to the merchant’s acquirer, who uses this information to
+    # facilitate end-of-day clearing processing with payment card companies.
+    # @return [Integer]
+    attr_accessor :sequence
+
+    # Total amount of the loan that is being paid in installments. This field is
+    # supported only for Visa Acceptance
+    # through VisaNet.
+    # @return [String]
+    attr_accessor :total_amount
+
+    # Total number of installments when making payments in installments.
+    # #### Chase Paymentech Solutions and FDC Compass
+    # This field is optional because this value is required in the merchant
+    # descriptors.
+    # #### American Express Direct, Cielo, and Comercio Latino
+    # This value is the total number of installments you approved.
+    # #### Visa Acceptance Latin American Processing in Brazil
+    # This value is the total number of installments that you approved. The
+    # default is 1.
+    # #### All Other Processors
+    # This value is used along with _sequence_ to track which payment is being
+    # processed.
+    # For example, the second of 5 payments would be passed to Visa Acceptance
+    # as _sequence_ = 2 and _totalCount_ = 5.
+    # #### Visa Acceptance through VisaNet
+    # For Crediario installment payments, the value for this field corresponds
+    # to the following data in the TC 33 capture file*:
+    # - Record: CP01 TCR9
+    # - Position: 23-25
+    # - Field: Number of Installments
+    # For installment payments with American Express in Brazil, the value for
+    # this field corresponds to the following data in the TC 33 capture file*:
+    # - Record: CP07 TCR3
+    # - Position: 7-8
+    # - Field: Number of Installments
+    # For installment payments with Visa in Brazil, the value for this field
+    # corresponds to the following data in the TC 33 capture file*:
+    # - Record: CP07 TCR1
+    # - Position: 7-8
+    # - Field: Number of Installments
+    # For all other kinds of installment payments, the value for this field
+    # corresponds to the following data in the TC 33 capture file*:
+    # - Record: CP01 TCR5
+    # - Position: 20-22
+    # - Field: Installment Total Count
+    # **Note** The TC 33 Capture file contains information about the purchases
+    # and refunds that a merchant submits to Visa Acceptance. Visa Acceptance
+    # through VisaNet creates the TC 33 Capture file at the end of the day and
+    # sends it to the merchant’s acquirer, who uses this information to
+    # facilitate end-of-day clearing processing with payment card companies.
+    # @return [Integer]
+    attr_accessor :total_count
+
+    # Date of the first installment payment. Format: YYMMDD. When you do not
+    # include this field, Visa Acceptance sends a string of six zeros (000000)
+    # to the processor.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on Visa Acceptance through VisaNet.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file:
+    # - Record: CP01 TCR9
+    # - Position: 42-47
+    # - Field: Date of First Installment
+    # @return [String]
+    attr_accessor :first_installment_date
+
+    # Amount of the first installment payment. The issuer provides this value
+    # when the first installment payment is successful.
+    # This field is supported for Mastercard installment payments on Visa
+    # Acceptance through VisaNet in all countries except Brazil,Croatia,
+    # Georgia, and Greece.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file:
+    # - Record: CP01 TCR5
+    # - Position: 23-34
+    # - Field: Amount of Each Installment
+    # @return [String]
+    attr_accessor :first_installment_amount
+
+    # Invoice information that you want to provide to the issuer. This value is
+    # similar to a tracking number and is
+    # the same for all installment payments for one purchase.
+    # This field is supported only for installment payments with Mastercard on
+    # Visa Acceptance through VisaNet in Brazil.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file5:
+    # - Record: CP07 TCR4
+    # - Position: 51-70
+    # - Field: Purchase Identification
+    # @return [String]
+    attr_accessor :invoice_data
+
+    # Payment plan for the installments.
+    # This field is supported only for installment payments on Visa Platform
+    # Connect, RuPay and SPG-KSA seamless flow.
+    # Possible values for a standing-instruction (SI) merchant-initiated
+    # transaction (MIT) with Diners Club or Mastercard in India or with an
+    # India-issued card:
+    # - 1: SI with a fixed amount.
+    # - 2: SI with a maximum amount.
+    # - 3: Other kind of SI.
+    # Possible values for a type of Installment transaction for on-soil
+    # transaction in Kingdom of Saudi Arabia
+    # - 1: Registration or first transaction.
+    # - 2: Subsequent transaction.
+    # Possible values for other kinds of installment payments:
+    # - 0 (default): Regular installment. This value is not allowed for airline
+    # transactions.
+    # - 1: Installment payment with down payment.
+    # - 2: Installment payment without down payment. This value is supported
+    # only for airline transactions.
+    # - 3: Installment payment; down payment and boarding fee will follow. This
+    # value is supported only for airline transactions.
+    # - 4: Down payment only; regular installment payment will follow.
+    # - 5: Boarding fee only. This value is supported only for airline
+    # transactions.
+    # - 6: SI de-registration on RuPay for the payer authentication seamless
+    # flow.
+    # @return [String]
+    attr_accessor :payment_type
+
+    # Additional costs charged by the issuer to fund the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 128-139
+    # - Field: Total Other Costs
+    # @return [String]
+    attr_accessor :additional_costs
+
+    # Additional costs divided by the amount funded.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 140-143
+    # - Field: Percent of Total Other Costs
+    # @return [String]
+    attr_accessor :additional_costs_percentage
+
+    # Amount funded.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 48-59
+    # - Field: Total Amount Funded
+    # @return [String]
+    attr_accessor :amount_funded
+
+    # Amount requested divided by the amount funded.
+    # For example:
+    # - A value of 90.0 specifies 90%.
+    # - A value of 93.7 specifies 93.7%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 60-63
+    # - Field: Percent of Amount Requested
+    # @return [String]
+    attr_accessor :amount_requested_percentage
+
+    # Annual cost of financing the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 158-164
+    # - Field: Annual Total Cost of Financing
+    # @return [String]
+    attr_accessor :annual_financing_cost
+
+    # Annual interest rate.
+    # This field is returned only for two kinds of installment payments on Visa
+    # Platform Connect:
+    # - Crediario with Visa in Brazil: this field is included in the
+    # authorization response for the Crediario eligibility request when the
+    # issuer approves the customer's request for Crediario installment payments.
+    # - Mastercard in all countries except Brazil, Croatia, Georgia, and Greece.
+    # Example: A value of 1.0 specifies 1%.
+    # Example: A value of 4.0 specifies 4%.
+    # #### Brazil
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file:
+    # - Record: CP01 TCR9
+    # - Position: 151-157
+    # - Field: Annual Interest Rate
+    # #### Other Countries
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file:
+    # - Record: CP01 TCR5
+    # - Position: 58-62 SCMP API Fields| 216
+    # - Field: Mastercard Annual Percentage Rate
+    # @return [String]
+    attr_accessor :annual_interest_rate
+
+    # Expenses charged by the issuer to fund the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 64-75
+    # - Field: Total Expenses
+    # @return [String]
+    attr_accessor :expenses
+
+    # Expenses divided by the amount funded.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 76-79
+    # - Field: Percent of Total Expenses
+    # @return [String]
+    attr_accessor :expenses_percentage
+
+    # Fees charged by the issuer to fund the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 80-91
+    # - Field: Total Fees
+    # @return [String]
+    attr_accessor :fees
+
+    # Fees divided by the amount funded.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on Visa Acceptance through VisaNet.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 92-95
+    # - Field: Percent of Total Fees
+    # @return [String]
+    attr_accessor :fees_percentage
+
+    # Insurance charged by the issuer to fund the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 112-123
+    # - Field: Total Insurance
+    # @return [String]
+    attr_accessor :insurance
+
+    # Insurance costs divided by the amount funded.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 124-127
+    # - Field: Percent Of Total Insurance
+    # @return [String]
+    attr_accessor :insurance_percentage
+
+    # Monthly interest rate.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 144-150
+    # - Field: Monthly Interest Rate
+    # @return [String]
+    attr_accessor :monthly_interest_rate
+
+    # Taxes collected by the issuer to fund the installment payments.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 96-107
+    # - Field: Total Taxes
+    # @return [String]
+    attr_accessor :taxes
+
+    # Taxes divided by the amount funded.
+    # For example:
+    # - A value of 1.0 specifies 1%.
+    # - A value of 4.0 specifies 4%.
+    # This field is included in the authorization reply for the Crediario
+    # eligibility request when the issuer approves
+    # the cardholder's request for Crediario installment payments in Brazil.
+    # This field is supported only for Crediario installment payments in Brazil
+    # on **Visa Acceptance through VisaNet**.
+    # The value for this field corresponds to the following data in the TC 33
+    # capture file1:
+    # - Record: CP01 TCR9
+    # - Position: 108-111
+    # - Field: Percent of Total Taxes
+    # @return [String]
+    attr_accessor :taxes_percentage
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['amount'] = 'amount'
+      @_hash['frequency'] = 'frequency'
+      @_hash['plan_type'] = 'planType'
+      @_hash['sequence'] = 'sequence'
+      @_hash['total_amount'] = 'totalAmount'
+      @_hash['total_count'] = 'totalCount'
+      @_hash['first_installment_date'] = 'firstInstallmentDate'
+      @_hash['first_installment_amount'] = 'firstInstallmentAmount'
+      @_hash['invoice_data'] = 'invoiceData'
+      @_hash['payment_type'] = 'paymentType'
+      @_hash['additional_costs'] = 'additionalCosts'
+      @_hash['additional_costs_percentage'] = 'additionalCostsPercentage'
+      @_hash['amount_funded'] = 'amountFunded'
+      @_hash['amount_requested_percentage'] = 'amountRequestedPercentage'
+      @_hash['annual_financing_cost'] = 'annualFinancingCost'
+      @_hash['annual_interest_rate'] = 'annualInterestRate'
+      @_hash['expenses'] = 'expenses'
+      @_hash['expenses_percentage'] = 'expensesPercentage'
+      @_hash['fees'] = 'fees'
+      @_hash['fees_percentage'] = 'feesPercentage'
+      @_hash['insurance'] = 'insurance'
+      @_hash['insurance_percentage'] = 'insurancePercentage'
+      @_hash['monthly_interest_rate'] = 'monthlyInterestRate'
+      @_hash['taxes'] = 'taxes'
+      @_hash['taxes_percentage'] = 'taxesPercentage'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        amount
+        frequency
+        plan_type
+        sequence
+        total_amount
+        total_count
+        first_installment_date
+        first_installment_amount
+        invoice_data
+        payment_type
+        additional_costs
+        additional_costs_percentage
+        amount_funded
+        amount_requested_percentage
+        annual_financing_cost
+        annual_interest_rate
+        expenses
+        expenses_percentage
+        fees
+        fees_percentage
+        insurance
+        insurance_percentage
+        monthly_interest_rate
+        taxes
+        taxes_percentage
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(amount = SKIP, frequency = SKIP, plan_type = SKIP,
+                   sequence = SKIP, total_amount = SKIP, total_count = SKIP,
+                   first_installment_date = SKIP,
+                   first_installment_amount = SKIP, invoice_data = SKIP,
+                   payment_type = SKIP, additional_costs = SKIP,
+                   additional_costs_percentage = SKIP, amount_funded = SKIP,
+                   amount_requested_percentage = SKIP,
+                   annual_financing_cost = SKIP, annual_interest_rate = SKIP,
+                   expenses = SKIP, expenses_percentage = SKIP, fees = SKIP,
+                   fees_percentage = SKIP, insurance = SKIP,
+                   insurance_percentage = SKIP, monthly_interest_rate = SKIP,
+                   taxes = SKIP, taxes_percentage = SKIP)
+      @amount = amount unless amount == SKIP
+      @frequency = frequency unless frequency == SKIP
+      @plan_type = plan_type unless plan_type == SKIP
+      @sequence = sequence unless sequence == SKIP
+      @total_amount = total_amount unless total_amount == SKIP
+      @total_count = total_count unless total_count == SKIP
+      @first_installment_date = first_installment_date unless first_installment_date == SKIP
+      @first_installment_amount = first_installment_amount unless first_installment_amount == SKIP
+      @invoice_data = invoice_data unless invoice_data == SKIP
+      @payment_type = payment_type unless payment_type == SKIP
+      @additional_costs = additional_costs unless additional_costs == SKIP
+      unless additional_costs_percentage == SKIP
+        @additional_costs_percentage =
+          additional_costs_percentage
+      end
+      @amount_funded = amount_funded unless amount_funded == SKIP
+      unless amount_requested_percentage == SKIP
+        @amount_requested_percentage =
+          amount_requested_percentage
+      end
+      @annual_financing_cost = annual_financing_cost unless annual_financing_cost == SKIP
+      @annual_interest_rate = annual_interest_rate unless annual_interest_rate == SKIP
+      @expenses = expenses unless expenses == SKIP
+      @expenses_percentage = expenses_percentage unless expenses_percentage == SKIP
+      @fees = fees unless fees == SKIP
+      @fees_percentage = fees_percentage unless fees_percentage == SKIP
+      @insurance = insurance unless insurance == SKIP
+      @insurance_percentage = insurance_percentage unless insurance_percentage == SKIP
+      @monthly_interest_rate = monthly_interest_rate unless monthly_interest_rate == SKIP
+      @taxes = taxes unless taxes == SKIP
+      @taxes_percentage = taxes_percentage unless taxes_percentage == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      amount = hash.key?('amount') ? hash['amount'] : SKIP
+      frequency = hash.key?('frequency') ? hash['frequency'] : SKIP
+      plan_type = hash.key?('planType') ? hash['planType'] : SKIP
+      sequence = hash.key?('sequence') ? hash['sequence'] : SKIP
+      total_amount = hash.key?('totalAmount') ? hash['totalAmount'] : SKIP
+      total_count = hash.key?('totalCount') ? hash['totalCount'] : SKIP
+      first_installment_date =
+        hash.key?('firstInstallmentDate') ? hash['firstInstallmentDate'] : SKIP
+      first_installment_amount =
+        hash.key?('firstInstallmentAmount') ? hash['firstInstallmentAmount'] : SKIP
+      invoice_data = hash.key?('invoiceData') ? hash['invoiceData'] : SKIP
+      payment_type = hash.key?('paymentType') ? hash['paymentType'] : SKIP
+      additional_costs =
+        hash.key?('additionalCosts') ? hash['additionalCosts'] : SKIP
+      additional_costs_percentage =
+        hash.key?('additionalCostsPercentage') ? hash['additionalCostsPercentage'] : SKIP
+      amount_funded = hash.key?('amountFunded') ? hash['amountFunded'] : SKIP
+      amount_requested_percentage =
+        hash.key?('amountRequestedPercentage') ? hash['amountRequestedPercentage'] : SKIP
+      annual_financing_cost =
+        hash.key?('annualFinancingCost') ? hash['annualFinancingCost'] : SKIP
+      annual_interest_rate =
+        hash.key?('annualInterestRate') ? hash['annualInterestRate'] : SKIP
+      expenses = hash.key?('expenses') ? hash['expenses'] : SKIP
+      expenses_percentage =
+        hash.key?('expensesPercentage') ? hash['expensesPercentage'] : SKIP
+      fees = hash.key?('fees') ? hash['fees'] : SKIP
+      fees_percentage =
+        hash.key?('feesPercentage') ? hash['feesPercentage'] : SKIP
+      insurance = hash.key?('insurance') ? hash['insurance'] : SKIP
+      insurance_percentage =
+        hash.key?('insurancePercentage') ? hash['insurancePercentage'] : SKIP
+      monthly_interest_rate =
+        hash.key?('monthlyInterestRate') ? hash['monthlyInterestRate'] : SKIP
+      taxes = hash.key?('taxes') ? hash['taxes'] : SKIP
+      taxes_percentage =
+        hash.key?('taxesPercentage') ? hash['taxesPercentage'] : SKIP
+
+      # Create object from extracted values.
+      InstallmentInformation2.new(amount,
+                                  frequency,
+                                  plan_type,
+                                  sequence,
+                                  total_amount,
+                                  total_count,
+                                  first_installment_date,
+                                  first_installment_amount,
+                                  invoice_data,
+                                  payment_type,
+                                  additional_costs,
+                                  additional_costs_percentage,
+                                  amount_funded,
+                                  amount_requested_percentage,
+                                  annual_financing_cost,
+                                  annual_interest_rate,
+                                  expenses,
+                                  expenses_percentage,
+                                  fees,
+                                  fees_percentage,
+                                  insurance,
+                                  insurance_percentage,
+                                  monthly_interest_rate,
+                                  taxes,
+                                  taxes_percentage)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} amount: #{@amount}, frequency: #{@frequency}, plan_type: #{@plan_type},"\
+      " sequence: #{@sequence}, total_amount: #{@total_amount}, total_count: #{@total_count},"\
+      " first_installment_date: #{@first_installment_date}, first_installment_amount:"\
+      " #{@first_installment_amount}, invoice_data: #{@invoice_data}, payment_type:"\
+      " #{@payment_type}, additional_costs: #{@additional_costs}, additional_costs_percentage:"\
+      " #{@additional_costs_percentage}, amount_funded: #{@amount_funded},"\
+      " amount_requested_percentage: #{@amount_requested_percentage}, annual_financing_cost:"\
+      " #{@annual_financing_cost}, annual_interest_rate: #{@annual_interest_rate}, expenses:"\
+      " #{@expenses}, expenses_percentage: #{@expenses_percentage}, fees: #{@fees},"\
+      " fees_percentage: #{@fees_percentage}, insurance: #{@insurance}, insurance_percentage:"\
+      " #{@insurance_percentage}, monthly_interest_rate: #{@monthly_interest_rate}, taxes:"\
+      " #{@taxes}, taxes_percentage: #{@taxes_percentage}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} amount: #{@amount.inspect}, frequency: #{@frequency.inspect}, plan_type:"\
+      " #{@plan_type.inspect}, sequence: #{@sequence.inspect}, total_amount:"\
+      " #{@total_amount.inspect}, total_count: #{@total_count.inspect}, first_installment_date:"\
+      " #{@first_installment_date.inspect}, first_installment_amount:"\
+      " #{@first_installment_amount.inspect}, invoice_data: #{@invoice_data.inspect},"\
+      " payment_type: #{@payment_type.inspect}, additional_costs: #{@additional_costs.inspect},"\
+      " additional_costs_percentage: #{@additional_costs_percentage.inspect}, amount_funded:"\
+      " #{@amount_funded.inspect}, amount_requested_percentage:"\
+      " #{@amount_requested_percentage.inspect}, annual_financing_cost:"\
+      " #{@annual_financing_cost.inspect}, annual_interest_rate: #{@annual_interest_rate.inspect},"\
+      " expenses: #{@expenses.inspect}, expenses_percentage: #{@expenses_percentage.inspect},"\
+      " fees: #{@fees.inspect}, fees_percentage: #{@fees_percentage.inspect}, insurance:"\
+      " #{@insurance.inspect}, insurance_percentage: #{@insurance_percentage.inspect},"\
+      " monthly_interest_rate: #{@monthly_interest_rate.inspect}, taxes: #{@taxes.inspect},"\
+      " taxes_percentage: #{@taxes_percentage.inspect}>"
+    end
+  end
+end