mpesa_stk 2.0.0 → 3.0.0

data/lib/mpesa_stk/c2b.rb

@@ -1,127 +1,44 @@
 # 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'
+require 'mpesa_stk/client'
 
 module MpesaStk
-  # Customer to Business API - register URLs and simulate C2B payments
-  class C2B
+  # Register C2B URLs and simulate customer-to-business payments.
+  class C2B < Client
     class << self
-      def register_url(hash = {})
-        new(hash).register
+      def register(**options)
+        new(**options).register
       end
 
-      def simulate(amount, phone_number, hash = {})
-        new(hash).simulate_payment(amount, phone_number)
+      def call(amount, phone_number, **options)
+        new(**options).simulate_payment(amount, phone_number)
       end
     end
 
-    attr_reader :token, :short_code, :response_type, :confirmation_url, :validation_url, :command_id, :bill_ref_number
-
-    def initialize(hash = {})
-      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
-      @short_code = hash['short_code'] || ENV.fetch('business_short_code', nil)
-      @response_type = hash['response_type'] || 'Completed'
-      @confirmation_url = hash['confirmation_url'] || ENV.fetch('confirmation_url', nil)
-      @validation_url = hash['validation_url']
-      @command_id = hash['command_id'] || 'CustomerPayBillOnline'
-      @bill_ref_number = hash['bill_ref_number'] || ''
-    end
-
     def register
