mpesa_stk 1.3 → 2.0.0

data/lib/mpesa_stk/push.rb

@@ -1,20 +1,50 @@
-require "mpesa_stk/access_token"
+# frozen_string_literal: true
+
+# Copyright (c) 2018 mboya
+#
+# MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'date'
+require 'mpesa_stk/access_token'
 
 module MpesaStk
+  # Initiates STK Push payment for multiple applications with custom credentials
   class Push
     class << self
       def pay_bill(amount, phone_number, hash = {})
-        new(amount, phone_number, "CustomerPayBillOnline", nil, hash["business_short_code"], hash["callback_url"], hash["business_passkey"], hash["key"], hash["secret"]).push_payment
+        new(amount, phone_number, 'CustomerPayBillOnline', nil, hash['business_short_code'], hash['callback_url'],
+            hash['business_passkey'], hash['key'], hash['secret']).push_payment
       end
 
       def buy_goods(amount, phone_number, hash = {})
-        new(amount, phone_number, "CustomerBuyGoodsOnline", hash["till_number"], hash["business_short_code"], hash["callback_url"], hash["business_passkey"], hash["key"], hash["secret"]).push_payment
+        new(amount, phone_number, 'CustomerBuyGoodsOnline', hash['till_number'], hash['business_short_code'],
+            hash['callback_url'], hash['business_passkey'], hash['key'], hash['secret']).push_payment
       end
     end
 
-    attr_reader :token, :amount, :phone_number, :till_number, :business_short_code, :callback_url, :business_passkey, :transaction_type
+    attr_reader :token, :amount, :phone_number, :till_number, :business_short_code, :callback_url, :business_passkey,
+                :transaction_type
 
-    def initialize(amount, phone_number, transaction_type, till_number = nil, business_short_code = nil, callback_url = nil, business_passkey = nil, key = nil, secret = nil)
+    def initialize(amount, phone_number, transaction_type, till_number = nil, business_short_code = nil,
+                   callback_url = nil, business_passkey = nil, key = nil, secret = nil)
       @token = MpesaStk::AccessToken.call(key, secret)
       @transaction_type = transaction_type
       @till_number = till_number
@@ -27,19 +57,22 @@ module MpesaStk
 
     def push_payment
       response = HTTParty.post(url, headers: headers, body: body)
+
+      raise StandardError, "Failed to push payment: #{response.code} - #{response.body}" unless response.success?
+
       JSON.parse(response.body)
     end
 
     private
 
     def url
-      "#{ENV['base_url']}#{ENV['process_request_url']}"
+      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('process_request_url', nil)}"
     end
 
     def headers
       {
-        "Authorization" => "Bearer #{token}",
-        "Content-Type" => "application/json"
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
       }
     end
 
