payfort_start 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 21a5936818d47f37354f17ab24a9844da1456fd2
+  data.tar.gz: 7af678b629882d5d4be4c9528c1a17a50a41da9b
+SHA512:
+  metadata.gz: 56f81f4e54b67e62b2f8e132cc3478cc6cac42672419133080e076b335812a2c0c444ef5d04d6e6c00fb8ac9da8145a189c324fa20a65d76b9d490b3ecea9638
+  data.tar.gz: 35421f2a412b24dd33e9e65a0fe857a48eb0e70e9fd612d4d47fca081208539e4ea485a46c8b521ac2a923d886d4627feb974166878bbd4b101f7831c8109e74

data/.gitignore

@@ -0,0 +1,34 @@
+*.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/
+/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,6 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "rspec"
+gem "byebug"

data/Gemfile.lock

@@ -0,0 +1,44 @@
+PATH
+  remote: .
+  specs:
+    payfort (0.1)
+      httparty (~> 0.13)
+      json (~> 1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    byebug (3.5.1)
+      columnize (~> 0.8)
+      debugger-linecache (~> 1.2)
+      slop (~> 3.6)
+    columnize (0.9.0)
+    debugger-linecache (1.2.0)
+    diff-lcs (1.2.5)
+    httparty (0.13.5)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.3)
+    multi_xml (0.5.5)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    slop (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  payfort!
+  rspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Payfort
+
+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,95 @@
+# Start Ruby
+
+Payfort Start makes accepting payments in the Middle East ridiculously easy. Sign up for an account at [start.payfort.com](https://start.payfort.com).
+
+## Getting Started
+
+Using Start with your Ruby project is simple. If you're using [bundler](http://bundler.io) (and really, who isn't these days amirite?), you just need to add one line to your `Gemfile`:
+
+```ruby
+gem 'payfort_start', require: 'start'
+```
+
+Now, running `bundle install` will pull the library directly to your local project.
+
+## Using Start
+
+You'll need an account with Start if you don't already have one (grab one real quick at [start.payfort.com](https://start.payfort.com) and come back .. we'll wait).
+
+Got an account? Great .. let's get busy.
+
+### 1. Initializing Start
+
+To get started, you'll need to initialize Start with your secret API key. Here's how that looks (we're using a test key, so no real money will be exchanging hands):
+
+```ruby
+require 'start'
+
+Start.api_key = "test_sec_k_25dd497d7e657bb761ad6"
+```
+
+That's it! You probably want to do something with the Start object though -- it gets really bored when it doesn't have anything to do.
+
+Let's run a transaction, shall we.
+
+### 2. Processing a transaction through Start
+
+Now, for the fun part. Here's all the code you need to process a transaction with Start:
+
+```ruby
+Start::Charge.create(
+    :amount => 5,
+    :currency => "aed",
+    :email => "customer@example.com",
+    :card => {
+      :number => "4242424242424242",
+      :exp_month => 11,
+      :exp_year => 2016,
+      :cvv => 123
+    },
+    :description => "2kg of lizard tails, non-refundable"
+  )
+```
+
+This transaction should be successful since we used the `4242 4242 4242 4242` test credit card. For a complete list of test cards, and their expected output you can check out this link [here](https://docs.start.payfort.com/testing/).
+
+How can you tell that it was successful? Well, if no exception is raised then you're in the clear.
+
+### 3. Handling Errors
+
+Any errors that may occur during a transaction is raised as an Exception. Here's an example of how you can handle errors with Start:
+
+```ruby
+begin
+  # Use Start's bindings...
+
+rescue Start::BankingError => e
+  # Since it's a decline, Start::BankingError will be caught
+  puts "Status is: #{e.http_status}"
+  puts "Code is: #{e.code}"
+  puts "Message is: #{e.message}"
+
+rescue Start::RequestError => e
+  # Invalid parameters were supplied to Start's API
+
+rescue Start::AuthenticationError => e
+  # There's something wrong with that API key you passed
+
+rescue Start::ProcessingError => e
+  # There's something wrong on Start's end
+
+rescue Start::StartError => e
+  # Display a very generic error to the user, and maybe send
+  # yourself an email
+
+rescue => e
+  # Something else happened, completely unrelated to Start
+end
+```
+
+## Testing Start
+If you're looking to contribute to Start, then grab this repo and run `rake` on your local machine to run the unit tests.
+
+## Contributing
+
+Read our [Contributing Guidelines](CONTRIBUTING.md) for details

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.pattern = './spec/**/*_spec.rb'
+end

data/lib/data/ssl-bundle.crt

@@ -0,0 +1,92 @@
+-----BEGIN CERTIFICATE-----
+MIIGCDCCA/CgAwIBAgIQKy5u6tl1NmwUim7bo3yMBzANBgkqhkiG9w0BAQwFADCB
+hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
+BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTQwMjEy
+MDAwMDAwWhcNMjkwMjExMjM1OTU5WjCBkDELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
+EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
+Q09NT0RPIENBIExpbWl0ZWQxNjA0BgNVBAMTLUNPTU9ETyBSU0EgRG9tYWluIFZh
+bGlkYXRpb24gU2VjdXJlIFNlcnZlciBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEP
+ADCCAQoCggEBAI7CAhnhoFmk6zg1jSz9AdDTScBkxwtiBUUWOqigwAwCfx3M28Sh
+bXcDow+G+eMGnD4LgYqbSRutA776S9uMIO3Vzl5ljj4Nr0zCsLdFXlIvNN5IJGS0
+Qa4Al/e+Z96e0HqnU4A7fK31llVvl0cKfIWLIpeNs4TgllfQcBhglo/uLQeTnaG6
+ytHNe+nEKpooIZFNb5JPJaXyejXdJtxGpdCsWTWM/06RQ1A/WZMebFEh7lgUq/51
+UHg+TLAchhP6a5i84DuUHoVS3AOTJBhuyydRReZw3iVDpA3hSqXttn7IzW3uLh0n
+c13cRTCAquOyQQuvvUSH2rnlG51/ruWFgqUCAwEAAaOCAWUwggFhMB8GA1UdIwQY
+MBaAFLuvfgI9+qbxPISOre44mOzZMjLUMB0GA1UdDgQWBBSQr2o6lFoL2JDqElZz
+30O0Oija5zAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNV
+HSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwGwYDVR0gBBQwEjAGBgRVHSAAMAgG
+BmeBDAECATBMBgNVHR8ERTBDMEGgP6A9hjtodHRwOi8vY3JsLmNvbW9kb2NhLmNv
+bS9DT01PRE9SU0FDZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDBxBggrBgEFBQcB
+AQRlMGMwOwYIKwYBBQUHMAKGL2h0dHA6Ly9jcnQuY29tb2RvY2EuY29tL0NPTU9E
+T1JTQUFkZFRydXN0Q0EuY3J0MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21v
+ZG9jYS5jb20wDQYJKoZIhvcNAQEMBQADggIBAE4rdk+SHGI2ibp3wScF9BzWRJ2p
+mj6q1WZmAT7qSeaiNbz69t2Vjpk1mA42GHWx3d1Qcnyu3HeIzg/3kCDKo2cuH1Z/
+e+FE6kKVxF0NAVBGFfKBiVlsit2M8RKhjTpCipj4SzR7JzsItG8kO3KdY3RYPBps
+P0/HEZrIqPW1N+8QRcZs2eBelSaz662jue5/DJpmNXMyYE7l3YphLG5SEXdoltMY
+dVEVABt0iN3hxzgEQyjpFv3ZBdRdRydg1vs4O2xyopT4Qhrf7W8GjEXCBgCq5Ojc
+2bXhc3js9iPc0d1sjhqPpepUfJa3w/5Vjo1JXvxku88+vZbrac2/4EjxYoIQ5QxG
+V/Iz2tDIY+3GH5QFlkoakdH368+PUq4NCNk+qKBR6cGHdNXJ93SrLlP7u3r7l+L4
+HyaPs9Kg4DdbKDsx5Q5XLVq4rXmsXiBmGqW5prU5wfWYQ//u+aen/e7KJD2AFsQX
+j4rBYKEMrltDR5FL1ZoXX/nUh8HCjLfn4g8wGTeGrODcQgPmlKidrv0PJFGUzpII
+0fxQ8ANAe4hZ7Q7drNJ3gjTcBpUC2JD5Leo31Rpg0Gcg19hCC0Wvgmje3WYkN5Ap
+lBlGGSW4gNfL1IYoakRwJiNiqZ+Gb7+6kHDSVneFeO/qJakXzlByjAA6quPbYzSf
++AZxAeKCINT+b72x
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIFdDCCBFygAwIBAgIQJ2buVutJ846r13Ci/ITeIjANBgkqhkiG9w0BAQwFADBv
+MQswCQYDVQQGEwJTRTEUMBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFk
+ZFRydXN0IEV4dGVybmFsIFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBF
+eHRlcm5hbCBDQSBSb290MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFow
+gYUxCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAO
+BgNVBAcTB1NhbGZvcmQxGjAYBgNVBAoTEUNPTU9ETyBDQSBMaW1pdGVkMSswKQYD
+VQQDEyJDT01PRE8gUlNBIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkq
+hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAkehUktIKVrGsDSTdxc9EZ3SZKzejfSNw
+AHG8U9/E+ioSj0t/EFa9n3Byt2F/yUsPF6c947AEYe7/EZfH9IY+Cvo+XPmT5jR6
+2RRr55yzhaCCenavcZDX7P0N+pxs+t+wgvQUfvm+xKYvT3+Zf7X8Z0NyvQwA1onr
+ayzT7Y+YHBSrfuXjbvzYqOSSJNpDa2K4Vf3qwbxstovzDo2a5JtsaZn4eEgwRdWt
+4Q08RWD8MpZRJ7xnw8outmvqRsfHIKCxH2XeSAi6pE6p8oNGN4Tr6MyBSENnTnIq
+m1y9TBsoilwie7SrmNnu4FGDwwlGTm0+mfqVF9p8M1dBPI1R7Qu2XK8sYxrfV8g/
+vOldxJuvRZnio1oktLqpVj3Pb6r/SVi+8Kj/9Lit6Tf7urj0Czr56ENCHonYhMsT
+8dm74YlguIwoVqwUHZwK53Hrzw7dPamWoUi9PPevtQ0iTMARgexWO/bTouJbt7IE
+IlKVgJNp6I5MZfGRAy1wdALqi2cVKWlSArvX31BqVUa/oKMoYX9w0MOiqiwhqkfO
+KJwGRXa/ghgntNWutMtQ5mv0TIZxMOmm3xaG4Nj/QN370EKIf6MzOi5cHkERgWPO
+GHFrK+ymircxXDpqR+DDeVnWIBqv8mqYqnK8V0rSS527EPywTEHl7R09XiidnMy/
+s1Hap0flhFMCAwEAAaOB9DCB8TAfBgNVHSMEGDAWgBStvZh6NLQm9/rEJlTvA73g
+JMtUGjAdBgNVHQ4EFgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQD
+AgGGMA8GA1UdEwEB/wQFMAMBAf8wEQYDVR0gBAowCDAGBgRVHSAAMEQGA1UdHwQ9
+MDswOaA3oDWGM2h0dHA6Ly9jcmwudXNlcnRydXN0LmNvbS9BZGRUcnVzdEV4dGVy
+bmFsQ0FSb290LmNybDA1BggrBgEFBQcBAQQpMCcwJQYIKwYBBQUHMAGGGWh0dHA6
+Ly9vY3NwLnVzZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggEBAGS/g/FfmoXQ
+zbihKVcN6Fr30ek+8nYEbvFScLsePP9NDXRqzIGCJdPDoCpdTPW6i6FtxFQJdcfj
+Jw5dhHk3QBN39bSsHNA7qxcS1u80GH4r6XnTq1dFDK8o+tDb5VCViLvfhVdpfZLY
+Uspzgb8c8+a4bmYRBbMelC1/kZWSWfFMzqORcUx8Rww7Cxn2obFshj5cqsQugsv5
+B5a6SE2Q8pTIqXOi6wZ7I53eovNNVZ96YUWYGGjHXkBrI/V5eu+MtWuLt29G9Hvx
+PUsE2JOAWVrgQSQdso8VYFhH2+9uRv0V9dlfmrPb2LjkQLPNlzmuhbsdjrzch5vR
+pu/xO28QOG8=
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIENjCCAx6gAwIBAgIBATANBgkqhkiG9w0BAQUFADBvMQswCQYDVQQGEwJTRTEU
+MBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFkZFRydXN0IEV4dGVybmFs
+IFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBFeHRlcm5hbCBDQSBSb290
+MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFowbzELMAkGA1UEBhMCU0Ux
+FDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVzdCBFeHRlcm5h
+bCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJuYWwgQ0EgUm9v
+dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALf3GjPm8gAELTngTlvt
+H7xsD821+iO2zt6bETOXpClMfZOfvUq8k+0DGuOPz+VtUFrWlymUWoCwSXrbLpX9
+uMq/NzgtHj6RQa1wVsfwTz/oMp50ysiQVOnGXw94nZpAPA6sYapeFI+eh6FqUNzX
+mk6vBbOmcZSccbNQYArHE504B4YCqOmoaSYYkKtMsE8jqzpPhNjfzp/haW+710LX
+a0Tkx63ubUFfclpxCDezeWWkWaCUN/cALw3CknLa0Dhy2xSoRcRdKn23tNbE7qzN
+E0S3ySvdQwAl+mG5aWpYIxG3pzOPVnVZ9c0p10a3CitlttNCbxWyuHv77+ldU9U0
+WicCAwEAAaOB3DCB2TAdBgNVHQ4EFgQUrb2YejS0Jvf6xCZU7wO94CTLVBowCwYD
+VR0PBAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wgZkGA1UdIwSBkTCBjoAUrb2YejS0
+Jvf6xCZU7wO94CTLVBqhc6RxMG8xCzAJBgNVBAYTAlNFMRQwEgYDVQQKEwtBZGRU
+cnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0ZXJuYWwgVFRQIE5ldHdvcmsx
+IjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENBIFJvb3SCAQEwDQYJKoZIhvcN
+AQEFBQADggEBALCb4IUlwtYj4g+WBpKdQZic2YR5gdkeWxQHIzZlj7DYd7usQWxH
+YINRsPkyPef89iYTx4AWpb9a/IfPeHmJIZriTAcKhjW88t5RxNKWt9x+Tu5w/Rw5
+6wwCURQtjr0W4MHfRnXnJK3s9EK0hZNwEGe6nQY1ShjTK3rMUUKhemPR5ruhxSvC
+Nr4TDea9Y355e6cJDUCrat2PisP29owaQgVR1EX1n6diIWgVIEM8med8vSTYqZEX
+c4g/VhsxOBi0cQ+azcgOno4uG+GMmIPLHzHxREzGBHNJdmAPx/i9F4BrLunMTA5a
+mnkPIAou1Z5jJh5VkpTYghdae9C8x49OhgQ=
+-----END CERTIFICATE-----

data/lib/start.rb

@@ -0,0 +1,21 @@
+require "httparty"
+require "start/base_resource"
+require "start/customer"
+require "start/charge"
+require "start/errors/payfort_error"
+require "start/errors/authentication_error"
+require "start/errors/banking_error"
+require "start/errors/request_error"
+require "start/errors/processing_error"
+
+module Start
+  include HTTParty
+
+  base_uri 'https://api.start.payfort.com'
+
+  ssl_ca_file File.dirname(__FILE__) + '/data/ssl-bundle.crt'
+
+  def self.api_key=(value)
+    default_options[:basic_auth] = {username: value, password: ''}
+  end
+end

data/lib/start/base_resource.rb

@@ -0,0 +1,48 @@
+module Start
+  class BaseResource
+    class << self
+      attr_accessor :path
+
+      def create(params = {})
+        handle_response Start.post(path, body: params)
+      end
+
+      def get(id)
+        handle_response Start.post("#{path}/#{id}")
+      end
+
+      def all
+        handle_response Start.get(path)
+      end
+
+      private
+
+      def handle_response(response)
+        body = JSON.parse(response.body);
+
+        if response.code.between?(200, 299) and !body.key?('error')
+          # The request was successful
+          return body
+        end
+
+        # There was an error .. check the response
+        case body['error']['type']
+        when 'banking'
+          raise Start::BankingError.new(body['error']['message'], body['error']['code'], response.code)
+
+        when 'authentication'
+          raise Start::AuthenticationError.new(body['error']['message'], body['error']['code'], response.code)
+
+        when 'processing'
+          raise Start::ProcessingError.new(body['error']['message'], body['error']['code'], response.code)
+
+        when 'request'
+          raise Start::RequestError.new(body['error']['message'], body['error']['code'], response.code)
+        end
+
+        # Otherwise, raise a General error
+        raise Start::StartError.new(body['error']['message'], body['error']['code'], response.code)
+      end
+    end
+  end
+end

data/lib/start/charge.rb

@@ -0,0 +1,5 @@
+module Start
+  class Charge < BaseResource
+    self.path = '/charges'
+  end
+end

data/lib/start/customer.rb

@@ -0,0 +1,5 @@
+module Start
+  class Customer < BaseResource
+    self.path = '/customers'
+  end
+end

data/lib/start/errors/authentication_error.rb

@@ -0,0 +1,4 @@
+module Start
+  class AuthenticationError < StartError
+  end
+end

data/lib/start/errors/banking_error.rb

@@ -0,0 +1,4 @@
+module Start
+  class BankingError < StartError
+  end
+end

data/lib/start/errors/payfort_error.rb

@@ -0,0 +1,18 @@
+module Start
+  class StartError < StandardError
+    attr_reader :message
+    attr_reader :code
+    attr_reader :http_status
+
+    def initialize(message=nil, code=nil, http_status=nil)
+      @message = message
+      @code = code
+      @http_status = http_status
+    end
+
+    def to_s
+      status_string = @http_status.nil? ? "" : "(#{@code}Error - Status #{@http_status}) "
+      "#{status_string}#{@message}"
+    end
+  end
+end

data/lib/start/errors/processing_error.rb

@@ -0,0 +1,4 @@
+module Start
+  class ProcessingError < StartError
+  end
+end 

data/lib/start/errors/request_error.rb

@@ -0,0 +1,4 @@
+module Start
+  class RequestError < StartError
+  end
+end

data/lib/start/version.rb

@@ -0,0 +1,3 @@
+module Start
+  VERSION = '0.0.1'
+end

data/payfort_start.gemspec

@@ -0,0 +1,21 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'start/version'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'payfort_start'
+  s.version = Start::VERSION
+  s.summary = 'Ruby bindings for the Payfort Start API'
+  s.description = 'Payfort Start is the easiest way to accept payments online in the middle east. See https://start.payfort.com for details.'
+  s.authors = ['Pavel Gabriel','Yazin Alirhayim']
+  s.email = ['pavel@payfort.com','yazin@payfort.com']
+  s.homepage = 'https://start.payfort.com/docs/'
+  s.license = 'MIT'
+
+  s.add_dependency('httparty', '~> 0.13')
+  s.add_dependency('json', '~> 1.8')
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.require_paths = ['lib']
+end

data/spec/lib/start/charge_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Start::Charge do
+  before do
+    Start.api_key = "test_sec_k_2b99b969196bece8fa7fd"
+  end
+
+  it "must create a new charge" do
+    response = Start::Charge.create(
+      :amount => 400,
+      :currency => "usd",
+      :email => "ahmed@example.com",
+      :card => {
+        :name => "Abdullah Ahmed",
+        :number => "4242424242424242",
+        :exp_month => 11,
+        :exp_year => 2016,
+        :cvc => 123
+      },
+      :description => "Charge for test@example.com"
+    )
+
+    expect(response['captured_amount']).to eq(400)
+  end
+
+   it "must list created charges" do
+    response = Start::Charge.all()
+
+    expect(response).to_not be_empty
+   end
+end

data/spec/lib/start/customer_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Start::Customer do
+  before do
+    Start.api_key = "test_sec_k_2b99b969196bece8fa7fd"
+  end
+
+  it "must create a new customer" do
+    response = Start::Customer.create(
+      :name => "Abdullah Ahmed",
+      :email => "abdullah@msn.com",
+      :card => {
+        :number => "4242424242424242",
+        :exp_month => 11,
+        :exp_year => 2016,
+        :cvc => 123
+      },
+      :description => "Signed up at the Trade Show in Dec 2014"
+    )
+
+    expect(response['name']).to eq("Abdullah Ahmed")
+  end
+
+  it "must list created customers" do
+    response = Start::Customer.all()
+
+    expect(response).to_not be_empty
+  end
+end

data/spec/lib/start/error/authentication_error_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Start::AuthenticationError do
+  it "must be thown with an invalid key" do
+    Start.api_key = "invalid"
+
+    expect {
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "4242424242424242",
+          :exp_month => 11,
+          :exp_year => 2016,
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    }.to raise_error Start::AuthenticationError
+  end
+end

data/spec/lib/start/error/banking_error_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Start::BankingError do
+  it "must be thown with card_declined" do
+    Start.api_key = "test_sec_k_2b99b969196bece8fa7fd"
+
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :email => "abdullah@msn.com",
+        :card => {
+          :name => "Abdullah Ahmed",
+          :number => "4000000000000002",
+          :exp_month => 11,
+          :exp_year => 2016,
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::BankingError => e
+      expect(e.code).to eq('card_declined')
+      expect(e.http_status).to eq(402)
+    end
+  end
+end

data/spec/lib/start/error/request_error_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+
+describe Start::RequestError do
+  before do
+    Start.api_key = "test_sec_k_2b99b969196bece8fa7fd"
+  end
+
+  it "must be thrown with invalid_cvc" do
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "4242424242424242",
+          :exp_month => 11,
+          :exp_year => 2016,
+          :cvc => "abc"
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::RequestError => e
+      expect(e.code).to eq('unprocessable_entity')
+      expect(e.http_status).to eq(422)
+    end
+  end
+
+  it "must be thown with expired_card" do
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "4242424242424242",
+          :exp_month => 11,
+          :exp_year => 1999,
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::RequestError => e
+      expect(e.code).to eq('unprocessable_entity')
+      expect(e.http_status).to eq(422)
+    end
+  end
+
+  it "must be thown with invalid_number" do
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "1234123412341234",
+          :exp_month => 11,
+          :exp_year => 2016,
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::RequestError => e
+      expect(e.code).to eq('unprocessable_entity')
+      expect(e.http_status).to eq(422)
+    end
+  end
+
+  it "must be thown with invalid_expiry_month" do
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "4242424242424242",
+          :exp_month => 15,
+          :exp_year => 2016,
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::RequestError => e
+      expect(e.code).to eq('unprocessable_entity')
+      expect(e.http_status).to eq(422)
+    end
+  end
+
+  it "must be thown with invalid_expiry_year" do
+    begin
+      response = Start::Charge.create(
+        :amount => 400,
+        :currency => "usd",
+        :card => {
+          :number => "4242424242424242",
+          :exp_month => 12,
+          :exp_year => "abcd",
+          :cvc => 123
+        },
+        :description => "Charge for test@example.com"
+      )
+    rescue Start::RequestError => e
+      expect(e.code).to eq('unprocessable_entity')
+      expect(e.http_status).to eq(422)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+#we need the actual library file
+require_relative '../lib/start'
+
+require 'byebug'

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: payfort_start
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Pavel Gabriel
+- Yazin Alirhayim
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: Payfort Start is the easiest way to accept payments online in the middle
+  east. See https://start.payfort.com for details.
+email:
+- pavel@payfort.com
+- yazin@payfort.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/data/ssl-bundle.crt
+- lib/start.rb
+- lib/start/base_resource.rb
+- lib/start/charge.rb
+- lib/start/customer.rb
+- lib/start/errors/authentication_error.rb
+- lib/start/errors/banking_error.rb
+- lib/start/errors/payfort_error.rb
+- lib/start/errors/processing_error.rb
+- lib/start/errors/request_error.rb
+- lib/start/version.rb
+- payfort_start.gemspec
+- spec/lib/start/charge_spec.rb
+- spec/lib/start/customer_spec.rb
+- spec/lib/start/error/authentication_error_spec.rb
+- spec/lib/start/error/banking_error_spec.rb
+- spec/lib/start/error/request_error_spec.rb
+- spec/spec_helper.rb
+homepage: https://start.payfort.com/docs/
+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.6
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for the Payfort Start API
+test_files:
+- spec/lib/start/charge_spec.rb
+- spec/lib/start/customer_spec.rb
+- spec/lib/start/error/authentication_error_spec.rb
+- spec/lib/start/error/banking_error_spec.rb
+- spec/lib/start/error/request_error_spec.rb
+- spec/spec_helper.rb