paymentsds-mpesa 0.1.0.pre.alpha.27 → 0.1.0.pre.alpha.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6af0c9d99ed40864b592134ec7dba1896348da77525a6a7f748d1124a28b57c9
-  data.tar.gz: 66c7f14a413d93480182372ecf673a1b040569fb0ab0210cda9db5d9eee185fa
+  metadata.gz: 698bacf39217bd0ec2d8a515ac12dcc503cf53460a1a2a924705c7c0dc6a04f4
+  data.tar.gz: 3a2658187038669829a88207df6f17dab61d42597cfe9b6a62c56f349de24ea2
 SHA512:
-  metadata.gz: 5773f8c8a3d6d43b0245104f27e385dfe2ca2666ecd265cbc981f0d352da79ea7806db4089a275f295af612bc9c2dfeb95812de5d1480e3e865038eb65dcf96b
-  data.tar.gz: a4ab7bc50b4da802fe0ebd55e3cf0600b9f85c399ad5084ac70cea16b6295826e9a7f0c2ceedb7c11193f961145c0c271b0bf76774d749fa3c595c5190e2f438
+  metadata.gz: dc9b3150e581a24ffb48d84a346399d71781430eade8e0df7c2b217b51c79e8b990dbe785253f4d48774266d7a697966fd051d2704beab4394c8d7cbc3d4989c
+  data.tar.gz: 9080abb4e22cab13b3ff779fe0b6d1a4b0bd15a7859290a52ebbcc2b5a4a173fd5554a0a440952dbc5d9b1b31d57471ac9c445f3c180c868a46d4300bdca28be

data/.gitignore

@@ -10,4 +10,4 @@
 /Gemfile.lock
 # rspec failure tracking
 .rspec_status
-
+*.gem

data/lib/paymentsds/mpesa/errors/constants.rb

@@ -0,0 +1,51 @@
+module Paymentsds
+    module MPesa
+        INS0 = "INS-0"
+        INS18 = "INS-18"
+        INS19 = "INS-19"
+        INS20 = "INS-20"
+        INS21 = "INS-21"
+        INS22 = "INS-22"
+        INS23 = "INS-23"
+        INS24 = "INS-24"
+        INS25 = "INS-25"
+        INS993 = "INS-993"
+        INS994 = "INS-994"
+        INS995 = "INS-995"
+        INS996 = "INS-996"
+        INS997 = "INS-997"
+        INS998 = "INS-998"
+        INS2001 = "INS-2001"
+        INS2002 = "INS-2002"
+        INS2051 = "INS-2051"
+        INS2057 = "INS-2057"
+
+        DIRECT_DEBT = "DIRECT_DEBT"
+        DUPLICATE_TRANSACTION = "DUPLICATE_TRANSACTION"
+        INSUFICIENT_BALANCE = "INSUFICIENT_BALANCE"
+        INVALID_AMOUNT = "INVALID_AMOUNT"
+        INVALID_MISSING_PROPERTIES = "INVALID_MISSING_PROPERTIES"
+        INVALID_RECEIVER = "INVALID_RECEIVER"
+        INVALID_REFERENCE = "INVALID_REFERENCE"
+        INVALID_SECURITY_CREDENTIAL = "INVALID_SECURITY_CREDENTIAL"
+        INVALID_SHORTCODE = "INVALID_SHORTCODE"
+        INVALID_THIRDPARTY_REFERENCE = "INVALID_THIRDPARTY_REFERENCE"
+        INVALID_TRANSACTION_ID = "INVALID_TRANSACTION_ID"
+        INVALID_TRANSACTION_REFERENCE = "INVALID_TRANSACTION_INVALID_TRANSACTION_REFERENCE"
+        REQUEST_TIMEOUT = "REQUEST_TIMEOUT"
+        TRANSACTION_CANCELLED = "TRANSACTION_CANCELLED"
+        TRANSACTION_FAILED = "TRANSACTION_FAILED"
+        UNAVAILABLE_SERVER = "UNAVAILABLE_SERVER"
+        UNKNOWN_STATUS = "UNKNOWN_STATUS"
+        UNKNOWN = "UNKNOWN"
+        VALIDATION = "VALIDATION"
+        INVALID_INITIATOR_IDENTIFIER = "INVALID_INITIATOR_IDENTIFIER"
+        INVALID_LANGUAGE_CODE = "INVALID_LANGUAGE_CODE"
+        INVALID_MARKET = "INVALID_MARKET"
+        INVALID_MSISDN = "INVALID_MSISDN"
+        PROFILE_PROBLEMS = "PROFILE_PROBLEMS"
+        INACTIVE_ACCOUNT = "INACTIVE_ACCOUNT"
+        INITIATOR_AUTHENTICATION = "INITIATOR_AUTHENTICATION"
+        PROFILE_PROBLEMS = "PROFILE_PROBLEMS"
+    end
+end

