visa-acceptance-api-sdk 1.0.0

data/lib/visa_acceptance_merged_spec/models/card1.rb

@@ -0,0 +1,316 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # Card1 Model.
+  class Card1 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Last four digits of the cardholder’s account number. This field is
+    # included in the reply message when the client software
+    # that is installed on the POS terminal uses the token management service
+    # (TMS) to retrieve tokenized payment details.
+    # You must contact customer support to have your account enabled to receive
+    # these fields in the credit reply message.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # #### PIN debit
+    # This field is returned only for tokenized transactions. You can use this
+    # value on the receipt that you give to the cardholder.
+    # Returned by PIN debit credit and PIN debit purchase.
+    # This field is supported only by the following processors:
+    # - American Express Direct
+    # - Credit Mutuel-CIC
+    # - FDC Nashville Global
+    # - OmniPay Direct
+    # - SIX
+    # @return [String]
+    attr_accessor :suffix
+
+    # Two-digit month in which the payment card expires.
+    # Format: `MM`.
+    # Valid values: `01` through `12`. Leading 0 is required.
+    # #### Barclays and Streamline
+    # For Maestro (UK Domestic) and Maestro (International) cards on Barclays
+    # and Streamline, this must be a valid value
+    # (`01` through `12`) but is not required to be a valid expiration date. In
+    # other words, an expiration date that is
+    # in the past does not cause Visa Acceptance to reject your request.
+    # However, an invalid expiration date might cause
+    # the issuer to reject your request.
+    # #### Encoded Account Numbers
+    # For encoded account numbers (_type_=039), if there is no expiration date
+    # on the card, use `12`.
+    # #### FDMS Nashville
+    # Required field.
+    # #### All other processors
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # @return [String]
+    attr_accessor :expiration_month
+
+    # Four-digit year in which the payment card expires.
+    # Format: `YYYY`.
+    # #### Barclays and Streamline
+    # For Maestro (UK Domestic) and Maestro (International) cards on Barclays
+    # and Streamline, this must be a valid value (`1900` through `3000`) but is
+    # not required to be a valid expiration date. In other words, an expiration
+    # date that is in the past does not cause Visa Acceptance to reject your
+    # request. However, an invalid expiration date might cause the issuer to
+    # reject your request.
+    # #### Encoded Account Numbers
+    # For encoded account numbers (**_type_**`=039`), if there is no expiration
+    # date on the card, use `2021`.
+    # #### FDMS Nashville
+    # Required field.
+    # #### FDC Nashville Global and FDMS South
+    # You can send in 2 digits or 4 digits. If you send in 2 digits, they must
+    # be the last 2 digits of the year.
+    # #### All other processors
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # @return [String]
+    attr_accessor :expiration_year
+
+    # Three-digit value that indicates the card type.
+    # **IMPORTANT** It is strongly recommended that you include the card type
+    # field in request messages even if it is
+    # optional for your processor and card type. Omitting the card type can
+    # cause the transaction to be processed with the wrong card type.
+    # Possible values:
+    # - `001`: Visa. Use card type value `001` for Visa Electron.
+    # - `002`: Mastercard, Eurocard[^1], which is a European regional brand of
+    # Mastercard.
+    # - `003`: American Express
+    # - `004`: Discover
+    # - `005`: Diners Club
+    # - `006`: Carte Blanche[^1]
+    # - `007`: JCB[^1]
+    # - `008`: Optima
+    # - `009`: GE Private Label
+    # - `010`: Beneficial Private Label
+    # - `011`: Twinpay Credit Card
+    # - `012`: Twinpay Debit Card
+    # - `013`: WalMart
+    # - `014`: Enroute[^1]
+    # - `015`: Lowe's Consumer
+    # - `016`: Home Depot Consumer
+    # - `017`: MBNA
+    # - `018`: Dick's Sportswear
+    # - `019`: Casual Corner
+    # - `020`: Sears
+    # - `021`: JAL[^1]
+    # - `023`: Disney Card
+    # - `024`: Maestro (UK Domestic)[^1]
+    # - `025`: Sam's Club Consumer
+    # - `026`: Sam's Club Business
+    # - `027`: Nico's
+    # - `028`: Paymentech Bill Me Later
+    # - `029`: Bebe
+    # - `030`: Restoration Hardware
+    # - `031`: Delta Online
+    # - `032`: Solo
+    # - `033`: Visa Electron[^1]. Do not use this value. Use `001` for all Visa
+    # card types.
+    # - `034`: Dankort[^1]
+    # - `035`: Laser
+    # - `036`: Cartes Bancaires[^1,4]
+    # - `037`: Carta Si[^1]
+    # - `038`: Pinless Debit
+    # - `039`: Encoded account number[^1]
+    # - `040`: UATP[^1]
+    # - `041`: HOUSEHOLD
+    # - `042`: Maestro (International)[^1]
+    # - `043`: GE MONEY
+    # - `044`: Korean Cards
+    # - `045`: Style Cards
+    # - `046`: JCrew
+    # - `047`: Payeasecn eWallet
+    # - `048`: Payeasecn Bank Transfer
+    # - `049`: Meijer
+    # - `050`: Hipercard[^2,3]
+    # - `051`: Aura
+    # - `052`: Redecard
+    # - `053`: Orico card
+    # - `054`: Elo[^3]
+    # - `055`: Capitol One Private Label
+    # - `056`: Carnet
+    # - `057`: Costco Private Label
+    # - `058`: Carnet
+    # - `059`: ValueLink
+    # - `060`: MADA
+    # - `061`: RuPay
+    # - `062`: China UnionPay
+    # - `063`: Falabella Private Label
+    # - `064`: Prompt Card
+    # - `065`: Korean Domestic
+    # - `066`: Banricompras
+    # - `067`: MEEZA
+    # - `068`: PayPak
+    # - `070`: EFTPOS
+    # - `071`: Codensa
+    # - `072`: Olimpica
+    # - `073`: Colsubsidio
+    # - `074`: Tuya
+    # - `075`: Sodexo
+    # - `076`: Naranja
+    # - `077`: Cabal
+    # - `078`: DINELCO
+    # - `079`: PANAL
+    # - `080`: EPM
+    # - `081`: Jaywan
+    # [^1]: For this card type, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in your request for an authorization or a stand-alone credit.
+    # [^2]: For this card type on Cielo 3.0, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in a request for an authorization or a stand-alone credit. This card
+    # type is not supported on Cielo 1.5.
+    # [^3]: For this card type on Getnet and Rede, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in a request for an authorization or a stand-alone credit.
+    # [^4]: For this card type, you must include the
+    # `paymentInformation.card.type` in your request for any payer
+    # authentication services.
+    # #### Used by
+    # **Authorization**
+    # Required for Carte Blanche and JCB.
+    # Optional for all other card types.
+    # #### Card Present reply
+    # This field is included in the reply message when the client software that
+    # is installed on the POS terminal uses
+    # the token management service (TMS) to retrieve tokenized payment details.
+    # You must contact customer support to
+    # have your account enabled to receive these fields in the credit reply
+    # message.
+    # Returned by the Credit service.
+    # This reply field is only supported by the following processors:
+    # - American Express Direct
+    # - Credit Mutuel-CIC
+    # - FDC Nashville Global
+    # - OmniPay Direct
+    # - SIX
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # #### GPX
+    # This field only supports transactions from the following card types:
+    # - Visa
+    # - Mastercard
+    # - AMEX
+    # - Discover
+    # - Diners
+    # - JCB
+    # - Union Pay International
+    # @return [String]
+    attr_accessor :type
+
+    # Bank Identification Number (BIN). This is the initial four to six numbers
+    # on a credit card account number.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # @return [String]
+    attr_accessor :prefix
+
+    # #### Visa Platform Connect
+    # This API field will contain the SHA 256 hashed value of PAN.
+    # @return [String]
+    attr_accessor :hashed_number
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['suffix'] = 'suffix'
+      @_hash['expiration_month'] = 'expirationMonth'
+      @_hash['expiration_year'] = 'expirationYear'
+      @_hash['type'] = 'type'
+      @_hash['prefix'] = 'prefix'
+      @_hash['hashed_number'] = 'hashedNumber'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        suffix
+        expiration_month
+        expiration_year
+        type
+        prefix
+        hashed_number
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(suffix = SKIP, expiration_month = SKIP,
+                   expiration_year = SKIP, type = SKIP, prefix = SKIP,
+                   hashed_number = SKIP)
+      @suffix = suffix unless suffix == SKIP
+      @expiration_month = expiration_month unless expiration_month == SKIP
+      @expiration_year = expiration_year unless expiration_year == SKIP
+      @type = type unless type == SKIP
+      @prefix = prefix unless prefix == SKIP
+      @hashed_number = hashed_number unless hashed_number == 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.
+      suffix = hash.key?('suffix') ? hash['suffix'] : SKIP
+      expiration_month =
+        hash.key?('expirationMonth') ? hash['expirationMonth'] : SKIP
+      expiration_year =
+        hash.key?('expirationYear') ? hash['expirationYear'] : SKIP
+      type = hash.key?('type') ? hash['type'] : SKIP
+      prefix = hash.key?('prefix') ? hash['prefix'] : SKIP
+      hashed_number = hash.key?('hashedNumber') ? hash['hashedNumber'] : SKIP
+
+      # Create object from extracted values.
+      Card1.new(suffix,
+                expiration_month,
+                expiration_year,
+                type,
+                prefix,
+                hashed_number)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} suffix: #{@suffix}, expiration_month: #{@expiration_month},"\
+      " expiration_year: #{@expiration_year}, type: #{@type}, prefix: #{@prefix}, hashed_number:"\
+      " #{@hashed_number}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} suffix: #{@suffix.inspect}, expiration_month: #{@expiration_month.inspect},"\
+      " expiration_year: #{@expiration_year.inspect}, type: #{@type.inspect}, prefix:"\
+      " #{@prefix.inspect}, hashed_number: #{@hashed_number.inspect}>"
+    end
+  end
+end