@@ -47,12 +80,12 @@ module MpesaStk
       {
         BusinessShortCode: get_business_short_code,
         Password: generate_password,
-        Timestamp: "#{timestamp}",
+        Timestamp: timestamp.to_s,
         TransactionType: transaction_type,
-        Amount: "#{amount}",
-        PartyA: "#{phone_number}",
+        Amount: amount.to_s,
+        PartyA: phone_number.to_s,
         PartyB: get_till_number,
-        PhoneNumber: "#{phone_number}",
+        PhoneNumber: phone_number.to_s,
         CallBackURL: get_callback_url,
         AccountReference: generate_bill_reference_number(5),
         TransactionDesc: generate_bill_reference_number(5)
@@ -65,7 +98,7 @@ module MpesaStk
     end
 
     def timestamp
-      DateTime.now.strftime("%Y%m%d%H%M%S").to_i
+      DateTime.now.strftime('%Y%m%d%H%M%S').to_i
     end
 
     # shortcode
@@ -77,55 +110,51 @@ module MpesaStk
     end
 
     def get_business_short_code
-      if business_short_code.nil? || business_short_code.eql?("")
-        if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?("")
-          raise Exception.new "Business Short Code is not defined"
-        else
-          ENV['business_short_code']
+      if business_short_code.nil? || business_short_code.eql?('')
+        if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
+          raise ArgumentError, 'Business Short Code is not defined'
         end
+
+        ENV.fetch('business_short_code', nil)
+
       else
         business_short_code
       end
     end
 
     def get_business_passkey
-      if business_passkey.nil? || business_passkey.eql?("")
-        if ENV['business_passkey'].nil? || ENV['business_passkey'].eql?("")
-          raise Exception.new "Business Passkey is not defined"
-        else
-          ENV['business_passkey']
-        end
+      if business_passkey.nil? || business_passkey.eql?('')
+        raise ArgumentError, 'Business Passkey is not defined' if ENV['business_passkey'].nil? || ENV['business_passkey'].eql?('')
+
+        ENV.fetch('business_passkey', nil)
+
       else
         business_passkey
       end
     end
 
     def get_callback_url
-      if callback_url.nil? || callback_url.eql?("")
-        if ENV['callback_url'].nil? || ENV['callback_url'].eql?("")
-          raise Exception.new "Callback URL is not defined"
-        else
-          ENV['callback_url']
-        end
+      if callback_url.nil? || callback_url.eql?('')
+        raise ArgumentError, 'Callback URL is not defined' if ENV['callback_url'].nil? || ENV['callback_url'].eql?('')
+
+        ENV.fetch('callback_url', nil)
+
       else
         callback_url
       end
     end
 
     def get_till_number
-      if transaction_type.eql?("CustomerPayBillOnline")
+      if transaction_type.eql?('CustomerPayBillOnline')
         get_business_short_code
+      elsif till_number.nil?
+        raise ArgumentError, 'Till number is not defined' if ENV['till_number'].nil? || ENV['till_number'].eql?('')
+
+        ENV.fetch('till_number', nil)
+
       else
-        if till_number.nil?
-          if ENV['till_number'].nil? || ENV['till_number'].eql?("")
-            raise Exception.new "Till number is not defined"
-          else
-            ENV['till_number']
-          end
-        else
-          till_number
-        end
+        till_number
       end
     end
   end
-end
+end

data/lib/mpesa_stk/push_payment.rb

@@ -1,6 +1,32 @@
-require "mpesa_stk/access_token"
+# frozen_string_literal: true
+
+# Copyright (c) 2018 mboya
+#
+# MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'date'
+require 'mpesa_stk/access_token'
 
 module MpesaStk
+  # Initiates STK Push payment for a single application using ENV variables
   class PushPayment
     class << self
       def call(amount, phone_number)
@@ -18,33 +44,36 @@ module MpesaStk
 
     def push_payment
       response = HTTParty.post(url, headers: headers, body: body)
+
+      raise StandardError, "Failed to push payment: #{response.code} - #{response.body}" unless response.success?
+
       JSON.parse(response.body)
     end
 
     private
 
     def url
-      "#{ENV['base_url']}#{ENV['process_request_url']}"
+      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('process_request_url', nil)}"
     end
 
     def headers
       {
-        "Authorization" => "Bearer #{token}",
-        "Content-Type" => "application/json"
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
       }
     end
 
     def body
       {
-        BusinessShortCode: "#{ENV['business_short_code']}",
+        BusinessShortCode: ENV.fetch('business_short_code', nil).to_s,
         Password: generate_password,
-        Timestamp: "#{timestamp}",
-        TransactionType: "CustomerPayBillOnline",
-        Amount: "#{amount}",
-        PartyA: "#{phone_number}",
-        PartyB: "#{ENV['business_short_code']}",
-        PhoneNumber: "#{phone_number}",
-        CallBackURL: "#{ENV['callback_url']}",
+        Timestamp: timestamp.to_s,
+        TransactionType: 'CustomerPayBillOnline',
+        Amount: amount.to_s,
+        PartyA: phone_number.to_s,
+        PartyB: ENV.fetch('business_short_code', nil).to_s,
+        PhoneNumber: phone_number.to_s,
+        CallBackURL: ENV.fetch('callback_url', nil).to_s,
         AccountReference: generate_bill_reference_number(5),
         TransactionDesc: generate_bill_reference_number(5)
       }.to_json
@@ -56,16 +85,15 @@ module MpesaStk
     end
 
     def timestamp
-      DateTime.now.strftime("%Y%m%d%H%M%S").to_i
+      DateTime.now.strftime('%Y%m%d%H%M%S').to_i
     end
 
     # shortcode
     # passkey
     # timestamp
     def generate_password
-      key = "#{ENV['business_short_code']}#{ENV['business_passkey']}#{timestamp}"
+      key = "#{ENV.fetch('business_short_code', nil)}#{ENV.fetch('business_passkey', nil)}#{timestamp}"
       Base64.encode64(key).split("\n").join
     end
-
   end
-end
+end

