Class: ThePlaidApi::TransactionsRemovedWebhook

Inherits:
BaseModel
  • Object
show all
Defined in:
lib/the_plaid_api/models/transactions_removed_webhook.rb

Overview

Fired when transaction(s) for an Item are deleted. The deleted transaction IDs are included in the webhook payload. Plaid will typically check for deleted transaction data several times a day. This webhook is intended for use with ‘/transactions/get`; if you are using the newer `/transactions/sync` endpoint, this webhook will still be fired to maintain backwards compatibility, but it is recommended to listen for and respond to the `SYNC_UPDATES_AVAILABLE` webhook instead.

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(webhook_type:, webhook_code:, removed_transactions:, item_id:, environment:, error: SKIP, additional_properties: nil) ⇒ TransactionsRemovedWebhook

Returns a new instance of TransactionsRemovedWebhook.



76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 76

def initialize(webhook_type:, webhook_code:, removed_transactions:,
               item_id:, environment:, error: SKIP,
               additional_properties: nil)
  # Add additional model properties to the instance
  additional_properties = {} if additional_properties.nil?

  @webhook_type = webhook_type
  @webhook_code = webhook_code
  @error = error unless error == SKIP
  @removed_transactions = removed_transactions
  @item_id = item_id
  @environment = environment
  @additional_properties = additional_properties
end

Instance Attribute Details

#environment ⇒ WebhookEnvironmentValues

The Plaid environment the webhook was sent from

Returns:



48
49
50
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 48

def environment
  @environment
end

#error ⇒ Error

Errors are identified by ‘error_code` and categorized by `error_type`. Use these in preference to HTTP status codes to identify and handle specific errors. HTTP status codes are set and provide the broadest categorization of errors: 4xx codes are for developer- or user-related errors, and 5xx codes are for Plaid-related errors, and the status will be 2xx in non-error cases. An Item with a non-`null` error object will only be part of an API response when calling `/item/get` to view Item status. Otherwise, error fields will be `null` if no error has occurred; if an error has occurred, an error code will be returned instead.

Returns:



36
37
38
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 36

def error
  @error
end

#item_id ⇒ String

The ‘item_id` of the Item associated with this webhook, warning, or error

Returns:

  • (String) 


44
45
46
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 44

def item_id
  @item_id
end

#removed_transactions ⇒ Array[String]

An array of ‘transaction_ids` corresponding to the removed transactions

Returns:

  • (Array[String]) 


40
41
42
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 40

def removed_transactions
  @removed_transactions
end

#webhook_code ⇒ String

‘TRANSACTIONS_REMOVED`

Returns:

  • (String) 


24
25
26
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 24

def webhook_code
  @webhook_code
end

#webhook_type ⇒ String

‘TRANSACTIONS`

Returns:

  • (String) 


20
21
22
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 20

def webhook_type
  @webhook_type
end

Class Method Details

.from_hash(hash) ⇒ Object

Creates an instance of the object from a hash.



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 92

def self.from_hash(hash)
  return nil unless hash

  # Extract variables from the hash.
  webhook_type = hash.key?('webhook_type') ? hash['webhook_type'] : nil
  webhook_code = hash.key?('webhook_code') ? hash['webhook_code'] : nil
  removed_transactions =
    hash.key?('removed_transactions') ? hash['removed_transactions'] : nil
  item_id = hash.key?('item_id') ? hash['item_id'] : nil
  environment = hash.key?('environment') ? hash['environment'] : nil
  error = Error.from_hash(hash['error']) if hash['error']

  # 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.
  TransactionsRemovedWebhook.new(webhook_type: webhook_type,
                                 webhook_code: webhook_code,
                                 removed_transactions: removed_transactions,
                                 item_id: item_id,
                                 environment: environment,
                                 error: error,
                                 additional_properties: additional_properties)
end

.names ⇒ Object

A mapping from model property names to API property names.



51
52
53
54
55
56
57
58
59
60
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 51

def self.names
  @_hash = {} if @_hash.nil?
  @_hash['webhook_type'] = 'webhook_type'
  @_hash['webhook_code'] = 'webhook_code'
  @_hash['error'] = 'error'
  @_hash['removed_transactions'] = 'removed_transactions'
  @_hash['item_id'] = 'item_id'
  @_hash['environment'] = 'environment'
  @_hash
end

.nullables ⇒ Object

An array for nullable fields



70
71
72
73
74
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 70

def self.nullables
  %w[
    error
  ]
end

.optionals ⇒ Object

An array for optional fields



63
64
65
66
67
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 63

def self.optionals
  %w[
    error
  ]
end

Instance Method Details

#inspect ⇒ Object

Provides a debugging-friendly string with detailed object information.



130
131
132
133
134
135
136
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 130

def inspect
  class_name = self.class.name.split('::').last
  "<#{class_name} webhook_type: #{@webhook_type.inspect}, webhook_code:"\
  " #{@webhook_code.inspect}, error: #{@error.inspect}, removed_transactions:"\
  " #{@removed_transactions.inspect}, item_id: #{@item_id.inspect}, environment:"\
  " #{@environment.inspect}, additional_properties: #{@additional_properties}>"
end

#to_s ⇒ Object

Provides a human-readable string representation of the object.



122
123
124
125
126
127
 
# File 'lib/the_plaid_api/models/transactions_removed_webhook.rb', line 122

def to_s
  class_name = self.class.name.split('::').last
  "<#{class_name} webhook_type: #{@webhook_type}, webhook_code: #{@webhook_code}, error:"\
  " #{@error}, removed_transactions: #{@removed_transactions}, item_id: #{@item_id},"\
  " environment: #{@environment}, additional_properties: #{@additional_properties}>"
end