bitpesa 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8b61dc56d2e2bf5d8dde923b877478868e4bc71c
+  data.tar.gz: 165c230d90658805e2c997d30cb43dad7352bd2e
+SHA512:
+  metadata.gz: 809a31b9b1c4021cafab72c7010f5a48463f7bba82016d9a12624a5c34a93678635c3df874bb86f406c5f9303518c49c815911ae06a69d4f43f8583792d13fab
+  data.tar.gz: aa753b95469e580fe6dc77ccd61a1f6a70a1b5f12e31d3391b0e81277f0537731ab1b137761d274ecf0d63490936a0942b251754969ae993968e0f494c2f47f0

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,14 @@
+# BitPesa API wrapper in Ruby
+
+See the [API docs](https://api.bitpesa.co/documentation).
+
+## Installation
+
+You don't need this source code unless you want to modify the gem. If you just
+want to use the gem, you should run:
+
+    gem install bitpesa
+
+### Requirements
+
+* Ruby 2.3.0 or above

data/bitpesa.gemspec

@@ -0,0 +1,20 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require "bitpesa/version"
+
+spec = Gem::Specification.new do |s|
+  s.name = "bitpesa"
+  s.version = BitPesa::VERSION
+  s.required_ruby_version = ">= 2.3.0"
+  s.summary = "BitPesa API wrapper in Ruby"
+  s.description = "BitPesa is a payment provider. See https://bitpesa.com for details."
+  s.author = "Bitbond"
+  s.email = "developers@bitbond.com"
+  s.homepage = "https://api.bitpesa.co/documentation"
+  s.license = "MIT"
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/bitpesa/api.rb

@@ -0,0 +1,99 @@
+require "base64"
+
+module BitPesa
+
+  class Api
+
+    class << self
+
+      # Documents
+
+      def get_document id
+        BitPesa::Client.get("/documents/#{id}")
+      end
+
+      def upload_document file_content, **options
+        BitPesa::Client.post("/documents", {document: encode_document(file_content, options)})
+      end
+
+      def list_documents page=1
+        BitPesa::Client.get("/documents", page: page)
+      end
+
+      # Senders
+
+      def get_sender id
+        BitPesa::Client.get("/senders/#{id}")
+      end
+
+      def create_sender data
+        BitPesa::Client.post("/senders", {sender: data})
+      end
+
+      def update_sender id, data
+        BitPesa::Client.patch("/senders", data)
+      end
+
+      def list_senders page=1
+        BitPesa::Client.get("/senders", page: page)
+      end
+
+      def delete_sender id
+        BitPesa::Client.delete("/senders/#{id}")
+      end
+
+      # Transactions
+
+      def get_transaction id
+        BitPesa::Client.get("/transactions/#{id}")
+      end
+
+      def create_transaction data
+        BitPesa::Client.post("/transactions", transaction: data)
+      end
+
+      def list_transactions **filters
+        BitPesa::Client.get("/transactions", filters)
+      end
+
+      def calculate_transaction data
+        BitPesa::Client.post("/transactions/calculate", transaction: data)
+      end
+
+      def validate_transaction data
+        BitPesa::Client.post("/transactions/validate", transaction: data)
+      end
+
+      # Webhooks
+
+      def get_webhook id
+        BitPesa::Client.get("/webhooks/#{id}")
+      end
+
+      def create_webhook url:, events:, **meta_data
+        BitPesa::Client.post("/webhooks", {webhook: {url: url, events: events, metadata: meta_data}})
+      end
+
+      def list_webhooks
+        BitPesa::Client.get("/webhooks")
+      end
+
+      def delete_webhook id
+        BitPesa::Client.delete("/webhooks/#{id}")
+      end
+
+      # Helpers
+
+      def encode_document file_content, file_name:, mime_type:, **meta_data
+        encoded_file_content = "data:" + mime_type + ";base64," + Base64.encode64(file_content)
+        {
+          upload: encoded_file_content,
+          upload_file_name: file_name,
+          metadata: meta_data
+        }
+      end
+
+    end
+
+  end
+end

data/lib/bitpesa/client.rb

@@ -0,0 +1,104 @@
+require "securerandom"
+require "net/http"
+require "json"
+require "uri"
+
+module BitPesa
+
+  class Client
+
+    @host     = "api.bitpesa.co"
+    @key      = "API key"
+    @secret   = "API secret"
+    @base_url = "/v1"
+    @timeout  = 5
+
+    class << self
+
+      attr_accessor :host, :key, :secret, :timeout
+      attr_reader   :base_url
+
+      def get(endpoint, payload=nil)
+        url = request_url(endpoint)
+        url += "?" + URI.encode_www_form(payload) if payload
+        request "GET", url
+      end
+
+      def post(endpoint, payload={})
+        body = JSON.generate(payload)
+        request "POST", request_url(endpoint), body
+      end
+
+      def put(endpoint, payload={})
+        body = JSON.generate(payload)
+        request "PUT", request_url(endpoint), body
+      end
+
+      def patch(endpoint, payload={})
+        body = JSON.generate(payload)
+        request "PATCH", request_url(endpoint), body
+      end
+
+      def delete(endpoint)
+        request "DELETE", request_url(endpoint)
+      end
+
+      private
+
+        def request_url endpoint
+          base_url + endpoint
+        end
+
+        def generate_nonce
+          SecureRandom.uuid
+        end
+
+        def sign *args
+          message = args.compact.join("&")
+          OpenSSL::HMAC.hexdigest(OpenSSL::Digest::SHA512.new, secret, message)
+        end
+
+        def request http_method, url, payload=nil
+          req = Net::HTTP.const_get(http_method.capitalize).new(url, headers(http_method, url, payload))
+          req.body = payload
+          handle connection.start{|h| h.request(req)}
+        end
+
+        def headers http_method, url, body
+          nonce = generate_nonce
+          full_url = "https://" + host + url
+          body_hexdigest = OpenSSL::Digest::SHA512.hexdigest(body || "")
+          {
+            "Content-Type" => "application/json",
+            "Accept" => "text/html",
+            "User-Agent" => "BitPesa Ruby API Client",
+            "Authorization-Nonce" => nonce,
+            "Authorization-Key" => key,
+            "Authorization-Signature" => sign(nonce, http_method, full_url, body_hexdigest)
+          }
+        end
+
+        def connection
+          connection = Net::HTTP.new(host, 443)
+          connection.open_timeout = timeout
+          connection.read_timeout = timeout
+          connection.use_ssl = true
+          connection.set_debug_output $stderr
+          connection
+        end
+
+        def handle response
+          case response
+            when Net::HTTPSuccess
+              (response.body != "" && JSON.parse(response.body)) || true
+            when Net::HTTPUnauthorized
+              raise BitPesa::Unauthorized.new ""
+            else
+              raise BitPesa::Error.new response.body
+          end
+        end
+
+    end
+
+  end
+end

data/lib/bitpesa/error.rb

@@ -0,0 +1,9 @@
+module BitPesa
+
+  class Unauthorized < StandardError
+  end
+
+  class Error < StandardError
+  end
+
+end

data/lib/bitpesa/version.rb

@@ -0,0 +1,3 @@
+module BitPesa
+  VERSION = "0.0.1"
+end

data/lib/bitpesa.rb

@@ -0,0 +1,3 @@
+require "bitpesa/error"
+require "bitpesa/client"
+require "bitpesa/api"

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: bitpesa
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bitbond
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-02 00:00:00.000000000 Z
+dependencies: []
+description: BitPesa is a payment provider. See https://bitpesa.com for details.
+email: developers@bitbond.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- bitpesa.gemspec
+- lib/bitpesa.rb
+- lib/bitpesa/api.rb
+- lib/bitpesa/client.rb
+- lib/bitpesa/error.rb
+- lib/bitpesa/version.rb
+homepage: https://api.bitpesa.co/documentation
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: BitPesa API wrapper in Ruby
+test_files: []