-      response = HTTParty.post(register_url_endpoint, headers: headers, body: register_body)
-
-      raise StandardError, "Failed to register C2B URL: #{response.code} - #{response.body}" unless response.success?
-
-      JSON.parse(response.body)
-    end
-
-    def simulate_payment(amount, phone_number)
-      response = HTTParty.post(simulate_url_endpoint, headers: headers, body: simulate_body(amount, phone_number))
-
-      raise StandardError, "Failed to simulate C2B payment: #{response.code} - #{response.body}" unless response.success?
-
-      JSON.parse(response.body)
-    end
-
-    private
-
-    def register_url_endpoint
-      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('c2b_register_url', nil)}"
-    end
-
-    def simulate_url_endpoint
-      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('c2b_simulate_url', nil)}"
-    end
-
-    def headers
-      {
-        'Authorization' => "Bearer #{token}",
-        'Content-Type' => 'application/json'
-      }
-    end
-
-    def register_body
-      body_hash = {
-        ShortCode: get_short_code,
-        ResponseType: response_type,
-        ConfirmationURL: get_confirmation_url
+      body = {
+        ShortCode: option('business_short_code', :short_code),
+        ResponseType: @options.fetch(:response_type, 'Completed'),
+        ConfirmationURL: option('confirmation_url')
       }
-      body_hash[:ValidationURL] = validation_url if validation_url
-      body_hash.to_json
-    end
+      validation_url = optional_option('validation_url')
+      body[:ValidationURL] = validation_url if validation_url
 
-    def simulate_body(amount, phone_number)
-      {
-        ShortCode: get_short_code,
-        CommandID: command_id,
-        Amount: amount.to_s,
-        Msisdn: phone_number,
-        BillRefNumber: bill_ref_number
-      }.to_json
+      post('c2b_register_url', body, error_message: 'Failed to register C2B URL')
     end
 
-    def get_short_code
-      if short_code.nil? || short_code.eql?('')
-        raise ArgumentError, 'Short Code is not defined' if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
-
-        ENV.fetch('business_short_code', nil)
-
-      else
-        short_code
-      end
-    end
-
-    def get_confirmation_url
-      if confirmation_url.nil? || confirmation_url.eql?('')
-        raise ArgumentError, 'Confirmation URL is not defined' if ENV['confirmation_url'].nil? || ENV['confirmation_url'].eql?('')
-
-        ENV.fetch('confirmation_url', nil)
-
-      else
-        confirmation_url
-      end
+    def simulate_payment(amount, phone_number)
+      post(
+        'c2b_simulate_url',
+        {
+          ShortCode: option('business_short_code', :short_code),
+          CommandID: @options.fetch(:command_id, 'CustomerPayBillOnline'),
+          Amount: amount.to_s,
+          Msisdn: phone_number,
+          BillRefNumber: @options.fetch(:bill_ref_number, '')
+        },
+        error_message: 'Failed to simulate C2B payment'
+      )
     end
   end
 end

data/lib/mpesa_stk/client.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'date'
+require 'json'
+require 'mpesa_stk/config'
+require 'mpesa_stk/access_token'
+
+module MpesaStk
+  # Shared OAuth, HTTP, and configuration helpers for Daraja API clients
+  class Client
+    AUTH_KEYS = %i[key secret].freeze
+
+    def initialize(key: nil, secret: nil, **options)
+      @key = key
+      @secret = secret
+      @options = options
+    end
+
+    def token
+      @token ||= AccessToken.call(@key, @secret)
+    end
+
+    def post(path_env_key, body, error_message: 'Request failed')
+      url = "#{Config.fetch('base_url')}#{Config.fetch(path_env_key)}"
+      response = HTTParty.post(url, headers: json_headers, body: body.to_json)
+
+      raise StandardError, "#{error_message}: #{response.code} - #{response.body}" unless response.success?
+
+      JSON.parse(response.body)
+    end
+
+    def json_headers
+      {
+        'Authorization' => "Bearer #{token}",
+        'Content-Type' => 'application/json'
+      }
+    end
+
+    def stk_timestamp
+      DateTime.now.strftime('%Y%m%d%H%M%S').to_i
+    end
+
+    def stk_password(short_code, passkey, timestamp = stk_timestamp)
+      Base64.encode64("#{short_code}#{passkey}#{timestamp}").delete("\n")
+    end
+
+    def random_reference(length = 5)
+      charset = Array('A'..'Z') + Array('a'..'z')
+      Array.new(length) { charset.sample }.join
+    end
+
+    def option(env_key, keyword_key = nil)
+      keyword_key ||= env_key.to_s.tr('-', '_').to_sym
+      Config.fetch(env_key.to_s, @options[keyword_key])
+    end
+
+    def optional_option(env_key, keyword_key = nil)
+      keyword_key ||= env_key.to_s.tr('-', '_').to_sym
+      Config.env(env_key.to_s, @options[keyword_key])
+    end
+
+    def self.extract_auth_options(kwargs)
+      kwargs.slice(*AUTH_KEYS)
+    end
+  end
+end

data/lib/mpesa_stk/config.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module MpesaStk
+  # Central configuration: ENV defaults with optional overrides via MpesaStk.configure
+  class Config
+    class << self
+      attr_writer :settings
+
+      def settings
+        @settings ||= {}
+      end
+
+      def configure
+        yield(settings)
+      end
+
+      def env(name, override = nil)
+        override = nil if override.respond_to?(:empty?) && override.empty?
+
+        value = settings[name.to_sym]
+        value = settings[name.to_s] if value.nil? && settings.key?(name.to_s)
+        value = override unless override.nil?
+        value = ENV.fetch(name.to_s, nil) if value.nil? || (value.respond_to?(:empty?) && value.empty?)
+
+        value
+      end
+
+      def fetch(name, override = nil, label: nil)
+        value = env(name, override)
+        raise ArgumentError, "#{label || name} is not defined" if value.nil? || value.to_s.empty?
+
+        value
+      end
+    end
+  end
+end

data/lib/mpesa_stk/imsi.rb

@@ -1,70 +1,28 @@
 # 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'
+require 'mpesa_stk/client'
 
 module MpesaStk
-  # IMSI/SWAP Operations - query IMSI and SIM swap information for fraud prevention
-  class IMSI
+  # Check customer account type indicator (ATI) via IMSI API.
+  class IMSI < Client
     class << self
-      def check_ati(customer_number, hash = {}, version: 'v1')
-        new(hash).check_ati(customer_number, version)
+      def call(customer_number, version: 'v1', **options)
+        new(**options).check_ati(customer_number, version)
       end
     end
 
-    attr_reader :token
-
-    def initialize(hash = {})
-      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
-    end
-
     def check_ati(customer_number, version = 'v1')
-      endpoint = version == 'v2' ? '/imsi/v2/checkATI' : '/imsi/v1/checkATI'
-      response = HTTParty.post(url(endpoint), headers: headers, body: body(customer_number))
+      endpoint = version.to_s == 'v2' ? '/imsi/v2/checkATI' : '/imsi/v1/checkATI'
+      url = "#{Config.fetch('base_url')}#{endpoint}"
+      response = HTTParty.post(
+        url,
+        headers: json_headers,
+        body: { customerNumber: customer_number }.to_json
+      )
 
       raise StandardError, "Failed to check ATI: #{response.code} - #{response.body}" unless response.success?
 
       JSON.parse(response.body)
     end
-
-    private
-
-    def url(endpoint)
-      "#{ENV.fetch('base_url', nil)}#{endpoint}"
-    end
-
-    def headers
-      {
-        'Authorization' => "Bearer #{token}",
-        'Content-Type' => 'application/json'
-      }
-    end
-
-    def body(customer_number)
-      {
-        customerNumber: customer_number
-      }.to_json
-    end
   end
 end

data/lib/mpesa_stk/iot.rb

@@ -1,53 +1,37 @@
 # 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'
+require 'mpesa_stk/client'
 require 'securerandom'
 
 module MpesaStk
-  # IoT SIM Management & Messaging - manage SIM cards and send/receive messages for IoT devices
-  class IoT
+  # IoT SIM management and messaging via Safaricom SIM portal API.
+  class IoT < Client
     class << self
-      def sims(hash = {})
-        new(hash)
+      def call(action, *args, **options)
+        new(**options).public_send(action, *args)
       end
 
-      def messaging(hash = {})
-        new(hash)
+      def list_sims(**options)
+        new(**options).get_all_sims(
+          start_at_index: options.fetch(:start_at_index, 0),
+          page_size: options.fetch(:page_size, 10)
+        )
+      end
+
+      def send_message(msisdn, message, **options)
+        new(**options).send_single_message(msisdn, message)
       end
     end
 
-    attr_reader :token, :api_key, :vpn_group, :username
+    attr_reader :api_key, :vpn_group, :username
 
-    def initialize(hash = {})
-      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
-      @api_key = hash['api_key'] || ENV['iot_api_key'] || 'Yl4S3KEcr173mbeUdYdjf147IuG3rJ824ArMkP6Z'
-      @vpn_group = hash['vpn_group'] || ENV['vpn_group'] || ''
-      @username = hash['username'] || ENV['username'] || ''
+    def initialize(key: nil, secret: nil, api_key: nil, vpn_group: nil, username: nil, **options)
+      super(key: key, secret: secret, **options)
+      @api_key = Config.env('iot_api_key', api_key) || 'Yl4S3KEcr173mbeUdYdjf147IuG3rJ824ArMkP6Z'
+      @vpn_group = Config.env('vpn_group', vpn_group) || ''
+      @username = Config.env('username', username) || ''
     end
 
-    # SIM Operations
     def get_all_sims(start_at_index: 0, page_size: 10)
       post_request('/allsims', {
                      vpnGroup: [vpn_group],
@@ -58,27 +42,15 @@ module MpesaStk
     end
 
     def query_lifecycle_status(msisdn)
-      post_request('/queryLifeCycleStatus', {
-                     msisdn: msisdn,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/queryLifeCycleStatus', { msisdn: msisdn, vpnGroup: vpn_group, username: username })
     end
 
     def query_customer_info(msisdn)
-      post_request('/querycustomerinfo', {
-                     msisdn: msisdn,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/querycustomerinfo', { msisdn: msisdn, vpnGroup: vpn_group, username: username })
     end
 
     def sim_activation(msisdn)
-      post_request('/simactivation', {
-                     msisdn: msisdn,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/simactivation', { msisdn: msisdn, vpnGroup: vpn_group, username: username })
     end
 
     def get_activation_trends(start_date:, stop_date:)
@@ -100,11 +72,7 @@ module MpesaStk
     end
 
     def get_location_info(msisdn)
-      post_request('/getlocationinfo', {
-                     msisdn: msisdn,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/getlocationinfo', { msisdn: msisdn, vpnGroup: vpn_group, username: username })
     end
 
     def suspend_unsuspend_sub(msisdn, product, operation)
@@ -117,11 +85,8 @@ module MpesaStk
                    })
     end
 
-    # Messaging Operations
     def get_all_messages(page_no: 1, page_size: 10)
-      get_request("/getallmessages?pageNo=#{page_no}&pageSize=#{page_size}", {
-                    vpnGroup: vpn_group
-                  })
+      get_request("/getallmessages?pageNo=#{page_no}&pageSize=#{page_size}", { vpnGroup: vpn_group })
     end
 
     def search_messages(search_value, page_no: 1, page_size: 5)
@@ -152,28 +117,20 @@ module MpesaStk
     end
 
     def delete_message(message_id)
-      post_request('/deletemessage', {
-                     id: message_id,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/deletemessage', { id: message_id, vpnGroup: vpn_group, username: username })
     end
 
     def delete_message_thread(msisdn)
-      post_request('/deleteMessageThread', {
-                     msisdn: msisdn,
-                     vpnGroup: vpn_group,
-                     username: username
-                   })
+      post_request('/deleteMessageThread', { msisdn: msisdn, vpnGroup: vpn_group, username: username })
     end
 
     private
 
     def base_url
-      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('iot_base_url', nil)}"
+      "#{Config.fetch('base_url')}#{Config.fetch('iot_base_url')}"
     end
 
-    def headers(msisdn: nil)
+    def iot_headers(msisdn: nil)
       headers_hash = {
         'Authorization' => "Bearer #{token}",
         'Content-Type' => 'application/json',
@@ -188,7 +145,11 @@ module MpesaStk
     end
 
     def post_request(endpoint, body)
-      response = HTTParty.post("#{base_url}#{endpoint}", headers: headers(msisdn: body[:msisdn]), body: body.to_json)
+      response = HTTParty.post(
+        "#{base_url}#{endpoint}",
+        headers: iot_headers(msisdn: body[:msisdn]),
+        body: body.to_json
+      )
 
       raise StandardError, "Failed IoT request: #{response.code} - #{response.body}" unless response.success?
 
@@ -196,7 +157,7 @@ module MpesaStk
     end
 
     def get_request(endpoint, body)
-      response = HTTParty.post("#{base_url}#{endpoint}", headers: headers, body: body.to_json)
+      response = HTTParty.post("#{base_url}#{endpoint}", headers: iot_headers, body: body.to_json)
 
       raise StandardError, "Failed IoT request: #{response.code} - #{response.body}" unless response.success?
 

data/lib/mpesa_stk/pull_transactions.rb

@@ -1,126 +1,44 @@
 # 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'
+require 'mpesa_stk/client'
 
 module MpesaStk
-  # Pull Transactions API - register URLs and query historical transaction data
-  class PullTransactions
+  # Register and query pull transaction callbacks.
+  class PullTransactions < Client
     class << self
-      def register(hash = {})
-        new(hash).register_url
+      def register(**options)
+        new(**options).register_url
       end
 
-      def query(start_date, end_date, hash = {})
-        new(hash).query_transactions(start_date, end_date)
+      def call(start_date, end_date, **options)
+        new(**options).query_transactions(start_date, end_date)
       end
     end
 
-    attr_reader :token, :short_code, :request_type, :nominated_number, :callback_url, :offset_value
-
-    def initialize(hash = {})
-      @token = MpesaStk::AccessToken.call(hash['key'], hash['secret'])
-      @short_code = hash['short_code'] || ENV.fetch('business_short_code', nil)
-      @request_type = hash['request_type'] || ''
-      @nominated_number = hash['nominated_number'] || ''
-      @callback_url = hash['callback_url'] || ENV.fetch('callback_url', nil)
-      @offset_value = hash['offset_value'] || '0'
-    end
-
     def register_url
-      response = HTTParty.post(register_endpoint, headers: headers, body: register_body)
-
-      unless response.success?
-        raise StandardError, "Failed to register pull transactions URL: #{response.code} - #{response.body}"
-      end
-
-      JSON.parse(response.body)
+      post(
+        'pull_transactions_register_url',
+        {
+          ShortCode: option('business_short_code', :short_code),
+          RequestType: @options.fetch(:request_type, ''),
+          NominatedNumber: @options.fetch(:nominated_number, ''),
+          CallBackURL: option('callback_url')
+        },
+        error_message: 'Failed to register pull transactions URL'
+      )
     end
 
     def query_transactions(start_date, end_date)
-      response = HTTParty.post(query_endpoint, headers: headers, body: query_body(start_date, end_date))
-
-      raise StandardError, "Failed to query pull transactions: #{response.code} - #{response.body}" unless response.success?
-
-      JSON.parse(response.body)
-    end
-
-    private
-
-    def register_endpoint
-      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('pull_transactions_register_url', nil)}"
-    end
-
-    def query_endpoint
-      "#{ENV.fetch('base_url', nil)}#{ENV.fetch('pull_transactions_query_url', nil)}"
-    end
-
-    def headers
-      {
-        'Authorization' => "Bearer #{token}",
-        'Content-Type' => 'application/json'
-      }
-    end
-
-    def register_body
-      {
-        ShortCode: get_short_code,
-        RequestType: request_type,
-        NominatedNumber: nominated_number,
-        CallBackURL: get_callback_url
-      }.to_json
-    end
-
-    def query_body(start_date, end_date)
-      {
-        ShortCode: get_short_code,
-        StartDate: start_date,
-        EndDate: end_date,
-        OffSetValue: offset_value
-      }.to_json
-    end
-
-    def get_short_code
-      if short_code.nil? || short_code.eql?('')
-        raise ArgumentError, 'Short Code is not defined' if ENV['business_short_code'].nil? || ENV['business_short_code'].eql?('')
-
-        ENV.fetch('business_short_code', nil)
-
-      else
-        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
+      post(
+        'pull_transactions_query_url',
+        {
+          ShortCode: option('business_short_code', :short_code),
+          StartDate: start_date,
+          EndDate: end_date,
+          OffSetValue: @options.fetch(:offset_value, '0')
+        },
+        error_message: 'Failed to query pull transactions'
+      )
     end
   end
 end