lipisha-sdk 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: aab98f319bcd1f8ef02dfc46c4d3c53cd24d59c6
+  data.tar.gz: a406112493f898023f7eb70af0029243bdcac764
+SHA512:
+  metadata.gz: 2a20b45c472e83974b0e5f0527c1f7cb25c90f565ff8a0db81fe8f16585a7cd114429e3ee9952e24e1b89cb15a0bd149bff12eeb44e7497d507e48301a64d558
+  data.tar.gz: 13ccb5382cee8ecf3032e37651c19052b7e07c76e1b16e4478cbba524a040bd9c00c4f69808b2f1ae27bb543589bb328310958b01123eca92da58ee50fd372c1

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in lipisha-sdk.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    lipisha-sdk (1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    power_assert (0.2.6)
+    rake (10.4.2)
+    test-unit (3.1.5)
+      power_assert
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  lipisha-sdk!
+  rake
+  test-unit
+
+BUNDLED WITH
+   1.10.6

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Lipisha Consortium Limited
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,87 @@
+# Lipisha::Sdk
+
+This gem provides bindings for Lipisha Payments API (http://developers.lipisha.com)
+
+## Features
+
+- Send money
+- Acknowledge transactions
+- Send SMS
+- Get Float
+- Get Balance
+- Charge card transactions
+- Search transactions
+- Search customers
+- Add users
+- Add payment accounts and withdrawal accounts
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'lipisha-sdk'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install lipisha-sdk
+
+## Usage
+
+```ruby
+require "lipisha/sdk"
+
+lipisha = Lipisha::Sdk::LipishaAPI.new("<YOUR API kEY>", "YOUR API SIGNATURE", "<ENVIRONMENT>")
+# Enviroment may either be _live_ for production environment or _test_ for the lipisha sandbox.
+
+response = lipisha.get_balance()
+puts(response.status)
+puts(response.status_code)
+# This is a map of the content response
+# See the Lipisha API documentation for available metadata
+puts(response.content)
+puts(response.json)
+
+# Sending money
+response = lipisha.send_money("039XXX", "0722123456", 200)
+```
+
+## IPN Examples
+
+IPN Integration examples for Rails are in the examples directory
+
+https://github.com/lipisha/lipisha-ruby-sdk/tree/master/examples
+
+## Running Tests
+
+Edit the test configuration in `test/config.rb`
+
+Run all tests
+
+```shell
+bundle exec rake
+```
+
+Run a particular test
+
+```
+bundle exec rake TEST=test/<filename>
+```
+
+e.g. Balance tests
+
+```
+ bundle exec rake TEST=test/test_balance
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+    t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/examples/README.md

@@ -0,0 +1,8 @@
+# IPN Integration examples
+
+
+This is an examples of Lipisha IPN integration for rails.
+
+This assumes that you have configured an IPN URL for API callbacks.
+
+IPN: Instant Payment Notification

data/lib/lipisha/sdk.rb

@@ -0,0 +1,576 @@
+require "lipisha/sdk/version"
+require "net/http"
+require "uri"
+require "json"
+
+module Lipisha
+  module Sdk
+    class APIResponse
+      attr_reader :status
+      attr_reader :status_code
+      attr_reader :status_description
+      attr_reader :content
+      attr_reader :json
+
+      ##
+      # Initializes lipisha API respnse
+      #
+      # === Attributes
+      #
+      # * +status+ - status of the api call e.g. Success
+      # * +status_code+ - numeric status code of the api call
+      # * +status_description+ - Verbose status code description
+      # * +content+ - content section of api call response
+      # * +json+ - Raw JSON response (Hashmap)
+      def initialize(status, status_code, status_description, content, json)
+        @status = status
+        @status_code = status_code
+        @status_description = status_description
+        @content = content
+        @json = json
+      end
+
+      def to_s
+        @json.to_s
+      end
+    end
+    ##
+    # This class defines API bindings for lipisha payments.
+    # Each methods responds with an APIResponse object which
+    # may be introspected for the status of the call.
+
+    class LipishaAPI
+      LIVE_API_BASE_URL = "https://www.lipisha.com/payments/accounts/index.php/v2/api/"
+      SANDBOX_API_BASE_URL = "http://developer.lipisha.com/index.php/v2/api/"
+      DEFAULT_API_VERSION = "1.3.0"
+      DEFAULT_API_TYPE = "Callback"
+
+      ##
+      # Initialize Lipisha API connector
+      # API credentials can be acquired from your Lipisha account under settings.
+      #
+      # === Attributes
+      #
+      # * +api_key+ - API Key to use to connect to Lipisha
+      # * +api_signature+ - API Signature to use when connecting
+      # * +environment+ - either "live" for production environment or "test"
+      #                   for the sandbox
+      #
+      def initialize(api_key, api_signature, environment = "LIVE")
+        @api_key = api_key
+        @api_signature = api_signature
+        $environment = environment.upcase
+        # Set API base environment for selected environment
+        case $environment
+        when "LIVE"
+          @api_base = LIVE_API_BASE_URL
+        when "TEST"
+          @api_base = SANDBOX_API_BASE_URL
+        else
+          fail "`environment` must be either LIVE or TEST"
+        end
+      end
+
+      def execute(api_endpoint, api_parameters)
+        api_url = @api_base + api_endpoint
+        uri = URI.parse(api_url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = (uri.scheme == "https")
+        request = Net::HTTP::Post.new(uri.request_uri)
+        # Set api key and signature
+        api_parameters["api_key"] = @api_key
+        api_parameters["api_signature"] = @api_signature
+        api_parameters["api_type"] = DEFAULT_API_TYPE
+        api_parameters["api_version"] = DEFAULT_API_VERSION
+        request.set_form_data(api_parameters)
+        response = http.request(request)
+        response_map = JSON.parse(response.body)
+        api_response = APIResponse.new(response_map["status"]["status"],
+                                       response_map["status"]["status_code"],
+                                       response_map["status"]["status_description"],
+                                       response_map["content"],
+                                       response_map)
+        api_response
+      end
+
+      ##
+      # Gets available balance in Lipisha main account
+      #
+      # {Full docs - get_balance}[http://developer.lipisha.com/index.php/app/launch/api_get_balance]
+      #
+      def get_balance
+        endpoint = "get_balance"
+        parameters = {}
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Gets available balance in float account
+      #
+      # {Full docs - get_float}[http://developer.lipisha.com/index.php/app/launch/api_get_float]
+      #
+      # ==== Attributes
+      #
+      # * +account_number+ - float account number to look up
+      #
+      def get_float(account_number)
+        endpoint = "get_float"
+        parameters = { "account_number" => account_number }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Send money
+      #
+      # {Full docs - send_money}[http://developer.lipisha.com/index.php/app/launch/api_send_money]
+      #
+      # ==== Attributes
+      #
+      # * +account_number+
+      # * +mobile_number+
+      # * +amount+
+      #
+      #
+      def send_money(account_number, mobile_number, amount)
+        endpoint = "send_money"
+        parameters = { "account_number" => account_number, "mobile_number" => mobile_number, "amount" => amount }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Send sms
+      #
+      # {Full docs - send_sms}[http://developer.lipisha.com/index.php/app/launch/api_send_sms]
+      #
+      # ==== Attributes
+      #
+      # * +mobile_number+
+      # * +message+
+      #
+      #
+      def send_sms(mobile_number, message)
+        endpoint = "send_sms"
+        parameters = { "mobile_number" => mobile_number, "message" => message }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Acknowledge transaction
+      #
+      # {Full docs - acknowledge_transaction}[http://developer.lipisha.com/index.php/app/launch/api_acknowledge_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction+
+      #
+      #
+      def acknowledge_transaction(transaction)
+        endpoint = "acknowledge_transaction"
+        parameters = { "transaction" => transaction }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Confirm transaction
+      #
+      # {Full docs - confirm_transaction}[http://developer.lipisha.com/index.php/app/launch/api_confirm_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction+
+      #
+      #
+      def confirm_transaction(transaction)
+        endpoint = "confirm_transaction"
+        parameters = { "transaction" => transaction }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Reverse transaction
+      #
+      # {Full docs - reverse_transaction}[http://developer.lipisha.com/index.php/app/launch/api_reverse_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction+
+      #
+      #
+      def reverse_transaction(transaction)
+        endpoint = "reverse_transaction"
+        parameters = { "transaction" => transaction }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Send airtime
+      #
+      # {Full docs - send_airtime}[http://developer.lipisha.com/index.php/app/launch/api_send_airtime]
+      #
+      # ==== Attributes
+      #
+      # * +account_number+
+      # * +mobile_number+
+      # * +amount+
+      # * +network+
+      #
+      #
+      def send_airtime(account_number, mobile_number, amount, network)
+        endpoint = "send_airtime"
+        parameters = { "account_number" => account_number,
+                       "mobile_number" => mobile_number,
+                       "amount" => amount,
+                       "network" => network }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Create user
+      #
+      # {Full docs - create_user}[http://developer.lipisha.com/index.php/app/launch/api_create_user]
+      #
+      # ==== Attributes
+      #
+      # * +full_name+
+      # * +role+
+      # * +mobile_number+
+      # * +email+
+      # * +user_name+
+      # * +password+
+      #
+      #
+      def create_user(full_name, role, mobile_number, email, user_name, password)
+        endpoint = "create_user"
+        parameters = { "full_name" => full_name,
+                       "role" => role,
+                       "mobile_number" => mobile_number,
+                       "email" => email,
+                       "user_name" => user_name,
+                       "password" => password }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Update user
+      #
+      # {Full docs - update_user}[http://developer.lipisha.com/index.php/app/launch/api_update_user]
+      #
+      # ==== Attributes
+      #
+      # * +full_name+
+      # * +role+
+      # * +mobile_number+
+      # * +email+
+      # * +user_name+
+      #
+      #
+      def update_user(full_name, role, mobile_number, email, user_name)
+        endpoint = "update_user"
+        parameters = { "full_name" => full_name,
+                       "role" => role,
+                       "mobile_number" => mobile_number,
+                       "email" => email,
+                       "user_name" => user_name }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Create payment account
+      #
+      # {Full docs - create_payment_account}[http://developer.lipisha.com/index.php/app/launch/api_create_payment_account]
+      #
+      # ==== Attributes
+      #
+      # * +transaction_account_type+
+      # * +transaction_account_name+
+      # * +transaction_account_manager+
+      #
+      #
+      def create_payment_account(transaction_account_type,
+                                 transaction_account_name,
+                                 transaction_account_manager)
+        endpoint = "create_payment_account"
+        parameters = { "transaction_account_type" => transaction_account_type,
+                       "transaction_account_name" => transaction_account_name,
+                       "transaction_account_manager" => transaction_account_manager }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Create withdrawal account
+      #
+      # {Full docs - create_withdrawal_account}[http://developer.lipisha.com/index.php/app/launch/api_create_withdrawal_account]
+      #
+      # ==== Attributes
+      #
+      # * +transaction_account_type+
+      # * +transaction_account_name+
+      # * +transaction_account_number+
+      # * +transaction_account_bank_name+
+      # * +transaction_account_bank_branch+
+      # * +transaction_account_bank_address+
+      # * +transaction_account_swift_code+
+      # * +transaction_account_manager+
+      #
+      #
+      def create_withdrawal_account(transaction_account_type,
+                                    transaction_account_name,
+                                    transaction_account_number,
+                                    transaction_account_bank_name,
+                                    transaction_account_bank_branch,
+                                    transaction_account_bank_address,
+                                    transaction_account_swift_code,
+                                    transaction_account_manager)
+        endpoint = "create_withdrawal_account"
+        parameters = { "transaction_account_type" => transaction_account_type,
+                       "transaction_account_name" => transaction_account_name,
+                       "transaction_account_number" => transaction_account_number,
+                       "transaction_account_bank_name" => transaction_account_bank_name,
+                       "transaction_account_bank_branch" => transaction_account_bank_branch,
+                       "transaction_account_bank_address" => transaction_account_bank_address,
+                       "transaction_account_swift_code" => transaction_account_swift_code,
+                       "transaction_account_manager" => transaction_account_manager }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Get transactions
+      #
+      # {Full docs - get_transactions}[http://developer.lipisha.com/index.php/app/launch/api_get_transactions]
+      #
+      # ==== Attributes
+      #
+      # * +transaction+
+      # * +transaction_type+
+      # * +transaction_method+
+      # * +transaction_date_start+
+      # * +transaction_date_end+
+      # * +transaction_account_name+
+      # * +transaction_account_number+
+      # * +transaction_reference+
+      # * +transaction_amount_minimum+
+      # * +transaction_amount_maximum+
+      # * +transaction_status+
+      # * +transaction_name+
+      # * +transaction_mobile_number+
+      # * +transaction_email+
+      # * +limit+
+      # * +offset+
+      #
+      #
+      def get_transactions(transaction = "",
+                           transaction_type = "",
+                           transaction_method = "",
+                           transaction_date_start = "",
+                           transaction_date_end = "",
+                           transaction_account_name = "",
+                           transaction_account_number = "",
+                           transaction_reference = "",
+                           transaction_amount_minimum = "",
+                           transaction_amount_maximum = "",
+                           transaction_status = "",
+                           transaction_name = "",
+                           transaction_mobile_number = "",
+                           transaction_email = "",
+                           limit = 100,
+                           offset = 0)
+        endpoint = "get_transactions"
+        parameters = { "transaction" => transaction,
+                       "transaction_type" => transaction_type,
+                       "transaction_method" => transaction_method,
+                       "transaction_date_start" => transaction_date_start,
+                       "transaction_date_end" => transaction_date_end,
+                       "transaction_account_name" => transaction_account_name,
+                       "transaction_account_number" => transaction_account_number,
+                       "transaction_reference" => transaction_reference,
+                       "transaction_amount_minimum" => transaction_amount_minimum,
+                       "transaction_amount_maximum" => transaction_amount_maximum,
+                       "transaction_status" => transaction_status,
+                       "transaction_name" => transaction_name,
+                       "transaction_mobile_number" => transaction_mobile_number,
+                       "transaction_email" => transaction_email,
+                       "limit" => limit,
+                       "offset" => offset }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Get customers
+      #
+      # {Full docs - get_customers}[http://developer.lipisha.com/index.php/app/launch/api_get_customers]
+      #
+      # ==== Attributes
+      #
+      # * +customer_name+
+      # * +customer_mobile_number+
+      # * +customer_email+
+      # * +customer_first_payment_from+
+      # * +customer_first_payment_to+
+      # * +customer_last_payment_from+
+      # * +customer_last_payment_to+
+      # * +customer_payments_minimum+
+      # * +customer_payments_maximum+
+      # * +customer_total_spent_minimum+
+      # * +customer_total_spent_maximum+
+      # * +customer_average_spent_minimum+
+      # * +customer_average_spent_maximum+
+      # * +limit+
+      # * +offset+
+      #
+      #
+      def get_customers(customer_name = "",
+                        customer_mobile_number = "",
+                        customer_email = "",
+                        customer_first_payment_from = "",
+                        customer_first_payment_to = "",
+                        customer_last_payment_from = "",
+                        customer_last_payment_to = "",
+                        customer_payments_minimum = "",
+                        customer_payments_maximum = "",
+                        customer_total_spent_minimum = "",
+                        customer_total_spent_maximum = "",
+                        customer_average_spent_minimum = "",
+                        customer_average_spent_maximum = "",
+                        limit = 1000,
+                        offset = 0)
+        endpoint = "get_customers"
+        parameters = { "customer_name" => customer_name,
+                       "customer_mobile_number" => customer_mobile_number,
+                       "customer_email" => customer_email,
+                       "customer_first_payment_from" => customer_first_payment_from,
+                       "customer_first_payment_to" => customer_first_payment_to,
+                       "customer_last_payment_from" => customer_last_payment_from,
+                       "customer_last_payment_to" => customer_last_payment_to,
+                       "customer_payments_minimum" => customer_payments_minimum,
+                       "customer_payments_maximum" => customer_payments_maximum,
+                       "customer_total_spent_minimum" => customer_total_spent_minimum,
+                       "customer_total_spent_maximum" => customer_total_spent_maximum,
+                       "customer_average_spent_minimum" => customer_average_spent_minimum,
+                       "customer_average_spent_maximum" => customer_average_spent_maximum,
+                       "limit" => limit,
+                       "offset" => offset }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Authorize card transaction
+      #
+      # {Full docs - authorize_card_transaction}[http://developer.lipisha.com/index.php/app/launch/api_authorize_card_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +account_number+
+      # * +card_number+
+      # * +address1+
+      # * +address2+
+      # * +expiry+
+      # * +name+
+      # * +country+
+      # * +state+
+      # * +zip+
+      # * +security_code+
+      # * +amount+
+      # * +currency+
+      #
+      #
+      def authorize_card_transaction(account_number,
+                                     card_number,
+                                     address1,
+                                     address2,
+                                     expiry,
+                                     name,
+                                     country,
+                                     state,
+                                     zip,
+                                     security_code,
+                                     amount,
+                                     currency)
+        endpoint = "authorize_card_transaction"
+        parameters = { "account_number" => account_number,
+                       "card_number" => card_number,
+                       "address1" => address1,
+                       "address2" => address2,
+                       "expiry" => expiry,
+                       "name" => name,
+                       "country" => country,
+                       "state" => state,
+                       "zip" => zip,
+                       "security_code" => security_code,
+                       "amount" => amount,
+                       "currency" => currency }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Reverse card transaction
+      #
+      # {Full docs - reverse_card_transaction}[http://developer.lipisha.com/index.php/app/launch/api_reverse_card_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction_index+
+      # * +transaction_reference+
+      #
+      #
+      def reverse_card_transaction(transaction_index, transaction_reference)
+        endpoint = "reverse_card_transaction"
+        parameters = { "transaction_index" => transaction_index,
+                       "transaction_reference" => transaction_reference }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Complete card transaction
+      #
+      # {Full docs - complete_card_transaction}[http://developer.lipisha.com/index.php/app/launch/api_complete_card_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction_index+
+      # * +transaction_reference+
+      #
+      #
+      def complete_card_transaction(transaction_index, transaction_reference)
+        endpoint = "complete_card_transaction"
+        parameters = { "transaction_index" => transaction_index,
+                       "transaction_reference" => transaction_reference }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Void card transaction
+      #
+      # {Full docs - void_card_transaction}[http://developer.lipisha.com/index.php/app/launch/api_void_card_transaction]
+      #
+      # ==== Attributes
+      #
+      # * +transaction_index+
+      # * +transaction_reference+
+      #
+      #
+      def void_card_transaction(transaction_index, transaction_reference)
+        endpoint = "void_card_transaction"
+        parameters = { "transaction_index" => transaction_index,
+                       "transaction_reference" => transaction_reference }
+        execute(endpoint, parameters)
+      end
+
+      ##
+      # Request settlement
+      #
+      # {Full docs - request_settlement}[http://developer.lipisha.com/index.php/app/launch/api_request_settlement]
+      #
+      # ==== Attributes
+      #
+      # * +account_number+
+      # * +amount+
+      #
+      #
+      def request_settlement(account_number, amount)
+        endpoint = "request_settlement"
+        parameters = { "account_number" => account_number, "amount" => amount }
+        execute(endpoint, parameters)
+      end
+    end
+  end
+end

data/lib/lipisha/sdk/version.rb

@@ -0,0 +1,5 @@
+module Lipisha
+  module Sdk
+    VERSION = "1.0"
+  end
+end

data/lipisha-sdk.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'lipisha/sdk/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "lipisha-sdk"
+  spec.version       = Lipisha::Sdk::VERSION
+  spec.authors       = ["Lipisha Consortium Limited"]
+  spec.email         = ["api@lipisha.com"]
+  spec.description   = %q{Lipisha Payments Ruby SDK.}
+  spec.summary       = %q{Lipisha Payments Ruby SDK}
+  spec.homepage      = "https://github.com/lipisha/lipisha-ruby-sdk"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake", "~> 0"
+  spec.add_development_dependency "test-unit", "~> 0"
+end

data/test/config.rb

@@ -0,0 +1,60 @@
+API_KEY = ENV["LIPISHA_API_KEY"]
+API_SIGNATURE = ENV["LIPISHA_API_SIGNATURE"]
+API_ENVIRONMENT = "live"
+STATUS_SUCCESS = "SUCCESS"
+STATUS_CONFIRMED = "Completed"
+
+FLOAT_ACCOUNT = ""
+PAYOUT_ACCOUNT = ""
+AIRTIME_ACCOUNT = ""
+
+TRANSACTION_ID_CONFIRM = ""
+TRANSACTION_ID_REVERSE = ""
+
+AIRTIME_AMOUNT = 10
+AIRTIME_NETWORK = ""
+AIRTIME_MOBILE_NUMBER = ""
+PAYOUT_MOBILE_NUMBER = ""
+PAYOUT_AMOUNT = 10
+
+
+ACCOUNT_NAME = ""
+ACCOUNT_ADMIN = ""
+
+
+TEST_USER_NAMES = ""
+TEST_USER_ROLE = ""
+TEST_USER_MOBILE = ""
+TEST_USER_EMAIL = ""
+TEST_USER_LOGIN = ""
+
+TEST_TX_ACCOUNT_NAME = ""
+TEST_TX_ACCOUNT_NUMBER = ""
+TEST_TX_ACCOUNT_BANK_NAME = ""
+TEST_TX_ACCOUNT_BANK_BRANCH = ""
+TEST_TX_ACCOUNT_BANK_ADDRESS = ""
+TEST_TX_ACCOUNT_SWIFT_CODE = ""
+TEST_TX_ACCOUNT_MANAGER = ""
+
+CARD_AMOUNT = 10
+CARD_CURRENCY = ""
+CARD_ACCOUNT = ""
+CARD_NUMBER = ""
+CARD_ADDRESS1 = ""
+CARD_ADDRESS2 = ""
+CARD_EXPIRY = ""
+CARD_NAMES = ""
+CARD_COUNTRY = ""
+CARD_STATE = ""
+CARD_ZIP = ""
+CARD_SECURITY_CODE = ""
+
+
+CARD_COMPLETE_TX_INDEX = ""
+CARD_COMPLETE_TX_REF = ""
+
+CARD_REVERSE_TX_INDEX = ""
+CARD_REVERSE_TX_REF = ""
+
+CARD_VOID_TX_INDEX = ""
+CARD_VOID_TX_REF = ""

data/test/test_accounts.rb

@@ -0,0 +1,49 @@
+require "test/unit"
+require "lipisha/sdk"
+require_relative "config"
+
+class AccountsTest < Test::Unit::TestCase
+
+  def setup
+    @lipisha = Lipisha::Sdk::LipishaAPI.new(API_KEY, API_SIGNATURE, API_ENVIRONMENT)
+  end
+
+  def test_create_payment_account
+    omit_if((ACCOUNT_NAME.empty? and ACCOUNT_ADMIN.empty?))
+    response = @lipisha.create_payment_account(1, ACCOUNT_NAME, ACCOUNT_ADMIN)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_create_withdrawal_account
+    omit_if(TEST_TX_ACCOUNT_NAME.empty?)
+    response = @lipisha.create_withdrawal_account(1,
+                                                  TEST_TX_ACCOUNT_NAME,
+                                                  TEST_TX_ACCOUNT_NUMBER,
+                                                  TEST_TX_ACCOUNT_BANK_NAME,
+                                                  TEST_TX_ACCOUNT_BANK_BRANCH,
+                                                  TEST_TX_ACCOUNT_BANK_ADDRESS,
+                                                  TEST_TX_ACCOUNT_SWIFT_CODE,
+                                                  TEST_TX_ACCOUNT_MANAGER)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(TEST_TX_ACCOUNT_NUMBER, response.content["transaction_account_number"])
+  end
+
+  def test_create_user
+    omit_if(TEST_USER_ROLE.empty?)
+    response = @lipisha.create_user(TEST_USER_NAMES,
+                                    TEST_USER_ROLE,
+                                    TEST_USER_MOBILE,
+                                    TEST_USER_EMAIL,
+                                    TEST_USER_LOGIN,
+                                    TEST_USER_PASSWORD)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+
+end

data/test/test_balance.rb

@@ -0,0 +1,31 @@
+require "test/unit"
+require "lipisha/sdk"
+require_relative "config"
+
+class BalanceTest < Test::Unit::TestCase
+
+  def setup
+    @lipisha = Lipisha::Sdk::LipishaAPI.new(API_KEY, API_SIGNATURE, API_ENVIRONMENT)
+  end
+
+  def test_get_balance
+    response = @lipisha.get_balance()
+    puts(response)
+    assert_not_nil response
+    assert_not_nil response.status
+    assert_not_nil response.status_code
+    assert_not_nil response.content
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_get_float
+    omit_if(FLOAT_ACCOUNT.empty?)
+    response = @lipisha.get_float(FLOAT_ACCOUNT)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(FLOAT_ACCOUNT, response.content["account_number"])
+  end
+
+
+end

data/test/test_cards.rb

@@ -0,0 +1,63 @@
+require "test/unit"
+require "lipisha/sdk"
+require_relative "config"
+
+class CardTest < Test::Unit::TestCase
+
+  def setup
+    @lipisha = Lipisha::Sdk::LipishaAPI.new(API_KEY, API_SIGNATURE, API_ENVIRONMENT)
+  end
+
+  def test_authorize_card_transaction
+    omit_if((CARD_NUMBER.empty? and CARD_EXPIRY.empty?))
+    response = @lipisha.authorize_card_transaction(CARD_ACCOUNT,
+                                                   CARD_NUMBER,
+                                                   CARD_ADDRESS1,
+                                                   CARD_ADDRESS2,
+                                                   CARD_EXPIRY,
+                                                   CARD_NAMES,
+                                                   CARD_COUNTRY,
+                                                   CARD_STATE,
+                                                   CARD_ZIP,
+                                                   CARD_SECURITY_CODE,
+                                                   CARD_AMOUNT,
+                                                   CARD_CURRENCY)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_complete_card_transaction
+    omit_if((CARD_COMPLETE_TX_REF.empty? and CARD_COMPLETE_TX_INDEX.empty?))
+    response = @lipisha.complete_card_transaction(CARD_COMPLETE_TX_INDEX,
+                                                  CARD_COMPLETE_TX_REF)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(CARD_COMPLETE_TX_INDEX, response.content["transaction_index"])
+    assert_equal(CARD_COMPLETE_TX_REF, response.content["transaction_reference"])
+  end
+
+  def test_void_card_transaction
+    omit_if((CARD_VOID_TX_REF.empty? and CARD_VOID_TX_INDEX.empty?))
+    response = @lipisha.void_card_transaction(CARD_VOID_TX_INDEX,
+                                              CARD_VOID_TX_REF)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(CARD_VOID_TX_INDEX, response.content["transaction_index"])
+    assert_equal(CARD_VOID_TX_REF, response.content["transaction_reference"])
+  end
+
+  def test_reverse_card_transaction
+    omit_if((CARD_REVERSE_TX_REF.empty? and CARD_REVERSE_TX_INDEX.empty?))
+    response = @lipisha.reverse_card_transaction(CARD_REVERSE_TX_INDEX,
+                                                 CARD_REVERSE_TX_REF)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(CARD_REVERSE_TX_INDEX, response.content["transaction_index"])
+    assert_equal(CARD_REVERSE_TX_REF, response.content["transaction_reference"])
+  end
+
+end

data/test/test_send_money_airtime.rb

@@ -0,0 +1,28 @@
+require "test/unit"
+require "lipisha/sdk"
+require_relative "config"
+
+class SendMoneyAirtimeTest < Test::Unit::TestCase
+
+  def setup
+    @lipisha = Lipisha::Sdk::LipishaAPI.new(API_KEY, API_SIGNATURE, API_ENVIRONMENT)
+  end
+
+  def test_send_money
+    omit_if((PAYOUT_AMOUNT.nil? and PAYOUT_ACCOUNT.empty? and PAYOUT_MOBILE_NUMBER.empty?))
+    response = @lipisha.send_money(PAYOUT_ACCOUNT, PAYOUT_MOBILE_NUMBER, PAYOUT_AMOUNT)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_send_airtime
+    omit_if((AIRTIME_AMOUNT.nil? and AIRTIME_NETWORK.empty? and AIRTIME_MOBILE_NUMBER.empty?))
+    response = @lipisha.send_airtime(AIRTIME_ACCOUNT, AIRTIME_MOBILE_NUMBER, AIRTIME_AMOUNT, AIRTIME_NETWORK)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(AIRTIME_MOBILE_NUMBER, response.content["mobile_number"])
+    assert_equal(AIRTIME_AMOUNT, response.content["amount"])
+  end
+end

data/test/test_transactions_customers.rb

@@ -0,0 +1,46 @@
+require "test/unit"
+require "lipisha/sdk"
+require_relative "config"
+
+class TransactionsTest < Test::Unit::TestCase
+
+  def setup
+    @lipisha = Lipisha::Sdk::LipishaAPI.new(API_KEY, API_SIGNATURE, API_ENVIRONMENT)
+  end
+
+  def test_get_transactions
+    response = @lipisha.get_transactions(transcation_amount_minimum=10.0,
+                                         transaction_amount_maximum=200.0)
+    puts(response)
+    assert_not_nil response
+    assert_not_nil response.status
+    assert_not_nil response.status_code
+    assert_not_nil response.content
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_get_customers
+    response = @lipisha.get_customers(customer_payments_minimum=20.0)
+    puts(response)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+
+  def test_confirm_transaction
+    omit_if(TRANSACTION_ID_CONFIRM.empty?)
+    response = @lipisha.confirm_transaction(TRANSACTION_ID_CONFIRM)
+    puts(response)
+    assert_not_nil response
+    assert_not_nil response.content
+    assert_not_nil response.status
+    assert_equal(STATUS_SUCCESS, response.status)
+    assert_equal(STATUS_CONFIRMED, response.content["transaction_status"])
+  end
+
+  def test_reverse_transaction
+    omit_if(TRANSACTION_ID_REVERSE.empty?)
+    response = @lipisha.reverse_transaction(TRANSACTION_ID_REVERSE)
+    assert_not_nil response
+    assert_equal(STATUS_SUCCESS, response.status)
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: lipisha-sdk
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Lipisha Consortium Limited
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  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: Lipisha Payments Ruby SDK.
+email:
+- api@lipisha.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- examples/README.md
+- lib/lipisha/sdk.rb
+- lib/lipisha/sdk/version.rb
+- lipisha-sdk.gemspec
+- test/config.rb
+- test/test_accounts.rb
+- test/test_balance.rb
+- test/test_cards.rb
+- test/test_send_money_airtime.rb
+- test/test_transactions_customers.rb
+homepage: https://github.com/lipisha/lipisha-ruby-sdk
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Lipisha Payments Ruby SDK
+test_files:
+- test/config.rb
+- test/test_accounts.rb
+- test/test_balance.rb
+- test/test_cards.rb
+- test/test_send_money_airtime.rb
+- test/test_transactions_customers.rb