visa-acceptance-api-sdk 1.0.0

data/lib/visa_acceptance_merged_spec/models/amount_details6.rb

@@ -0,0 +1,63 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AmountDetails6 Model.
+  class AmountDetails6 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Service fee. Required for service fee transactions.
+    # @return [String]
+    attr_accessor :service_fee_amount
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['service_fee_amount'] = 'serviceFeeAmount'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        service_fee_amount
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(service_fee_amount = SKIP)
+      @service_fee_amount = service_fee_amount unless service_fee_amount == 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.
+      service_fee_amount =
+        hash.key?('serviceFeeAmount') ? hash['serviceFeeAmount'] : SKIP
+
+      # Create object from extracted values.
+      AmountDetails6.new(service_fee_amount)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} service_fee_amount: #{@service_fee_amount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} service_fee_amount: #{@service_fee_amount.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/amount_details9.rb

@@ -0,0 +1,404 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AmountDetails9 Model.
+  class AmountDetails9 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Grand total for the order. This value cannot be negative. You can include
+    # a decimal point (.), but no other special characters.
+    # Visa Acceptance truncates the amount to the correct number of decimal
+    # places.
+    # **Note** For CTV, FDCCompass, Paymentech processors, the maximum length
+    # for this field is 12.
+    # **Important** Some processors have specific requirements and limitations,
+    # such as maximum amounts and maximum field lengths.
+    # If your processor supports zero amount authorizations, you can set this
+    # field to 0 for the authorization to check if the card is lost or stolen. 
+    # #### Card Present
+    # Required to include either this field or
+    # `orderInformation.lineItems[].unitPrice` for the order.
+    # #### Invoicing / Pay By Link
+    # Required for creating a new invoice or payment link.
+    # #### PIN Debit
+    # Amount you requested for the PIN debit purchase. This value is returned
+    # for partial authorizations. The issuing bank can approve a partial amount
+    # if the balance on the debit card is less than the requested transaction
+    # amount.
+    # Required field for PIN Debit purchase and PIN Debit credit requests.
+    # Optional field for PIN Debit reversal requests.
+    # #### GPX
+    # This field is optional for reversing an authorization or credit; however,
+    # for all other processors, these fields are required.
+    # #### DCC with a Third-Party Provider
+    # Set this field to the converted amount that was returned by the DCC
+    # provider. You must include either this field or the 1st line item in the
+    # order and the specific line-order amount in your request. 
+    # #### DCC for First Data
+    # Not used.
+    # @return [String]
+    attr_accessor :total_amount
+
+    # Currency used for the order. Use the three-character [ISO Standard
+    # Currency Codes.](
+    # #### Used by
+    # **Authorization**
+    # Required field.
+    # **Authorization Reversal**
+    # For an authorization reversal (`reversalInformation`) or a capture
+    # (`processingOptions.capture` is set to `true`), you must use the same
+    # currency that you used in your payment authorization request.
+    # #### PIN Debit
+    # Currency for the amount you requested for the PIN debit purchase. This
+    # value is returned for partial authorizations. The issuing bank can approve
+    # a partial amount if the balance on the debit card is less than the
+    # requested transaction amount. For the possible values, see the [ISO
+    # Standard Currency Codes](
+    # Returned by PIN debit purchase.
+    # For PIN debit reversal requests, you must use the same currency that was
+    # used for the PIN debit purchase or PIN debit credit that you are
+    # reversing.
+    # For the possible values, see the [ISO Standard Currency Codes](
+    # Required field for PIN Debit purchase and PIN Debit credit requests.
+    # Optional field for PIN Debit reversal requests.
+    # #### GPX
+    # This field is optional for reversing an authorization or credit.
+    # #### DCC for First Data
+    # Your local currency.
+    # #### Tax Calculation
+    # Required for international tax and value added tax only.
+    # Optional for U.S. and Canadian taxes.
+    # Your local currency.
+    # @return [String]
+    attr_accessor :currency
+
+    # Total discount amount applied to the order.
+    # @return [String]
+    attr_accessor :discount_amount
+
+    # Total charges for any import or export duties included in the order.
+    # @return [String]
+    attr_accessor :duty_amount
+
+    # Gratuity or tip amount for restaurants. Allowed only when
+    # industryDatatype=restaurant.
+    # When your customer uses a debit card or prepaid card, and you receive a
+    # partial authorization, the payment networks recommend that you do not
+    # submit a capture amount that is higher than the authorized amount. When
+    # the capture amount exceeds the partial amount that was approved, the
+    # issuer has chargeback rights for the excess amount.
+    # Used by **Capture**
+    # Optional field.
+    # #### Visa Acceptance through VisaNet
+    # Restaurant data is supported only on Visa Acceptance through VisaNet when
+    # card is present.
+    # @return [String]
+    attr_accessor :gratuity_amount
+
+    # Total tax amount for all the items in the order.
+    # @return [String]
+    attr_accessor :tax_amount
+
+    # Flag that indicates whether a national tax is included in the order total.
+    # Possible values:
+    #  - **0**: national tax not included
+    #  - **1**: national tax included
+    # @return [String]
+    attr_accessor :national_tax_included
+
+    # Flag that indicates how the merchant manages discounts.
+    # Possible values:
+    #  - **0**: no invoice level discount included
+    #  - **1**: tax calculated on the postdiscount invoice total
+    #  - **2**: tax calculated on the prediscount invoice total
+    # @return [String]
+    attr_accessor :tax_applied_after_discount
+
+    # Flag that indicates how you calculate tax.
+    # Possible values:
+    #  - **0**: net prices with tax calculated at line item level
+    #  - **1**: net prices with tax calculated at invoice level
+    #  - **2**: gross prices with tax provided at line item level
+    #  - **3**: gross prices with tax provided at invoice level
+    #  - **4**: no tax applies on the invoice for the transaction
+    # @return [String]
+    attr_accessor :tax_applied_level
+
+    # For tax amounts that can be categorized as one tax type.
+    # This field contains the tax type code that corresponds to the entry in the
+    # _lineItems.taxAmount_ field.
+    # Possible values:
+    #  - **056**: sales tax (U.S only)
+    #  - **TX~**: all taxes (Canada only)   Note ~ = space.
+    # @return [String]
+    attr_accessor :tax_type_code
+
+    # Total freight or shipping and handling charges for the order. When you
+    # include this field in your request, you
+    # must also include the **totalAmount** field.
+    # @return [String]
+    attr_accessor :freight_amount
+
+    # Set this field to the converted amount that was returned by the DCC
+    # provider.
+    # @return [String]
+    attr_accessor :foreign_amount
+
+    # Set this field to the converted amount that was returned by the DCC
+    # provider.
+    # @return [String]
+    attr_accessor :foreign_currency
+
+    # Exchange rate returned by the DCC service. Includes a decimal point and a
+    # maximum of 4 decimal places.
+    # @return [String]
+    attr_accessor :exchange_rate
+
+    # Time stamp for the exchange rate. This value is returned by the DCC
+    # service.
+    # Format: `YYYYMMDD~HH:MM`  where ~ denotes a space.
+    # @return [String]
+    attr_accessor :exchange_rate_time_stamp
+
+    # Time stamp for the exchange rate. This value is returned by the DCC
+    # service.
+    # Format: `YYYYMMDD~HH:MM`  where ~ denotes a space.
+    # @return [Array[AmexAdditionalAmount]]
+    attr_accessor :amex_additional_amounts
+
+    # Time stamp for the exchange rate. This value is returned by the DCC
+    # service.
+    # Format: `YYYYMMDD~HH:MM`  where ~ denotes a space.
+    # @return [Array[TaxDetails1]]
+    attr_accessor :tax_details
+
+    # Service fee. Required for service fee transactions.
+    # @return [String]
+    attr_accessor :service_fee_amount
+
+    # Your local pricing currency code.
+    # For the possible values, see the [ISO Standard Currency Codes.](
+    # @return [String]
+    attr_accessor :original_currency
+
+    # Cashback amount in the acquirer’s currency. If a cashback amount is
+    # included in the request, it must be included
+    # in the `orderInformation.amountDetails.totalAmount` value.
+    # This field is supported only on Visa Acceptance through VisaNet.
+    # #### Used by
+    # **Authorization**
+    # Optional.
+    # **Authorization Reversal**
+    # Optional.
+    # #### PIN debit
+    # Optional field for PIN debit purchase, PIN debit credit or PIN debit
+    # reversal.
+    # @return [String]
+    attr_accessor :cashback_amount
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['total_amount'] = 'totalAmount'
+      @_hash['currency'] = 'currency'
+      @_hash['discount_amount'] = 'discountAmount'
+      @_hash['duty_amount'] = 'dutyAmount'
+      @_hash['gratuity_amount'] = 'gratuityAmount'
+      @_hash['tax_amount'] = 'taxAmount'
+      @_hash['national_tax_included'] = 'nationalTaxIncluded'
+      @_hash['tax_applied_after_discount'] = 'taxAppliedAfterDiscount'
+      @_hash['tax_applied_level'] = 'taxAppliedLevel'
+      @_hash['tax_type_code'] = 'taxTypeCode'
+      @_hash['freight_amount'] = 'freightAmount'
+      @_hash['foreign_amount'] = 'foreignAmount'
+      @_hash['foreign_currency'] = 'foreignCurrency'
+      @_hash['exchange_rate'] = 'exchangeRate'
+      @_hash['exchange_rate_time_stamp'] = 'exchangeRateTimeStamp'
+      @_hash['amex_additional_amounts'] = 'amexAdditionalAmounts'
+      @_hash['tax_details'] = 'taxDetails'
+      @_hash['service_fee_amount'] = 'serviceFeeAmount'
+      @_hash['original_currency'] = 'originalCurrency'
+      @_hash['cashback_amount'] = 'cashbackAmount'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        total_amount
+        currency
+        discount_amount
+        duty_amount
+        gratuity_amount
+        tax_amount
+        national_tax_included
+        tax_applied_after_discount
+        tax_applied_level
+        tax_type_code
+        freight_amount
+        foreign_amount
+        foreign_currency
+        exchange_rate
+        exchange_rate_time_stamp
+        amex_additional_amounts
+        tax_details
+        service_fee_amount
+        original_currency
+        cashback_amount
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(total_amount = SKIP, currency = SKIP, discount_amount = SKIP,
+                   duty_amount = SKIP, gratuity_amount = SKIP,
+                   tax_amount = SKIP, national_tax_included = SKIP,
+                   tax_applied_after_discount = SKIP, tax_applied_level = SKIP,
+                   tax_type_code = SKIP, freight_amount = SKIP,
+                   foreign_amount = SKIP, foreign_currency = SKIP,
+                   exchange_rate = SKIP, exchange_rate_time_stamp = SKIP,
+                   amex_additional_amounts = SKIP, tax_details = SKIP,
+                   service_fee_amount = SKIP, original_currency = SKIP,
+                   cashback_amount = SKIP)
+      @total_amount = total_amount unless total_amount == SKIP
+      @currency = currency unless currency == SKIP
+      @discount_amount = discount_amount unless discount_amount == SKIP
+      @duty_amount = duty_amount unless duty_amount == SKIP
+      @gratuity_amount = gratuity_amount unless gratuity_amount == SKIP
+      @tax_amount = tax_amount unless tax_amount == SKIP
+      @national_tax_included = national_tax_included unless national_tax_included == SKIP
+      unless tax_applied_after_discount == SKIP
+        @tax_applied_after_discount =
+          tax_applied_after_discount
+      end
+      @tax_applied_level = tax_applied_level unless tax_applied_level == SKIP
+      @tax_type_code = tax_type_code unless tax_type_code == SKIP
+      @freight_amount = freight_amount unless freight_amount == SKIP
+      @foreign_amount = foreign_amount unless foreign_amount == SKIP
+      @foreign_currency = foreign_currency unless foreign_currency == SKIP
+      @exchange_rate = exchange_rate unless exchange_rate == SKIP
+      @exchange_rate_time_stamp = exchange_rate_time_stamp unless exchange_rate_time_stamp == SKIP
+      @amex_additional_amounts = amex_additional_amounts unless amex_additional_amounts == SKIP
+      @tax_details = tax_details unless tax_details == SKIP
+      @service_fee_amount = service_fee_amount unless service_fee_amount == SKIP
+      @original_currency = original_currency unless original_currency == SKIP
+      @cashback_amount = cashback_amount unless cashback_amount == 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.
+      total_amount = hash.key?('totalAmount') ? hash['totalAmount'] : SKIP
+      currency = hash.key?('currency') ? hash['currency'] : SKIP
+      discount_amount =
+        hash.key?('discountAmount') ? hash['discountAmount'] : SKIP
+      duty_amount = hash.key?('dutyAmount') ? hash['dutyAmount'] : SKIP
+      gratuity_amount =
+        hash.key?('gratuityAmount') ? hash['gratuityAmount'] : SKIP
+      tax_amount = hash.key?('taxAmount') ? hash['taxAmount'] : SKIP
+      national_tax_included =
+        hash.key?('nationalTaxIncluded') ? hash['nationalTaxIncluded'] : SKIP
+      tax_applied_after_discount =
+        hash.key?('taxAppliedAfterDiscount') ? hash['taxAppliedAfterDiscount'] : SKIP
+      tax_applied_level =
+        hash.key?('taxAppliedLevel') ? hash['taxAppliedLevel'] : SKIP
+      tax_type_code = hash.key?('taxTypeCode') ? hash['taxTypeCode'] : SKIP
+      freight_amount = hash.key?('freightAmount') ? hash['freightAmount'] : SKIP
+      foreign_amount = hash.key?('foreignAmount') ? hash['foreignAmount'] : SKIP
+      foreign_currency =
+        hash.key?('foreignCurrency') ? hash['foreignCurrency'] : SKIP
+      exchange_rate = hash.key?('exchangeRate') ? hash['exchangeRate'] : SKIP
+      exchange_rate_time_stamp =
+        hash.key?('exchangeRateTimeStamp') ? hash['exchangeRateTimeStamp'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      amex_additional_amounts = nil
+      unless hash['amexAdditionalAmounts'].nil?
+        amex_additional_amounts = []
+        hash['amexAdditionalAmounts'].each do |structure|
+          amex_additional_amounts << (AmexAdditionalAmount.from_hash(structure) if structure)
+        end
+      end
+
+      amex_additional_amounts = SKIP unless hash.key?('amexAdditionalAmounts')
+      # Parameter is an array, so we need to iterate through it
+      tax_details = nil
+      unless hash['taxDetails'].nil?
+        tax_details = []
+        hash['taxDetails'].each do |structure|
+          tax_details << (TaxDetails1.from_hash(structure) if structure)
+        end
+      end
+
+      tax_details = SKIP unless hash.key?('taxDetails')
+      service_fee_amount =
+        hash.key?('serviceFeeAmount') ? hash['serviceFeeAmount'] : SKIP
+      original_currency =
+        hash.key?('originalCurrency') ? hash['originalCurrency'] : SKIP
+      cashback_amount =
+        hash.key?('cashbackAmount') ? hash['cashbackAmount'] : SKIP
+
+      # Create object from extracted values.
+      AmountDetails9.new(total_amount,
+                         currency,
+                         discount_amount,
+                         duty_amount,
+                         gratuity_amount,
+                         tax_amount,
+                         national_tax_included,
+                         tax_applied_after_discount,
+                         tax_applied_level,
+                         tax_type_code,
+                         freight_amount,
+                         foreign_amount,
+                         foreign_currency,
+                         exchange_rate,
+                         exchange_rate_time_stamp,
+                         amex_additional_amounts,
+                         tax_details,
+                         service_fee_amount,
+                         original_currency,
+                         cashback_amount)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} total_amount: #{@total_amount}, currency: #{@currency}, discount_amount:"\
+      " #{@discount_amount}, duty_amount: #{@duty_amount}, gratuity_amount: #{@gratuity_amount},"\
+      " tax_amount: #{@tax_amount}, national_tax_included: #{@national_tax_included},"\
+      " tax_applied_after_discount: #{@tax_applied_after_discount}, tax_applied_level:"\
+      " #{@tax_applied_level}, tax_type_code: #{@tax_type_code}, freight_amount:"\
+      " #{@freight_amount}, foreign_amount: #{@foreign_amount}, foreign_currency:"\
+      " #{@foreign_currency}, exchange_rate: #{@exchange_rate}, exchange_rate_time_stamp:"\
+      " #{@exchange_rate_time_stamp}, amex_additional_amounts: #{@amex_additional_amounts},"\
+      " tax_details: #{@tax_details}, service_fee_amount: #{@service_fee_amount},"\
+      " original_currency: #{@original_currency}, cashback_amount: #{@cashback_amount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} total_amount: #{@total_amount.inspect}, currency: #{@currency.inspect},"\
+      " discount_amount: #{@discount_amount.inspect}, duty_amount: #{@duty_amount.inspect},"\
+      " gratuity_amount: #{@gratuity_amount.inspect}, tax_amount: #{@tax_amount.inspect},"\
+      " national_tax_included: #{@national_tax_included.inspect}, tax_applied_after_discount:"\
+      " #{@tax_applied_after_discount.inspect}, tax_applied_level: #{@tax_applied_level.inspect},"\
+      " tax_type_code: #{@tax_type_code.inspect}, freight_amount: #{@freight_amount.inspect},"\
+      " foreign_amount: #{@foreign_amount.inspect}, foreign_currency:"\
+      " #{@foreign_currency.inspect}, exchange_rate: #{@exchange_rate.inspect},"\
+      " exchange_rate_time_stamp: #{@exchange_rate_time_stamp.inspect}, amex_additional_amounts:"\
+      " #{@amex_additional_amounts.inspect}, tax_details: #{@tax_details.inspect},"\
+      " service_fee_amount: #{@service_fee_amount.inspect}, original_currency:"\
+      " #{@original_currency.inspect}, cashback_amount: #{@cashback_amount.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/ancillary_information.rb

