Adds Verification resource with validation and regression tests

Introduces a new Verification resource supporting functionality for resolving bank accounts, card BINs, and account validation with required and optional fields. Registers the Verification resource in the main client for streamlined access and implements regression tests to ensure reliability of all methods. Also fixes an incorrect link in the banks API and updates the SDK version to 0.0.9.

Author: nanafox

CHANGELOG.md

@@ -1,5 +1,20 @@
 # 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

lib/paystack_sdk/client.rb

@@ -5,6 +5,7 @@
 require_relative "resources/transfer_recipients"
 require_relative "resources/transfers"
 require_relative "resources/banks"
+require_relative "resources/verification"
 require_relative "utils/connection_utils"
 
 module PaystackSdk
@@ -106,5 +107,19 @@ def transfers
  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

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

lib/paystack_sdk/version.rb

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

spec/resources/verification_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+RSpec.describe PaystackSdk::Resources::Verification do
+ let(:connection) { instance_double("PaystackSdk::Connection") }
+ let(:verification) { described_class.new(connection) }
+
+ describe "#resolve_account" do
+ it "resolves a bank account and wraps response" do
+ response_double = double("Response", success?: true)
+ expect(connection).to receive(:get)
+ .with("/bank/resolve", {account_number: "0001234567", bank_code: "058"})
+ .and_return(response_double)
+ expect(PaystackSdk::Response).to receive(:new).with(response_double)
+ verification.resolve_account(account_number: "0001234567", bank_code: "058")
+ end
+
+ it "raises error for missing account_number" do
+ expect {
+ verification.resolve_account(account_number: nil, bank_code: "058")
+ }.to raise_error(PaystackSdk::MissingParamError, /account_number/)
+ end
+
+ it "raises error for missing bank_code" do
+ expect {
+ verification.resolve_account(account_number: "0001234567", bank_code: nil)
+ }.to raise_error(PaystackSdk::MissingParamError, /bank_code/)
+ end
+ end
+
+ describe "#resolve_card_bin" do
+ it "resolves a card bin and wraps response" do
+ response_double = double("Response", success?: true)
+ expect(connection).to receive(:get)
+ .with("/decision/bin/539983")
+ .and_return(response_double)
+ expect(PaystackSdk::Response).to receive(:new).with(response_double)
+ verification.resolve_card_bin("539983")
+ end
+
+ it "raises error for missing bin" do
+ expect {
+ verification.resolve_card_bin(nil)
+ }.to raise_error(PaystackSdk::MissingParamError, /bin/)
+ end
+ end
+
+ describe "#validate_account" do
+ let(:required_params) do
+ {
+ account_number: "0001234567",
+ account_name: "Jane Doe",
+ account_type: "personal",
+ bank_code: "058",
+ country_code: "NG",
+ document_type: "identityNumber"
+ }
+ end
+
+ it "validates an account and wraps response" do
+ response_double = double("Response", success?: true)
+ expect(connection).to receive(:post)
+ .with("/bank/validate", required_params)
+ .and_return(response_double)
+ expect(PaystackSdk::Response).to receive(:new).with(response_double)
+ verification.validate_account(required_params)
+ end
+
+ it "raises error for missing required fields" do
+ %i[account_number account_name account_type bank_code country_code document_type].each do |field|
+ params = required_params.dup
+ params.delete(field)
+ expect {
+ verification.validate_account(params)
+ }.to raise_error(PaystackSdk::MissingParamError, /#{field}/)
+ end
+ end
+
+ it "validates an account with all params and wraps response" do
+ all_params = required_params.merge(
+ document_number: "1234567890123"
+ )
+ response_double = double("Response", success?: true)
+ expect(connection).to receive(:post)
+ .with("/bank/validate", all_params)
+ .and_return(response_double)
+ expect(PaystackSdk::Response).to receive(:new).with(response_double)
+ verification.validate_account(all_params)
+ end
+ end
+end