Class: AdvancedBilling::BankAccountPaymentProfile

Inherits:
BaseModel
  • Object
show all
Defined in:
lib/advanced_billing/models/bank_account_payment_profile.rb

Overview

BankAccountPaymentProfile Model.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from BaseModel

#to_hash, #to_json

Constructor Details

#initialize(masked_bank_account_number:, payment_type: PaymentType::BANK_ACCOUNT, id: SKIP, first_name: SKIP, last_name: SKIP, customer_id: SKIP, current_vault: SKIP, vault_token: SKIP, billing_address: SKIP, billing_city: SKIP, billing_state: SKIP, billing_zip: SKIP, billing_country: SKIP, customer_vault_token: SKIP, billing_address_2: SKIP, bank_name: SKIP, masked_bank_routing_number: SKIP, bank_account_type: SKIP, bank_account_holder_type: SKIP, verified: false, site_gateway_setting_id: SKIP, gateway_handle: SKIP, additional_properties: {}) ⇒ BankAccountPaymentProfile

Returns a new instance of BankAccountPaymentProfile.



181
182
183
184
185
186
187
188
189
190
191
192
193
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
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 181

def initialize(masked_bank_account_number:,
               payment_type: PaymentType::BANK_ACCOUNT, id: SKIP,
               first_name: SKIP, last_name: SKIP, customer_id: SKIP,
               current_vault: SKIP, vault_token: SKIP,
               billing_address: SKIP, billing_city: SKIP,
               billing_state: SKIP, billing_zip: SKIP,
               billing_country: SKIP, customer_vault_token: SKIP,
               billing_address_2: SKIP, bank_name: SKIP,
               masked_bank_routing_number: SKIP, bank_account_type: SKIP,
               bank_account_holder_type: SKIP, verified: false,
               site_gateway_setting_id: SKIP, gateway_handle: SKIP,
               additional_properties: {})
  @id = id unless id == SKIP
  @first_name = first_name unless first_name == SKIP
  @last_name = last_name unless last_name == SKIP
  @customer_id = customer_id unless customer_id == SKIP
  @current_vault = current_vault unless current_vault == SKIP
  @vault_token = vault_token unless vault_token == SKIP
  @billing_address = billing_address unless billing_address == SKIP
  @billing_city = billing_city unless billing_city == SKIP
  @billing_state = billing_state unless billing_state == SKIP
  @billing_zip = billing_zip unless billing_zip == SKIP
  @billing_country = billing_country unless billing_country == SKIP
  @customer_vault_token = customer_vault_token unless customer_vault_token == SKIP
  @billing_address_2 = billing_address_2 unless billing_address_2 == SKIP
  @bank_name = bank_name unless bank_name == SKIP
  unless masked_bank_routing_number == SKIP
    @masked_bank_routing_number =
      masked_bank_routing_number
  end
  @masked_bank_account_number = 
  @bank_account_type =  unless  == SKIP
  @bank_account_holder_type =  unless  == SKIP
  @payment_type = payment_type
  @verified = verified unless verified == SKIP
  @site_gateway_setting_id = site_gateway_setting_id unless site_gateway_setting_id == SKIP
  @gateway_handle = gateway_handle unless gateway_handle == SKIP

  # Add additional model properties to the instance.
  additional_properties.each do |_name, _value|
    instance_variable_set("@#{_name}", _value)
  end
end

Instance Attribute Details

#bank_account_holder_type ⇒ BankAccountHolderType

Defaults to personal

Returns:



91
92
93
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 91

def 
  @bank_account_holder_type
end

#bank_account_type ⇒ BankAccountType

Defaults to checking

Returns:



87
88
89
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 87

def 
  @bank_account_type
end

#bank_name ⇒ String

The bank where the account resides

Returns:

  • (String) 


72
73
74
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 72

def bank_name
  @bank_name
end

#billing_address ⇒ String

The current billing street address for the bank account

Returns:

  • (String) 


43
44
45
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 43

def billing_address
  @billing_address
end

#billing_address_2 ⇒ String

The current billing street address, second line, for the bank account

Returns:

  • (String) 


68
69
70
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 68

def billing_address_2
  @billing_address_2
end

#billing_city ⇒ String

The current billing address city for the bank account

Returns:

  • (String) 


47
48
49
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 47

def billing_city
  @billing_city
end

#billing_country ⇒ String

The current billing address country for the bank account

Returns:

  • (String) 


59
60
61
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 59

def billing_country
  @billing_country
end

#billing_state ⇒ String

The current billing address state for the bank account

Returns:

  • (String) 


51
52
53
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 51

def billing_state
  @billing_state
