visa-acceptance-api-sdk 1.0.0

data/lib/visa_acceptance_merged_spec/models/account_features.rb

@@ -0,0 +1,424 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AccountFeatures Model.
+  class AccountFeatures < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Type of account. This value is returned only if you requested a balance
+    # inquiry. Possible values:
+    #  - `00`: Not applicable or not specified
+    #  - `10`: Savings account
+    #  - `20`: Checking account
+    #  - `30`: Credit card account
+    #  - `40`: Universal account
+    # #### PIN debit
+    # Type of account. This value is returned only if you requested a balance
+    # inquiry.
+    # Possible values:
+    # - `00`: Not applicable or not specified
+    # - `10`: Savings account
+    # - `20`: Checking account
+    # - `40`: Universal account
+    # - `96`: Cash benefits account
+    # - `98`: Food stamp account
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :account_type
+
+    # Possible values:
+    # - `N`: Nonregulated
+    # - `R`: Regulated
+    # Returned by PIN debit credit or PIN debit purchase.
+    # **Note** This field is returned only for Visa Acceptance through VisaNet.
+    # @return [String]
+    attr_accessor :account_status
+
+    # This is an array of multiple balances information an issuer can return for
+    # a given card.
+    # @return [Array[Balance]]
+    attr_accessor :balances
+
+    # Remaining balance on the account.
+    # Returned by authorization service.
+    # #### PIN debit
+    # Remaining balance on the prepaid card.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :balance_amount
+
+    # Type of amount. This value is returned only if you requested a balance
+    # inquiry. The issuer determines the value
+    # that is returned. Possible values for deposit accounts:
+    #  - `01`: Current ledger (posted) balance.
+    #  - `02`: Current available balance, which is typically the ledger balance
+    # less outstanding authorizations.
+    # Some depository institutions also include pending deposits and the credit
+    # or overdraft line associated with the
+    # account. Possible values for credit card accounts:
+    #  - `01`: Credit amount remaining for customer (open to buy).
+    #  - `02`: Credit limit.
+    # @return [String]
+    attr_accessor :balance_amount_type
+
+    # Currency of the remaining balance on the account. For the possible values,
+    # see the [ISO Standard Currency Codes.](
+    # Returned by authorization service.
+    # #### PIN debit
+    # Currency of the remaining balance on the prepaid card.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :currency
+
+    # Sign for the remaining balance on the account. Returned only when the
+    # processor returns this value. Possible values:
+    # Possible values:
+    # - `Positive`
+    # - `Negative`
+    # #### PIN debit
+    # Sign for the remaining balance on the prepaid card. Returned only when the
+    # processor returns this value.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :balance_sign
+
+    # **Chase Paymentech Solutions**
+    # Indicates whether a customer has high credit limits. This information
+    # enables you to market high cost items to
+    # these customers and to understand the kinds of cards that high income
+    # customers are using.
+    # This field is supported for Visa, Mastercard, Discover, and Diners Club.
+    # Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # #### Litle
+    # Flag that indicates that a Visa cardholder or Mastercard cardholder is in
+    # one of the affluent categories.
+    # Possible values:
+    #  - `AFFLUENT`: High income customer with high spending pattern (>100k USD
+    # annual income and >40k USD annual
+    #    card usage).
+    #  - `MASS AFFLUENT`: High income customer (>100k USD annual income).
+    #  Maximum length is 13.
+    # #### Chase Paymentech Solutions
+    #  Maximum length is 1.
+    # @return [String]
+    attr_accessor :affluence_indicator
+
+    # #### GPX
+    # Mastercard product ID associated with the primary account number (PAN).
+    # Returned by authorization service.
+    # #### Visa Acceptance through VisaNet
+    # Visa or Mastercard product ID that is associated with the primary account
+    # number (PAN).
+    # For descriptions of the Visa product IDs, see the Product ID table on the
+    # [Visa
+    # Request & Response Codes web page.](
+    # Data Length: String (3)
+    # #### GPN
+    # Visa or Mastercard product ID that is associated with the primary account
+    # number (PAN).
+    # For descriptions of the Visa product IDs, see the Product ID table on the
+    # [Visa Request & Response Codes web page.](
+    # Data Length: String (3)
+    # #### Worldpay VAP
+    # **Important** Before using this field on Worldpay VAP,
+    # you must contact Visa Acceptance Customer Support to have
+    # your account configured for this feature.
+    # Type of card used in the transaction. The only possible value is:
+    # - `PREPAID`: Prepaid Card
+    # Data Length: String (7)
+    # #### RBS WorldPay Atlanta
+    # Type of card used in the transaction. Possible values:
+    # - `B`: Business Card
+    # - `O`: Noncommercial Card
+    # - `R`: Corporate Card
+    # - `S`: Purchase Card
+    # - `Blank`: Purchase card not supported
+    # Data Length: String (1)
+    # @return [String]
+    attr_accessor :category
+
+    # Indicates whether the card is a commercial card, which enables you to
+    # include Level II data in your transaction
+    # requests. This field is supported for Visa and Mastercard on **Chase
+    # Paymentech Solutions**. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :commercial
+
+    # Type of commercial card. This field is supported only for Visa Acceptance
+    # through VisaNet. Possible values:
+    #  - `B`: Business card
+    #  - `R`: Corporate card
+    #  - `S`: Purchasing card
+    #  - `0`: Noncommercial card
+    # Returned by authorization service.
+    # @return [String]
+    attr_accessor :group
+
+    # Indicates whether the card is a healthcare card. This field is supported
+    # for Visa and Mastercard on **Chase
+    # Paymentech Solutions**. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :health_care
+
+    # Indicates whether the card is a payroll card. This field is supported for
+    # Visa, Discover, Diners Club, and JCB
+    # on **Chase Paymentech Solutions**. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :payroll
+
+    # Indicates whether the card is eligible for Level III interchange fees,
+    # which enables you to include Level III
+    # data in your transaction requests. This field is supported for Visa and
+    # Mastercard on **Chase Paymentech
+    # Solutions**. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :level3_eligible
+
+    # Indicates whether the card is a PINless debit card. This field is
+    # supported for Visa and Mastercard on **Chase
+    # Paymentech Solutions**. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :pinless_debit
+
+    # Indicates whether the card is a signature debit card.
+    # This information enables you to alter the way an order is processed. For
+    # example, you might not want to reauthorize a transaction for a signature
+    # debit card, or you might
+    # want to perform reversals promptly for a signature debit card. This field
+    # is supported for Visa, Mastercard, and
+    # Maestro (International) on Chase Paymentech Solutions. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :signature_debit
+
+    # Indicates whether the card is a prepaid card. This information enables you
+    # to determine when a gift card or
+    # prepaid card is presented for use when establishing a new recurring,
+    # installment, or deferred billing
+    # relationship.
+    # This field is supported for Visa, Mastercard, Discover, Diners Club, and
+    # JCB on Chase Paymentech Solutions.
+    # Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :prepaid
+
+    # Indicates whether the card is regulated according to the Durbin Amendment.
+    # If the card is regulated, the card
+    # issuer is subject to price caps and interchange rules. This field is
+    # supported for Visa, Mastercard, Discover,
+    # Diners Club, and JCB on Chase Paymentech Solutions. Possible values:
+    #  - `Y`: Yes
+    #  - `N`: No
+    #  - `X`: Not applicable / Unknown
+    # @return [String]
+    attr_accessor :regulated
+
+    # This is the account owner information, valid values are:
+    # - `01` : primary account holder
+    # - `02` : secondary account holder
+    # This is returned in the response of an account verification transaction by
+    # the Issuer.
+    # @return [String]
+    attr_accessor :account_holder_type
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['account_type'] = 'accountType'
+      @_hash['account_status'] = 'accountStatus'
+      @_hash['balances'] = 'balances'
+      @_hash['balance_amount'] = 'balanceAmount'
+      @_hash['balance_amount_type'] = 'balanceAmountType'
+      @_hash['currency'] = 'currency'
+      @_hash['balance_sign'] = 'balanceSign'
+      @_hash['affluence_indicator'] = 'affluenceIndicator'
+      @_hash['category'] = 'category'
+      @_hash['commercial'] = 'commercial'
+      @_hash['group'] = 'group'
+      @_hash['health_care'] = 'healthCare'
+      @_hash['payroll'] = 'payroll'
+      @_hash['level3_eligible'] = 'level3Eligible'
+      @_hash['pinless_debit'] = 'pinlessDebit'
+      @_hash['signature_debit'] = 'signatureDebit'
+      @_hash['prepaid'] = 'prepaid'
+      @_hash['regulated'] = 'regulated'
+      @_hash['account_holder_type'] = 'accountHolderType'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        account_type
+        account_status
+        balances
+        balance_amount
+        balance_amount_type
+        currency
+        balance_sign
+        affluence_indicator
+        category
+        commercial
+        group
+        health_care
+        payroll
+        level3_eligible
+        pinless_debit
+        signature_debit
+        prepaid
+        regulated
+        account_holder_type
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(account_type = SKIP, account_status = SKIP, balances = SKIP,
+                   balance_amount = SKIP, balance_amount_type = SKIP,
+                   currency = SKIP, balance_sign = SKIP,
+                   affluence_indicator = SKIP, category = SKIP,
+                   commercial = SKIP, group = SKIP, health_care = SKIP,
+                   payroll = SKIP, level3_eligible = SKIP, pinless_debit = SKIP,
+                   signature_debit = SKIP, prepaid = SKIP, regulated = SKIP,
+                   account_holder_type = SKIP)
+      @account_type = account_type unless account_type == SKIP
+      @account_status = account_status unless account_status == SKIP
+      @balances = balances unless balances == SKIP
+      @balance_amount = balance_amount unless balance_amount == SKIP
+      @balance_amount_type = balance_amount_type unless balance_amount_type == SKIP
+      @currency = currency unless currency == SKIP
+      @balance_sign = balance_sign unless balance_sign == SKIP
+      @affluence_indicator = affluence_indicator unless affluence_indicator == SKIP
+      @category = category unless category == SKIP
+      @commercial = commercial unless commercial == SKIP
+      @group = group unless group == SKIP
+      @health_care = health_care unless health_care == SKIP
+      @payroll = payroll unless payroll == SKIP
+      @level3_eligible = level3_eligible unless level3_eligible == SKIP
+      @pinless_debit = pinless_debit unless pinless_debit == SKIP
+      @signature_debit = signature_debit unless signature_debit == SKIP
+      @prepaid = prepaid unless prepaid == SKIP
+      @regulated = regulated unless regulated == SKIP
+      @account_holder_type = account_holder_type unless account_holder_type == 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.
+      account_type = hash.key?('accountType') ? hash['accountType'] : SKIP
+      account_status = hash.key?('accountStatus') ? hash['accountStatus'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      balances = nil
+      unless hash['balances'].nil?
+        balances = []
+        hash['balances'].each do |structure|
+          balances << (Balance.from_hash(structure) if structure)
+        end
+      end
+
+      balances = SKIP unless hash.key?('balances')
+      balance_amount = hash.key?('balanceAmount') ? hash['balanceAmount'] : SKIP
+      balance_amount_type =
+        hash.key?('balanceAmountType') ? hash['balanceAmountType'] : SKIP
+      currency = hash.key?('currency') ? hash['currency'] : SKIP
+      balance_sign = hash.key?('balanceSign') ? hash['balanceSign'] : SKIP
+      affluence_indicator =
+        hash.key?('affluenceIndicator') ? hash['affluenceIndicator'] : SKIP
+      category = hash.key?('category') ? hash['category'] : SKIP
+      commercial = hash.key?('commercial') ? hash['commercial'] : SKIP
+      group = hash.key?('group') ? hash['group'] : SKIP
+      health_care = hash.key?('healthCare') ? hash['healthCare'] : SKIP
+      payroll = hash.key?('payroll') ? hash['payroll'] : SKIP
+      level3_eligible =
+        hash.key?('level3Eligible') ? hash['level3Eligible'] : SKIP
+      pinless_debit = hash.key?('pinlessDebit') ? hash['pinlessDebit'] : SKIP
+      signature_debit =
+        hash.key?('signatureDebit') ? hash['signatureDebit'] : SKIP
+      prepaid = hash.key?('prepaid') ? hash['prepaid'] : SKIP
+      regulated = hash.key?('regulated') ? hash['regulated'] : SKIP
+      account_holder_type =
+        hash.key?('accountHolderType') ? hash['accountHolderType'] : SKIP
+
+      # Create object from extracted values.
+      AccountFeatures.new(account_type,
+                          account_status,
+                          balances,
+                          balance_amount,
+                          balance_amount_type,
+                          currency,
+                          balance_sign,
+                          affluence_indicator,
+                          category,
+                          commercial,
+                          group,
+                          health_care,
+                          payroll,
+                          level3_eligible,
+                          pinless_debit,
+                          signature_debit,
+                          prepaid,
+                          regulated,
+                          account_holder_type)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_type: #{@account_type}, account_status: #{@account_status},"\
+      " balances: #{@balances}, balance_amount: #{@balance_amount}, balance_amount_type:"\
+      " #{@balance_amount_type}, currency: #{@currency}, balance_sign: #{@balance_sign},"\
+      " affluence_indicator: #{@affluence_indicator}, category: #{@category}, commercial:"\
+      " #{@commercial}, group: #{@group}, health_care: #{@health_care}, payroll: #{@payroll},"\
+      " level3_eligible: #{@level3_eligible}, pinless_debit: #{@pinless_debit}, signature_debit:"\
+      " #{@signature_debit}, prepaid: #{@prepaid}, regulated: #{@regulated}, account_holder_type:"\
+      " #{@account_holder_type}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_type: #{@account_type.inspect}, account_status:"\
+      " #{@account_status.inspect}, balances: #{@balances.inspect}, balance_amount:"\
+      " #{@balance_amount.inspect}, balance_amount_type: #{@balance_amount_type.inspect},"\
+      " currency: #{@currency.inspect}, balance_sign: #{@balance_sign.inspect},"\
+      " affluence_indicator: #{@affluence_indicator.inspect}, category: #{@category.inspect},"\
+      " commercial: #{@commercial.inspect}, group: #{@group.inspect}, health_care:"\
+      " #{@health_care.inspect}, payroll: #{@payroll.inspect}, level3_eligible:"\
+      " #{@level3_eligible.inspect}, pinless_debit: #{@pinless_debit.inspect}, signature_debit:"\
+      " #{@signature_debit.inspect}, prepaid: #{@prepaid.inspect}, regulated:"\
+      " #{@regulated.inspect}, account_holder_type: #{@account_holder_type.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/account_features1.rb

@@ -0,0 +1,92 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AccountFeatures1 Model.
+  class AccountFeatures1 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # #### GPX
+    # Mastercard product ID associated with the primary account number (PAN).
+    # Returned by authorization service.
+    # #### Visa Acceptance through VisaNet
+    # Visa or Mastercard product ID that is associated with the primary account
+    # number (PAN).
+    # For descriptions of the Visa product IDs, see the Product ID table on the
+    # [Visa
+    # Request & Response Codes web page.](
+    # Data Length: String (3)
+    # #### GPN
+    # Visa or Mastercard product ID that is associated with the primary account
+    # number (PAN).
+    # For descriptions of the Visa product IDs, see the Product ID table on the
+    # [Visa Request & Response Codes web page.](
+    # Data Length: String (3)
+    # #### Worldpay VAP
+    # **Important** Before using this field on Worldpay VAP,
+    # you must contact Visa Acceptance Customer Support to have
+    # your account configured for this feature.
+    # Type of card used in the transaction. The only possible value is:
+    # - `PREPAID`: Prepaid Card
+    # Data Length: String (7)
+    # #### RBS WorldPay Atlanta
+    # Type of card used in the transaction. Possible values:
+    # - `B`: Business Card
+    # - `O`: Noncommercial Card
+    # - `R`: Corporate Card
+    # - `S`: Purchase Card
+    # - `Blank`: Purchase card not supported
+    # Data Length: String (1)
+    # @return [String]
+    attr_accessor :category
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['category'] = 'category'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        category
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(category = SKIP)
+      @category = category unless category == 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.
+      category = hash.key?('category') ? hash['category'] : SKIP
+
+      # Create object from extracted values.
+      AccountFeatures1.new(category)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} category: #{@category}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} category: #{@category.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/account_features2.rb

