airtel-pesa 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e06e465c534dece88a911bc1944ad38b61defedf7f9c0b79c57fc66bb76e265
-  data.tar.gz: 4ac9c8fb62277958960e74ac9fb6f1c4882bec4d28cf941d60e10a4ca74454cb
+  metadata.gz: dedc371bd6300da3b7711ca31c6bf156dd1bacfffba8fe800bed38debd3d586c
+  data.tar.gz: bcdb935588f1622d0daa12a51da58247825d0f88a6b4a3a300d1a5d560973200
 SHA512:
-  metadata.gz: 8ddab4e485aad11a7c98813258bf971b3ad585c30e8b3e02b9d91698db39f377efbe868a2989f3e58d26b9f69a85aff683f023a4d90b1e4d6666b1abe05cccf4
-  data.tar.gz: b4867c0b8166dd0d4ce94badb6cb0f8e44d8c4e10556e403b36f8e1b8ddae6d75cba695401fde3c0f76d10653e0b8a158f8b44909b0a35c44e1dd5250d70d4d7
+  metadata.gz: d44543437df68897ca3a2a58a2f5eac69b8cfe4ef5e64f31624b4cafc1d455cfe9002fb0312af07e34c08a924f39104ffa846c56a08523854acb8daa359dc0bd
+  data.tar.gz: 72573b45af2b5b7dd37b2be9c7c91da1ecafe992986cf3e1906aaf7e7710fe183798988cd10d4c05498eea0d9764ad0b887be0a289a2e101b4afd0c7e96c19d3

data/Gemfile.lock

@@ -0,0 +1,57 @@
+PATH
+  remote: .
+  specs:
+    airtel-pesa (0.1.1)
+      colorize
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    colorize (0.8.1)
+    diff-lcs (1.4.4)
+    parallel (1.21.0)
+    parser (3.0.3.1)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.6)
+    regexp_parser (2.2.0)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    rubocop (1.23.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.12.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.14.0)
+      parser (>= 3.0.1.1)
+    ruby-progressbar (1.11.0)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  x86_64-darwin-21
+
+DEPENDENCIES
+  airtel-pesa!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.7)
+
+BUNDLED WITH
+   2.2.22

data/lib/airtel/pesa/balance_enquiry.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class BalanceEnquiry
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :transaction_country_code, :transaction_currency_code
+
+      def self.call(transaction_country_code:, transaction_currency_code:)
+        new(transaction_country_code, transaction_currency_code).call
+      end
+
+      def initialize(transaction_country_code, transaction_currency_code)
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+      end
+
+      def call
+        url = URI("#{env_url}/standard/v1/users/balance")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Get.new(url)
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+    end
+  end
+end

data/lib/airtel/pesa/disbursement_payment.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class UssdPushPayment
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :amount, :phone_number, :reference, :pin,
+                  :transaction_country_code, :transaction_currency_code, :unique_random_id
+
+      def self.call(
+        amount:, phone_number:, reference:, pin:,
+        transaction_country_code:, transaction_currency_code:,
+        unique_random_id:
+      )
+        new(
+          amount, phone_number, reference, pin,
+          transaction_country_code, transaction_currency_code,
+          unique_random_id
+        ).call
+      end
+  
+      def initialize(
+        amount, phone_number, reference, pin,
+        transaction_country_code, transaction_currency_code,
+        unique_random_id
+      )
+        @amount = amount
+        @phone_number = phone_number
+        @reference = reference
+        @pin = pin
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+        @unique_random_id = unique_random_id
+      end
+
+      def call
+        url = URI("#{env_url}/standard/v1/disbursements")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Post.new(url)
+        request["Content-Type"] = 'application/json'
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+        request.body = JSON.dump(body)
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+
+      def body
+        {
+          "payee": {
+            "msisdn": phone_number
+          },
+          "reference": reference,
+          "pin": pin || Airtel::Pesa::Encryption.call.result,
+          "transaction": {
+            "amount": amount,
+            "id": unique_random_id
+          }
+        }
+      end
+    end
+  end
+end

data/lib/airtel/pesa/disbursement_transaction_enquiry.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class DisbursementTransactionEnquiry
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :transaction_id, :transaction_country_code, :transaction_currency_code
+
+      def self.call(transaction_id:, transaction_country_code:, transaction_currency_code:)
+        new(transaction_id, transaction_country_code, transaction_currency_code).call
+      end
+
+      def initialize(transaction_id, transaction_country_code, transaction_currency_code)
+        @transaction_id = transaction_id
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+      end
+  
+      def call
+        url = URI("#{env_url}/standard/v1/disbursements/#{transaction_id}")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Get.new(url)
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+    end
+  end
+end

data/lib/airtel/pesa/example.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class Example
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :param1, :transaction_country_code, :transaction_currency_code, :param4, :param5, :param6
+
+      def self.call(param1:, transaction_country_code:, transaction_currency_code:, param4:, param5:, param6:)
+        new(param1, transaction_country_code, transaction_currency_code, param4, param5, param6).call
+      end
+  
+      def initialize(param1, transaction_country_code, transaction_currency_code, param4, param5, param6)
+        @param1 = param1
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+        @param4 = param4
+        @param5 = param5
+        @param6 = param6
+      end
+  
+      def call
+        url = URI("#{env_url}/merchant/v1/payments/")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Post.new(url)
+        request["Content-Type"] = 'application/json'
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+        request.body = JSON.dump(body)
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+
+      def body
+        {}
+      end
+    end
+  end
+end

