Class: PaystackSdk::Client

Inherits:
Object
  • Object
show all
Includes:
Utils::ConnectionUtils
Defined in:
lib/paystack_sdk/client.rb

Overview

The Client class serves as the main entry point for interacting with the Paystack API. It initializes a connection to the Paystack API and provides access to various resources.

Constant Summary

Constants included from Utils::ConnectionUtils

Utils::ConnectionUtils::BASE_URL

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Utils::ConnectionUtils

#create_connection, #initialize_connection

Constructor Details

#initialize(connection = nil, secret_key: nil) ⇒ Client

Initializes a new Client instance.

Examples:

With an existing connection

connection = Faraday.new(...)
client = PaystackSdk::Client.new(connection)

With an API key

client = PaystackSdk::Client.new(secret_key: "sk_test_xxx")

With default connection (requires PAYSTACK_SECRET_KEY environment variable)

client = PaystackSdk::Client.new

Parameters:

  • (defaults to: nil)

    The Faraday connection object used for API requests. If nil, a new connection will be created using the default API key.

  • (defaults to: nil)

    Optional API key to use for creating a new connection. Only used if connection is nil.



38
39
40
 
# File 'lib/paystack_sdk/client.rb', line 38

def initialize(connection = nil, secret_key: nil)
  @connection = initialize_connection(connection, secret_key: secret_key)
end

Instance Attribute Details

#connection ⇒ Faraday::Connection (readonly)

Returns The Faraday connection object used for API requests.

Returns:

  • The Faraday connection object used for API requests



20
21
22
 
# File 'lib/paystack_sdk/client.rb', line 20

def connection
  @connection
end

Instance Method Details

#banks ⇒ PaystackSdk::Resources::Banks

Provides access to the Banks resource.

  banks = client.banks
  response = banks.list

Returns:

  • An instance of the Banks resource.



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

def banks
  @banks ||= Resources::Banks.new(@connection)
end

#charges ⇒ PaystackSdk::Resources::Charges

Provides access to the Charges resource.

  charges = client.charges
  response = charges.mobile_money(payload)

Returns:

  • An instance of the Charges resource.



136
137
138
 
# File 'lib/paystack_sdk/client.rb', line 136

def charges
  @charges ||= Resources::Charges.new(@connection)
end

#customers ⇒ PaystackSdk::Resources::Customers

Provides access to the Customers resource.

  customers = client.customers
  response = customers.list

Returns:

  • An instance of the Customers resource.



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

def customers
  @customers ||= Resources::Customers.new(@connection)
end

#transactions ⇒ PaystackSdk::Resources::Transactions

Provides access to the Transactions resource.

  transactions = client.transactions
  response = transactions.initiate(params)

Returns:

  • An instance of the Transactions resource.



52
53
54
 
# File 'lib/paystack_sdk/client.rb', line 52

def transactions
  @transactions ||= Resources::Transactions.new(@connection)
end

#transfer_recipients ⇒ PaystackSdk::Resources::TransferRecipients

Provides access to the TransferRecipients resource.

  recipients = client.transfer_recipients
  response = recipients.create(params)

Returns:

  • An instance of the TransferRecipients resource.



80
81
82
 
# File 'lib/paystack_sdk/client.rb', line 80

def transfer_recipients
  @transfer_recipients ||= Resources::TransferRecipients.new(@connection)
end

#transfers ⇒ PaystackSdk::Resources::Transfers

Provides access to the Transfers resource.

  transfers = client.transfers
  response = transfers.create(params)

Returns:

  • An instance of the Transfers resource.



94
95
96
 
# File 'lib/paystack_sdk/client.rb', line 94

def transfers
  @transfers ||= Resources::Transfers.new(@connection)
end

#verification ⇒ PaystackSdk::Resources::Verification

Provides access to the Verification resource.

  verification = client.verification
  response = verification.(account_number: ..., bank_code: ...)

Returns:

  • An instance of the Verification resource.



122
123
124
 
# File 'lib/paystack_sdk/client.rb', line 122

def verification
  @verification ||= Resources::Verification.new(@connection)
end