end

#billing_zip ⇒ String

The current billing address zip code for the bank account

Returns:

  • (String) 


55
56
57
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 55

def billing_zip
  @billing_zip
end

#current_vault ⇒ BankAccountVault

The vault that stores the payment profile with the provided vault_token. Use ‘bogus` for testing.

Returns:



34
35
36
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 34

def current_vault
  @current_vault
end

#customer_id ⇒ Integer

The Chargify-assigned id for the customer record to which the bank account belongs

Returns:

  • (Integer) 


29
30
31
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 29

def customer_id
  @customer_id
end

#customer_vault_token ⇒ String

(only for Authorize.Net CIM storage): the customerProfileId for the owner of the customerPaymentProfileId provided as the vault_token.

Returns:

  • (String) 


64
65
66
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 64

def customer_vault_token
  @customer_vault_token
end

#first_name ⇒ String

The first name of the bank account holder

Returns:

  • (String) 


20
21
22
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 20

def first_name
  @first_name
end

#gateway_handle ⇒ String

denotes whether a bank account has been verified by providing the amounts of two small deposits made into the account

Returns:

  • (String) 


110
111
112
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 110

def gateway_handle
  @gateway_handle
end

#id ⇒ Integer

The Chargify-assigned ID of the stored bank account. This value can be used as an input to payment_profile_id when creating a subscription, in order to re-use a stored payment profile for the same customer

Returns:

  • (Integer) 


16
17
18
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 16

def id
  @id
end

#last_name ⇒ String

The last name of the bank account holder

Returns:

  • (String) 


24
25
26
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 24

def last_name
  @last_name
end

#masked_bank_account_number ⇒ String

A string representation of the stored bank account number with all but the last 4 digits marked with X’s (i.e. ‘XXXXXXX1111’)

Returns:

  • (String) 


83
84
85
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 83

def 
  @masked_bank_account_number
end

#masked_bank_routing_number ⇒ String

A string representation of the stored bank routing number with all but the last 4 digits marked with X’s (i.e. ‘XXXXXXX1111’). payment_type will be bank_account

Returns:

  • (String) 


78
79
80
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 78

def masked_bank_routing_number
  @masked_bank_routing_number
end

#payment_type ⇒ PaymentType

Defaults to personal

Returns:



95
96
97
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 95

def payment_type
  @payment_type
end

#site_gateway_setting_id ⇒ Integer

denotes whether a bank account has been verified by providing the amounts of two small deposits made into the account

Returns:

  • (Integer) 


105
106
107
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 105

def site_gateway_setting_id
  @site_gateway_setting_id
end

#vault_token ⇒ String

The “token” provided by your vault storage for an already stored payment profile

Returns:

  • (String) 


39
40
41
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 39

def vault_token
  @vault_token
end

#verified ⇒ TrueClass | FalseClass

denotes whether a bank account has been verified by providing the amounts of two small deposits made into the account

Returns:

  • (TrueClass | FalseClass) 


100
101
102
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 100

def verified
  @verified
end

Class Method Details

.from_hash(hash) ⇒ Object

Creates an instance of the object from a hash.



226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 226

def self.from_hash(hash)
  return nil unless hash

  # Extract variables from the hash.
   =
    hash.key?('masked_bank_account_number') ? hash['masked_bank_account_number'] : nil
  payment_type = hash['payment_type'] ||= PaymentType::BANK_ACCOUNT
  id = hash.key?('id') ? hash['id'] : SKIP
  first_name = hash.key?('first_name') ? hash['first_name'] : SKIP
  last_name = hash.key?('last_name') ? hash['last_name'] : SKIP
  customer_id = hash.key?('customer_id') ? hash['customer_id'] : SKIP
  current_vault = hash.key?('current_vault') ? hash['current_vault'] : SKIP
  vault_token = hash.key?('vault_token') ? hash['vault_token'] : SKIP
  billing_address =
    hash.key?('billing_address') ? hash['billing_address'] : SKIP
  billing_city = hash.key?('billing_city') ? hash['billing_city'] : SKIP
  billing_state = hash.key?('billing_state') ? hash['billing_state'] : SKIP
  billing_zip = hash.key?('billing_zip') ? hash['billing_zip'] : SKIP
  billing_country =
    hash.key?('billing_country') ? hash['billing_country'] : SKIP
  customer_vault_token =
    hash.key?('customer_vault_token') ? hash['customer_vault_token'] : SKIP
  billing_address_2 =
    hash.key?('billing_address_2') ? hash['billing_address_2'] : SKIP
  bank_name = hash.key?('bank_name') ? hash['bank_name'] : SKIP
  masked_bank_routing_number =
    hash.key?('masked_bank_routing_number') ? hash['masked_bank_routing_number'] : SKIP
   =
    hash.key?('bank_account_type') ? hash['bank_account_type'] : SKIP
   =
    hash.key?('bank_account_holder_type') ? hash['bank_account_holder_type'] : SKIP
  verified = hash['verified'] ||= false
  site_gateway_setting_id =
    hash.key?('site_gateway_setting_id') ? hash['site_gateway_setting_id'] : SKIP
  gateway_handle =
    hash.key?('gateway_handle') ? hash['gateway_handle'] : SKIP

  # Clean out expected properties from Hash.
  names.each_value { |k| hash.delete(k) }

  # Create object from extracted values.
  BankAccountPaymentProfile.new(masked_bank_account_number: ,
                                payment_type: payment_type,
                                id: id,
                                first_name: first_name,
                                last_name: last_name,
                                customer_id: customer_id,
                                current_vault: current_vault,
                                vault_token: vault_token,
                                billing_address: billing_address,
                                billing_city: billing_city,
                                billing_state: billing_state,
                                billing_zip: billing_zip,
                                billing_country: billing_country,
                                customer_vault_token: customer_vault_token,
                                billing_address_2: billing_address_2,
                                bank_name: bank_name,
                                masked_bank_routing_number: masked_bank_routing_number,
                                bank_account_type: ,
                                bank_account_holder_type: ,
                                verified: verified,
                                site_gateway_setting_id: site_gateway_setting_id,
                                gateway_handle: gateway_handle,
                                additional_properties: hash)
end

.names ⇒ Object

A mapping from model property names to API property names.



113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 113

def self.names
  @_hash = {} if @_hash.nil?
  @_hash['id'] = 'id'
  @_hash['first_name'] = 'first_name'
  @_hash['last_name'] = 'last_name'
  @_hash['customer_id'] = 'customer_id'
  @_hash['current_vault'] = 'current_vault'
  @_hash['vault_token'] = 'vault_token'
  @_hash['billing_address'] = 'billing_address'
  @_hash['billing_city'] = 'billing_city'
  @_hash['billing_state'] = 'billing_state'
  @_hash['billing_zip'] = 'billing_zip'
  @_hash['billing_country'] = 'billing_country'
  @_hash['customer_vault_token'] = 'customer_vault_token'
  @_hash['billing_address_2'] = 'billing_address_2'
  @_hash['bank_name'] = 'bank_name'
  @_hash['masked_bank_routing_number'] = 'masked_bank_routing_number'
  @_hash['masked_bank_account_number'] = 'masked_bank_account_number'
  @_hash['bank_account_type'] = 'bank_account_type'
  @_hash['bank_account_holder_type'] = 'bank_account_holder_type'
  @_hash['payment_type'] = 'payment_type'
  @_hash['verified'] = 'verified'
  @_hash['site_gateway_setting_id'] = 'site_gateway_setting_id'
  @_hash['gateway_handle'] = 'gateway_handle'
  @_hash
end

.nullables ⇒ Object

An array for nullable fields



167
168
169
170
171
172
173
174
175
176
177
178
179
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 167

def self.nullables
  %w[
    billing_address
    billing_city
    billing_state
    billing_zip
    billing_country
    customer_vault_token
    billing_address_2
    site_gateway_setting_id
    gateway_handle
  ]
end

.optionals ⇒ Object

An array for optional fields



141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 141

def self.optionals
  %w[
    id
    first_name
    last_name
    customer_id
    current_vault
    vault_token
    billing_address
    billing_city
    billing_state
    billing_zip
    billing_country
    customer_vault_token
    billing_address_2
    bank_name
    masked_bank_routing_number
    bank_account_type
    bank_account_holder_type
    verified
    site_gateway_setting_id
    gateway_handle
  ]
end

.validate(value) ⇒ Object

Validates an instance of the object from a given value.

Parameters:



294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
 
# File 'lib/advanced_billing/models/bank_account_payment_profile.rb', line 294

def self.validate(value)
  if value.instance_of? self
    return (
      APIHelper.valid_type?(value.,
                            ->(val) { val.instance_of? String }) and
        APIHelper.valid_type?(value.payment_type,
                              ->(val) { PaymentType.validate(val) })
    )
  end

  return false unless value.instance_of? Hash

  (
    APIHelper.valid_type?(value['masked_bank_account_number'],
                          ->(val) { val.instance_of? String }) and
      APIHelper.valid_type?(value['payment_type'],
                            ->(val) { PaymentType.validate(val) })
  )
end