data/lib/paymentsds/mpesa/errors/direct_debt_missing.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class DirectDebtMissingError < StandardError
+            def initialize(msg=Paymentsds::MPesa::DIRECT_DEBT)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/duplicate_direct_debt.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class DuplicateDirectDebtError < StandardError
+            def initialize(msg=Paymentsds::MPesa::DUPLICATE_TRANSACTION)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/errors.rb

@@ -0,0 +1,26 @@
+require_relative "constants"
+require_relative "direct_debt_missing"
+require_relative "duplicate_direct_debt"
+require_relative "inactive_account"
+require_relative "initiator_authentication"
+require_relative "insuficient_balance"
+require_relative "invalid_initiator_identifier"
+require_relative "invalid_market"
+require_relative "invalid_language_code"
+require_relative "invalid_msisdn"
+require_relative "profile_problems"
+require_relative "invalid_amount"
+require_relative "invalid_missing_properties"
+require_relative "invalid_receiver"
+require_relative "invalid_reference"
+require_relative "invalid_security_credential"
+require_relative "invalid_shortcode"
+require_relative "invalid_thirdparty_reference"
+require_relative "invalid_transaction_id"
+require_relative "invalid_transaction_reference"
+require_relative "request_timeout"
+require_relative "transaction_cancelled"
+require_relative "transaction_failed"
+require_relative "unavailable_server"
+require_relative "unknown_status"
+require_relative "unknown"

data/lib/paymentsds/mpesa/errors/inactive_account.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InactiveAccountError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INACTIVE_ACCOUNT)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/initiator_authentication.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InitiatorAuthenticationError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INITIATOR_AUTHENTICATION)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/insuficient_balance.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InsuficientBalanceError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INSUFICIENT_BALANCE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_amount.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidAmountError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_AMOUNT)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_initiator_identifier.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidInitiatorIdentifierError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_INITIATOR_IDENTIFIER)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_language_code.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidLanguageCodeError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_LANGUAGE_CODE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_market.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidMarketError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_MARKET)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_missing_properties.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidMissingPropertiesError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_MISSING_PROPERTIES)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_msisdn.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidMSISDNError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_MSISDN)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_receiver.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidReceiverError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_RECEIVER)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_reference.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidReferenceError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_REFERENCE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_security_credential.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidSecurityCredentialError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_SECURITY_CREDENTIAL)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_shortcode.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidShortcodeError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_SHORTCODE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_thirdparty_reference.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidThirdPartyReferenceError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_THIRDPARTY_REFERENCE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_transaction_id.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class TransactionIdError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_TRANSACTION_ID)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/invalid_transaction_reference.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class InvalidTransactionReferenceError < StandardError
+            def initialize(msg=Paymentsds::MPesa::INVALID_TRANSACTION_REFERENCE)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/profile_problems.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class ProfileProblemsError < StandardError
+            def initialize(msg=Paymentsds::MPesa::PROFILE_PROBLEMS)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/request_timeout.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class ProfileProblemsError < StandardError
+            def initialize(msg=Paymentsds::MPesa::PROFILE_PROBLEMS)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/transaction_cancelled.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class TransactionCancelledError < StandardError
+            def initialize(msg=Paymentsds::MPesa::TRANSACTION_CANCELLED)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/transaction_failed.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class TransactionFailedError < StandardError
+            def initialize(msg=Paymentsds::MPesa::TRANSACTION_FAILED)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/unavailabe_server.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class UnavailableServerError < StandardError
+            def initialize(msg=Paymentsds::MPesa::UNAVAILABLE_SERVER)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/unknown.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class UnknownError < StandardError
+            def initialize(msg=Paymentsds::MPesa::UNKNOWN)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/unknown_status.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class UnknownStatusError < StandardError
+            def initialize(msg=Paymentsds::MPesa::UNKNOWN_STATUS)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/errors/validation.rb

