paystack_sdk 0.0.9 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49b220e27fe0ec66289af8fbbba9d84e63c3698b5964629293edcc8e31335119
-  data.tar.gz: 0df4630d49d761fb99371fb020271c515153dcbf3f784ac6c6bf543dc63a0634
+  metadata.gz: 7771d8c6ca4931f237e71c171c7507cfcd9ca5b6159974ee4a4a37d3d667a0e7
+  data.tar.gz: e2c83863b81cd30f7fed5380f145ccfa283a25ea334a30e33cb86170636f0b50
 SHA512:
-  metadata.gz: 15748f65a44c87b7a2b679642c3a46c8aa9f7db1841f964975e0929d30dfcdf52a4979a74289085717927452b81806c3c364c362a9cf15416db75baf25b5db43
-  data.tar.gz: 0e242f0b20e9475d4eb23fff2f6979007d104223f0d681701da99f9aa2635644c9bad41ce23878605dd3583eee38e3535703347a351d7995f078922b1c081798
+  metadata.gz: aeeef1dcbfd223247142cfa6ee3ffb85624f2cc392ba5a993f9224ab5a4166273f386b1bf4a6fc4d0571dd30b3a626f08a1d0234cbe3808124e350c88228bebb
+  data.tar.gz: f8af0ecc7ef80cd7cfd0ab4858365bdce1b244115402869e5b1b29e3a6018816f19224ed0df2483d2fd732d6babd12a75764f4c324cdc55ee32bc35212d83654

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.1.0] - 2025-06-26
+
+### Changed
+
+#### Error Handling Strategy
+
+- **BREAKING**: Clarified error handling approach - the SDK now consistently follows a two-tier error handling strategy:
+  - **Validation errors** (missing/invalid input data) are thrown as exceptions immediately before API calls
+  - **API response errors** (business logic, not found, etc.) are returned as unsuccessful Response objects
+- Updated documentation to clearly explain when exceptions are thrown vs. when to check `response.success?`
+
+#### Test Infrastructure
+
+- **BREAKING**: Standardized all test specifications to use connection doubles instead of Faraday-specific mocks
+- Updated test pattern across all resource specs to use `instance_double("PaystackSdk::Connection")` for better framework independence
+- All tests now follow consistent mocking pattern with `PaystackSdk::Response.new()` expectations
+
+#### Documentation
+
+- Enhanced README with comprehensive error handling examples
+- Added validation error examples showing `MissingParamError`, `InvalidFormatError`, and `InvalidValueError`
+- Updated Quick Start guide to demonstrate proper exception handling
+- Clarified the difference between input validation (exceptions) and API response handling (Response objects)
+
+### Improved
+
+- Better separation of concerns between input validation and API error handling
+- More consistent test suite that's not tied to specific HTTP client implementation
+- Clearer developer experience with predictable error handling patterns
+
 ## [0.0.9] - 2025-06-26
 
 ### Added

data/README.md

@@ -69,13 +69,19 @@ params = {
   currency: "NGN"
 }
 
-response = paystack.transactions.initiate(params)
+begin
+  response = paystack.transactions.initiate(params)
 
-if response.success?
-  puts "Visit this URL to complete payment: #{response.authorization_url}"
-  puts "Transaction reference: #{response.reference}"
-else
-  puts "Error: #{response.error_message}"
+  if response.success?
+    puts "Visit this URL to complete payment: #{response.authorization_url}"
+    puts "Transaction reference: #{response.reference}"
+  else
+    puts "Error: #{response.error_message}"
+  end
+rescue PaystackSdk::MissingParamError => e
+  puts "Missing required data: #{e.message}"
+rescue PaystackSdk::InvalidFormatError => e
+  puts "Invalid data format: #{e.message}"
 end
 
 # Create a customer
@@ -85,12 +91,16 @@ customer_params = {
   last_name: "Doe"
 }
 
-customer_response = paystack.customers.create(customer_params)
+begin
+  customer_response = paystack.customers.create(customer_params)
 
