Class: VisaAcceptanceMergedSpec::Card10

Inherits:

BaseModel

Object
CoreLibrary::BaseModel
BaseModel
VisaAcceptanceMergedSpec::Card10

show all

Defined in:: lib/visa_acceptance_merged_spec/models/card10.rb

Overview

Card10 Model.

Instance Attribute Summary collapse

#expiration_month ⇒ String
Two-digit month in which the payment card expires.
#expiration_year ⇒ String
Four-digit year in which the payment card expires.
#number ⇒ String
The customer’s payment card number, also known as the Primary Account Number (PAN).
#security_code ⇒ String
Card Verification Number.
#type ⇒ String
Three-digit value that indicates the card type.
#use_as ⇒ String
Flag that specifies the type of account associated with the card.

Class Method Summary collapse

.from_hash(hash) ⇒ Object
Creates an instance of the object from a hash.
.names ⇒ Object
A mapping from model property names to API property names.
.nullables ⇒ Object
An array for nullable fields.
.optionals ⇒ Object
An array for optional fields.

Instance Method Summary collapse

#initialize(number: SKIP, expiration_month: SKIP, expiration_year: SKIP, type: SKIP, security_code: SKIP, use_as: SKIP, additional_properties: nil) ⇒ Card10 constructor
A new instance of Card10.
#inspect ⇒ Object
Provides a debugging-friendly string with detailed object information.
#to_s ⇒ Object
Provides a human-readable string representation of the object.

Methods inherited from BaseModel

#check_for_conflict, #process_additional_properties, #process_array, #process_basic_value, #process_hash, #to_hash, #to_json

Constructor Details

#initialize(number: SKIP, expiration_month: SKIP, expiration_year: SKIP, type: SKIP, security_code: SKIP, use_as: SKIP, additional_properties: nil) ⇒ `Card10`

Returns a new instance of Card10.

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 304

def initialize(number: SKIP, expiration_month: SKIP, expiration_year: SKIP,
               type: SKIP, security_code: SKIP, use_as: SKIP,
               additional_properties: nil)
  # Add additional model properties to the instance
  additional_properties = {} if additional_properties.nil?

  @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
  @additional_properties = additional_properties
end

Instance Attribute Details

#expiration_month ⇒ `String`

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.

Returns:

(String)



58
59
60

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 58

def expiration_month
  @expiration_month
end

#expiration_year ⇒ `String`

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

Google Pay transactions

For PAN-based Google Pay transactions, this field is returned in the API response.

Returns:

(String)



87
88
89

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 87

def expiration_year
  @expiration_year
end

#number ⇒ `String`

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

All other processors

Returns:

(String)



30
31
32

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 30

def number
  @number
end

#security_code ⇒ `String`

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.

Returns:

(String)



235
236
237

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 235

def security_code
  @security_code
end

#type ⇒ `String`

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, which is a European regional brand of Mastercard.
003: American Express
004: Discover
005: Diners Club
006: Carte Blanche
007: JCB
008: Optima
009: GE Private Label
010: Beneficial Private Label
011: Twinpay Credit Card
012: Twinpay Debit Card
013: WalMart
014: Enroute
015: Lowe's Consumer
016: Home Depot Consumer
017: MBNA
018: Dick's Sportswear
019: Casual Corner
020: Sears
021: JAL
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. Do not use this value. Use 001 for all Visa card types.
034: Dankort
035: Laser
036: Cartes Bancaires
037: Carta Si
038: Pinless Debit
039: Encoded account number
040: UATP
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
051: Aura
052: Redecard
053: Orico card
054: Elo
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

Returns:

(String)



220
221
222

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 220

def type
  @type
end

#use_as ⇒ `String`

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.

Returns:

(String)



273
274
275

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 273

def use_as
  @use_as
end

Class Method Details

.from_hash(hash) ⇒ `Object`

Creates an instance of the object from a hash.

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 320

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 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.
  Card10.new(number: number,
             expiration_month: expiration_month,
             expiration_year: expiration_year,
             type: type,
             security_code: security_code,
             use_as: use_as,
             additional_properties: additional_properties)
end

.names ⇒ `Object`

A mapping from model property names to API property names.

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 276

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

.nullables ⇒ `Object`

An array for nullable fields



300
301
302

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 300

def self.nullables
  []
end

.optionals ⇒ `Object`

An array for optional fields

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 288

def self.optionals
  %w[
    number
    expiration_month
    expiration_year
    type
    security_code
    use_as
  ]
end

Instance Method Details

#inspect ⇒ `Object`

Provides a debugging-friendly string with detailed object information.

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 359

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}, additional_properties:"\
  " #{@additional_properties}>"
end

#to_s ⇒ `Object`

Provides a human-readable string representation of the object.

# File 'lib/visa_acceptance_merged_spec/models/card10.rb', line 351

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}, additional_properties: #{@additional_properties}>"
end

Class: VisaAcceptanceMergedSpec::Card10

Overview

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from BaseModel

Constructor Details

#initialize(number: SKIP, expiration_month: SKIP, expiration_year: SKIP, type: SKIP, security_code: SKIP, use_as: SKIP, additional_properties: nil) ⇒ Card10

Instance Attribute Details

#expiration_month ⇒ String

Barclays and Streamline

Encoded Account Numbers

FDMS Nashville

All other processors

Google Pay transactions

#expiration_year ⇒ String

Barclays and Streamline

Encoded Account Numbers

FDMS Nashville

FDC Nashville Global and FDMS South

All other processors

Google Pay transactions

#number ⇒ String

FDMS Nashville

GPX

All other processors

#security_code ⇒ String

FDMS Nashville

Ingenico ePayments

TSYS Acquiring Solutions

GPX

All other processors:

#type ⇒ String

Used by

Card Present reply

Google Pay transactions

GPX

#use_as ⇒ String

Class Method Details

.from_hash(hash) ⇒ Object

.names ⇒ Object

.nullables ⇒ Object

.optionals ⇒ Object

Instance Method Details

#inspect ⇒ Object

#to_s ⇒ Object

#initialize(number: SKIP, expiration_month: SKIP, expiration_year: SKIP, type: SKIP, security_code: SKIP, use_as: SKIP, additional_properties: nil) ⇒ `Card10`

#expiration_month ⇒ `String`

#expiration_year ⇒ `String`

#number ⇒ `String`

#security_code ⇒ `String`

#type ⇒ `String`

#use_as ⇒ `String`

.from_hash(hash) ⇒ `Object`

.names ⇒ `Object`

.nullables ⇒ `Object`

.optionals ⇒ `Object`

#inspect ⇒ `Object`

#to_s ⇒ `Object`