data/lib/mpesa_stk/ratiba.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018 mboya
+#
+# MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'mpesa_stk/access_token'
+
+module MpesaStk
+  # M-Pesa Ratiba (Standing Orders) - create recurring payments
+  class Ratiba
+    class << self
+      def create_standing_order(hash = {})
+        new(hash).create
+      end
+    end
+
+    attr_reader :token, :standing_order_name, :business_short_code, :transaction_type, :amount, :party_a,
+                :receiver_party_identifier_type, :callback_url, :account_reference, :transaction_desc,
+                :frequency, :start_date, :end_date
+
+    def initialize(hash = {})
+      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
+      @standing_order_name = hash['standing_order_name'] || 'Standing Order'
+      @business_short_code = hash['business_short_code'] || ENV.fetch('business_short_code', nil)
+      @transaction_type = hash['transaction_type'] || 'Standing Order Customer Pay Bill'
+      @amount = hash['amount']
+      @party_a = hash['party_a']
+      @receiver_party_identifier_type = hash['receiver_party_identifier_type'] || '4'
+      @callback_url = hash['callback_url'] || ENV.fetch('callback_url', nil)
+      @account_reference = hash['account_reference'] || ''
+      @transaction_desc = hash['transaction_desc'] || ''
+      @frequency = hash['frequency'] || '3'
+      @start_date = hash['start_date']
+      @end_date = hash['end_date']
+    end
+
+    def create
+      response = HTTParty.post(url, headers: headers, body: body)
+
+      raise StandardError, "Failed to create standing order: #{response.code} - #{response.body}" unless response.success?
+
+      JSON.parse(response.body)
+    end
+
+    private
+
+    def url
+      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('ratiba_url', nil)}"
+    end
+
+    def headers
+      {
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
+      }
+    end
+
+    def body
+      {
+        StandingOrderName: standing_order_name,
+        BusinessShortCode: get_business_short_code,
+        TransactionType: transaction_type,
+        Amount: amount.to_s,
+        PartyA: party_a,
+        ReceiverPartyIdentifierType: receiver_party_identifier_type,
+        CallBackURL: get_callback_url,
+        AccountReference: account_reference,
+        TransactionDesc: transaction_desc,
+        Frequency: frequency,
+        StartDate: start_date,
+        EndDate: end_date
+      }.to_json
+    end
+
+    def get_business_short_code
+      if business_short_code.nil? || business_short_code.eql?('')
+        if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
+          raise ArgumentError, 'Business Short Code is not defined'
+        end
+
+        ENV.fetch('business_short_code', nil)
+
+      else
+        business_short_code
+      end
+    end
+
+    def get_callback_url
+      if callback_url.nil? || callback_url.eql?('')
+        raise ArgumentError, 'Callback URL is not defined' if ENV['callback_url'].nil? || ENV['callback_url'].eql?('')
+
+        ENV.fetch('callback_url', nil)
+
+      else
+        callback_url
+      end
+    end
+  end
+end