-if customer_response.success?
-  puts "Customer created: #{customer_response.data.customer_code}"
-else
-  puts "Error: #{customer_response.error_message}"
+  if customer_response.success?
+    puts "Customer created: #{customer_response.data.customer_code}"
+  else
+    puts "Error: #{customer_response.error_message}"
+  end
+rescue PaystackSdk::ValidationError => e
+  puts "Validation error: #{e.message}"
 end
 ```
 
@@ -98,6 +108,55 @@ end
 
 The SDK handles API responses that use string keys (as returned by Paystack) and provides seamless access through both string and symbol notation. All response data maintains the original string key format from the API while offering convenient dot notation access.
 
+### Error Handling
+
+The SDK uses a two-tier error handling approach:
+
+1. **Validation Errors** (thrown as exceptions) - for missing or invalid input data
+2. **API Response Errors** (returned as unsuccessful Response objects) - for API-level issues
+
+#### Input Validation
+
+The SDK validates your parameters **before** making API calls and throws exceptions immediately for data issues:
+
+```ruby
+begin
+  # This will throw an exception before making any API call
+  response = paystack.transactions.initiate({amount: 1000}) # Missing required email
+rescue PaystackSdk::MissingParamError => e
+  puts "Fix your data: #{e.message}"
+end
+```
+
+#### API Response Handling
+
+All successful API calls return a `Response` object that you can check for success:
+
+```ruby
+response = paystack.transactions.initiate(valid_params)
+
+if response.success?
+  puts "Transaction created: #{response.authorization_url}"
+else
+  puts "Transaction failed: #{response.error_message}"
+
+  # Get detailed error information
+  error_details = response.error_details
+  puts "Status code: #{error_details[:status_code]}"
+  puts "Error message: #{error_details[:message]}"
+end
+```
+
+**Note**: The SDK raises exceptions for:
+
+- **Validation errors** - when required parameters are missing or have invalid formats
+- **Authentication errors** (401) - usually configuration issues
+- **Rate limiting** (429) - requires retry logic
+- **Server errors** (5xx) - Paystack infrastructure issues
+- **Network errors** - connection failures
+
+All other API errors (resource not found, business logic errors, etc.) are returned as unsuccessful Response objects.
+
 ## Usage
 
 ### Client Initialization
@@ -457,19 +516,19 @@ total_count = original.dig("meta", "total")
 current_page = original.dig("meta", "page")
 ```
 
-#### Error Handling
+#### Exception Handling
 
 The SDK provides specific error classes for different types of failures, making it easier to handle errors appropriately:
 
 ```ruby
 begin
   response = paystack.transactions.verify(reference: "invalid_reference")
-rescue PaystackSdk::ResourceNotFoundError => e
-  puts "Resource not found: #{e.message}"
 rescue PaystackSdk::AuthenticationError => e
   puts "Authentication failed: #{e.message}"
-rescue PaystackSdk::ValidationError => e
-  puts "Validation error: #{e.message}"
+rescue PaystackSdk::RateLimitError => e
+  puts "Rate limit exceeded. Retry after: #{e.retry_after} seconds"
+rescue PaystackSdk::ServerError => e
+  puts "Server error: #{e.message}"
 rescue PaystackSdk::APIError => e
   puts "API error: #{e.message}"
 rescue PaystackSdk::Error => e
@@ -507,6 +566,41 @@ The SDK includes several specific error classes:
   - **`PaystackSdk::RateLimitError`** - Rate limiting encountered
   - **`PaystackSdk::ServerError`** - Server errors (5xx responses)
 
+##### Validation Error Examples
+
+The SDK validates your input data **before** making API calls and will throw exceptions immediately if required data is missing or incorrectly formatted:
+
+```ruby
+# Missing required parameter
+begin
+  paystack.transactions.initiate({amount: 1000}) # Missing email
+rescue PaystackSdk::MissingParamError => e
+  puts e.message # => "Missing required parameter: email"
+end
+
+# Invalid format
+begin
+  paystack.transactions.initiate({
+    email: "invalid-email",  # Not a valid email format
+    amount: 1000
+  })
+rescue PaystackSdk::InvalidFormatError => e
+  puts e.message # => "Invalid format for Email. Expected format: valid email address"
+end
+
+# Invalid value
+begin
+  paystack.customers.set_risk_action({
+    customer: "CUS_123",
+    risk_action: "invalid_action"  # Not in allowed values
+  })
+rescue PaystackSdk::InvalidValueError => e
+  puts e.message # => "Invalid value for risk_action: must be one of [default, allow, deny]"
+end
+```
+
+These validation errors are thrown immediately and prevent the API call from being made, helping you catch data issues early in development.
+
 ## Advanced Usage
 
 ### Environment Variables

data/lib/paystack_sdk/client.rb

@@ -6,6 +6,7 @@ require_relative "resources/transfer_recipients"
 require_relative "resources/transfers"
 require_relative "resources/banks"
 require_relative "resources/verification"
+require_relative "resources/charges"
 require_relative "utils/connection_utils"
 
 module PaystackSdk
@@ -121,5 +122,19 @@ module PaystackSdk
     def verification
       @verification ||= Resources::Verification.new(@connection)
     end
+
+    # Provides access to the `Charges` resource.
+    #
+    # @return [PaystackSdk::Resources::Charges] An instance of the
+    #  `Charges` resource.
+    #
+    # @example
+    # ```ruby
+    #   charges = client.charges
+    #   response = charges.mobile_money(payload)
+    # ```
+    def charges
+      @charges ||= Resources::Charges.new(@connection)
+    end
   end
 end

