judopay 1.0.0.pre

data/spec/judopay/web_payments/preauth_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require_relative '../../../lib/judopay/models/web_payments/preauth'
+
+describe Judopay::WebPayments::Preauth do
+  it 'should create a new web preauth request' do
+    stub_post('/webpayments/payments').
+      to_return(:status => 200,
+                :body => lambda { |_request| fixture('web_payments/payments/create.json') })
+
+    payment = build(:web_preauth)
+    response = payment.create
+
+    expect(response).to be_a(Hash)
+    expect(response.post_url).to eq('https://pay.judopay-sandbox.com/')
+  end
+end

data/spec/judopay/web_payments/transaction_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+require_relative '../../../lib/judopay/models/web_payments/transaction'
+
+describe Judopay::WebPayments::Transaction do
+  it 'should give details of a single web transaction given a valid reference' do
+    reference = '4gcBAAMAGAASAAAADA66kRor6ofknGqU3A6i-759FprFGPH3ecVcW5ChMQK0f3pLBQ'
+    stub_get('/webpayments/' + reference).
+      to_return(:status => 200,
+                :body => lambda { |_request| fixture('web_payments/payments/find.json') })
+
+    payment = Judopay::WebPayments::Transaction.find(reference)
+    expect(payment).to be_a(Hash)
+    expect(payment.reference).to eq(reference)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,37 @@
+require_relative '../lib/judopay'
+require 'i18n'
+
+require 'factory_girl'
+require 'factories'
+require 'webmock/rspec'
+
+# Added to counter deprecation warning
+I18n.enforce_available_locales = true
+
+RSpec.configure do |config|
+  config.include FactoryGirl::Syntax::Methods
+  config.include WebMock::API
+
+  config.expect_with :rspec do |c|
+    c.syntax = [:expect, :should]
+  end
+end
+
+# Use Judopay default configuration
+Judopay.configure
+
+def stub_get(path)
+  stub_request(:get, /judopay/i)
+end
+
+def stub_post(path)
+  stub_request(:post, /judopay/i)
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end

data/tutorials/judo_getting_started.md

@@ -0,0 +1,74 @@
+# Getting started - Ruby
+
+[Include standard create account/getting started sections]
+
+## Installation
+
+The Judopay gem supports Ruby 1.9.3 and above (including 2.0.x and 2.1.x).
+
+Add this line to your application's Gemfile:
+
+    gem 'judopay'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install judopay
+
+## Dependencies
+
+These will all be automatically installed for you when you install the Judopay gem.
+
+### virtus
+https://github.com/solnic/virtus
+Provides a common API for defining attributes on a model
+
+### httpclient
+https://github.com/nahi/httpclient
+HTTP client adaptor used by Faraday
+
+### activemodel
+https://github.com/rails/rails/tree/master/activemodel
+Provides pre-request validation of user input
+
+### faraday
+https://github.com/lostisland/faraday
+Simple, but flexible HTTP client library
+
+### rash
+https://github.com/tcocca/rash
+Extension to Hashie::Mash to convert all keys in the hash to underscore
+
+### addressable
+https://github.com/sporkmonger/addressable
+Used for generation of URIs
+
+# Configuration
+
+You configure the Judopay gem by passing a block. For example:
+
+Judopay.configure do |config|
+	config.judo_id = 12345
+end
+
+# Authentication
+You can authenticate either with basic authentication by passing your login and password credentials or using an existing OAuth2 access token.
+
+### Basic authentication
+
+Judopay.configure do |config|
+	config.judo_id = 12345
+	config.api_token = 'your-token'
+  config.api_secret = 'your-secret'
+end
+
+### OAuth2 access token authentication
+
+Judopay.configure do |config|
+	config.judo_id = 12345
+	config.oauth_access_token = 'your-oauth-token'
+end
+

data/tutorials/judo_making_a_payment.md