data/lib/mpesa_stk/reversal.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018 mboya
+#
+# MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'mpesa_stk/access_token'
+
+module MpesaStk
+  # Reverse M-Pesa transactions (full or partial)
+  class Reversal
+    class << self
+      def reverse(transaction_id, amount, hash = {})
+        new(transaction_id, amount, hash).reverse_transaction
+      end
+    end
+
+    attr_reader :token, :transaction_id, :amount, :initiator, :security_credential, :receiver_party,
+                :receiver_identifier_type, :result_url, :queue_timeout_url
+
+    def initialize(transaction_id, amount, hash = {})
+      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
+      @transaction_id = transaction_id
+      @amount = amount
+      @initiator = hash['initiator'] || ENV.fetch('initiator', nil)
+      @security_credential = hash['security_credential'] || ENV.fetch('security_credential', nil)
+      @receiver_party = hash['receiver_party'] || ENV.fetch('business_short_code', nil)
+      @receiver_identifier_type = hash['receiver_identifier_type'] || '4'
+      @result_url = hash['result_url'] || ENV.fetch('result_url', nil)
+      @queue_timeout_url = hash['queue_timeout_url'] || ENV.fetch('queue_timeout_url', nil)
+    end
+
+    def reverse_transaction
+      response = HTTParty.post(url, headers: headers, body: body)
+
+      raise StandardError, "Failed to reverse transaction: #{response.code} - #{response.body}" unless response.success?
+
+      JSON.parse(response.body)
+    end
+
+    private
+
+    def url
+      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('reversal_url', nil)}"
+    end
+
+    def headers
+      {
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
+      }
+    end
+
+    def body
+      {
+        Initiator: get_initiator,
+        SecurityCredential: get_security_credential,
+        CommandID: 'TransactionReversal',
+        TransactionID: transaction_id,
+        Amount: amount.to_s,
+        ReceiverParty: get_receiver_party,
+        RecieverIdentifierType: receiver_identifier_type,
+        ResultURL: get_result_url,
+        QueueTimeOutURL: get_queue_timeout_url
+      }.to_json
+    end
+
+    def get_initiator
+      if initiator.nil? || initiator.eql?('')
+        raise ArgumentError, 'Initiator is not defined' if ENV['initiator'].nil? || ENV['initiator'].eql?('')
+
+        ENV.fetch('initiator', nil)
+
+      else
+        initiator
+      end
+    end
+
+    def get_security_credential
+      if security_credential.nil? || security_credential.eql?('')
+        if ENV['security_credential'].nil? || ENV['security_credential'].eql?('')
+          raise ArgumentError, 'Security Credential is not defined'
+        end
+
+        ENV.fetch('security_credential', nil)
+
+      else
+        security_credential
+      end
+    end
+
+    def get_receiver_party
+      if receiver_party.nil? || receiver_party.eql?('')
+        if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
+          raise ArgumentError, 'Receiver Party (Business Short Code) is not defined'
+        end
+
+        ENV.fetch('business_short_code', nil)
+
+      else
+        receiver_party
+      end
+    end
+
+    def get_result_url
+      if result_url.nil? || result_url.eql?('')
+        raise ArgumentError, 'Result URL is not defined' if ENV['result_url'].nil? || ENV['result_url'].eql?('')
+
+        ENV.fetch('result_url', nil)
+
+      else
+        result_url
+      end
+    end
+
+    def get_queue_timeout_url
+      if queue_timeout_url.nil? || queue_timeout_url.eql?('')
+        if ENV['queue_timeout_url'].nil? || ENV['queue_timeout_url'].eql?('')
+          raise ArgumentError, 'Queue Timeout URL is not defined'
+        end
+
+        ENV.fetch('queue_timeout_url', nil)
+
+      else
+        queue_timeout_url
+      end
+    end
+  end
+end

data/lib/mpesa_stk/stk_push_query.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018 mboya
+#
+# MIT License
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'date'
+require 'mpesa_stk/access_token'
+
+module MpesaStk
+  # Query STK Push transaction status using CheckoutRequestID
+  class StkPushQuery
+    class << self
+      def query(checkout_request_id, hash = {})
+        new(checkout_request_id, hash).query_status
+      end
+    end
+
+    attr_reader :token, :checkout_request_id, :business_short_code, :business_passkey
+
+    def initialize(checkout_request_id, hash = {})
+      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
+      @checkout_request_id = checkout_request_id
+      @business_short_code = hash['business_short_code'] || ENV.fetch('business_short_code', nil)
+      @business_passkey = hash['business_passkey'] || ENV.fetch('business_passkey', nil)
+    end
+
+    def query_status
+      response = HTTParty.post(url, headers: headers, body: body)
+
+      raise StandardError, "Failed to query STK push status: #{response.code} - #{response.body}" unless response.success?
+
+      JSON.parse(response.body)
+    end
+
+    private
+
+    def url
+      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('stk_push_query_url', nil)}"
+    end
+
+    def headers
+      {
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
+      }
+    end
+
+    def body
+      {
+        BusinessShortCode: get_business_short_code,
+        Password: generate_password,
+        Timestamp: timestamp.to_s,
+        CheckoutRequestID: checkout_request_id
+      }.to_json
+    end
+
+    def timestamp
+      DateTime.now.strftime('%Y%m%d%H%M%S').to_i
+    end
+
+    def generate_password
+      key = "#{get_business_short_code}#{get_business_passkey}#{timestamp}"
+      Base64.encode64(key).split("\n").join
+    end
+
+    def get_business_short_code
+      if business_short_code.nil? || business_short_code.eql?('')
+        if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
+          raise ArgumentError, 'Business Short Code is not defined'
+        end
+
+        ENV.fetch('business_short_code', nil)
+
+      else
+        business_short_code
+      end
+    end
+
+    def get_business_passkey
+      if business_passkey.nil? || business_passkey.eql?('')
+        raise ArgumentError, 'Business Passkey is not defined' if ENV['business_passkey'].nil? || ENV['business_passkey'].eql?('')
+
+        ENV.fetch('business_passkey', nil)
+
+      else
+        business_passkey
+      end
+    end
+  end
+end