@@ -0,0 +1,97 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AccountFeatures2 Model.
+  class AccountFeatures2 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Remaining balance on the account.
+    # Returned by authorization service.
+    # #### PIN debit
+    # Remaining balance on the prepaid card.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :balance_amount
+
+    # Remaining balance on the account.
+    # Returned by authorization service.
+    # #### PIN debit
+    # Remaining balance on the prepaid card.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :previous_balance_amount
+
+    # Currency of the remaining balance on the account. For the possible values,
+    # see the [ISO Standard Currency Codes.](
+    # Returned by authorization service.
+    # #### PIN debit
+    # Currency of the remaining balance on the prepaid card.
+    # Returned by PIN debit purchase.
+    # @return [String]
+    attr_accessor :currency
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['balance_amount'] = 'balanceAmount'
+      @_hash['previous_balance_amount'] = 'previousBalanceAmount'
+      @_hash['currency'] = 'currency'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        balance_amount
+        previous_balance_amount
+        currency
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(balance_amount = SKIP, previous_balance_amount = SKIP,
+                   currency = SKIP)
+      @balance_amount = balance_amount unless balance_amount == SKIP
+      @previous_balance_amount = previous_balance_amount unless previous_balance_amount == SKIP
+      @currency = currency unless currency == 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.
+      balance_amount = hash.key?('balanceAmount') ? hash['balanceAmount'] : SKIP
+      previous_balance_amount =
+        hash.key?('previousBalanceAmount') ? hash['previousBalanceAmount'] : SKIP
+      currency = hash.key?('currency') ? hash['currency'] : SKIP
+
+      # Create object from extracted values.
+      AccountFeatures2.new(balance_amount,
+                           previous_balance_amount,
+                           currency)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} balance_amount: #{@balance_amount}, previous_balance_amount:"\
+      " #{@previous_balance_amount}, currency: #{@currency}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} balance_amount: #{@balance_amount.inspect}, previous_balance_amount:"\
+      " #{@previous_balance_amount.inspect}, currency: #{@currency.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/account_history.rb