@@ -0,0 +1,84 @@
+# Making a payment - Ruby
+
+First, configure Judopay with your authentication credentials (as described in the Getting Started guide).
+
+Judopay.configure do |config|
+	config.api_token = 'your-token'
+  config.api_secret = 'your-secret'
+end
+
+To make a new payment with full card details, create a new Judopay::Payment. You can check on the required fields and the format of each field in the _Judopay REST API reference_.
+
+transaction = Judopay::Payment.new(
+  :your_consumer_reference => '123',
+  :your_payment_reference => '456',
+  :judo_id => '123-456-789',
+  :amount => 5.01,
+  :card_number => '4976000000003436',
+  :expiry_date => '12/15',
+  :cv2 => '452',
+  :card_address => {
+  	:line1 => '32 Edward Street',
+  	:town => 'Camborne',
+  	:postcode => 'TR14 8PA'
+	},
+  :consumer_location => {
+    :latitude => 51.5033630,
+    :longitude => -0.1276250
+  }
+)
+
+To send the request to the API, call:
+
+response = payment.create
+
+If the payment is successful, you'll receive a response like this:
+
+#<Judopay::Mash amount=5.01 appears_on_statement_as="JudoPay/XXX" card_details=#<Judopay::Mash card_lastfour="3436" card_token="WidQ0QXs4VMloCCerfGFHQkLVFwbwjVc" card_type=1 end_date="1215"> consumer=#<Judopay::Mash consumer_token="rFl6UUihdSfpJt3x" your_consumer_reference="123"> created_at="2014-07-08T15:49:10.8587+01:00" currency="GBP" judo_id=100978394 merchant_name="XXXX" message="AuthCode: 570320" net_amount=5.01 original_amount=5.01 receipt_id="465377" result="Success" type="Payment">
+
+The Judopay::Mash object behaves like a traditional Hash, but with extra special powers. See:
+
+http://www.intridea.com/blog/2008/4/12/mash-mocking-hash-for-total-poser-objects
+
+## Error handling
+
+When making a payment, there are a number of different scenarios that can arise. It is important to handle all of the different exceptions in your code.
+
+begin
+  response = payment.create
+rescue Judopay::ValidationError => e
+	puts e.message
+	puts e.model_errors.inspect # Hash of validation errors
+rescue Judopay::BadRequest => e
+  # Invalid parameters were supplied to Judopay's API
+	puts e.message
+	puts e.model_errors.inspect # Hash of validation errors
+rescue Judopay::NotAuthorized => e
+  # You're not authorized to make the request - check credentials and permissions in the Judopay portal
+rescue Judopay::NotFound => e
+  # The resource was not found
+rescue Judopay::Conflict => e
+  # Rate limiting - you have made too many requests to the Judopay API
+rescue Judopay::Error => e
+  # There was a problem connecting to the API
+rescue => e
+  # A problem occurred outside the Judopay gem
+end
+
+## Logging
+
+To help you debug your Judopay integration, you can attach a logger to the gem.
+
+For example, to log debug messages to the file 'log.txt':
+
+logger = Logger.new('log.txt')
+logger.level = Logger::DEBUG
+Judopay.configure do |config|
+	config.logger = logger
+end
+
+If you're using Rails, you use the built-in logger to write to your existing application log file:
+
+Judopay.configure do |config|
+	config.logger = Rails.logger
+end

metadata

