flutterwave 0.1.1

data/lib/flutterwave/bank.rb

@@ -0,0 +1,46 @@
+module Flutterwave
+  class BankAPI
+    attr_accessor :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    # https://www.flutterwave.com/documentation/banks-enquiry/
+    def list
+      response = post(
+        Flutterwave::Utils::Constants::BANK[:list_url]
+      )
+
+      all_banks = response['data']
+      all_banks.keys.inject([]) do |list, code|
+        list << Bank.new(code, all_banks[code])
+      end
+    end
+
+    def find_by_code(code)
+      list.detect do |bank|
+        bank.code == code
+      end
+    end
+
+    def find_by_name(name_match)
+      list.detect do |bank|
+        !(bank.name.downcase =~ /#{name_match.downcase}/).nil?
+      end
+    end
+
+    def post(url, data = {})
+      Flutterwave::Utils::NetworkManager.post(url, data)
+    end
+  end
+
+  class Bank
+    attr_accessor :code, :name
+
+    def initialize(code, name)
+      @code = code
+      @name = name
+    end
+  end
+end

data/lib/flutterwave/bin.rb

@@ -0,0 +1,35 @@
+module Flutterwave
+  class BIN
+    include Flutterwave::Helpers
+    attr_accessor :client, :options
+
+    def initialize(client)
+      @client = client
+    end
+
+    # https://www.flutterwave.com/documentation/compliance/ - Verify Card BIN API
+    def check(options = {})
+      @options = options
+
+      request_params = {
+        card6: encrypt(:card6)
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::BIN[:check_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    def encrypt(key)
+      plain_text = options[key].to_s
+      raise Flutterwave::Utils::MissingKeyError.new(
+        "#{key.capitalize} key required!"
+      ) if plain_text.empty?
+
+      encrypt_data(plain_text, client.api_key)
+    end
+  end
+end

data/lib/flutterwave/bvn.rb

@@ -0,0 +1,74 @@
+module Flutterwave
+  class BVN
+    include Flutterwave::Helpers
+    attr_accessor :client, :options
+
+    def initialize(client)
+      @client = client
+    end
+
+    # https://www.flutterwave.com/documentation/compliance/ - Verify (request a user enter their BVN for verification)
+    def verify(options = {})
+      @options = options
+
+      request_params = {
+        otpoption: encrypt(:otpoption),
+        bvn: encrypt(:bvn),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::BVN[:verify_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/compliance/ - Resend OTP
+    def resend(options = {})
+      @options = options
+
+      request_params = {
+        validateoption: encrypt(:validateoption),
+        transactionreference: encrypt(:transactionreference),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::BVN[:resend_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/compliance/ - Validate (This is used to validate the OTP entered by the user)
+    def validate(options = {})
+      @options = options
+
+      request_params = {
+        otp: encrypt(:otp),
+        transactionreference: encrypt(:transactionreference),
+        bvn: encrypt(:bvn),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::BVN[:validate_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    def encrypt(key)
+      plain_text = options[key].to_s
+      raise Flutterwave::Utils::MissingKeyError.new(
+        "#{key.capitalize} key required!"
+      ) if plain_text.empty?
+
+      encrypt_data(plain_text, client.api_key)
+    end
+  end
+end

data/lib/flutterwave/card.rb

@@ -0,0 +1,272 @@
+require 'flutterwave/response'
+
+module Flutterwave
+  class Card
+    include Flutterwave::Helpers
+    attr_accessor :client, :options
+
+    def initialize(client)
+      @client = client
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments-with-preauth/#tokenize
+    def tokenize(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        validateoption: encrypt(:validateoption),
+        authmodel: encrypt(:authmodel),
+        cardno: encrypt(:cardno),
+        cvv: encrypt(:cvv),
+        country: encrypt(:country),
+        expirymonth: encrypt(:expirymonth),
+        expiryyear: encrypt(:expiryyear),
+        merchantid: client.merchant_key
+      }
+
+      request_params[:bvn] = encrypt(:bvn) if options[:authmodel] == 'BVN'
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:tokenize_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments-with-preauth/#preauthorize
+    def preauthorize(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        currency: encrypt(:currency),
+        chargetoken: encrypt(:chargetoken),
+        country: encrypt(:country),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:preauthorize_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments-with-preauth/#capture
+    def capture(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        currency: encrypt(:currency),
+        country: encrypt(:country),
+        trxreference: encrypt(:trxreference),
+        trxauthorizeid: encrypt(:trxauthorizeid),
+        chargetoken: encrypt(:chargetoken),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:capture_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments-with-preauth/#refund
+    def refund(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        currency: encrypt(:currency),
+        country: encrypt(:country),
+        trxreference: encrypt(:trxreference),
+        trxauthorizeid: encrypt(:trxauthorizeid),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:refund_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments-with-preauth/#void
+    def void(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        currency: encrypt(:currency),
+        country: encrypt(:country),
+        trxreference: encrypt(:trxreference),
+        trxauthorizeid: encrypt(:trxauthorizeid),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:void_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-enquiry/ - Card Enquiry
+    def enquiry(options = {})
+      @options = options
+
+      request_params = {
+        cardno: encrypt(:cardno),
+        cvv: encrypt(:cvv),
+        expirymonth: encrypt(:expirymonth),
+        expiryyear: encrypt(:expiryyear),
+        pin: encrypt(:pin),
+        trxreference: encrypt(:trxreference),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:enquiry_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-enquiry/ - Validate
+    def validate_enquiry(options = {})
+      @options = options
+
+      request_params = {
+        otp: encrypt(:otp),
+        otptransactionidentifier: encrypt(:otptransactionidentifier),
+        trxreference: encrypt(:trxreference),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:validate_enquiry_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments/#tokenize-and-charge
+    def charge(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        authmodel: encrypt(:authmodel),
+        cardno: encrypt(:cardno),
+        currency: encrypt(:currency),
+        custid: encrypt(:custid),
+        country: encrypt(:country),
+        cvv: encrypt(:cvv),
+        expirymonth: encrypt(:expirymonth),
+        expiryyear: encrypt(:expiryyear),
+        narration: encrypt(:narration),
+        merchantid: client.merchant_key
+      }
+
+      request_params[:pin] = encrypt(:pin) if options[:authmodel] == 'PIN'
+
+      request_params[:bvn] = encrypt(:bvn) if options[:authmodel] == 'BVN'
+
+      request_params[:responseurl] = encrypt(:responseurl) if
+        options[:authmodel] == 'VBVSECURECODE'
+
+      request_params[:cardtype] = encrypt(:cardtype) if options[:cardtype]
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:charge_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments/#validate
+    def validate_charge(options = {})
+      @options = options
+
+      request_params = {
+        otp: encrypt(:otp),
+        otptransactionidentifier: encrypt(:otptransactionidentifier),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:validate_charge_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/card-payments/#recurrent-charge
+    def recurrent_charge(options = {})
+      @options = options
+      options[:country] ||= 'NG'
+
+      request_params = {
+        amount: encrypt(:amount),
+        currency: encrypt(:currency),
+        custid: encrypt(:custid),
+        country: encrypt(:country),
+        narration: encrypt(:narration),
+        chargetoken: encrypt(:chargetoken),
+        merchantid: client.merchant_key
+      }
+
+      request_params[:cardtype] = encrypt(:cardtype) if options[:cardtype]
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:charge_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    # https://www.flutterwave.com/documentation/check-transaction-status/
+    def verify(options = {})
+      @options = options
+
+      request_params = {
+        trxreference: encrypt(:trxreference),
+        merchantid: client.merchant_key
+      }
+
+      response = post(
+        Flutterwave::Utils::Constants::CARD[:verify_url],
+        request_params
+      )
+
+      Flutterwave::Response.new(response)
+    end
+
+    def encrypt(key)
+      plain_text = options[key].to_s
+      raise Flutterwave::Utils::MissingKeyError.new(
+        "#{key.capitalize} key required!"
+      ) if plain_text.empty?
+
+      encrypt_data(plain_text, client.api_key)
+    end
+  end
+end

data/lib/flutterwave/client.rb

@@ -0,0 +1,31 @@
+require 'flutterwave/utils/helpers'
+require 'flutterwave/utils/missing_key_error'
+require 'flutterwave/bvn'
+require 'flutterwave/bin'
+require 'flutterwave/ip'
+require 'flutterwave/bank'
+require 'flutterwave/card'
+require 'flutterwave/account'
+require 'flutterwave/ach'
+require 'flutterwave/pay'
+
+module Flutterwave
+  class Client
+    attr_accessor :merchant_key, :api_key, :bvn, :bin, :ip, :bank,
+                  :card, :account, :ach, :pay
+
+    def initialize(merchant_key, api_key)
+      @merchant_key = merchant_key
+      @api_key = api_key
+
+      @bvn = Flutterwave::BVN.new(self)
+      @bin = Flutterwave::BIN.new(self)
+      @ip = Flutterwave::IP.new(self)
+      @bank = Flutterwave::BankAPI.new(self)
+      @card = Flutterwave::Card.new(self)
+      @account = Flutterwave::Account.new(self)
+      @ach = Flutterwave::ACH.new(self)
+      @pay = Flutterwave::Pay.new(self)
+    end
+  end
+end