Class: CyberSourceMergedSpec::ClientReferenceInformation10

Inherits:
BaseModel
  • Object
show all
Defined in:
lib/cyber_source_merged_spec/models/client_reference_information10.rb

Overview

ClientReferenceInformation10 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, return_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) ⇒ ClientReferenceInformation10

Returns a new instance of ClientReferenceInformation10.



130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 130

def initialize(code: SKIP, reconciliation_id: SKIP,
               return_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
  @return_reconciliation_id = return_reconciliation_id unless return_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 CyberSource.

Returns:

  • (String) 


80
81
82
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 80

def application_name
  @application_name
end

#application_user ⇒ String

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

Returns:

  • (String) 


91
92
93
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 91

def application_user
  @application_user
end

#application_version ⇒ String

Version of the CyberSource application or integration used for a transaction.

Returns:

  • (String) 


85
86
87
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 85

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/cyber_source_merged_spec/models/client_reference_information10.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) 


69
70
71
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 69

def comments
  @comments
end

#partner ⇒ Partner

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

Returns:



74
75
76
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 74

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) 


50
51
52
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 50

def paused_request_id
  @paused_request_id
end

#reconciliation_id ⇒ String

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

Returns:

  • (String) 


39
40
41
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 39

def reconciliation_id
  @reconciliation_id
end

#return_reconciliation_id ⇒ String

A new ID which is created for refund

Returns:

  • (String) 


43
44
45
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 43

def return_reconciliation_id
  @return_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) 


64
65
66
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 64

def transaction_id
  @transaction_id
end

Class Method Details

.from_element(root) ⇒ Object 



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 194

def self.from_element(root)
  code = XmlUtilities.from_element(root, 'code', String)
  reconciliation_id = XmlUtilities.from_element(root, 'reconciliationId',
                                                String)
  return_reconciliation_id = XmlUtilities.from_element(
    root, 'returnReconciliationId', String
  )
  paused_request_id = XmlUtilities.from_element(root, 'pausedRequestId',
                                                String)
  transaction_id = XmlUtilities.from_element(root, 'transactionId', String)
  comments = XmlUtilities.from_element(root, 'comments', String)
  partner = XmlUtilities.from_element(root, 'Partner', Partner)
  application_name = XmlUtilities.from_element(root, 'applicationName',
                                               String)
  application_version = XmlUtilities.from_element(root,
                                                  'applicationVersion',
                                                  String)
  application_user = XmlUtilities.from_element(root, 'applicationUser',
                                               String)

  new(code: code,
      reconciliation_id: reconciliation_id,
      return_reconciliation_id: return_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

.from_hash(hash) ⇒ Object

Creates an instance of the object from a hash.



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
183
184
185
186
187
188
189
190
191
192
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 152

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
  return_reconciliation_id =
    hash.key?('returnReconciliationId') ? hash['returnReconciliationId'] : 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.
  ClientReferenceInformation10.new(code: code,
                                   reconciliation_id: reconciliation_id,
                                   return_reconciliation_id: return_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.



94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 94

def self.names
  @_hash = {} if @_hash.nil?
  @_hash['code'] = 'code'
  @_hash['reconciliation_id'] = 'reconciliationId'
  @_hash['return_reconciliation_id'] = 'returnReconciliationId'
  @_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



126
127
128
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 126

def self.nullables
  []
end

.optionals ⇒ Object

An array for optional fields



110
111
112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 110

def self.optionals
  %w[
    code
    reconciliation_id
    return_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.



264
265
266
267
268
269
270
271
272
273
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 264

def inspect
  class_name = self.class.name.split('::').last
  "<#{class_name} code: #{@code.inspect}, reconciliation_id: #{@reconciliation_id.inspect},"\
  " return_reconciliation_id: #{@return_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.



253
254
255
256
257
258
259
260
261
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 253

def to_s
  class_name = self.class.name.split('::').last
  "<#{class_name} code: #{@code}, reconciliation_id: #{@reconciliation_id},"\
  " return_reconciliation_id: #{@return_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

#to_xml_element(doc, root_name) ⇒ Object 



227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
 
# File 'lib/cyber_source_merged_spec/models/client_reference_information10.rb', line 227

def to_xml_element(doc, root_name)
  root = doc.create_element(root_name)

  XmlUtilities.add_as_subelement(doc, root, 'code', code)
  XmlUtilities.add_as_subelement(doc, root, 'reconciliationId',
                                 reconciliation_id)
  XmlUtilities.add_as_subelement(doc, root, 'returnReconciliationId',
                                 return_reconciliation_id)
  XmlUtilities.add_as_subelement(doc, root, 'pausedRequestId',
                                 paused_request_id)
  XmlUtilities.add_as_subelement(doc, root, 'transactionId', transaction_id)
  XmlUtilities.add_as_subelement(doc, root, 'comments', comments)
  XmlUtilities.add_as_subelement(doc, root, 'Partner', partner)
  XmlUtilities.add_as_subelement(doc, root, 'applicationName',
                                 application_name)
  XmlUtilities.add_as_subelement(doc, root, 'applicationVersion',
                                 application_version)
  XmlUtilities.add_as_subelement(doc, root, 'applicationUser',
                                 application_user)
  XmlUtilities.add_as_subelement(doc, root, 'additional_properties',
                                 additional_properties)

  root
end