data/lib/visa_acceptance_merged_spec/models/card10.rb

@@ -0,0 +1,354 @@
+# visa_acceptance_merged_spec
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module VisaAcceptanceMergedSpec
+  # Card10 Model.
+  class Card10 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The customer’s payment card number, also known as the Primary Account
+    # Number (PAN). You can also use this field
+    # for encoded account numbers.
+    # #### FDMS Nashville
+    # Required. String (19)
+    # #### GPX
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # #### All other processors
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # @return [String]
+    attr_accessor :number
+
+    # Two-digit month in which the payment card expires.
+    # Format: `MM`.
+    # Valid values: `01` through `12`. Leading 0 is required.
+    # #### Barclays and Streamline
+    # For Maestro (UK Domestic) and Maestro (International) cards on Barclays
+    # and Streamline, this must be a valid value
+    # (`01` through `12`) but is not required to be a valid expiration date. In
+    # other words, an expiration date that is
+    # in the past does not cause Visa Acceptance to reject your request.
+    # However, an invalid expiration date might cause
+    # the issuer to reject your request.
+    # #### Encoded Account Numbers
+    # For encoded account numbers (_type_=039), if there is no expiration date
+    # on the card, use `12`.
+    # #### FDMS Nashville
+    # Required field.
+    # #### All other processors
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # @return [String]
+    attr_accessor :expiration_month
+
+    # Four-digit year in which the payment card expires.
+    # Format: `YYYY`.
+    # #### Barclays and Streamline
+    # For Maestro (UK Domestic) and Maestro (International) cards on Barclays
+    # and Streamline, this must be a valid value (`1900` through `3000`) but is
+    # not required to be a valid expiration date. In other words, an expiration
+    # date that is in the past does not cause Visa Acceptance to reject your
+    # request. However, an invalid expiration date might cause the issuer to
+    # reject your request.
+    # #### Encoded Account Numbers
+    # For encoded account numbers (**_type_**`=039`), if there is no expiration
+    # date on the card, use `2021`.
+    # #### FDMS Nashville
+    # Required field.
+    # #### FDC Nashville Global and FDMS South
+    # You can send in 2 digits or 4 digits. If you send in 2 digits, they must
+    # be the last 2 digits of the year.
+    # #### All other processors
+    # Required if `pointOfSaleInformation.entryMode=keyed`. However, this field
+    # is optional if your account is configured
+    # for relaxed requirements for address data and expiration date.
+    # **Important** It is your responsibility to determine
+    # whether a field is required for the transaction you are requesting.
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # @return [String]
+    attr_accessor :expiration_year
+
+    # Three-digit value that indicates the card type.
+    # **IMPORTANT** It is strongly recommended that you include the card type
+    # field in request messages even if it is
+    # optional for your processor and card type. Omitting the card type can
+    # cause the transaction to be processed with the wrong card type.
+    # Possible values:
+    # - `001`: Visa. Use card type value `001` for Visa Electron.
+    # - `002`: Mastercard, Eurocard[^1], which is a European regional brand of
+    # Mastercard.
+    # - `003`: American Express
+    # - `004`: Discover
+    # - `005`: Diners Club
+    # - `006`: Carte Blanche[^1]
+    # - `007`: JCB[^1]
+    # - `008`: Optima
+    # - `009`: GE Private Label
+    # - `010`: Beneficial Private Label
+    # - `011`: Twinpay Credit Card
+    # - `012`: Twinpay Debit Card
+    # - `013`: WalMart
+    # - `014`: Enroute[^1]
+    # - `015`: Lowe's Consumer
+    # - `016`: Home Depot Consumer
+    # - `017`: MBNA
+    # - `018`: Dick's Sportswear
+    # - `019`: Casual Corner
+    # - `020`: Sears
+    # - `021`: JAL[^1]
+    # - `023`: Disney Card
+    # - `024`: Maestro (UK Domestic)[^1]
+    # - `025`: Sam's Club Consumer
+    # - `026`: Sam's Club Business
+    # - `027`: Nico's
+    # - `028`: Paymentech Bill Me Later
+    # - `029`: Bebe
+    # - `030`: Restoration Hardware
+    # - `031`: Delta Online
+    # - `032`: Solo
+    # - `033`: Visa Electron[^1]. Do not use this value. Use `001` for all Visa
+    # card types.
+    # - `034`: Dankort[^1]
+    # - `035`: Laser
+    # - `036`: Cartes Bancaires[^1,4]
+    # - `037`: Carta Si[^1]
+    # - `038`: Pinless Debit
+    # - `039`: Encoded account number[^1]
+    # - `040`: UATP[^1]
+    # - `041`: HOUSEHOLD
+    # - `042`: Maestro (International)[^1]
+    # - `043`: GE MONEY
+    # - `044`: Korean Cards
+    # - `045`: Style Cards
+    # - `046`: JCrew
+    # - `047`: Payeasecn eWallet
+    # - `048`: Payeasecn Bank Transfer
+    # - `049`: Meijer
+    # - `050`: Hipercard[^2,3]
+    # - `051`: Aura
+    # - `052`: Redecard
+    # - `053`: Orico card
+    # - `054`: Elo[^3]
+    # - `055`: Capitol One Private Label
+    # - `056`: Carnet
+    # - `057`: Costco Private Label
+    # - `058`: Carnet
+    # - `059`: ValueLink
+    # - `060`: MADA
+    # - `061`: RuPay
+    # - `062`: China UnionPay
+    # - `063`: Falabella Private Label
+    # - `064`: Prompt Card
+    # - `065`: Korean Domestic
+    # - `066`: Banricompras
+    # - `067`: MEEZA
+    # - `068`: PayPak
+    # - `070`: EFTPOS
+    # - `071`: Codensa
+    # - `072`: Olimpica
+    # - `073`: Colsubsidio
+    # - `074`: Tuya
+    # - `075`: Sodexo
+    # - `076`: Naranja
+    # - `077`: Cabal
+    # - `078`: DINELCO
+    # - `079`: PANAL
+    # - `080`: EPM
+    # - `081`: Jaywan
+    # [^1]: For this card type, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in your request for an authorization or a stand-alone credit.
+    # [^2]: For this card type on Cielo 3.0, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in a request for an authorization or a stand-alone credit. This card
+    # type is not supported on Cielo 1.5.
+    # [^3]: For this card type on Getnet and Rede, you must include the
+    # `paymentInformation.card.type` or `paymentInformation.tokenizedCard.type`
+    # field in a request for an authorization or a stand-alone credit.
+    # [^4]: For this card type, you must include the
+    # `paymentInformation.card.type` in your request for any payer
+    # authentication services.
+    # #### Used by
+    # **Authorization**
+    # Required for Carte Blanche and JCB.
+    # Optional for all other card types.
+    # #### Card Present reply
+    # This field is included in the reply message when the client software that
+    # is installed on the POS terminal uses
+    # the token management service (TMS) to retrieve tokenized payment details.
+    # You must contact customer support to
+    # have your account enabled to receive these fields in the credit reply
+    # message.
+    # Returned by the Credit service.
+    # This reply field is only supported by the following processors:
+    # - American Express Direct
+    # - Credit Mutuel-CIC
+    # - FDC Nashville Global
+    # - OmniPay Direct
+    # - SIX
+    # #### Google Pay transactions
+    # For PAN-based Google Pay transactions, this field is returned in the API
+    # response.
+    # #### GPX
+    # This field only supports transactions from the following card types:
+    # - Visa
+    # - Mastercard
+    # - AMEX
+    # - Discover
+    # - Diners
+    # - JCB
+    # - Union Pay International
+    # @return [String]
+    attr_accessor :type
+
+    # Card Verification Number.
+    # #### FDMS Nashville
+    # Required for American Express or if swiped; otherwise, optional.
+    # #### Ingenico ePayments
+    # Do not include this field when `commerceIndicator=recurring`.
+    # **Note** Ingenico ePayments was previously called _Global Collect_.
+    # #### TSYS Acquiring Solutions
+    # Optional if pointOfSaleInformation.entryMode=keyed; otherwise, not used.
+    # #### GPX
+    # Optional.
+    # #### All other processors:
+    # Optional.
+    # @return [String]
+    attr_accessor :security_code
+
+    # Flag that specifies the type of account associated with the card.  This
+    # field is available only for China UnionPay, Cielo, Comercio Latino and
+    # Visa Platform Connect.
+    # The cardholder provides this information during the payment process.  This
+    # field is required for:
+    #  - Debit transactions on Cielo and Comercio Latino.
+    #  - Transactions with Brazilian-issued cards on Visa Acceptance through
+    # VisaNet.
+    # **China UnionPayCard Transactions on China UnionPay:**
+    # Possible values:
+    #  - C: Domestic credit card
+    #  - D: Domestic debit card
+    #  - F: International credit card
+    #  - I: International debit card
+    # When the value is D, the e-commerce indicator and CAVV fields must be
+    # included in the authorization request.
+    # When the value is C, F or I the card verification number, expiration month
+    # and expiration year fields must in included in the authorization request.
+    # **Cielo and Comercio Latino Credit Card Transactions:**
+    # On these processors, this field is supported only for authorizations.
+    # Possible values:
+    #  - CR: Credit card
+    #  - DB: Debit card     
+    # **Visa Platform Connect Credit Card Transactions:**
+    # This field is supported for all card types on Visa Platform Connect.
+    # For combo **card present** transactions with Mastercard on
+    # Brazilian-issued cards, possible values:
+    #  - CR: Credit card
+    #  - DB: Debit Card
+    # For combo **card not present** transactions with Mastercard on
+    # Brazilian-issued cards, possible values:
+    #  - C: Credit card
+    #  - D: Debit card
+    # A value of CR or DB in the useAs field takes precedence over any value in
+    # the Source Account Type field.
+    # @return [String]
+    attr_accessor :use_as
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['number'] = 'number'
+      @_hash['expiration_month'] = 'expirationMonth'
+      @_hash['expiration_year'] = 'expirationYear'
+      @_hash['type'] = 'type'
+      @_hash['security_code'] = 'securityCode'
+      @_hash['use_as'] = 'useAs'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        number
+        expiration_month
+        expiration_year
+        type
+        security_code
+        use_as
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(number = SKIP, expiration_month = SKIP,
+                   expiration_year = SKIP, type = SKIP, security_code = SKIP,
+                   use_as = SKIP)
+      @number = number unless number == SKIP
+      @expiration_month = expiration_month unless expiration_month == SKIP
+      @expiration_year = expiration_year unless expiration_year == SKIP
+      @type = type unless type == SKIP
+      @security_code = security_code unless security_code == SKIP
+      @use_as = use_as unless use_as == 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.
+      number = hash.key?('number') ? hash['number'] : SKIP
+      expiration_month =
+        hash.key?('expirationMonth') ? hash['expirationMonth'] : SKIP
+      expiration_year =
+        hash.key?('expirationYear') ? hash['expirationYear'] : SKIP
+      type = hash.key?('type') ? hash['type'] : SKIP
+      security_code = hash.key?('securityCode') ? hash['securityCode'] : SKIP
+      use_as = hash.key?('useAs') ? hash['useAs'] : SKIP
+
+      # Create object from extracted values.
+      Card10.new(number,
+                 expiration_month,
+                 expiration_year,
+                 type,
+                 security_code,
+                 use_as)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} number: #{@number}, expiration_month: #{@expiration_month},"\
+      " expiration_year: #{@expiration_year}, type: #{@type}, security_code: #{@security_code},"\
+      " use_as: #{@use_as}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} number: #{@number.inspect}, expiration_month: #{@expiration_month.inspect},"\
+      " expiration_year: #{@expiration_year.inspect}, type: #{@type.inspect}, security_code:"\
+      " #{@security_code.inspect}, use_as: #{@use_as.inspect}>"
+    end
+  end
+end