@@ -0,0 +1,9 @@
+module Paymentsds
+    module MPesa
+        class ValidationError < StandardError
+            def initialize(msg=Paymentsds::MPesa::VALIDATION)
+                super(msg)
+            end
+        end
+    end
+end

data/lib/paymentsds/mpesa/service.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 require 'json'
 require 'faraday'
+require 'faraday_middleware'
+
+require_relative "errors/errors"
 
 module Paymentsds
   module MPesa
@@ -58,11 +61,9 @@ module Paymentsds
           when /^[0-9]{5,6}$/
             :B2B_PAYMENT
           end
-
-          # Should raise an exception
         end
 
-        # Should raise an exception
+        raise InvalidDestination
       end
 
       def detect_missing_properties(opcode, intent)
@@ -148,6 +149,7 @@ module Paymentsds
         }
 
         http_client = Faraday.new(url: request_data[:base_url]) do |client|
+          client.adapter Faraday.default_adapter
           client.headers = request_data[:headers]
           client.response :json
         end
@@ -178,17 +180,127 @@ module Paymentsds
       end
 
       def build_response(result)
-        puts result.inspect
-        
-        if result.status < 300
-          response = Paymentsds::MPesa::Result.new(result.success?, nil, result.data)
-        elsif result.status < 400
-          case re
-        elsif result.status < 500
-        elsif result.status < 600
+
+        case result.status
+        when 200
+          case result.body[:output_ResponseCode]
+          when Paymentsds::MPesa::INS0
+            response = Paymentsds::MPesa::Result.new(result.success?, nil, result.body)
+          else
+            raise UnknownError
+          end
+
+        when 201
+          case result.body[:output_ResponseCode]
+          when Paymentsds::MPesa::INS0
+            response = Paymentsds::MPesa::Result.new(result.success?, nil, result.body)
+          else
+            raise UnknownError
+          end
+
+        when 400
+          case result.body[:output_ResponseCode]
+          when Paymentsds::MPesa::INS13
+            raise InvalidShortcodeError
+          when Paymentsds::MPesa::INS14
+            raise InvalidReferenceError
+          when Paymentsds::MPesa::INS15
+            raise InvalidAmountError
+          when Paymentsds::MPesa::INS17
+            raise InvalidTransactionReferenceError
+          when Paymentsds::MPesa::INS18
+            raise InvalidTransactionIdError
+          when Paymentsds::MPesa::INS19
+            raise InvalidThirdPartyReferenceError
+          when Paymentsds::MPesa::INS20
+            raise InvalidMissingPropertiesError
+          when Paymentsds::MPesa::INS21
+            raise ValidationError
+          when Paymentsds::MPesa::INS22
+            raise InvalidOperationPartError
+          when Paymentsds::MPesa::INS23
+            raise UnknownStatusError
+          when Paymentsds::MPesa::INS24
+            raise InvalidInitiatorIdentifierError
+          when Paymentsds::MPesa::INS25
+            raise InvalidSecurityCredentialError
+          when Paymentsds::MPesa::INS993
+            raise DirectDebtMissingError
+          when Paymentsds::MPesa::INS994
+            raise DuplicatedDirectDebtError
+          when Paymentsds::MPesa::INS995
+            raise ProfileProblemsError
+          when Paymentsds::MPesa::INS996
+            raise InactiveAccountError
+          when Paymentsds::MPesa::INS997
+            raise InvalidLanguageCodeError
+          when Paymentsds::MPesa::INS998
+            raise InvalidMarketError
+          when Paymentsds::MPesa::INS2001
+            raise InitiatorAuthenticationError
+          when Paymentsds::MPesa::INS2002
+            raise InvalidReceiverError
+          when Paymentsds::MPesa::INS2051
+            raise InvalidMSISDNError
+          when Paymentsds::MPesa::INS2057
+            raise InvalidLanguageCodeError
+          else
+            raise UnknownError
+          end
+          
+        when 401
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS5
+            raise TransactionCancelledError
+          when Paymentsds::MPesa::INS6
+            raise TransactionFailedError
+          else
+            raise UnknownError
+          end
+      
+        when 408
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS9
+            raise RequestTimeoutError
+          else
+            raise UnknownError
+          end
+
+        when 409
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS10
+            raise DuplicateTransactionError
+          else
+            raise UnknownError
+          end
+
+        when 422
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS2006
+            raise InsufficientBalanceError
+          else
+            raise UnknownError
+          end
+
+        when 500
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS1
+            raise InternalError
+          else
+            raise UnknownError
+          end
+
+        when 503
+          case result.body[:output_ResponseCode] 
+          when Paymentsds::MPesa::INS16
+            raise UnavailableServerError
+          else
+            raise UnknownError
+          end
+
         else
