paynow_sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 56bee4241cdf99c577b8120b93bc5ea43d5c731e757564f6f3a98d8b9406f19c
+  data.tar.gz: 57a991385c85ac9efe9fb642baf40f5a92a46c7ab56fb08d45c1a0cb65ba71d4
+SHA512:
+  metadata.gz: 6c9a8eb3e02601664d30f502429bbfc2997504145f31968844d0eab9f73f4017f3b645183dd0ee6455b69d7be7b8db24332f099319c9e1aa3cc386b109de91d6
+  data.tar.gz: 5fe8c87c533671b3bd6815376dd8a976da289f0dbfaeca60071875b1f32f573485fb8c7f9326d06f847517a3abb3fc488e0cbd89d270965ee910ae1e7a85c731

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.7.1
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in paynow_sdk.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "minitest", "~> 5.0"
+gem "minitest-reporters", "~> 1.4", ">= 1.4.2"

data/Gemfile.lock

@@ -0,0 +1,30 @@
+PATH
+  remote: .
+  specs:
+    paynow_sdk (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.5.0)
+    builder (3.2.4)
+    minitest (5.14.1)
+    minitest-reporters (1.4.2)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    rake (12.3.3)
+    ruby-progressbar (1.10.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  minitest (~> 5.0)
+  minitest-reporters (~> 1.4, >= 1.4.2)
+  paynow_sdk!
+  rake (~> 12.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,36 @@
+# PaynowSdk
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/paynow_sdk`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'paynow_sdk'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install paynow_sdk
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/paynow_sdk.
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "paynow_sdk"
+
+# 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/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/lib/paynow_sdk.rb

@@ -0,0 +1,269 @@
+require "paynow_sdk/version"
+require "httparty"
+
+#throws error when hash from Paynow does not match locally generated hash
+
+class HashMismatch < StandardError
+  def initialize(message)
+    super(message)
+  end
+end
+
+# status of the transaction
+
+class StatusResponse
+  attr_accessor :paid, :status, :amount, :reference, :paynow_reference, :hash
+
+  def initialize(data, update)
+    @data = data
+    @update = update
+    if update
+      self.status_update(data)
+    else
+      self.status = data["status"].downcase
+      self.paid = self.status == "paid"
+
+      if data.include?("amount")
+        self.amount = data["amount"].to_f
+      end
+      if data.include?("reference")
+        self.reference = data["reference"].to_s
+      end
+      if data.include?("paynow_reference")
+        self.paynow_reference = data["paynow_reference"].to_s
+      end
+      if data.include?("hash")
+        self.hash = data["hash"]
+      end
+    end
+  end
+
+  def self.status_update(data)
+    print "Not Implemented"
+  end
+end
+
+#response from paynow during transaction
+
+class InitialResponse
+  attr_accessor :success, :instructions, :has_redirect, :hash, :redirect_url, :error, :poll_url
+
+  def initialize(data)
+    @data = data
+
+    self.status = data["status"]
+    self.success = data["status"].downcase != "error"
+    self.has_redirect = data["browserurl"]
+    self.hash = data["hash"]
+
+    if !self.success
+      self.poll_url = data["pollurl"]
+      self.error = data["error"]
+    end
+    if !self.has_redirect
+      self.redirect_url = data["browserurl"]
+    end
+    if data.include?(instructions)
+      self.instruction = data["instructions"]
+    end
+  end
+end
+
+#Create a transaction
+
+class Payment
+  attr_accessor :items, :auth_email
+
+  def initialize(reference, auth_email)
+    @reference = reference
+    @auth_email = auth_email
+  end
+
+  def add(title, amount)
+    self.items.push([title, amount])
+  end
+
+  def self.total
+    total = 0.0
+    items.each do |item|
+      total += item[1]
+      return total
+    end
+  end
+
+  def self.info
+    ticket = ""
+    items.each do |item|
+      ticket += item[0] + ", "
+      return ticket
+    end
+  end
+end
+
+class PaynowSdk
+  attr_accessor :integration_id, :integration_key
+
+  url_initiate_transaction = "https://www.paynow.co.zw/interface/initiatetransaction"
+  url_initiate_mobile_transaction = "https://www.paynow.co.zw/interface/remotetransaction"
+
+  return_url = ""
+  result_url = ""
+
+  def initialize(integration_id, integration_key, return_url, result_url)
+    @integration_id = integration_id
+    @integration_key = integration_key
+    @return_url = return_url
+    @result_url = result_url
+  end
+
+  def self.result_url(url)
+    self.result_url = url
+  end
+
+  def self.create_payment(reference, auth_email)
+    return Payment.new(reference, auth_email)
+  end
+
+  def send(payment)
+    return paying(payment)
+  end
+
+  def send_mobile(payment, phone, method)
+    return paying_mobile(payment, phone, method)
+  end
+
+  def process_status_update(data)
+    return StatusResponse(data)
+  end
+
+  def self.paying(payment)
+    if payment.total <= 0
+      raise "Transaction total cannot be less than 1"
+    end
+
+    data = build(payment)
+
+    response = HTTParty.post(url_initiate_transaction, data)
+    response_object = rebuild_response(response.parsed_response)
+
+    if response_object.status.to_s == "error"
+      return InitalResponse.new(response_object)
+    end
+    if !verify_hash(response_object, integration_key)
+      raise HashMismatchException("Hashes do not match")
+    end
+    return InitalResponse.new(response_object)
+  end
+
+  def paying_mobile(payment, phone, method)
+    if payment.total <= 0
+      raise "Transaction total cannot be less than 1"
+    end
+
+    if !payment.auth_email || payment.auth_email.length <= 0
+      raise "Auth email is required for mobile transactions. You can pass the auth email as the "
+      "second parameter in the create_payment method call"
+    end
+
+    data = build(payment, phone, method)
+
+    response = HTTParty.post(url_initiate_mobile_transaction, data)
+    response_object = rebuild_response(response.parsed_response)
+
+    if response_object["status"].to_s == "error"
+      return InitalResponse.new(response_object)
+    end
+    if !verify_hash(response_object, integration_key)
+      raise HashMismatchException("Hashes do not match")
+    end
+    return InitalResponse.new(response_object)
+  end
+
+  def self.check_transaction_status(poll_url)
+    response = HTTParty.post(poll_url, data)
+    response_object = rebuild_response(response.parsed_response)
+
+    return StatusResponse.new(response_object)
+  end
+
+  def build(payment)
+    body = {
+      "resulturl": result_url,
+      "returnurl": return_url,
+      "reference": payment.reference,
+      "amount": payment.total,
+      "id": integration_id,
+      "additionalinfo": payment.info,
+      "authemail": payment.auth_email || "",
+      "status": "Message",
+    }
+
+    body.each do |key, value|
+      body[key] = %q[value].to_s
+    end
+
+    body["hash"] = ahash(body, integration_key)
+
+    return body
+  end
+
+  def build_mobile(payment, phone, method)
+    body = {
+      "resulturl": result_url,
+      "returnurl": return_url,
+      "reference": payment.reference,
+      "amount": payment.total,
+      "id": integration_id,
+      "additionalinfo": payment.info,
+      "authemail": payment.auth_email || "",
+      "phone": phone,
+      "method": method,
+      "status": "Message",
+    }
+
+    body.each do |key, value|
+      if key == "authemail"
+        next
+      end
+
+      body[key] = %q[value].to_s
+    end
+
+    body["hash"] = ahash(body, integration_key)
+
+    return body
+  end
+
+  def self.ahash(items, integration_key)
+    out = ""
+    items.each do |key, value|
+      if key.to_s.downcase == "hash"
+        next
+      end
+      out = value.to_s
+    end
+    out += integration_key.downcase
+
+    # return hashlib.sha512(out.encode('utf-8')).hexdigest().upper()
+  end
+
+  def self.verify_hash(response, integration_key)
+    if "hash" != response
+      raise "Response from Paynow does not contain a hash"
+    end
+
+    old_hash = response["hash"]
+    new_hash = self.ahash(response, integration_key)
+
+    return old_hash == new_hash
+  end
+
+  def self.rebuild_response(response)
+    res = {}
+    response.each do |key, value|
+      res[key] = value[0].to_s
+    end
+
+    return res
+  end
+end

data/lib/paynow_sdk/version.rb

@@ -0,0 +1,3 @@
+module PaynowSdk
+  VERSION = "0.1.0"
+end

data/paynow_sdk.gemspec

@@ -0,0 +1,27 @@
+require_relative "lib/paynow_sdk/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "paynow_sdk"
+  spec.version = PaynowSdk::VERSION
+  spec.authors = ["marshall nyasha chikari"]
+  spec.email = ["marshall.chikari@gmail.com"]
+
+  spec.summary = %q{A paynow payment gateway system for ruby apps.}
+  spec.description = %q{The gem includes modules and methods to make it easy for integrating paynow api to ruby apps.}
+  spec.homepage = "https://github.com/gitnyasha/paynow-ruby-sdk"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org/"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/gitnyasha/paynow-ruby-sdk"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end