@@ -0,0 +1,85 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # AccountHistory Model.
+  class AccountHistory < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Applicable when this is not a guest account.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :first_use_of_shipping_address
+
+    # Date when the shipping address for this transaction was first used.
+    # Recommended for Discover ProtectBuy.
+    # If `firstUseOfShippingAddress` is false and not a guest account, then this
+    # date is entered.
+    # @return [String]
+    attr_accessor :shipping_address_usage_date
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['first_use_of_shipping_address'] = 'firstUseOfShippingAddress'
+      @_hash['shipping_address_usage_date'] = 'shippingAddressUsageDate'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        first_use_of_shipping_address
+        shipping_address_usage_date
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(first_use_of_shipping_address = SKIP,
+                   shipping_address_usage_date = SKIP)
+      unless first_use_of_shipping_address == SKIP
+        @first_use_of_shipping_address =
+          first_use_of_shipping_address
+      end
+      unless shipping_address_usage_date == SKIP
+        @shipping_address_usage_date =
+          shipping_address_usage_date
+      end
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      first_use_of_shipping_address =
+        hash.key?('firstUseOfShippingAddress') ? hash['firstUseOfShippingAddress'] : SKIP
+      shipping_address_usage_date =
+        hash.key?('shippingAddressUsageDate') ? hash['shippingAddressUsageDate'] : SKIP
+
+      # Create object from extracted values.
+      AccountHistory.new(first_use_of_shipping_address,
+                         shipping_address_usage_date)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} first_use_of_shipping_address: #{@first_use_of_shipping_address},"\
+      " shipping_address_usage_date: #{@shipping_address_usage_date}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} first_use_of_shipping_address: #{@first_use_of_shipping_address.inspect},"\
+      " shipping_address_usage_date: #{@shipping_address_usage_date.inspect}>"
+    end
+  end
+end