data/lib/airtel/pesa/refund_payment.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class RefundPayment
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :airtel_money_id, :transaction_country_code, :transaction_currency_code
+
+      def self.call(airtel_money_id:, transaction_country_code:, transaction_currency_code:)
+        new(airtel_money_id, transaction_country_code, transaction_currency_code).call
+      end
+  
+      def initialize(airtel_money_id, transaction_country_code, transaction_currency_code)
+        @airtel_money_id = airtel_money_id
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+      end
+  
+      def call
+        url = URI("#{env_url}/standard/v1/payments/refund")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Post.new(url)
+        request["Content-Type"] = 'application/json'
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+        request.body = JSON.dump(body)
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+
+      def body
+        {
+          "transaction": {
+            "airtel_money_id": airtel_money_id
+          }
+        }
+      end
+    end
+  end
+end

data/lib/airtel/pesa/transaction_enquiry.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class TransactionEnquiry
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :transaction_id, :transaction_country_code, :transaction_currency_code
+
+      def self.call(transaction_id:, transaction_country_code:, transaction_currency_code:)
+        new(transaction_id, transaction_country_code, transaction_currency_code).call
+      end
+
+      def initialize(transaction_id, transaction_country_code, transaction_currency_code)
+        @transaction_id = transaction_id
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+      end
+  
+      def call
+        url = URI("#{env_url}/standard/v1/payments/#{transaction_id}")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Get.new(url)
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+    end
+  end
+end

data/lib/airtel/pesa/user_enquiry.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class TransactionEnquiry
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :phone_number, :transaction_country_code, :transaction_currency_code
+
+      def self.call(phone_number:, transaction_country_code:, transaction_currency_code:)
+        new(phone_number, transaction_country_code, transaction_currency_code).call
+      end
+
+      def initialize(phone_number, transaction_country_code, transaction_currency_code)
+        @phone_number = phone_number
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+      end
+  
+      def call
+        url = URI("#{env_url}/standard/v1/users/#{phone_number}")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Get.new(url)
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+    end
+  end
+end

data/lib/airtel/pesa/ussd_push_payment.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'openssl'
+require 'ostruct'
+require 'json'
+
+module Airtel
+  module Pesa
+    class UssdPushPayment
+      STAGING_URL = "https://openapiuat.airtel.africa".freeze
+      PRODUCTION_URL = "https://openapi.airtel.africa".freeze
+
+      attr_reader :amount, :phone_number, :country_code, :currency_code,
+                  :transaction_country_code, :transaction_currency_code, :unique_random_id
+
+      def self.call(
+        amount:, phone_number:, country_code:, currency_code:,
+        transaction_country_code:, transaction_currency_code:,
+        unique_random_id:
+      )
+        new(
+          amount, phone_number, country_code, currency_code,
+          transaction_country_code, transaction_currency_code,
+          unique_random_id
+        ).call
+      end
+  
+      def initialize(
+        amount, phone_number, country_code, currency_code,
+        transaction_country_code, transaction_currency_code,
+        unique_random_id
+      )
+        @amount = amount
+        @phone_number = phone_number
+        @country_code = country_code
+        @currency_code = currency_code
+        @transaction_country_code = transaction_country_code
+        @transaction_currency_code = transaction_currency_code
+        @unique_random_id = unique_random_id
+      end
+
+      def call
+        url = URI("#{env_url}/merchant/v1/payments")
+
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+        request = Net::HTTP::Post.new(url)
+        request["Content-Type"] = 'application/json'
+        request["Authorization"] = "Bearer #{token}"
+        request["X-Country"] = transaction_country_code
+        request["X-Currency"] = transaction_currency_code
+        request.body = JSON.dump(body)
+
+        response = http.request(request)
+        parsed_response = JSON.parse(response.read_body)
+        result = Airtel::Pesa.to_recursive_ostruct(parsed_response)
+        OpenStruct.new(result: result, error: nil)
+      rescue JSON::ParserError => error
+        OpenStruct.new(result: nil, error: error)
+      end
+
+      private
+
+      def env_url
+        return STAGING_URL Airtel::Pesa.configuration.env == 'staging'
+        return PRODUCTION_URL Airtel::Pesa.configuration.env == 'production'
+      end
+
+      def token
+        Airtel::Pesa::Authorization.call.result.access_token
+      end
+
+      def body
+        {
+          "reference": "airtel-pesa gem transaction",
+          "subscriber": {
+            "country": country_code,
+            "currency": currency_code,
+            "msisdn": phone_number
+          },
+          "transaction": {
+            "amount": amount,
+            "country": transaction_country_code,
+            "currency": transaction_currency_code,
+            "id": unique_random_id
+          }
+        }
+      end
+    end
+  end
+end

data/lib/airtel/pesa/version.rb

@@ -2,6 +2,6 @@
 
 module Airtel
   module Pesa
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airtel-pesa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Sylvance
@@ -37,6 +37,7 @@ files:
 - ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -45,7 +46,15 @@ files:
 - bin/setup
 - lib/airtel/pesa.rb
 - lib/airtel/pesa/authorization.rb
+- lib/airtel/pesa/balance_enquiry.rb
+- lib/airtel/pesa/disbursement_payment.rb
+- lib/airtel/pesa/disbursement_transaction_enquiry.rb
 - lib/airtel/pesa/encryption.rb
+- lib/airtel/pesa/example.rb
+- lib/airtel/pesa/refund_payment.rb
+- lib/airtel/pesa/transaction_enquiry.rb
+- lib/airtel/pesa/user_enquiry.rb
+- lib/airtel/pesa/ussd_push_payment.rb
 - lib/airtel/pesa/version.rb
 homepage: https://github.com/Sylvance/airtel-pesa
 licenses: