Class: Increase::Client

Inherits:
Internal::Transport::BaseClient show all
Defined in:
lib/increase/client.rb,
sig/increase/client.rbs

Constant Summary collapse

DEFAULT_MAX_RETRIES =

Default max number of retries to attempt after a failed retryable request.

Returns:

  • (2) 
2
DEFAULT_TIMEOUT_IN_SECONDS =

Default per-request timeout.

Returns:

  • (Float) 
60.0
DEFAULT_INITIAL_RETRY_DELAY =

Default initial retry delay in seconds. Overall delay is calculated using exponential backoff + jitter.

Returns:

  • (Float) 
0.5
DEFAULT_MAX_RETRY_DELAY =

Default max retry delay in seconds.

Returns:

  • (Float) 
8.0
ENVIRONMENTS =

rubocop:disable Style/MutableConstant

Returns:

  • ({) 
{production: "https://api.increase.com", sandbox: "https://sandbox.increase.com"}

Constants inherited from Internal::Transport::BaseClient

Internal::Transport::BaseClient::Increase, Internal::Transport::BaseClient::MAX_REDIRECTS

Instance Attribute Summary collapse

Attributes inherited from Internal::Transport::BaseClient

#base_url, #headers, #idempotency_header, #initial_retry_delay, #max_retries, #max_retry_delay, #requester, #timeout

Instance Method Summary collapse

Methods inherited from Internal::Transport::BaseClient

follow_redirect, #inspect, reap_connection!, #request, #send_request, should_retry?, validate!

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(api_key: ENV["INCREASE_API_KEY"], webhook_secret: ENV["INCREASE_WEBHOOK_SECRET"], environment: nil, base_url: ENV["INCREASE_BASE_URL"], max_retries: self.class::DEFAULT_MAX_RETRIES, timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS, initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY, max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY, idempotency_header: "Idempotency-Key") ⇒ Client

Creates and returns a new client for interacting with the API.

Parameters:

  • api_key (String, nil) (defaults to: ENV["INCREASE_API_KEY"]) —

    Defaults to ENV["INCREASE_API_KEY"]

  • webhook_secret (String, nil) (defaults to: ENV["INCREASE_WEBHOOK_SECRET"]) —

    Defaults to ENV["INCREASE_WEBHOOK_SECRET"]

  • environment (:production, :sandbox, nil) (defaults to: nil) —

    Specifies the environment to use for the API.

    Each environment maps to a different base URL:

    • production corresponds to https://api.increase.com
    • sandbox corresponds to https://sandbox.increase.com
  • base_url (String, nil) (defaults to: ENV["INCREASE_BASE_URL"]) —

    Override the default base URL for the API, e.g., "https://api.example.com/v2/". Defaults to ENV["INCREASE_BASE_URL"]

  • max_retries (Integer) (defaults to: self.class::DEFAULT_MAX_RETRIES) —

    Max number of retries to attempt after a failed retryable request.

  • timeout (Float) (defaults to: self.class::DEFAULT_TIMEOUT_IN_SECONDS)
  • initial_retry_delay (Float) (defaults to: self.class::DEFAULT_INITIAL_RETRY_DELAY)
  • max_retry_delay (Float) (defaults to: self.class::DEFAULT_MAX_RETRY_DELAY)
  • idempotency_header (String) (defaults to: "Idempotency-Key") 


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
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
 
# File 'lib/increase/client.rb', line 236

def initialize(
  api_key: ENV["INCREASE_API_KEY"],
  webhook_secret: ENV["INCREASE_WEBHOOK_SECRET"],
  environment: nil,
  base_url: ENV["INCREASE_BASE_URL"],
  max_retries: self.class::DEFAULT_MAX_RETRIES,
  timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
  initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
  max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
  idempotency_header: "Idempotency-Key"
)
  base_url ||= Increase::Client::ENVIRONMENTS.fetch(environment&.to_sym || :production) do
    message = "environment must be one of #{Increase::Client::ENVIRONMENTS.keys}, got #{environment}"
    raise ArgumentError.new(message)
  end

  if api_key.nil?
    raise ArgumentError.new("api_key is required, and can be set via environ: \"INCREASE_API_KEY\"")
  end

  headers = {}
  custom_headers_env = ENV["INCREASE_CUSTOM_HEADERS"]
  unless custom_headers_env.nil?
    parsed = {}
    custom_headers_env.split("\n").each do |line|
      colon = line.index(":")
      unless colon.nil?
        parsed[line[0...colon].strip] = line[(colon + 1)..].strip
      end
    end
    headers = parsed.merge(headers)
  end

  @api_key = api_key.to_s
  @webhook_secret = webhook_secret&.to_s

  super(
    base_url: base_url,
    timeout: timeout,
    max_retries: max_retries,
    initial_retry_delay: initial_retry_delay,
    max_retry_delay: max_retry_delay,
    headers: headers,
    idempotency_header: idempotency_header
  )

  @accounts = Increase::Resources::Accounts.new(client: self)
  @account_numbers = Increase::Resources::AccountNumbers.new(client: self)
  @account_transfers = Increase::Resources::AccountTransfers.new(client: self)
  @cards = Increase::Resources::Cards.new(client: self)
  @card_payments = Increase::Resources::CardPayments.new(client: self)
  @card_purchase_supplements = Increase::Resources::CardPurchaseSupplements.new(client: self)
  @card_disputes = Increase::Resources::CardDisputes.new(client: self)
  @physical_cards = Increase::Resources::PhysicalCards.new(client: self)
  @digital_card_profiles = Increase::Resources::DigitalCardProfiles.new(client: self)
  @physical_card_profiles = Increase::Resources::PhysicalCardProfiles.new(client: self)
  @digital_wallet_tokens = Increase::Resources::DigitalWalletTokens.new(client: self)
  @transactions = Increase::Resources::Transactions.new(client: self)
  @pending_transactions = Increase::Resources::PendingTransactions.new(client: self)
  @declined_transactions = Increase::Resources::DeclinedTransactions.new(client: self)
  @ach_transfers = Increase::Resources::ACHTransfers.new(client: self)
  @inbound_ach_transfers = Increase::Resources::InboundACHTransfers.new(client: self)
  @ach_prenotifications = Increase::Resources::ACHPrenotifications.new(client: self)
  @wire_transfers = Increase::Resources::WireTransfers.new(client: self)
  @inbound_wire_transfers = Increase::Resources::InboundWireTransfers.new(client: self)
  @wire_drawdown_requests = Increase::Resources::WireDrawdownRequests.new(client: self)
  @inbound_wire_drawdown_requests = Increase::Resources::InboundWireDrawdownRequests.new(client: self)
  @check_transfers = Increase::Resources::CheckTransfers.new(client: self)
  @inbound_check_deposits = Increase::Resources::InboundCheckDeposits.new(client: self)
  @real_time_payments_transfers = Increase::Resources::RealTimePaymentsTransfers.new(client: self)
  @inbound_real_time_payments_transfers =
    Increase::Resources::InboundRealTimePaymentsTransfers.new(client: self)
  @fednow_transfers = Increase::Resources::FednowTransfers.new(client: self)
  @inbound_fednow_transfers = Increase::Resources::InboundFednowTransfers.new(client: self)
  @swift_transfers = Increase::Resources::SwiftTransfers.new(client: self)
  @check_deposits = Increase::Resources::CheckDeposits.new(client: self)
  @lockbox_addresses = Increase::Resources::LockboxAddresses.new(client: self)
  @lockbox_recipients = Increase::Resources::LockboxRecipients.new(client: self)
  @inbound_mail_items = Increase::Resources::InboundMailItems.new(client: self)
  @routing_numbers = Increase::Resources::RoutingNumbers.new(client: self)
  @external_accounts = Increase::Resources::ExternalAccounts.new(client: self)
  @entities = Increase::Resources::Entities.new(client: self)
  @beneficial_owners = Increase::Resources::BeneficialOwners.new(client: self)
  @supplemental_documents = Increase::Resources::SupplementalDocuments.new(client: self)
  @entity_onboarding_sessions = Increase::Resources::EntityOnboardingSessions.new(client: self)
  @programs = Increase::Resources::Programs.new(client: self)
  @account_statements = Increase::Resources::AccountStatements.new(client: self)
  @files = Increase::Resources::Files.new(client: self)
  @file_links = Increase::Resources::FileLinks.new(client: self)
  @exports = Increase::Resources::Exports.new(client: self)
  @events = Increase::Resources::Events.new(client: self)
  @event_subscriptions = Increase::Resources::EventSubscriptions.new(client: self)
  @real_time_decisions = Increase::Resources::RealTimeDecisions.new(client: self)
  @groups = Increase::Resources::Groups.new(client: self)
  @oauth_applications = Increase::Resources::OAuthApplications.new(client: self)
  @oauth_connections = Increase::Resources::OAuthConnections.new(client: self)
  @oauth_tokens = Increase::Resources::OAuthTokens.new(client: self)
   = Increase::Resources::IntrafiAccountEnrollments.new(client: self)
  @intrafi_balances = Increase::Resources::IntrafiBalances.new(client: self)
  @intrafi_exclusions = Increase::Resources::IntrafiExclusions.new(client: self)
  @card_tokens = Increase::Resources::CardTokens.new(client: self)
  @card_push_transfers = Increase::Resources::CardPushTransfers.new(client: self)
  @card_validations = Increase::Resources::CardValidations.new(client: self)
  @simulations = Increase::Resources::Simulations.new(client: self)
end

Instance Attribute Details

#account_numbers ⇒ Increase::Resources::AccountNumbers (readonly)

Returns:



33
34
35
 
# File 'lib/increase/client.rb', line 33

def 
  @account_numbers
end

#account_statements ⇒ Increase::Resources::AccountStatements (readonly)

Returns:



147
148
149
 
# File 'lib/increase/client.rb', line 147

def 
  @account_statements
end

#account_transfers ⇒ Increase::Resources::AccountTransfers (readonly)

Returns:



36
37
38
 
# File 'lib/increase/client.rb', line 36

def 
  @account_transfers
end

#accounts ⇒ Increase::Resources::Accounts (readonly)

Returns:



30
31
32
 
# File 'lib/increase/client.rb', line 30

def accounts
  @accounts
end

#ach_prenotifications ⇒ Increase::Resources::ACHPrenotifications (readonly)

Returns:



78
79
80
 
# File 'lib/increase/client.rb', line 78

def ach_prenotifications
  @ach_prenotifications
end

#ach_transfers ⇒ Increase::Resources::ACHTransfers (readonly)

Returns:



72
73
74
 
# File 'lib/increase/client.rb', line 72

def ach_transfers
  @ach_transfers
end

#api_key ⇒ String (readonly)

Returns:

  • (String) 


24
25
26
 
# File 'lib/increase/client.rb', line 24

def api_key
  @api_key
end

#beneficial_owners ⇒ Increase::Resources::BeneficialOwners (readonly)

Returns:



135
136
137
 
# File 'lib/increase/client.rb', line 135

def beneficial_owners
  @beneficial_owners
end

#card_disputes ⇒ Increase::Resources::CardDisputes (readonly)

Returns:



48
49
50
 
# File 'lib/increase/client.rb', line 48

def card_disputes
  @card_disputes
end

#card_payments ⇒ Increase::Resources::CardPayments (readonly)

Returns:



42
43
44
 
# File 'lib/increase/client.rb', line 42

def card_payments
  @card_payments
end

#card_purchase_supplements ⇒ Increase::Resources::CardPurchaseSupplements (readonly)

Returns:



45
46
47
 
# File 'lib/increase/client.rb', line 45

def card_purchase_supplements
  @card_purchase_supplements
end

#card_push_transfers ⇒ Increase::Resources::CardPushTransfers (readonly)

Returns:



192
193
194
 
# File 'lib/increase/client.rb', line 192

def card_push_transfers
  @card_push_transfers
end

#card_tokens ⇒ Increase::Resources::CardTokens (readonly)

Returns:



189
190
191
 
# File 'lib/increase/client.rb', line 189

def card_tokens
  @card_tokens
end

#card_validations ⇒ Increase::Resources::CardValidations (readonly)

Returns:



195
196
197
 
# File 'lib/increase/client.rb', line 195

def card_validations
  @card_validations
end

#cards ⇒ Increase::Resources::Cards (readonly)

Returns:



39
40
41
 
# File 'lib/increase/client.rb', line 39

def cards
  @cards
end

#check_deposits ⇒ Increase::Resources::CheckDeposits (readonly)

Returns:



114
115
116
 
# File 'lib/increase/client.rb', line 114

def check_deposits
  @check_deposits
end

#check_transfers ⇒ Increase::Resources::CheckTransfers (readonly)

Returns:



93
94
95
 
# File 'lib/increase/client.rb', line 93

def check_transfers
  @check_transfers
end

#declined_transactions ⇒ Increase::Resources::DeclinedTransactions (readonly)

Returns:



69
70
71
 
# File 'lib/increase/client.rb', line 69

def declined_transactions
  @declined_transactions
end

#digital_card_profiles ⇒ Increase::Resources::DigitalCardProfiles (readonly)

Returns:



54
55
56
 
# File 'lib/increase/client.rb', line 54

def digital_card_profiles
  @digital_card_profiles
end

#digital_wallet_tokens ⇒ Increase::Resources::DigitalWalletTokens (readonly)

Returns:



60
61
62
 
# File 'lib/increase/client.rb', line 60

def digital_wallet_tokens
  @digital_wallet_tokens
end

#entities ⇒ Increase::Resources::Entities (readonly)

Returns:



132
133
134
 
# File 'lib/increase/client.rb', line 132

def entities
  @entities
end

#entity_onboarding_sessions ⇒ Increase::Resources::EntityOnboardingSessions (readonly)

Returns:



141
142
143
 
# File 'lib/increase/client.rb', line 141

def entity_onboarding_sessions
  @entity_onboarding_sessions
end

#event_subscriptions ⇒ Increase::Resources::EventSubscriptions (readonly)

Returns:



162
163
164
 
# File 'lib/increase/client.rb', line 162

def event_subscriptions
  @event_subscriptions
end

#events ⇒ Increase::Resources::Events (readonly)

Returns:



159
160
161
 
# File 'lib/increase/client.rb', line 159

def events
  @events
end

#exports ⇒ Increase::Resources::Exports (readonly)

Returns:



156
157
158
 
# File 'lib/increase/client.rb', line 156

def exports
  @exports
end

#external_accounts ⇒ Increase::Resources::ExternalAccounts (readonly)

Returns:



129
130
131
 
# File 'lib/increase/client.rb', line 129

def external_accounts
  @external_accounts
end

#fednow_transfers ⇒ Increase::Resources::FednowTransfers (readonly)

Returns:



105
106
107
 
# File 'lib/increase/client.rb', line 105

def fednow_transfers
  @fednow_transfers
end

#file_links ⇒ Increase::Resources::FileLinks (readonly)

Returns:



153
154
155
 
# File 'lib/increase/client.rb', line 153

def file_links
  @file_links
end

#files ⇒ Increase::Resources::Files (readonly)

Returns:



150
151
152
 
# File 'lib/increase/client.rb', line 150

def files
  @files
end

#groups ⇒ Increase::Resources::Groups (readonly)

Returns:



168
169
170
 
# File 'lib/increase/client.rb', line 168

def groups
  @groups
end

#inbound_ach_transfers ⇒ Increase::Resources::InboundACHTransfers (readonly)

Returns:



75
76
77
 
# File 'lib/increase/client.rb', line 75

def inbound_ach_transfers
  @inbound_ach_transfers
end

#inbound_check_deposits ⇒ Increase::Resources::InboundCheckDeposits (readonly)

Returns:



96
97
98
 
# File 'lib/increase/client.rb', line 96

def inbound_check_deposits
  @inbound_check_deposits
end

#inbound_fednow_transfers ⇒ Increase::Resources::InboundFednowTransfers (readonly)

Returns:



108
109
110
 
# File 'lib/increase/client.rb', line 108

def inbound_fednow_transfers
  @inbound_fednow_transfers
end

#inbound_mail_items ⇒ Increase::Resources::InboundMailItems (readonly)

Returns:



123
124
125
 
# File 'lib/increase/client.rb', line 123

def inbound_mail_items
  @inbound_mail_items
end

#inbound_real_time_payments_transfers ⇒ Increase::Resources::InboundRealTimePaymentsTransfers (readonly)

Returns:



102
103
104
 
# File 'lib/increase/client.rb', line 102

def inbound_real_time_payments_transfers
  @inbound_real_time_payments_transfers
end

#inbound_wire_drawdown_requests ⇒ Increase::Resources::InboundWireDrawdownRequests (readonly)

Returns:



90
91
92
 
# File 'lib/increase/client.rb', line 90

def inbound_wire_drawdown_requests
  @inbound_wire_drawdown_requests
end

#inbound_wire_transfers ⇒ Increase::Resources::InboundWireTransfers (readonly)

Returns:



84
85
86
 
# File 'lib/increase/client.rb', line 84

def inbound_wire_transfers
  @inbound_wire_transfers
end

#intrafi_account_enrollments ⇒ Increase::Resources::IntrafiAccountEnrollments (readonly)

Returns:



180
181
182
 
# File 'lib/increase/client.rb', line 180

def 
  
end

#intrafi_balances ⇒ Increase::Resources::IntrafiBalances (readonly)

Returns:



183
184
185
 
# File 'lib/increase/client.rb', line 183

def intrafi_balances
  @intrafi_balances
end

#intrafi_exclusions ⇒ Increase::Resources::IntrafiExclusions (readonly)

Returns:



186
187
188
 
# File 'lib/increase/client.rb', line 186

def intrafi_exclusions
  @intrafi_exclusions
end

#lockbox_addresses ⇒ Increase::Resources::LockboxAddresses (readonly)

Returns:



117
118
119
 
# File 'lib/increase/client.rb', line 117

def lockbox_addresses
  @lockbox_addresses
end

#lockbox_recipients ⇒ Increase::Resources::LockboxRecipients (readonly)

Returns:



120
121
122
 
# File 'lib/increase/client.rb', line 120

def lockbox_recipients
  @lockbox_recipients
end

#oauth_applications ⇒ Increase::Resources::OAuthApplications (readonly)

Returns:



171
172
173
 
# File 'lib/increase/client.rb', line 171

def oauth_applications
  @oauth_applications
end

#oauth_connections ⇒ Increase::Resources::OAuthConnections (readonly)

Returns:



174
175
176
 
# File 'lib/increase/client.rb', line 174

def oauth_connections
  @oauth_connections
end

#oauth_tokens ⇒ Increase::Resources::OAuthTokens (readonly)

Returns:



177
178
179
 
# File 'lib/increase/client.rb', line 177

def oauth_tokens
  @oauth_tokens
end

#pending_transactions ⇒ Increase::Resources::PendingTransactions (readonly)

Returns:



66
67
68
 
# File 'lib/increase/client.rb', line 66

def pending_transactions
  @pending_transactions
end

#physical_card_profiles ⇒ Increase::Resources::PhysicalCardProfiles (readonly)

Returns:



57
58
59
 
# File 'lib/increase/client.rb', line 57

def physical_card_profiles
  @physical_card_profiles
end

#physical_cards ⇒ Increase::Resources::PhysicalCards (readonly)

Returns:



51
52
53
 
# File 'lib/increase/client.rb', line 51

def physical_cards
  @physical_cards
end

#programs ⇒ Increase::Resources::Programs (readonly)

Returns:



144
145
146
 
# File 'lib/increase/client.rb', line 144

def programs
  @programs
end

#real_time_decisions ⇒ Increase::Resources::RealTimeDecisions (readonly)

Returns:



165
166
167
 
# File 'lib/increase/client.rb', line 165

def real_time_decisions
  @real_time_decisions
end

#real_time_payments_transfers ⇒ Increase::Resources::RealTimePaymentsTransfers (readonly)

Returns:



99
100
101
 
# File 'lib/increase/client.rb', line 99

def real_time_payments_transfers
  @real_time_payments_transfers
end

#routing_numbers ⇒ Increase::Resources::RoutingNumbers (readonly)

Returns:



126
127
128
 
# File 'lib/increase/client.rb', line 126

def routing_numbers
  @routing_numbers
end

#simulations ⇒ Increase::Resources::Simulations (readonly)

Returns:



198
199
200
 
# File 'lib/increase/client.rb', line 198

def simulations
  @simulations
end

#supplemental_documents ⇒ Increase::Resources::SupplementalDocuments (readonly)

Returns:



138
139
140
 
# File 'lib/increase/client.rb', line 138

def supplemental_documents
  @supplemental_documents
end

#swift_transfers ⇒ Increase::Resources::SwiftTransfers (readonly)

Returns:



111
112
113
 
# File 'lib/increase/client.rb', line 111

def swift_transfers
  @swift_transfers
end

#transactions ⇒ Increase::Resources::Transactions (readonly)

Returns:



63
64
65
 
# File 'lib/increase/client.rb', line 63

def transactions
  @transactions
end

#webhook_secret ⇒ String? (readonly)

Returns:

  • (String, nil) 


27
28
29
 
# File 'lib/increase/client.rb', line 27

def webhook_secret
  @webhook_secret
end

#wire_drawdown_requests ⇒ Increase::Resources::WireDrawdownRequests (readonly)

Returns:



87
88
89
 
# File 'lib/increase/client.rb', line 87

def wire_drawdown_requests
  @wire_drawdown_requests
end

#wire_transfers ⇒ Increase::Resources::WireTransfers (readonly)

Returns:



81
82
83
 
# File 'lib/increase/client.rb', line 81

def wire_transfers
  @wire_transfers
end