fdx-apimatic-sdk 0.0.1

data/lib/fdx_v660_api/models/transaction.rb

@@ -0,0 +1,449 @@
+# fdx_v660_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+require 'date'
+module FdxV660Api
+  # Financial transaction details not specific to an account category
+  class Transaction < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Corresponds to AccountId in Account
+    # @return [String]
+    attr_accessor :account_id
+
+    # Long term persistent identity of the transaction (unique to account)
+    # @return [String]
+    attr_accessor :transaction_id
+
+    # The date and time that the transaction was posted to the account. If not
+    # provided then TransactionTimestamp can be used as PostedTimeStamp
+    # @return [DateTime]
+    attr_accessor :posted_timestamp
+
+    # The date and time that the transaction was added to the server backend
+    # systems
+    # @return [DateTime]
+    attr_accessor :transaction_timestamp
+
+    # The description of the transaction, such as information about a merchant's
+    # name or place of business in a manner that is user friendly and accessible
+    # to the customer. Detailed information on a payee, such as address, can be
+    # sent in `transactionPayee`
+    # @return [String]
+    attr_accessor :description
+
+    # The merchant or individual payee who was involved in the transaction
+    # @return [TransactionPayeeEntity3]
+    attr_accessor :transaction_payee
+
+    # DEBIT, CREDIT, MEMO
+    # @return [DebitCreditMemo2]
+    attr_accessor :debit_credit_memo
+
+    # PENDING, MEMO, POSTED, AUTHORIZATION
+    # @return [TransactionStatus2]
+    attr_accessor :status
+
+    # The amount of money in the account currency
+    # @return [Float]
+    attr_accessor :amount
+
+    # Rewards earned with this transaction. If data provider does not have
+    # rewards data available alongside full Transaction details, instead of
+    # including in full `/transactions` response this can be returned as part of
+    # `/reward-transactions` endpoint. Deprecated in v6.5 to be replaced by
+    # array property `rewards` in next major version v7.0
+    # @return [TransactionRewardEntity]
+    attr_accessor :reward
+
+    # Array of rewards earned or adjusted with this transaction. If data
+    # provider does not have rewards data available alongside full Transaction
+    # details, instead of including in full `/transactions` response this can be
+    # returned as part of `/reward-transactions` endpoint
+    # @return [Array[TransactionRewardEntity]]
+    attr_accessor :rewards
+
+    # Array of FI-specific attributes
+    # @return [Array[FiAttributeEntity]]
+    attr_accessor :fi_attributes
+
+    # Links (unique to this transaction) used to retrieve full transaction
+    # details or images of checks or transaction receipts
+    # @return [Array[HateoasLink]]
+    attr_accessor :links
+
+    # Links (unique to this transaction) used to retrieve full transaction
+    # details or images of checks or transaction receipts
+    # @return [String]
+    attr_accessor :account_category
+
+    # For reverse postings, the identity of the transaction being reversed. For
+    # the correction transaction, the identity of the reversing post. For credit
+    # card posting transactions, the identity of the authorization transaction
+    # @return [String]
+    attr_accessor :reference_transaction_id
+
+    # The payment card number (e.g. debit, credit or digital), suitably masked,
+    # used to originate the transaction. May differ from primary account number
+    # as a secondary or employee card or a one-time use number. This is an
+    # optional field and won't be returned for certain types of transactions
+    # such as cash or check deposits
+    # @return [String]
+    attr_accessor :card_number_display
+
+    # Secondary transaction description
+    # @return [String]
+    attr_accessor :memo
+
+    # High-level description of transaction category. Such as Transportation.
+    # The deprecated prior description was 'Transaction category, preferably MCC
+    # or SIC'
+    # @return [String]
+    attr_accessor :category
+
+    # Lower-level description of the transaction's sub-category. Such as
+    # Airfare. The deprecated prior description was 'Transaction category detail
+    # specifying the standard of the transaction category. For example, "MCC"'
+    # @return [String]
+    attr_accessor :sub_category
+
+    # Transaction category code from `MCC` or `SIC` codesets
+    # @return [String]
+    attr_accessor :category_code
+
+    # Type of transaction category code, either `MCC` (Merchant Category Code)
+    # or `SIC` (Standard Industrial Classification)
+    # @return [CategoryType2]
+    attr_accessor :category_type
+
+    # A tracking reference identifier
+    # @return [String]
+    attr_accessor :reference
+
+    # Remittance details for the transaction
+    # @return [Remittance2]
+    attr_accessor :remittance
+
+    # The amount of money in the foreign currency
+    # @return [Float]
+    attr_accessor :foreign_amount
+
+    # The ISO 4217 code of the foreign currency
+    # @return [Iso4217CurrencyCode3]
+    attr_accessor :foreign_currency
+
+    # Array of Image Identifiers (unique to this transaction) used to retrieve
+    # Images of check or transaction receipt
+    # @return [Array[String]]
+    attr_accessor :image_ids
+
+    # Breakdown of the transaction details
+    # @return [Array[LineItemEntity]]
+    attr_accessor :line_item
+
+    # Discriminators mapping.
+    def self.discriminators
+      if @_discriminators.nil?
+        @_discriminators = {}
+        @_discriminators['Buy Now Pay Later Transaction entity'] = BuyNowPayLaterTransactionEntity
+        @_discriminators['Commercial Transaction entity'] = CommercialTransactionEntity
+        @_discriminators['Deposit Transaction entity'] = DepositTransactionEntity
+        @_discriminators['Digital Wallet Transaction entity'] = DigitalWalletTransactionEntity
+        @_discriminators['Insurance Transaction entity'] = InsuranceTransactionEntity
+        @_discriminators['Investment Transaction entity'] = InvestmentTransactionEntity
+        @_discriminators['Line of Credit Transaction entity'] = LineOfCreditTransactionEntity
+        @_discriminators['Loan Transaction entity'] = LoanTransactionEntity
+      end
+      @_discriminators
+    end
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['account_id'] = 'accountId'
+      @_hash['transaction_id'] = 'transactionId'
+      @_hash['posted_timestamp'] = 'postedTimestamp'
+      @_hash['transaction_timestamp'] = 'transactionTimestamp'
+      @_hash['description'] = 'description'
+      @_hash['transaction_payee'] = 'transactionPayee'
+      @_hash['debit_credit_memo'] = 'debitCreditMemo'
+      @_hash['status'] = 'status'
+      @_hash['amount'] = 'amount'
+      @_hash['reward'] = 'reward'
+      @_hash['rewards'] = 'rewards'
+      @_hash['fi_attributes'] = 'fiAttributes'
+      @_hash['links'] = 'links'
+      @_hash['account_category'] = 'accountCategory'
+      @_hash['reference_transaction_id'] = 'referenceTransactionId'
+      @_hash['card_number_display'] = 'cardNumberDisplay'
+      @_hash['memo'] = 'memo'
+      @_hash['category'] = 'category'
+      @_hash['sub_category'] = 'subCategory'
+      @_hash['category_code'] = 'categoryCode'
+      @_hash['category_type'] = 'categoryType'
+      @_hash['reference'] = 'reference'
+      @_hash['remittance'] = 'remittance'
+      @_hash['foreign_amount'] = 'foreignAmount'
+      @_hash['foreign_currency'] = 'foreignCurrency'
+      @_hash['image_ids'] = 'imageIds'
+      @_hash['line_item'] = 'lineItem'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        account_id
+        transaction_id
+        posted_timestamp
+        transaction_timestamp
+        description
+        transaction_payee
+        debit_credit_memo
+        status
+        amount
+        reward
+        rewards
+        fi_attributes
+        links
+        account_category
+        reference_transaction_id
+        card_number_display
+        memo
+        category
+        sub_category
+        category_code
+        category_type
+        reference
+        remittance
+        foreign_amount
+        foreign_currency
+        image_ids
+        line_item
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(account_id: SKIP, transaction_id: SKIP,
+                   posted_timestamp: SKIP, transaction_timestamp: SKIP,
+                   description: SKIP, transaction_payee: SKIP,
+                   debit_credit_memo: SKIP, status: SKIP, amount: SKIP,
+                   reward: SKIP, rewards: SKIP, fi_attributes: SKIP,
+                   links: SKIP, account_category: 'Transaction',
+                   reference_transaction_id: SKIP, card_number_display: SKIP,
+                   memo: SKIP, category: SKIP, sub_category: SKIP,
+                   category_code: SKIP, category_type: SKIP, reference: SKIP,
+                   remittance: SKIP, foreign_amount: SKIP,
+                   foreign_currency: SKIP, image_ids: SKIP, line_item: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @account_id = account_id unless account_id == SKIP
+      @transaction_id = transaction_id unless transaction_id == SKIP
+      @posted_timestamp = posted_timestamp unless posted_timestamp == SKIP
+      @transaction_timestamp = transaction_timestamp unless transaction_timestamp == SKIP
+      @description = description unless description == SKIP
+      @transaction_payee = transaction_payee unless transaction_payee == SKIP
+      @debit_credit_memo = debit_credit_memo unless debit_credit_memo == SKIP
+      @status = status unless status == SKIP
+      @amount = amount unless amount == SKIP
+      @reward = reward unless reward == SKIP
+      @rewards = rewards unless rewards == SKIP
+      @fi_attributes = fi_attributes unless fi_attributes == SKIP
+      @links = links unless links == SKIP
+      @account_category = account_category unless account_category == SKIP
+      @reference_transaction_id = reference_transaction_id unless reference_transaction_id == SKIP
+      @card_number_display = card_number_display unless card_number_display == SKIP
+      @memo = memo unless memo == SKIP
+      @category = category unless category == SKIP
+      @sub_category = sub_category unless sub_category == SKIP
+      @category_code = category_code unless category_code == SKIP
+      @category_type = category_type unless category_type == SKIP
+      @reference = reference unless reference == SKIP
+      @remittance = remittance unless remittance == SKIP
+      @foreign_amount = foreign_amount unless foreign_amount == SKIP
+      @foreign_currency = foreign_currency unless foreign_currency == SKIP
+      @image_ids = image_ids unless image_ids == SKIP
+      @line_item = line_item unless line_item == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Delegate unboxing to another function if a discriminator
+      # value for a child class is present.
+      unboxer = discriminators[hash['accountCategory']]
+      return unboxer.send(:from_hash, hash) if unboxer
+
+      # Extract variables from the hash.
+      account_id = hash.key?('accountId') ? hash['accountId'] : SKIP
+      transaction_id = hash.key?('transactionId') ? hash['transactionId'] : SKIP
+      posted_timestamp = if hash.key?('postedTimestamp')
+                           (DateTimeHelper.from_rfc3339(hash['postedTimestamp']) if hash['postedTimestamp'])
+                         else
+                           SKIP
+                         end
+      transaction_timestamp = if hash.key?('transactionTimestamp')
+                                (DateTimeHelper.from_rfc3339(hash['transactionTimestamp']) if hash['transactionTimestamp'])
+                              else
+                                SKIP
+                              end
+      description = hash.key?('description') ? hash['description'] : SKIP
+      transaction_payee = TransactionPayeeEntity3.from_hash(hash['transactionPayee']) if
+        hash['transactionPayee']
+      debit_credit_memo =
+        hash.key?('debitCreditMemo') ? hash['debitCreditMemo'] : SKIP
+      status = hash.key?('status') ? hash['status'] : SKIP
+      amount = hash.key?('amount') ? hash['amount'] : SKIP
+      reward = TransactionRewardEntity.from_hash(hash['reward']) if hash['reward']
+      # Parameter is an array, so we need to iterate through it
+      rewards = nil
+      unless hash['rewards'].nil?
+        rewards = []
+        hash['rewards'].each do |structure|
+          rewards << (TransactionRewardEntity.from_hash(structure) if structure)
+        end
+      end
+
+      rewards = SKIP unless hash.key?('rewards')
+      # Parameter is an array, so we need to iterate through it
+      fi_attributes = nil
+      unless hash['fiAttributes'].nil?
+        fi_attributes = []
+        hash['fiAttributes'].each do |structure|
+          fi_attributes << (FiAttributeEntity.from_hash(structure) if structure)
+        end
+      end
+
+      fi_attributes = SKIP unless hash.key?('fiAttributes')
+      # Parameter is an array, so we need to iterate through it
+      links = nil
+      unless hash['links'].nil?
+        links = []
+        hash['links'].each do |structure|
+          links << (HateoasLink.from_hash(structure) if structure)
+        end
+      end
+
+      links = SKIP unless hash.key?('links')
+      account_category = hash['accountCategory'] ||= 'Transaction'
+      reference_transaction_id =
+        hash.key?('referenceTransactionId') ? hash['referenceTransactionId'] : SKIP
+      card_number_display =
+        hash.key?('cardNumberDisplay') ? hash['cardNumberDisplay'] : SKIP
+      memo = hash.key?('memo') ? hash['memo'] : SKIP
+      category = hash.key?('category') ? hash['category'] : SKIP
+      sub_category = hash.key?('subCategory') ? hash['subCategory'] : SKIP
+      category_code = hash.key?('categoryCode') ? hash['categoryCode'] : SKIP
+      category_type = hash.key?('categoryType') ? hash['categoryType'] : SKIP
+      reference = hash.key?('reference') ? hash['reference'] : SKIP
+      remittance = Remittance2.from_hash(hash['remittance']) if hash['remittance']
+      foreign_amount = hash.key?('foreignAmount') ? hash['foreignAmount'] : SKIP
+      foreign_currency =
+        hash.key?('foreignCurrency') ? hash['foreignCurrency'] : SKIP
+      image_ids = hash.key?('imageIds') ? hash['imageIds'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      line_item = nil
+      unless hash['lineItem'].nil?
+        line_item = []
+        hash['lineItem'].each do |structure|
+          line_item << (LineItemEntity.from_hash(structure) if structure)
+        end
+      end
+
+      line_item = SKIP unless hash.key?('lineItem')
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Transaction.new(account_id: account_id,
+                      transaction_id: transaction_id,
+                      posted_timestamp: posted_timestamp,
+                      transaction_timestamp: transaction_timestamp,
+                      description: description,
+                      transaction_payee: transaction_payee,
+                      debit_credit_memo: debit_credit_memo,
+                      status: status,
+                      amount: amount,
+                      reward: reward,
+                      rewards: rewards,
+                      fi_attributes: fi_attributes,
+                      links: links,
+                      account_category: account_category,
+                      reference_transaction_id: reference_transaction_id,
+                      card_number_display: card_number_display,
+                      memo: memo,
+                      category: category,
+                      sub_category: sub_category,
+                      category_code: category_code,
+                      category_type: category_type,
+                      reference: reference,
+                      remittance: remittance,
+                      foreign_amount: foreign_amount,
+                      foreign_currency: foreign_currency,
+                      image_ids: image_ids,
+                      line_item: line_item,
+                      additional_properties: additional_properties)
+    end
+
+    def to_custom_posted_timestamp
+      DateTimeHelper.to_rfc3339(posted_timestamp)
+    end
+
+    def to_custom_transaction_timestamp
+      DateTimeHelper.to_rfc3339(transaction_timestamp)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_id: #{@account_id}, transaction_id: #{@transaction_id},"\
+      " posted_timestamp: #{@posted_timestamp}, transaction_timestamp: #{@transaction_timestamp},"\
+      " description: #{@description}, transaction_payee: #{@transaction_payee}, debit_credit_memo:"\
+      " #{@debit_credit_memo}, status: #{@status}, amount: #{@amount}, reward: #{@reward},"\
+      " rewards: #{@rewards}, fi_attributes: #{@fi_attributes}, links: #{@links},"\
+      " account_category: #{@account_category}, reference_transaction_id:"\
+      " #{@reference_transaction_id}, card_number_display: #{@card_number_display}, memo:"\
+      " #{@memo}, category: #{@category}, sub_category: #{@sub_category}, category_code:"\
+      " #{@category_code}, category_type: #{@category_type}, reference: #{@reference}, remittance:"\
+      " #{@remittance}, foreign_amount: #{@foreign_amount}, foreign_currency:"\
+      " #{@foreign_currency}, image_ids: #{@image_ids}, line_item: #{@line_item},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_id: #{@account_id.inspect}, transaction_id:"\
+      " #{@transaction_id.inspect}, posted_timestamp: #{@posted_timestamp.inspect},"\
+      " transaction_timestamp: #{@transaction_timestamp.inspect}, description:"\
+      " #{@description.inspect}, transaction_payee: #{@transaction_payee.inspect},"\
+      " debit_credit_memo: #{@debit_credit_memo.inspect}, status: #{@status.inspect}, amount:"\
+      " #{@amount.inspect}, reward: #{@reward.inspect}, rewards: #{@rewards.inspect},"\
+      " fi_attributes: #{@fi_attributes.inspect}, links: #{@links.inspect}, account_category:"\
+      " #{@account_category.inspect}, reference_transaction_id:"\
+      " #{@reference_transaction_id.inspect}, card_number_display:"\
+      " #{@card_number_display.inspect}, memo: #{@memo.inspect}, category: #{@category.inspect},"\
+      " sub_category: #{@sub_category.inspect}, category_code: #{@category_code.inspect},"\
+      " category_type: #{@category_type.inspect}, reference: #{@reference.inspect}, remittance:"\
+      " #{@remittance.inspect}, foreign_amount: #{@foreign_amount.inspect}, foreign_currency:"\
+      " #{@foreign_currency.inspect}, image_ids: #{@image_ids.inspect}, line_item:"\
+      " #{@line_item.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/fdx_v660_api/models/transaction_limit.rb

@@ -0,0 +1,97 @@
+# fdx_v660_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module FdxV660Api
+  # The various size limits on account transaction amounts
+  class TransactionLimit < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The maximum amount which is permitted for a single transaction of this
+    # type
+    # @return [Float]
+    attr_accessor :maximum_amount
+
+    # The type of transaction restricted by this limit, such as ATMWITHDRAWAL,
+    # BILLPAYMENT, CASHIERSCHECK, PERSONTOPERSON
+    # @return [DepositTransactionType1]
+    attr_accessor :type
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['maximum_amount'] = 'maximumAmount'
+      @_hash['type'] = 'type'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        maximum_amount
+        type
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(maximum_amount: SKIP, type: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @maximum_amount = maximum_amount unless maximum_amount == SKIP
+      @type = type unless type == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      maximum_amount = hash.key?('maximumAmount') ? hash['maximumAmount'] : SKIP
+      type = hash.key?('type') ? hash['type'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      TransactionLimit.new(maximum_amount: maximum_amount,
+                           type: type,
+                           additional_properties: additional_properties)
+    end
+
+    # Validates an instance of the object from a given value.
+    # @param [TransactionLimit | Hash] The value against the validation is performed.
+    def self.validate(value)
+      return true if value.instance_of? self
+
+      return false unless value.instance_of? Hash
+
+      true
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} maximum_amount: #{@maximum_amount}, type: #{@type}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} maximum_amount: #{@maximum_amount.inspect}, type: #{@type.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/fdx_v660_api/models/transaction_payee_entity.rb

@@ -0,0 +1,120 @@
+# fdx_v660_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module FdxV660Api
+  # Primary demographic information for payee on a transaction; name, location,
+  # contact phone
+  class TransactionPayeeEntity < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Name when payee is a merchant, typically a business from which goods or
+    # services are rendered
+    # @return [BusinessName5]
+    attr_accessor :merchant_name
+
+    # Merchant identifier (MID) for card processing
+    # @return [String]
+    attr_accessor :merchant_id
+
+    # Name when payee is an individual
+    # @return [IndividualName7]
+    attr_accessor :individual_name
+
+    # Address of the payee who received the payment
+    # @return [DeliveryAddress1]
+    attr_accessor :address
+
+    # Phone number of the payee who received the payment
+    # @return [TelephoneNumber3]
+    attr_accessor :phone
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['merchant_name'] = 'merchantName'
+      @_hash['merchant_id'] = 'merchantId'
+      @_hash['individual_name'] = 'individualName'
+      @_hash['address'] = 'address'
+      @_hash['phone'] = 'phone'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        merchant_name
+        merchant_id
+        individual_name
+        address
+        phone
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(merchant_name: SKIP, merchant_id: SKIP,
+                   individual_name: SKIP, address: SKIP, phone: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @merchant_name = merchant_name unless merchant_name == SKIP
+      @merchant_id = merchant_id unless merchant_id == SKIP
+      @individual_name = individual_name unless individual_name == SKIP
+      @address = address unless address == SKIP
+      @phone = phone unless phone == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      merchant_name = BusinessName5.from_hash(hash['merchantName']) if hash['merchantName']
+      merchant_id = hash.key?('merchantId') ? hash['merchantId'] : SKIP
+      individual_name = IndividualName7.from_hash(hash['individualName']) if
+        hash['individualName']
+      address = DeliveryAddress1.from_hash(hash['address']) if hash['address']
+      phone = TelephoneNumber3.from_hash(hash['phone']) if hash['phone']
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      TransactionPayeeEntity.new(merchant_name: merchant_name,
+                                 merchant_id: merchant_id,
+                                 individual_name: individual_name,
+                                 address: address,
+                                 phone: phone,
+                                 additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} merchant_name: #{@merchant_name}, merchant_id: #{@merchant_id},"\
+      " individual_name: #{@individual_name}, address: #{@address}, phone: #{@phone},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} merchant_name: #{@merchant_name.inspect}, merchant_id:"\
+      " #{@merchant_id.inspect}, individual_name: #{@individual_name.inspect}, address:"\
+      " #{@address.inspect}, phone: #{@phone.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end