paystack_sdk 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c0c86514c8e91c4ad7c193577baffc2bb81f440538060a2ebbb8fc6a7aac70f
-  data.tar.gz: 3c3a91324750db2890e047afbb610ef5f4db5466dfa736b0b723480c2025a2a0
+  metadata.gz: 49b220e27fe0ec66289af8fbbba9d84e63c3698b5964629293edcc8e31335119
+  data.tar.gz: 0df4630d49d761fb99371fb020271c515153dcbf3f784ac6c6bf543dc63a0634
 SHA512:
-  metadata.gz: 3ea181b46bad07e3a134ee4b96d3f1b8aedfdc07f5d7c06b911acedb088dc57d1b74f0238b9bd4b6fff2d3d9335c53086e8b7cbc3fd24d20a3f0dac84d6aff69
-  data.tar.gz: b24c889c49d667cc5d26e9ef89e684d258e8be63f5a237f8b450a061dede02ce9676b3d27de247fe32b8966f2c543744252633fceb6cb941b85bfead9f01b291
+  metadata.gz: 15748f65a44c87b7a2b679642c3a46c8aa9f7db1841f964975e0929d30dfcdf52a4979a74289085717927452b81806c3c364c362a9cf15416db75baf25b5db43
+  data.tar.gz: 0e242f0b20e9475d4eb23fff2f6979007d104223f0d681701da99f9aa2635644c9bad41ce23878605dd3583eee38e3535703347a351d7995f078922b1c081798

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.0.9] - 2025-06-26
+
+### Added
+
+- Verification resource with support for:
+  - Resolving bank accounts
+  - Resolving card BINs
+  - Validating accounts (with required and optional fields)
+- Registered `verification` resource in the main client for easy access
+- Regression tests for all Verification resource methods, including required field validation and full parameter support
+
+### Changed
+
+- Fix the link for listing banks API
+
+## [0.0.8] - 2025-06-26
+
+### Added
+
+- Banks resource with support for listing banks and currency validation
+- Regression tests for Banks resource, including validation for allowed currencies
+- Registered `banks` resource in the main client for easy access
+
+### Improved
+
+- Validation for allowed currency values in Banks resource for safer API usage
+
 ## [0.0.7] - 2025-06-25
 
 ### Added

data/lib/paystack_sdk/client.rb

@@ -4,6 +4,8 @@ require_relative "resources/transactions"
 require_relative "resources/customers"
 require_relative "resources/transfer_recipients"
 require_relative "resources/transfers"
+require_relative "resources/banks"
+require_relative "resources/verification"
 require_relative "utils/connection_utils"
 
 module PaystackSdk
@@ -91,5 +93,33 @@ module PaystackSdk
     def transfers
       @transfers ||= Resources::Transfers.new(@connection)
     end
+
+    # Provides access to the `Banks` resource.
+    #
+    # @return [PaystackSdk::Resources::Banks] An instance of the
+    #  `Banks` resource.
+    #
+    # @example
+    # ```ruby
+    #   banks = client.banks
+    #   response = banks.list
+    # ```
+    def banks
+      @banks ||= Resources::Banks.new(@connection)
+    end
+
+    # Provides access to the `Verification` resource.
+    #
+    # @return [PaystackSdk::Resources::Verification] An instance of the
+    #  `Verification` resource.
+    #
+    # @example
+    # ```ruby
+    #   verification = client.verification
+    #   response = verification.resolve_account(account_number: ..., bank_code: ...)
+    # ```
+    def verification
+      @verification ||= Resources::Verification.new(@connection)
+    end
   end
 end

data/lib/paystack_sdk/resources/banks.rb

@@ -0,0 +1,21 @@
+require_relative "../validations"
+
+module PaystackSdk
+  module Resources
+    class Banks < Base
+      # List banks
+      # @see https://paystack.com/docs/api/miscellaneous/#bank
+      def list(query = {})
+        if query.key?(:currency)
+          validate_allowed_values!(
+            value: query[:currency],
+            name: "currency",
+            allowed_values: %w[NGN GHS ZAR KES USD]
+          )
+        end
+
+        handle_response(@connection.get("/bank", query))
+      end
+    end
+  end
+end

data/lib/paystack_sdk/resources/verification.rb

@@ -0,0 +1,36 @@
+require_relative "../validations"
+require_relative "base"
+
+module PaystackSdk
+  module Resources
+    class Verification < Base
+      # Resolve Bank Account
+      # @see https://paystack.com/docs/api/verification/#resolve-bank-account
+      def resolve_account(account_number:, bank_code:)
+        validate_presence!(value: account_number, name: "account_number")
+        validate_presence!(value: bank_code, name: "bank_code")
+        handle_response(@connection.get("/bank/resolve", {account_number: account_number, bank_code: bank_code}))
+      end
+
+      # Resolve Card BIN
+      # @see https://paystack.com/docs/api/verification/#resolve-card-bin
+      def resolve_card_bin(bin)
+        validate_presence!(value: bin, name: "bin")
+        handle_response(@connection.get("/decision/bin/#{bin}"))
+      end
+
+      # Validate Account
+      # @see https://paystack.com/docs/api/verification/#validate-account
+      # Required: account_number, account_name, account_type, bank_code, country_code, document_type
+      # Optional: document_number
+      def validate_account(params)
+        validate_required_params!(
+          payload: params,
+          required_params: %i[account_number account_name account_type bank_code country_code document_type],
+          operation_name: "Validate Account"
+        )
+        handle_response(@connection.post("/bank/validate", params))
+      end
+    end
+  end
+end

data/lib/paystack_sdk/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paystack_sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - Maxwell Nana Forson (theLazyProgrammer)
@@ -115,11 +115,13 @@ files:
 - Rakefile
 - lib/paystack_sdk.rb
 - lib/paystack_sdk/client.rb
+- lib/paystack_sdk/resources/banks.rb
 - lib/paystack_sdk/resources/base.rb
 - lib/paystack_sdk/resources/customers.rb
 - lib/paystack_sdk/resources/transactions.rb
 - lib/paystack_sdk/resources/transfer_recipients.rb
 - lib/paystack_sdk/resources/transfers.rb
+- lib/paystack_sdk/resources/verification.rb
 - lib/paystack_sdk/response.rb
 - lib/paystack_sdk/utils/connection_utils.rb
 - lib/paystack_sdk/validations.rb