@@ -0,0 +1,164 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AncillaryInformation Model.
+  class AncillaryInformation < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Ticket number, which consists of the carrier code, form, and serial
+    # number, without the check digit.
+    # **Important** This field is required in the U.S. in order for you to
+    # qualify for either the
+    # custom payment service (CPS) or the electronic interchange reimbursement
+    # fee (EIRF) program.
+    # Format: English characters only.
+    # Optional field for ancillary services.
+    # @return [String]
+    attr_accessor :ticket_number
+
+    # Name of the passenger. If the passenger’s name is not available, this
+    # value is the cardholder’s name. If neither the passenger’s name nor the
+    # cardholder’s name is available,
+    # this value is a description of the ancillary purchase.
+    # **Important** This field is required in the U.S. in order for you to
+    # qualify for either the custom payment service (CPS) or the electronic
+    # interchange reimbursement fee (EIRF)
+    # program.
+    # Format: English characters only.
+    # Optional field for ancillary service.
+    # @return [String]
+    attr_accessor :passenger_name
+
+    # Number for the airline ticket to which the ancillary purchase is
+    # connected.
+    # If this purchase has a connection or relationship to another purchase such
+    # as a baggage fee for a passenger transport ticket, this field must contain
+    # the ticket number for the other purchase.
+    # For a stand-alone purchase, the value for this field must be the same as
+    # the value for the
+    # `travelInformation.transit.airline.ancillaryInformation.ticketNumber`
+    # field.
+    # **Important** This field is required in the U.S. in order for you to
+    # qualify for either the custom payment service (CPS) or the electronic
+    # interchange reimbursement fee (EIRF)
+    # program.
+    # Format: English characters only.
+    # Optional request field for ancillary services.
+    # @return [String]
+    attr_accessor :connected_ticket_number
+
+    # Reason for the credit.
+    # Possible values:
+    # - `A`: Cancellation of the ancillary passenger transport purchase.
+    # - `B`: Cancellation of the airline ticket and the passenger transport
+    # ancillary purchase.
+    # - `C`: Cancellation of the airline ticket.
+    # - `O`: Other.
+    # - `P`: Partial refund of the airline ticket.
+    # Format: English characters only.
+    # Optional field for ancillary services.
+    # @return [String]
+    attr_accessor :credit_reason_indicator
+
+    # Reason for the credit.
+    # Possible values:
+    # - `A`: Cancellation of the ancillary passenger transport purchase.
+    # - `B`: Cancellation of the airline ticket and the passenger transport
+    # ancillary purchase.
+    # - `C`: Cancellation of the airline ticket.
+    # - `O`: Other.
+    # - `P`: Partial refund of the airline ticket.
+    # Format: English characters only.
+    # Optional field for ancillary services.
+    # @return [Array[Service]]
+    attr_accessor :service
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['ticket_number'] = 'ticketNumber'
+      @_hash['passenger_name'] = 'passengerName'
+      @_hash['connected_ticket_number'] = 'connectedTicketNumber'
+      @_hash['credit_reason_indicator'] = 'creditReasonIndicator'
+      @_hash['service'] = 'service'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        ticket_number
+        passenger_name
+        connected_ticket_number
+        credit_reason_indicator
+        service
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(ticket_number = SKIP, passenger_name = SKIP,
+                   connected_ticket_number = SKIP,
+                   credit_reason_indicator = SKIP, service = SKIP)
+      @ticket_number = ticket_number unless ticket_number == SKIP
+      @passenger_name = passenger_name unless passenger_name == SKIP
+      @connected_ticket_number = connected_ticket_number unless connected_ticket_number == SKIP
+      @credit_reason_indicator = credit_reason_indicator unless credit_reason_indicator == SKIP
+      @service = service unless service == 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.
+      ticket_number = hash.key?('ticketNumber') ? hash['ticketNumber'] : SKIP
+      passenger_name = hash.key?('passengerName') ? hash['passengerName'] : SKIP
+      connected_ticket_number =
+        hash.key?('connectedTicketNumber') ? hash['connectedTicketNumber'] : SKIP
+      credit_reason_indicator =
+        hash.key?('creditReasonIndicator') ? hash['creditReasonIndicator'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      service = nil
+      unless hash['service'].nil?
+        service = []
+        hash['service'].each do |structure|
+          service << (Service.from_hash(structure) if structure)
+        end
+      end
+
+      service = SKIP unless hash.key?('service')
+
+      # Create object from extracted values.
+      AncillaryInformation.new(ticket_number,
+                               passenger_name,
+                               connected_ticket_number,
+                               credit_reason_indicator,
+                               service)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ticket_number: #{@ticket_number}, passenger_name: #{@passenger_name},"\
+      " connected_ticket_number: #{@connected_ticket_number}, credit_reason_indicator:"\
+      " #{@credit_reason_indicator}, service: #{@service}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ticket_number: #{@ticket_number.inspect}, passenger_name:"\
+      " #{@passenger_name.inspect}, connected_ticket_number: #{@connected_ticket_number.inspect},"\
+      " credit_reason_indicator: #{@credit_reason_indicator.inspect}, service:"\
+      " #{@service.inspect}>"
+    end
+  end
+end