paymentsds-mpesa 0.1.0.pre.alpha.31 → 0.1.0.pre.alpha.36

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'paysuite/mpesa'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'mpesa/version'
+require_relative 'mpesa/operation'
+require_relative 'mpesa/constants'
+require_relative 'mpesa/environment'
+require_relative 'mpesa/configuration'
+require_relative 'mpesa/result'
+require_relative 'mpesa/error_type'
+require_relative 'mpesa/service'
+require_relative 'mpesa/client'
+
+module Paymentsds
+  module MPesa
+    class Error < StandardError; end
+  end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Paymentsds
+  module MPesa
+    class Client
+      def initialize
+        @service = Service.new
+        yield(@service.config) if block_given?
+        @service.apply
+      end
+
+      def send(intent)
+        @service.handle_send(intent)
+      end
+
+      def receive(intent)
+        @service.handle_receive(intent)
+      end
+
+      def query(intent)
+        @service.handle_query(intent)
+      end
+
+      def revert(intent)
+        @service.handle_revert(intent)
+      end
+    end
+  end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/configuration.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'openssl'
+
+module Paymentsds
+  module MPesa
+    class Configuration
+      attr_accessor :access_token
+      attr_accessor :api_key
+      attr_accessor :public_key
+      attr_accessor :user_agent
+      attr_accessor :verify_ssl
+      attr_accessor :timeout
+      attr_accessor :debugging
+      attr_accessor :environment
+      attr_accessor :initiator_identifier
+      attr_accessor :security_credential
+      attr_accessor :service_provider_code
+      attr_accessor :origin
+      attr_reader :auth
+
+      def initialize
+        @user_agent = 'Paymentsds Ruby'
+        @origin = "*"
+        @verify_ssl = false
+        @timeout = 10
+        
+        yield(self) if block_given?
+      end
+
+      def apply
+        @environment = if @environment == :production
+          Paymentsds::MPesa::Environment.new('https', 'api.vm.co.mz').freeze
+        else
+          Paymentsds::MPesa::Environment.new('https', 'api.sandbox.vm.co.mz').freeze
+        end
+      end
+
+      def generate_access_token
+        has_keys = instance_variable_defined?('@api_key') && instance_variable_defined?('@public_key')
+        has_access_token = instance_variable_defined?('@access_token')
+
+        @auth = encrypt(@api_key, @public_key) if has_keys
+        @auth = @access_token if has_access_token
+      end
+
+      private
+
+      def encrypt(api_key, public_key)
+        plain_public_key = Base64.decode64 public_key
+        key = OpenSSL::PKey::RSA.new plain_public_key
+        encrypted_api_key = key.public_encrypt api_key
+
+        Base64.strict_encode64 encrypted_api_key
+      end
+    end
+  end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/constants.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+module Paymentsds
+  module MPesa
+    PATTERNS = {
+      PHONE_NUMBER: /^((00|\+)?(258))?8[45][0-9]{7}$/,
+      MONEY_AMOUNT: /^[1-9][0-9]*(\.[0-9]+)?$/,
+      WORD: /^\w+$/,
+      SERVICE_PROVIDER: /^[0-9]{5,6}$/
+    }.freeze
+
+    OPERATIONS = {
+      C2B_PAYMENT: {
+        method: :post,
+        port: '18352',
+        path: '/ipg/v1x/c2bPayment/singleStage/',
+        mapping: {
+          to: 'input_ServiceProviderCode',
+          from: 'input_CustomerMSISDN',
+          amount: 'input_Amount',
+          reference: 'input_ThirdPartyReference',
+          transaction: 'input_TransactionReference'
+        },
+        validation: {
+          to: PATTERNS[:SERVICE_PROVIDER],
+          from: PATTERNS[:PHONE_NUMBER],
+          amount: PATTERNS[:MONEY_AMOUNT],
+          reference: PATTERNS[:WORD],
+          transaction: PATTERNS[:WORD]
+        },
+        required: [
+          :to,
+          :from,
+          :amount,
+          :reference,
+          :transaction
+        ],
+        optional: [
+          :to
+        ]
+      },
+
+      B2C_PAYMENT: {
+        method: :post,
+        port: '18345',
+        path: '/ipg/v1x/b2cPayment/',
+        mapping: {
+          to: 'input_ServiceProviderCode',
+          from: 'input_CustomerMSISDN',
+          amount: 'input_Amount',
+          reference: 'input_ThirdPartyReference',
+          transaction: 'input_TransactionReference'
+        },
+        validation: {
+          to: PATTERNS[:SERVICE_PROVIDER],
+          from: PATTERNS[:PHONE_NUMBER],
+          amount: PATTERNS[:MONEY_AMOUNT],
+          reference: PATTERNS[:WORD],
+          transaction: PATTERNS[:WORD]
+        },
+        required: [
+          :to,
+          :from,
+          :amount,
+          :reference,
+          :transaction
+        ],
+        optional: [
+          :to
+        ]
+      },
+
+      B2B_PAYMENT: {
+        method: :post,
+        port: '18349',
+        path: '/ipg/v1x/b2bPayment/',
+        mapping: {
+          to: 'input_ServiceProviderCode',
+          from: 'input_CustomerMSISDN',
+          amount: 'input_Amount',
+          reference: 'input_ThirdPartyReference',
+          transaction: 'input_TransactionReference'
+        },
+        validation: {
+          to: PATTERNS[:SERVICE_PROVIDER],
+          from: PATTERNS[:PHONE_NUMBER],
+          amount: PATTERNS[:MONEY_AMOUNT],
+          reference: PATTERNS[:WORD],
+          transaction: PATTERNS[:WORD]
+        },
+        required: [
+          :to,
+          :from,
+          :amount,
+          :reference,
+          :transaction
+        ],
+        optional: [
+          :to
+        ]
+      },
+
+      REVERSAL: {
+        method: :put,
+        port: '18354',
+        path: '/ipg/v1x/reversal/',
+        mapping: {
+          to: 'input_ServiceProviderCode',
+          from: 'input_CustomerMSISDN',
+          amount: 'input_Amount',
+          reference: 'input_ThirdPartyReference',
+          transaction: 'input_TransactionReference'
+        },
+        validation: {
+          to: PATTERNS[:SERVICE_PROVIDER],
+          from: PATTERNS[:PHONE_NUMBER],
+          amount: PATTERNS[:MONEY_AMOUNT],
+          reference: PATTERNS[:WORD],
+          transaction: PATTERNS[:WORD]
+        },
+        required: [
+          :to,
+          :from,
+          :amount,
+          :reference,
+          :transaction
+        ],
+        optional: [
+          :to
+        ]
+      },
+
+      QUERY_TRANSACTION_STATUS: {
+        method: :get,
+        port: '18353',
+        path: '/ipg/v1x/queryTransactionStatus/',
+        mapping: {
+          to: 'input_ServiceProviderCode',
+          from: 'input_CustomerMSISDN',
+          amount: 'input_Amount',
+          reference: 'input_ThirdPartyReference',
+          transaction: 'input_TransactionReference'
+        },
+        validation: {
+          to: PATTERNS[:SERVICE_PROVIDER],
+          from: PATTERNS[:PHONE_NUMBER],
+          amount: PATTERNS[:MONEY_AMOUNT],
+          reference: PATTERNS[:WORD],
+          transaction: PATTERNS[:WORD]
+        },
+        required: [
+          :to,
+          :from,
+          :amount,
+          :reference,
+          :transaction
+        ],
+        optional: [
+          :to
+        ]
+      }
+    }.freeze
+  end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/environment.rb

@@ -0,0 +1,17 @@
+module Paymentsds
+    module MPesa
+        class Environment
+            attr_accessor :scheme
+            attr_accessor :domain
+
+            def initialize(scheme, domain) 
+                @scheme = scheme
+                @domain = domain
+            end
+
+            def to_url
+                "#{@scheme}://#{@domain}"
+            end
+        end
+    end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/error_type.rb

@@ -0,0 +1,8 @@
+module Paymentsds
+    module MPesa
+        class ErrorType
+            MISSING_PROPERTIES = :MISSING_PROPERTIES
+            VALIDATION_ERROR = :VALIDATION_ERROR
+        end
+    end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/data/lib/paymentsds/mpesa/errors/constants.rb

@@ -0,0 +1,50 @@
+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"
+    end
+end

data/paymentsds-mpesa-0.1.0.pre.alpha.31/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/paymentsds-mpesa-0.1.0.pre.alpha.31/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/paymentsds-mpesa-0.1.0.pre.alpha.31/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/paymentsds-mpesa-0.1.0.pre.alpha.31/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/paymentsds-mpesa-0.1.0.pre.alpha.31/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