data/lib/paystack_sdk/resources/charges.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module PaystackSdk
+  module Resources
+    # The `Charges` resource exposes helpers for initiating and managing charges
+    # through alternative payment channels such as Mobile Money.
+    #
+    # At the moment the SDK focuses on supporting the Mobile Money channel which
+    # requires posting to the `/charge` endpoint with the customer's email,
+    # amount, currency, and the provider specific `mobile_money` payload.
+    class Charges < PaystackSdk::Resources::Base
+      MOBILE_MONEY_PROVIDERS = %w[mtn atl vod mpesa orange wave].freeze
+
+      # Initiates a Mobile Money payment.
+      #
+      # @param payload [Hash] The payload containing charge details.
+      # @option payload [String] :email Customer's email address (required)
+      # @option payload [Integer] :amount Amount in the lowest currency unit (required)
+      # @option payload [String] :currency ISO currency code (default: GHS)
+      # @option payload [String] :reference Optional reference supplied by the merchant
+      # @option payload [String] :callback_url Optional callback URL for Paystack to redirect to
+      # @option payload [Hash] :metadata Optional metadata to attach to the transaction
+      # @option payload [Hash] :mobile_money The mobile money details (required)
+      #   - :phone [String] Customer's mobile money phone number (required)
+      #   - :provider [String] Mobile money provider code (required)
+      #
+      # @return [PaystackSdk::Response] The wrapped API response.
+      # @raise [PaystackSdk::ValidationError] If the payload is invalid.
+      def mobile_money(payload)
+        validate_mobile_money_payload!(payload)
+
+        normalized_payload = normalize_mobile_money_provider(payload)
+        response = @connection.post("/charge", normalized_payload)
+        handle_response(response)
+      end
+
+      # Submits an OTP for authorising a pending Mobile Money charge (e.g. Vodafone).
+      #
+      # @param payload [Hash] Payload containing the OTP and charge reference.
+      # @option payload [String] :otp The OTP supplied by the customer (required)
+      # @option payload [String] :reference The charge reference returned from initiation (required)
+      #
+      # @return [PaystackSdk::Response] The wrapped API response.
+      # @raise [PaystackSdk::ValidationError] If the payload is invalid.
+      def submit_otp(payload)
+        validate_fields!(
+          payload: payload,
+          validations: {
+            otp: {type: :string, required: true},
+            reference: {type: :reference, required: true}
+          }
+        )
+
+        response = @connection.post("/charge/submit_otp", payload)
+        handle_response(response)
+      end
+
+      private
+
+      def validate_mobile_money_payload!(payload)
+        validate_fields!(
+          payload: payload,
+          validations: {
+            email: {type: :email, required: true},
+            amount: {type: :positive_integer, required: true},
+            currency: {type: :currency, required: false},
+            reference: {type: :reference, required: false},
+            callback_url: {required: false},
+            metadata: {required: false},
+            mobile_money: {required: true}
+          }
+        )
+
+        mobile_money = payload[:mobile_money] || payload["mobile_money"]
+        validate_hash!(input: mobile_money, name: "mobile_money")
+
+        phone = mobile_money[:phone] || mobile_money["phone"]
+        validate_presence!(value: phone, name: "mobile_money phone")
+
+        provider = mobile_money[:provider] || mobile_money["provider"]
+        validate_mobile_money_provider!(provider)
+      end
+
+      def validate_mobile_money_provider!(provider)
+        normalized = provider&.to_s&.downcase
+        validate_allowed_values!(
+          value: normalized,
+          allowed_values: MOBILE_MONEY_PROVIDERS,
+          name: "mobile_money provider",
+          allow_nil: false
+        )
+      end
+
+      def normalize_mobile_money_provider(payload)
+        mm = payload[:mobile_money] || payload["mobile_money"] || {}
+        provider = mm[:provider] || mm["provider"]
+        normalized_provider = provider&.to_s&.downcase
+        # Avoid mutating the caller's payload
+        payload.merge(mobile_money: mm.merge(provider: normalized_provider))
+      end
+    end
+  end
+end