@@ -0,0 +1,373 @@
+--- !ruby/object:Gem::Specification
+name: judopay
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre
+platform: ruby
+authors:
+- Chris Rosser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: 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: rspec
+  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: yard
+  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: yard-xml
+  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: factory_girl
+  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: rubocop
+  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: webmock
+  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: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.6
+description: ''
+email:
+- developersupport@judopay.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".yardopts"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- judopay.gemspec
+- lib/certs/rapidssl_ca.crt
+- lib/faraday/judo_mashify.rb
+- lib/faraday/raise_http_exception.rb
+- lib/judopay.rb
+- lib/judopay/api.rb
+- lib/judopay/connection.rb
+- lib/judopay/core_ext/hash.rb
+- lib/judopay/core_ext/string.rb
+- lib/judopay/error.rb
+- lib/judopay/mash.rb
+- lib/judopay/model.rb
+- lib/judopay/models/card_address.rb
+- lib/judopay/models/card_payment.rb
+- lib/judopay/models/card_preauth.rb
+- lib/judopay/models/collection.rb
+- lib/judopay/models/consumer_location.rb
+- lib/judopay/models/market/collection.rb
+- lib/judopay/models/market/payment.rb
+- lib/judopay/models/market/preauth.rb
+- lib/judopay/models/market/refund.rb
+- lib/judopay/models/market/transaction.rb
+- lib/judopay/models/payment.rb
+- lib/judopay/models/preauth.rb
+- lib/judopay/models/refund.rb
+- lib/judopay/models/token_payment.rb
+- lib/judopay/models/token_preauth.rb
+- lib/judopay/models/transaction.rb
+- lib/judopay/models/web_payments/payment.rb
+- lib/judopay/models/web_payments/preauth.rb
+- lib/judopay/models/web_payments/transaction.rb
+- lib/judopay/null_logger.rb
+- lib/judopay/request.rb
+- lib/judopay/response.rb
+- lib/judopay/serializer.rb
+- lib/judopay/version.rb
+- spec/factories.rb
+- spec/faraday/response_spec.rb
+- spec/fixtures/card_payments/create.json
+- spec/fixtures/card_payments/create_3dsecure.json
+- spec/fixtures/card_payments/create_bad_request.json
+- spec/fixtures/card_payments/create_declined.json
+- spec/fixtures/card_payments/validate.json
+- spec/fixtures/token_payments/create.json
+- spec/fixtures/transactions/all.json
+- spec/fixtures/transactions/find.json
+- spec/fixtures/transactions/find_not_found.json
+- spec/fixtures/web_payments/payments/create.json
+- spec/fixtures/web_payments/payments/find.json
+- spec/judopay/card_address_spec.rb
+- spec/judopay/card_payment_spec.rb
+- spec/judopay/card_preauth_spec.rb
+- spec/judopay/collection_spec.rb
+- spec/judopay/core_ext/hash_spec.rb
+- spec/judopay/core_ext/string_spec.rb
+- spec/judopay/error_spec.rb
+- spec/judopay/judopay_spec.rb
+- spec/judopay/market/collection_spec.rb
+- spec/judopay/market/payment_spec.rb
+- spec/judopay/market/preauth_spec.rb
+- spec/judopay/market/refund_spec.rb
+- spec/judopay/market/transaction_spec.rb
+- spec/judopay/payment_spec.rb
+- spec/judopay/preauth_spec.rb
+- spec/judopay/refund_spec.rb
+- spec/judopay/token_payment_spec.rb
+- spec/judopay/token_preauth_spec.rb
+- spec/judopay/transaction_spec.rb
+- spec/judopay/web_payments/payment_spec.rb
+- spec/judopay/web_payments/preauth_spec.rb
+- spec/judopay/web_payments/transaction_spec.rb
+- spec/spec_helper.rb
+- tutorials/judo_getting_started.md
+- tutorials/judo_making_a_payment.md
+homepage: http://www.judopay.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby SDK wrapper for the Judopay REST API
+test_files:
+- spec/factories.rb
+- spec/faraday/response_spec.rb
+- spec/fixtures/card_payments/create.json
+- spec/fixtures/card_payments/create_3dsecure.json
+- spec/fixtures/card_payments/create_bad_request.json
+- spec/fixtures/card_payments/create_declined.json
+- spec/fixtures/card_payments/validate.json
+- spec/fixtures/token_payments/create.json
+- spec/fixtures/transactions/all.json
+- spec/fixtures/transactions/find.json
+- spec/fixtures/transactions/find_not_found.json
+- spec/fixtures/web_payments/payments/create.json
+- spec/fixtures/web_payments/payments/find.json
+- spec/judopay/card_address_spec.rb
+- spec/judopay/card_payment_spec.rb
+- spec/judopay/card_preauth_spec.rb
+- spec/judopay/collection_spec.rb
+- spec/judopay/core_ext/hash_spec.rb
+- spec/judopay/core_ext/string_spec.rb
+- spec/judopay/error_spec.rb
+- spec/judopay/judopay_spec.rb
+- spec/judopay/market/collection_spec.rb
+- spec/judopay/market/payment_spec.rb
+- spec/judopay/market/preauth_spec.rb
+- spec/judopay/market/refund_spec.rb
+- spec/judopay/market/transaction_spec.rb
+- spec/judopay/payment_spec.rb
+- spec/judopay/preauth_spec.rb
+- spec/judopay/refund_spec.rb
+- spec/judopay/token_payment_spec.rb
+- spec/judopay/token_preauth_spec.rb
+- spec/judopay/transaction_spec.rb
+- spec/judopay/web_payments/payment_spec.rb
+- spec/judopay/web_payments/preauth_spec.rb
+- spec/judopay/web_payments/transaction_spec.rb
+- spec/spec_helper.rb
+has_rdoc: