Class: VisaAcceptanceMergedSpec::ClientReferenceInformation

Inherits:
BaseModel
  • Object
show all
Defined in:
lib/visa_acceptance_merged_spec/models/client_reference_information.rb

Overview

ClientReferenceInformation Model.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from BaseModel

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

Constructor Details

#initialize(code: SKIP, reconciliation_id: SKIP, paused_request_id: SKIP, transaction_id: SKIP, comments: SKIP, partner: SKIP, application_name: SKIP, application_version: SKIP, application_user: SKIP, additional_properties: nil) ⇒ ClientReferenceInformation

Returns a new instance of ClientReferenceInformation.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 125

def initialize(code: SKIP, reconciliation_id: SKIP, paused_request_id: SKIP,
               transaction_id: SKIP, comments: SKIP, partner: SKIP,
               application_name: SKIP, application_version: SKIP,
               application_user: SKIP, additional_properties: nil)
  # Add additional model properties to the instance
  additional_properties = {} if additional_properties.nil?

  @code = code unless code == SKIP
  @reconciliation_id = reconciliation_id unless reconciliation_id == SKIP
  @paused_request_id = paused_request_id unless paused_request_id == SKIP
  @transaction_id = transaction_id unless transaction_id == SKIP
  @comments = comments unless comments == SKIP
  @partner = partner unless partner == SKIP
  @application_name = application_name unless application_name == SKIP
  @application_version = application_version unless application_version == SKIP
  @application_user = application_user unless application_user == SKIP
  @additional_properties = additional_properties
end

Instance Attribute Details

#application_name ⇒ String

The name of the Connection Method client (such as Virtual Terminal or SOAP Toolkit API) that the merchant uses to send a transaction request to Visa Acceptance.

Returns:

  • (String) 


77
78
79
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 77

def application_name
  @application_name
end

#application_user ⇒ String

The entity that is responsible for running the transaction and submitting the processing request to Visa Acceptance. This could be a person, a system, or a connection method.

Returns:

  • (String) 


88
89
90
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 88

def application_user
  @application_user
end

#application_version ⇒ String

Version of the Visa Acceptance application or integration used for a transaction.

Returns:

  • (String) 


82
83
84
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 82

def application_version
  @application_version
end

#code ⇒ String

Merchant-generated order reference or tracking number. It is recommended that you send a unique value for each transaction so that you can perform meaningful searches for the transaction.

Used by

Authorization Required field.

PIN Debit

Requests for PIN debit reversals need to use the same merchant reference number that was used in the transaction that is being reversed. Required field for all PIN Debit requests (purchase, credit, and reversal).

FDC Nashville Global

Certain circumstances can cause the processor to truncate this value to 15 or 17 characters for Level II and Level III processing, which can cause a discrepancy between the value you submit and the value included in some processor reports.

Returns:

  • (String) 


31
32
33
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 31

def code
  @code
end

#comments ⇒ String

Brief description of the order or any comment you wish to add to the order.

Returns:

  • (String) 


66
67
68
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 66

def comments
  @comments
end

#partner ⇒ Partner

Brief description of the order or any comment you wish to add to the order.

Returns:



71
72
73
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 71

def partner
  @partner
end

#paused_request_id ⇒ String

Used to resume a transaction that was paused for an order modification rule to allow for payer authentication to complete. To resume and continue with the authorization/decision service flow, call the services and include the request id from the prior decision call.

Returns:

  • (String) 


47
48
49
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 47

def paused_request_id
  @paused_request_id
end

#reconciliation_id ⇒ String

Reference number for the transaction. Depending on how your Visa Acceptance account is configured, this value could either be provided in the API request or generated by Visa Acceptance. The actual value used in the request to the processor is provided back to you by Visa Acceptance in the response.

Returns:

  • (String) 


40
41
42
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 40

def reconciliation_id
  @reconciliation_id
end

#transaction_id ⇒ String

Identifier that you assign to the transaction. Normally generated by a client server to identify a unique API request. Note Use this field only if you want to support merchant-initiated reversal and void operations.

Used by

Authorization, Authorization Reversal, Capture, Credit, and Void Optional field.

PIN Debit

For a PIN debit reversal, your request must include a request ID or a merchant transaction identifier. Optional field for PIN debit purchase or credit requests.

Returns:

  • (String) 


61
62
63
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 61

def transaction_id
  @transaction_id
end

Class Method Details

.from_hash(hash) ⇒ Object

Creates an instance of the object from a hash.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 145

def self.from_hash(hash)
  return nil unless hash

  # Extract variables from the hash.
  code = hash.key?('code') ? hash['code'] : SKIP
  reconciliation_id =
    hash.key?('reconciliationId') ? hash['reconciliationId'] : SKIP
  paused_request_id =
    hash.key?('pausedRequestId') ? hash['pausedRequestId'] : SKIP
  transaction_id = hash.key?('transactionId') ? hash['transactionId'] : SKIP
  comments = hash.key?('comments') ? hash['comments'] : SKIP
  partner = Partner.from_hash(hash['partner']) if hash['partner']
  application_name =
    hash.key?('applicationName') ? hash['applicationName'] : SKIP
  application_version =
    hash.key?('applicationVersion') ? hash['applicationVersion'] : SKIP
  application_user =
    hash.key?('applicationUser') ? hash['applicationUser'] : 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.
  ClientReferenceInformation.new(code: code,
                                 reconciliation_id: reconciliation_id,
                                 paused_request_id: paused_request_id,
                                 transaction_id: transaction_id,
                                 comments: comments,
                                 partner: partner,
                                 application_name: application_name,
                                 application_version: application_version,
                                 application_user: application_user,
                                 additional_properties: additional_properties)
end

.names ⇒ Object

A mapping from model property names to API property names.



91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 91

def self.names
  @_hash = {} if @_hash.nil?
  @_hash['code'] = 'code'
  @_hash['reconciliation_id'] = 'reconciliationId'
  @_hash['paused_request_id'] = 'pausedRequestId'
  @_hash['transaction_id'] = 'transactionId'
  @_hash['comments'] = 'comments'
  @_hash['partner'] = 'partner'
  @_hash['application_name'] = 'applicationName'
  @_hash['application_version'] = 'applicationVersion'
  @_hash['application_user'] = 'applicationUser'
  @_hash
end

.nullables ⇒ Object

An array for nullable fields



121
122
123
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 121

def self.nullables
  []
end

.optionals ⇒ Object

An array for optional fields



106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 106

def self.optionals
  %w[
    code
    reconciliation_id
    paused_request_id
    transaction_id
    comments
    partner
    application_name
    application_version
    application_user
  ]
end

Instance Method Details

#inspect ⇒ Object

Provides a debugging-friendly string with detailed object information.



195
196
197
198
199
200
201
202
203
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 195

def inspect
  class_name = self.class.name.split('::').last
  "<#{class_name} code: #{@code.inspect}, reconciliation_id: #{@reconciliation_id.inspect},"\
  " paused_request_id: #{@paused_request_id.inspect}, transaction_id:"\
  " #{@transaction_id.inspect}, comments: #{@comments.inspect}, partner: #{@partner.inspect},"\
  " application_name: #{@application_name.inspect}, application_version:"\
  " #{@application_version.inspect}, application_user: #{@application_user.inspect},"\
  " additional_properties: #{@additional_properties}>"
end

#to_s ⇒ Object

Provides a human-readable string representation of the object.



185
186
187
188
189
190
191
192
 
# File 'lib/visa_acceptance_merged_spec/models/client_reference_information.rb', line 185

def to_s
  class_name = self.class.name.split('::').last
  "<#{class_name} code: #{@code}, reconciliation_id: #{@reconciliation_id},"\
  " paused_request_id: #{@paused_request_id}, transaction_id: #{@transaction_id}, comments:"\
  " #{@comments}, partner: #{@partner}, application_name: #{@application_name},"\
  " application_version: #{@application_version}, application_user: #{@application_user},"\
  " additional_properties: #{@additional_properties}>"
end