data/lib/paystack_sdk/resources/customers.rb

@@ -68,13 +68,9 @@ module PaystackSdk
         validate_positive_integer!(value: per_page, name: "per_page", allow_nil: true)
         validate_positive_integer!(value: page, name: "page", allow_nil: true)
 
-        if params[:from]
-          validate_date_format!(date_str: params[:from], name: "from")
-        end
+        validate_date_format!(date_str: params[:from], name: "from") if params[:from]
 
-        if params[:to]
-          validate_date_format!(date_str: params[:to], name: "to")
-        end
+        validate_date_format!(date_str: params[:to], name: "to") if params[:to]
 
         query_params = {perPage: per_page, page: page}.merge(params)
         response = @connection.get("customer", query_params)

data/lib/paystack_sdk/response.rb

@@ -63,11 +63,11 @@ module PaystackSdk
     # Initializes a new Response object
     #
     # @param response [Faraday::Response, Hash, Array] The raw API response or data
-    # @raise [PaystackSdk::APIError] If the API returns an error response
     # @raise [PaystackSdk::AuthenticationError] If authentication fails (401)
-    # @raise [PaystackSdk::ResourceNotFoundError] If resource is not found (404 or 400 with not found message)
     # @raise [PaystackSdk::RateLimitError] If rate limit is exceeded (429)
     # @raise [PaystackSdk::ServerError] If server returns 5xx error
+    # @note API-level errors (4xx except 401) are returned as unsuccessful Response objects
+    #       rather than raised as exceptions. Use response.success? to check for errors.
     def initialize(response)
       if response.is_a?(Faraday::Response)
         @status_code = response.status
@@ -79,20 +79,23 @@ module PaystackSdk
         case @status_code
         when 200..299
           @success = true
-        when 400
-          handle_400_response
-        when 401
-          raise AuthenticationError.new
-        when 404
-          handle_404_response
+        when 400..499
+          # Client errors - return unsuccessful response for user to handle
+          @success = false
+          @error_message = @api_message || "Client error"
+
+          # Still raise for authentication issues as these are usually config problems
+          raise AuthenticationError.new(@api_message || "Authentication failed") if @status_code == 401
         when 429
+          # Rate limiting - raise as users need to implement retry logic
           retry_after = response.headers["Retry-After"]
           raise RateLimitError.new(retry_after || 30)
         when 500..599
+          # Server errors - raise as these indicate Paystack infrastructure issues
           raise ServerError.new(@status_code, @api_message)
         else
           @success = false
-          raise APIError.new(@api_message || "Paystack API Error")
+          @error_message = @api_message || "Unknown error"
         end
       elsif response.is_a?(Response)
         @success = response.success?
@@ -120,6 +123,26 @@ module PaystackSdk
       @success
     end
 
+    # Check if the response failed
+    #
+    # @return [Boolean] true if the API request failed
+    def failed?
+      !@success
+    end
+
+    # Get error information if the request failed
+    #
+    # @return [Hash] Hash containing error details, or empty hash if successful
+    def error_details
+      return {} if success?
+
+      {
+        status_code: @status_code,
+        message: @error_message || @api_message,
+        raw_response: @body
+      }.compact
+    end
+
     # Returns the original response body
     # This is useful for debugging or accessing raw data
     #
