mpesarb 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b9bb17e2e11d77e25e40681e8ba6f0405c21fe95d46765701e38506a6956c15
-  data.tar.gz: 829d6f538edb26ff125ef9e86f1d3f04c1cde4457ed02b682c188af219b4e7b0
+  metadata.gz: d5629d27ad035e58f3526e8b9e255296fa18b693b1267d6ba99e6825acd6cf8f
+  data.tar.gz: 9af526343130143acae5a8fbce51105738876e33582e73e232bace44fb1d3ef2
 SHA512:
-  metadata.gz: 39cd7e301abc42110303bfec0ffdb0dbdaed6536a123ede46894ba5489809a07edd473420dea54d66aa8451906884355c80cf6f2d20737ae94ad3b77149e2288
-  data.tar.gz: 9380d06c1bee67f1ff54aa03eb535fd2eb876e5bfdcaa2b02681368935db092171ace55c94d84d36cd0e3c9e6247e311e7d03bcd882e8f1e2b50ca6848099215
+  metadata.gz: 31c766e363b1bc3c2295c9b54509cc123a4464d67d7c3162a5268e09801d500a01add96d8ee216e1e4dbd361186295500fc9184693eac31348ded4ab008c6747
+  data.tar.gz: 55fe4ce347865ee6e5ea4587434bece73d2a9cac219a922c5df323c62e061384524ebb9980fe27f5f65d210e5cf5f4eea8dfc9d491eb9f1ea342be0cf4b71475

data/Dockerfile

@@ -1,6 +1,7 @@
 FROM ruby:rc-alpine3.10
 # update and upgrade packages
-RUN apk update && apk upgrade
+RUN apk update && apk upgrade && \
+  apk add build-base openssl-dev git
 
 # Create non-root user
 RUN addgroup -S admin -g 1000 && adduser -S -g '' -u 1000 -G admin deploy
@@ -17,7 +18,7 @@ USER deploy
 WORKDIR /mpesa
 
 # install gem bundler
-RUN gem install bundler
+RUN gem install bundler -v 2.4.22
 
 # create a Gem
 #RUN bundle gem ruby_mpesa

data/README.md

@@ -59,7 +59,7 @@ Register C2B Urls( confirmation and validation url)
  response.ResponseDescription # "success"  
 ```
 
-### STK (LPNMO)
+### STK (LPNMO)/M-Pesa Express
 
 Lipa na mpesa online(Stk Push)
 
@@ -78,6 +78,18 @@ response.CheckoutRequestID # "ws_CO_040920212326513616"
 response.inspect # to see all available attributes
 ```
 
+### STK Query
+
+Check the status of a Lipa na M-Pesa Online transaction.
+
+```ruby
+response = client.stk_query(
+  checkout_request_id: "ws_CO_040920212326513616"
+)
+
+response.ResultCode # "1032"
+response.ResultDesc # "Request Cancelled by user."
+```
 
 ### B2C (Payout)
 

data/docker-compose.yml

@@ -4,3 +4,6 @@ services:
     build: .
     volumes:
       - .:/mpesa
+      - bundle:/usr/local/bundle
+volumes:
+  bundle:

data/lib/mpesa/client.rb

@@ -28,6 +28,10 @@ module Mpesa
       Stk.new(self, args).call
     end
 
+    def stk_query(**args)
+      StkQuery.new(self, args).call
+    end
+
     def payout(**args)
       Payout.new(self, args).call
     end

data/lib/mpesa/resources/stk_query.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'base64'
+
+module Mpesa
+  class StkQuery < Resource
+    PATH = 'mpesa/stkpushquery/v1/query'
+
+    def call
+      Object.new post_request(url: PATH, body: body).body
+    end
+
+    def body
+      {
+        'BusinessShortCode': shortcode,
+        'Password': password,
+        'Timestamp': timestamp,
+        'CheckoutRequestID': args[:checkout_request_id]
+      }
+    end
+
+    def password
+      Base64.strict_encode64("#{shortcode}#{args[:pass_key] || client.pass_key}#{timestamp}")
+    end
+
+    def timestamp
+      Time.now.strftime('%Y%m%d%H%M%S')
+    end
+
+    def shortcode
+      args[:shortcode] || client.shortcode
+    end
+  end
+end

data/lib/mpesa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mpesa
-  VERSION = '0.3.5'
+  VERSION = '0.3.6'
 end

data/lib/mpesa.rb

@@ -13,6 +13,7 @@ module Mpesa
   autoload :Register, 'mpesa/resources/register'
   autoload :Token, 'mpesa/resources/token'
   autoload :Stk, 'mpesa/resources/stk'
+  autoload :StkQuery, 'mpesa/resources/stk_query'
   autoload :Payout, 'mpesa/resources/payout'
   autoload :Status, 'mpesa/resources/status'
   autoload :Balance, 'mpesa/resources/balance'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mpesarb
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - Moses Gathuku
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-10-21 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -214,6 +213,7 @@ files:
 - lib/mpesa/resources/reversal.rb
 - lib/mpesa/resources/status.rb
 - lib/mpesa/resources/stk.rb
+- lib/mpesa/resources/stk_query.rb
 - lib/mpesa/resources/token.rb
 - lib/mpesa/securitycred.rb
 - lib/mpesa/version.rb
@@ -225,7 +225,6 @@ metadata:
   homepage_uri: https://github.com/gathuku/ruby_mpesa
   source_code_uri: https://github.com/gathuku/mpesa
   changelog_uri: https://github.com/gathuku/mpesa
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -240,8 +239,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: a simple gem to integrate ruby with mpesa Apis
 test_files: []