-        end
-        
+          raise UnknownError
+        end        
       end
 
       def generate_access_token

data/lib/paymentsds/mpesa/version.rb

@@ -2,6 +2,6 @@
 
 module Paymentsds
   module MPesa
-    VERSION = '0.1.0.pre.alpha.27'
+    VERSION = '0.1.0.pre.alpha.32'
   end
 end

data/paymentsds-mpesa.gemspec

@@ -28,4 +28,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rspec', '~> 3.9.0', '>= 3.9.0'
   spec.add_development_dependency 'overcommit', '~> 0.55.0', '>= 0.55.0'
   spec.add_development_dependency 'rubocop', '~> 0.88.0', '>= 0.88.0'
+  spec.add_development_dependency 'faraday_middleware'
 end

data/publish.sh

@@ -0,0 +1,6 @@
+#!/bin/env bash
+
+rm -rf *.gem
+gem build paymentsds-mpesa.gemspec
+gem push *.gem
+gem install paymentsds-mpesa --pre

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: paymentsds-mpesa
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.27
+  version: 0.1.0.pre.alpha.32
 platform: ruby
 authors:
 - Edson Michaque
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-27 00:00:00.000000000 Z
+date: 2020-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -90,6 +90,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.88.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: M-Pesa SDK for Ruby is an unofficial library aiming to help businesses
   integrating every M-Pesa operations to their Ruby applications.
 email:
@@ -115,12 +129,41 @@ files:
 - lib/paymentsds/mpesa/constants.rb
 - lib/paymentsds/mpesa/environment.rb
 - lib/paymentsds/mpesa/error_type.rb
+- lib/paymentsds/mpesa/errors/constants.rb
+- lib/paymentsds/mpesa/errors/direct_debt_missing.rb
+- lib/paymentsds/mpesa/errors/duplicate_direct_debt.rb
+- lib/paymentsds/mpesa/errors/errors.rb
+- lib/paymentsds/mpesa/errors/inactive_account.rb
+- lib/paymentsds/mpesa/errors/initiator_authentication.rb
+- lib/paymentsds/mpesa/errors/insuficient_balance.rb
+- lib/paymentsds/mpesa/errors/invalid_amount.rb
+- lib/paymentsds/mpesa/errors/invalid_initiator_identifier.rb
+- lib/paymentsds/mpesa/errors/invalid_language_code.rb
+- lib/paymentsds/mpesa/errors/invalid_market.rb
+- lib/paymentsds/mpesa/errors/invalid_missing_properties.rb
+- lib/paymentsds/mpesa/errors/invalid_msisdn.rb
+- lib/paymentsds/mpesa/errors/invalid_receiver.rb
+- lib/paymentsds/mpesa/errors/invalid_reference.rb
+- lib/paymentsds/mpesa/errors/invalid_security_credential.rb
+- lib/paymentsds/mpesa/errors/invalid_shortcode.rb
+- lib/paymentsds/mpesa/errors/invalid_thirdparty_reference.rb
+- lib/paymentsds/mpesa/errors/invalid_transaction_id.rb
+- lib/paymentsds/mpesa/errors/invalid_transaction_reference.rb
+- lib/paymentsds/mpesa/errors/profile_problems.rb
+- lib/paymentsds/mpesa/errors/request_timeout.rb
+- lib/paymentsds/mpesa/errors/transaction_cancelled.rb
+- lib/paymentsds/mpesa/errors/transaction_failed.rb
+- lib/paymentsds/mpesa/errors/unavailabe_server.rb
+- lib/paymentsds/mpesa/errors/unknown.rb
+- lib/paymentsds/mpesa/errors/unknown_status.rb
+- lib/paymentsds/mpesa/errors/validation.rb
 - lib/paymentsds/mpesa/operation.rb
 - lib/paymentsds/mpesa/patterns.rb
 - lib/paymentsds/mpesa/result.rb
 - lib/paymentsds/mpesa/service.rb
 - lib/paymentsds/mpesa/version.rb
 - paymentsds-mpesa.gemspec
+- publish.sh
 homepage: https://github.com/paymentsds/mpesa-ruby-sdk
 licenses:
 - Apache-2.0