@@ -186,7 +209,7 @@ module PaystackSdk
     # @yield [key, value] For hashes, passes each key-value pair
     # @yield [value] For arrays, passes each item
     # @return [Response, Enumerator] Self for chaining or Enumerator if no block given
-    def each(&block)
+    def each
       return enum_for(:each) unless block_given?
 
       if @raw_data.is_a?(Hash)
@@ -206,7 +229,7 @@ module PaystackSdk
     #   @return [Integer] The number of items
     # @!method empty?
     #   @return [Boolean] Whether the collection is empty
-    [:size, :length, :count, :empty?].each do |method_name|
+    %i[size length count empty?].each do |method_name|
       define_method(method_name) do
         @raw_data.send(method_name) if @raw_data.respond_to?(method_name)
       end
@@ -217,9 +240,10 @@ module PaystackSdk
     #   @return [Object, Response] The first item, wrapped if necessary
     # @!method last
     #   @return [Object, Response] The last item, wrapped if necessary
-    [:first, :last].each do |method_name|
+    %i[first last].each do |method_name|
       define_method(method_name) do
         return nil unless @raw_data.is_a?(Array)
+
         wrap_value(@raw_data.send(method_name))
       end
     end
@@ -236,9 +260,7 @@ module PaystackSdk
 
       # First try to get identifier from the message
       message = body["message"].to_s.downcase
-      if message =~ /with (id|code|reference|email): ([^\s]+)/i
-        return $2
-      end
+      return ::Regexp.last_match(2) if message =~ /with (id|code|reference|email): ([^\s]+)/i
 
       # If not found in message, try to extract from error code
       if body["code"]&.match?(/^(transaction|customer)_/)
@@ -263,6 +285,7 @@ module PaystackSdk
     # @return [Hash, Array, nil] The data from the response
     def extract_data_from_body(body)
       return body unless body.is_a?(Hash)
+
       body["data"] || body
     end
 
@@ -284,28 +307,15 @@ module PaystackSdk
       end
     end
 
-    def handle_400_response
-      if @body["code"]&.end_with?("_not_found") ||
-          @api_message&.match?(/not found|cannot find|does not exist/i)
-        resource_type = determine_resource_type
-        meta_info = @body["meta"]&.dig("nextStep")
-        message = @api_message
-        message = "#{message}\nHint: #{meta_info}" if meta_info
-        raise ResourceNotFoundError.new(resource_type, message)
-      else
-        @success = false
-        raise APIError.new(@api_message || "Paystack API Error")
-      end
-    end
+    def determine_resource_type
+      return "Unknown" unless @body.is_a?(Hash) && @body["code"]
 
-    def handle_404_response
-      resource_type = determine_resource_type
-      raise ResourceNotFoundError.new(resource_type, @api_message)
-    end
+      if @body["code"].include?("_")
+        parts = @body["code"].to_s.split("_")
+        return parts.last if parts.last != "not_found"
+      end
 
-    def determine_resource_type
-      resource = @body["code"].split("_").first
-      resource.capitalize
+      "unknown"
     end
   end
 end

data/lib/paystack_sdk/validations.rb

@@ -37,9 +37,9 @@ module PaystackSdk
     # @param name [String] Name of the parameter for error messages
     # @raise [PaystackSdk::InvalidFormatError] If input is not a hash
     def validate_hash!(input:, name: "Payload")
-      unless input.is_a?(Hash)
-        raise PaystackSdk::InvalidFormatError.new(name, "Hash")
-      end
+      return if input.is_a?(Hash)
+
+      raise PaystackSdk::InvalidFormatError.new(name, "Hash")
     end
 
     # Validates that required parameters are present in a payload.
@@ -53,10 +53,10 @@ module PaystackSdk
         !payload.key?(param) && !payload.key?(param.to_s)
       end
 
-      unless missing_params.empty?
-        param = missing_params.first
-        raise PaystackSdk::MissingParamError.new(param)
-      end
+      return if missing_params.empty?
+
+      param = missing_params.first
+      raise PaystackSdk::MissingParamError.new(param)
     end
 
     # Validates that a value is present (not nil or empty).
@@ -91,9 +91,9 @@ module PaystackSdk
     # @param name [String] Name of the parameter for error messages
     # @raise [PaystackSdk::InvalidFormatError] If reference format is invalid
     def validate_reference_format!(reference:, name: "Reference")
-      unless reference.to_s.match?(/^[a-zA-Z0-9._=-]+$/)
-        raise PaystackSdk::InvalidFormatError.new(name, "alphanumeric characters and the following: -, ., =")
-      end
+      return if reference.to_s.match?(/^[a-zA-Z0-9._=-]+$/)
+
+      raise PaystackSdk::InvalidFormatError.new(name, "alphanumeric characters and the following: -, ., =")
     end
 
     # Validates a date string format.
@@ -106,6 +106,7 @@ module PaystackSdk
     def validate_date_format!(date_str:, name: "Date", allow_nil: true)
       if date_str.nil?
         raise PaystackSdk::MissingParamError.new(name) unless allow_nil
+
         return
       end
 
@@ -136,13 +137,14 @@ module PaystackSdk
     def validate_allowed_values!(value:, allowed_values:, name: "Parameter", allow_nil: true)
       if value.nil?
         raise PaystackSdk::MissingParamError.new(name) unless allow_nil
+
         return
       end
 
-      unless allowed_values.include?(value)
-        allowed_list = allowed_values.join(", ")
-        raise PaystackSdk::InvalidValueError.new(name, "must be one of: #{allowed_list}")
-      end
+      return if allowed_values.include?(value)
+
+      allowed_list = allowed_values.join(", ")
+      raise PaystackSdk::InvalidValueError.new(name, "must be one of: #{allowed_list}")
     end
 
     # Validates an email format.
@@ -154,12 +156,13 @@ module PaystackSdk
     def validate_email!(email:, name: "Email", allow_nil: false)
       if email.nil?
         raise PaystackSdk::MissingParamError.new(name) unless allow_nil
+
         return
       end
 
-      unless email.to_s.match?(/\A[^@\s]+@[^@\s]+\.[^@\s]+\z/)
-        raise PaystackSdk::InvalidFormatError.new(name, "valid email address")
-      end
+      return if email.to_s.match?(/\A[^@\s]+@[^@\s]+\.[^@\s]+\z/)
+
+      raise PaystackSdk::InvalidFormatError.new(name, "valid email address")
     end
 
     # Validates a currency code format.
@@ -171,12 +174,13 @@ module PaystackSdk
     def validate_currency!(currency:, name: "Currency", allow_nil: true)
       if currency.nil?
         raise PaystackSdk::MissingParamError.new(name) unless allow_nil
+
         return
       end
 
-      unless currency.to_s.match?(/\A[A-Z]{3}\z/)
-        raise PaystackSdk::InvalidFormatError.new(name, "3-letter ISO code (e.g., NGN, USD, GHS)")
-      end
+      return if currency.to_s.match?(/\A[A-Z]{3}\z/)
+
+      raise PaystackSdk::InvalidFormatError.new(name, "3-letter ISO code (e.g., NGN, USD, GHS)")
     end
 
     # Validates multiple fields at once.

data/lib/paystack_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PaystackSdk
-  VERSION = "0.0.9"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paystack_sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.1.1
 platform: ruby
 authors:
 - Maxwell Nana Forson (theLazyProgrammer)
@@ -24,75 +24,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 2.13.1
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: debug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: 1.9.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: 1.9.0
 - !ruby/object:Gem::Dependency
-  name: standard
+  name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.49.0
+        version: 1.15.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.49.0
+        version: 1.15.1
 - !ruby/object:Gem::Dependency
-  name: irb
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.1
+        version: 13.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.1
+        version: 13.2.1
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.2.1
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.2.1
+        version: '3.13'
 - !ruby/object:Gem::Dependency
-  name: debug
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.49.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.49.0
 description: |
   The `paystack_sdk` gem provides a simple and intuitive interface for
   interacting with Paystack's payment gateway API. It allows developers to
@@ -117,6 +117,7 @@ files:
 - lib/paystack_sdk/client.rb
 - lib/paystack_sdk/resources/banks.rb
 - lib/paystack_sdk/resources/base.rb
+- lib/paystack_sdk/resources/charges.rb
 - lib/paystack_sdk/resources/customers.rb
 - lib/paystack_sdk/resources/transactions.rb
 - lib/paystack_sdk/resources/transfer_recipients.rb