rails4-przelewy24 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7f37ff279b63fa0d281e6fb1a5a5598137117110
+  data.tar.gz: 9d98d586c156501efca4b08dd3c5a23594e13ab1
+SHA512:
+  metadata.gz: 4da113ee841fa080ce4d535b16f15c4f03a021f6bf3cf0ed4bc5b7f6e2ed712aee0eec0fc23046e7bc19e801ab8d8fad6b45f69da05ac82e4ec5ef8e32118d84
+  data.tar.gz: fd8b32f70999a2c06343cb9c7db35d0d74439cefbf1ff2c7804c46d393ac4cf4fb87ac23a4baa7ae451184eeb23c45aa76e77753d6b046691dede9b2a026dc75

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Mariusz Henn
+
+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,64 @@
+# Przelewy24 for rails4
+
+This gem provide basic communication wrapper with przelewy24 payment API v.3.2
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rails4-przelewy24'
+
+And then execute:
+
+    $ bundle
+
+## Configuration 
+
+Required in Your config file:
+    
+    Przelewy24.configure do |config|
+      config.merchant_id = <Integer:your_merchant_id>
+      config.crc = <String:your_crc_from_przelewy24_profile>
+      config.return_url = <String:url_to_return_from_payment_page>
+    end
+
+You can add separate configuration for your sandbox in development and test environments.
+
+## Testing and Developing
+
+In environments other than production, this module communicate with przelewy24 sandbox. This prevents requirement to make real money transfer when testing.
+
+## Usage
+
+Since this gem is only a function wrapper, You have to create Your own model for payments and transaction flow controller 
+according to przelewy24 specification: https://www.przelewy24.pl/files/cms/13/przelewy24_specification.pdf.
+
+### Initializing
+Dont place p24_ prefix for options. Dont format Your amount to CURRENCY/100 type. This gem will do it for You.
+
+    example_options = {session_id: 123, amount: 1.23, currency:'PLN', description:'desc', email:'mariusz.henn@gmail.com', country:'pl', url_status: 'http://example.com/status', url_return: 'http://example.com/success_transaction'}
+    transaction = Przelewy24::Transaction.new example_options
+ 
+### Registering transaction
+ 
+    transaction.register_transaction
+
+This function will provide transaction.token and transaction.transaction_url so You can redirect user to payment site.
+
+### Verifying transaction status
+Przelewy24 will send You transaction status to url_status. To verify validity of received params You can do:
+ 
+    transaction.verify_transaction_status received_params
+
+### Confirming transaction
+To confirm transaction (it is required to process money transfer from customer to You in przelewy24 system)
+
+    transaction.confirm_transaction
+   
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/rails4-przelewy24/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+Dir.glob('tasks/**/*.rake').each(&method(:import))
+
+desc 'Open an irb session preloaded with this library'
+task :console do
+  sh 'irb -rubygems -I lib -r rails4-przelewy24.rb'
+end

data/lib/przelewy24/configuration.rb

@@ -0,0 +1,44 @@
+require 'rails'
+
+module Przelewy24
+  class Configuration
+    attr_accessor :merchant_id, :crc, :url_return, :url_status
+    attr_accessor :test_connection_params, :register_transaction_params, :confirm_transaction_params
+    attr_reader :test_url, :register_url, :request_url, :confirm_transaction_url
+
+    def initialize
+      @merchant_id = nil
+      @crc = nil
+      namespace = Rails.env=='production' ? 'secure' : 'sandbox'
+      @test_url = "https://#{namespace}.przelewy24.pl/testConnection"
+      @register_url =  "https://#{namespace}.przelewy24.pl/trnRegister"
+      @request_url = "https://#{namespace}.przelewy24.pl/trnRequest/"
+      @confirm_transaction_url = "https://#{namespace}.przelewy24.pl/trnVerify"
+      @url_return = nil
+      @url_status = nil
+      @test_connection_params = hash_of %w(merchant_id pos_id sign)
+      @register_transaction_params = hash_of %w(session_id merchant_id pos_id amount currency description email country url_return url_status api_version sign)
+      @confirm_transaction_params = hash_of %w(merchant_id pos_id session_id amount currency order_id sign)
+      @api_version = '3.2'
+    end
+
+    def default_transaction_options
+      out = {}
+      self.instance_values.each do |o,v|
+        out[o.to_sym] = v
+      end
+      out
+    end
+
+    private
+
+    def hash_of(params)
+      new_hash = Hash.new
+      params.each do |k|
+        new_hash[('p24_'+k).to_sym] = nil
+      end
+      new_hash
+    end
+
+  end
+end

data/lib/przelewy24/transaction.rb

@@ -0,0 +1,100 @@
+require 'httparty'
+require 'json'
+
+module Przelewy24
+  class Transaction
+    attr_accessor :options
+    attr_reader :token, :transaction_url
+
+    def initialize(options = {})
+      @conf = Przelewy24.config
+      @options = p24_options(@conf.default_transaction_options).merge(p24_options(options))
+    end
+
+    def test_connection
+      params = create_params @conf.test_connection_params
+      sign params, %w(p24_pos_id)
+      verify_params params
+      response = query_p24 @conf.test_url, params
+      response['error'] == '0'
+    end
+
+    def register_transaction
+      params = create_params @conf.register_transaction_params
+      unless @options[:p24_order_id].present?
+        sign params, %w(p24_session_id p24_merchant_id p24_amount p24_currency)
+        verify_params params
+        response = query_p24 @conf.register_url, params
+        @token = response['token']
+        params.merge({:p24_token => @token})
+      else
+        @token = params[:p24_token]
+      end
+      @transaction_url = @conf.request_url + @token
+    end
+
+    def verify_transaction_status(params)
+      test = [params[:p24_session_id],params[:p24_order_id],params[:p24_amount],params[:p24_currency],@conf.crc]
+      raise 'malformed sign' unless Digest::MD5.hexdigest(test.join('|')) == params[:p24_sign]
+      %i(p24_session_id p24_amount p24_currency).each do |t|
+        raise "param #{t} not match" unless params[t].to_s == @options[t].to_s
+      end
+      @options[:p24_order_id] = params[:p24_order_id]
+      true
+    end
+
+    def confirm_transaction
+      params = create_params @conf.confirm_transaction_params
+      sign params, %w(p24_session_id p24_order_id p24_amount p24_currency)
+      verify_params params
+      response = query_p24 @conf.confirm_transaction_url, params
+      response['error'] == '0'
+    end
+
+    private
+
+    attr_writer :conf
+
+    def p24_options(options)
+      out = {}
+      options.each do |k, v|
+        out[('p24_'+k.to_s).to_sym] = v
+      end
+      out[:p24_pos_id] = @conf.merchant_id unless out[:p24_pos_id].present?
+      out[:p24_amount] = (out[:p24_amount]*100).to_int if out[:p24_amount].present?
+      out
+    end
+
+    def query_p24(url, params)
+      response = HTTParty.post url, body: params
+      response = Rack::Utils.parse_nested_query response.parsed_response
+      raise response['error']+': '+response['errorMessage'] unless response['error'] == '0'
+      response
+    end
+
+    def verify_params(params)
+      params.each do |p, v|
+        raise "#{p} cannot be nil" unless v.present?
+      end
+    end
+
+    def create_params(source_params = {})
+      params = {}
+      source_params.each do |k, v|
+        params[k] = @options[k]
+      end
+      params
+    end
+
+    def sign(params, with_params = {})
+      p = []
+      with_params.each do |k|
+        p << @options[k.to_sym]
+      end
+      p << @conf.crc
+      s = Digest::MD5.hexdigest p.join('|')
+      params[:p24_sign] = s
+    end
+  
+  end
+end

data/lib/przelewy24/version.rb

@@ -0,0 +1,3 @@
+module Przelewy24
+  VERSION = '0.1.6'
+end

data/lib/rails4-przelewy24.rb

@@ -0,0 +1,17 @@
+require 'przelewy24/version'
+require 'przelewy24/configuration'
+require 'przelewy24/transaction'
+require 'action_view'
+
+module Przelewy24
+  attr_writer :config
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.configure
+    yield(config) if block_given?
+  end
+
+end

data/rails4-przelewy24.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'przelewy24/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'rails4-przelewy24'
+  spec.version       = Przelewy24::VERSION
+  spec.authors       = ['Mariusz Henn']
+  spec.email         = ['mariusz.henn@gmail.com']
+  spec.summary       = %q{przelewy24 payment provider}
+  spec.description   = %q{This gem provide basic methods to communicate with przelewy24 payment system}
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.6'
+  spec.add_development_dependency 'rake', '>= 10.3.2'
+  spec.add_development_dependency 'rspec-rails', '>= 3.3.0'
+  spec.add_runtime_dependency 'httparty', '~> 0.13.5'
+  spec.add_runtime_dependency 'rails', '>= 4.0.0'
+end

data/spec/przelewy24_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+require 'action_controller'
+describe Przelewy24 do
+
+  before do
+    Przelewy24.configure do |config|
+      config.merchant_id = 37154
+      config.crc = 'a65ac19629e9c9fa'
+      config.url_return = 'http://example.com/success_transaction'
+    end
+  end
+
+  context 'is configurable' do
+    let(:merchant_id) { Przelewy24.config.merchant_id }
+    it { expect(merchant_id).to equal 37154 }
+  end
+
+  describe Przelewy24::Transaction do
+    let(:options) {{order_id:18506028, session_id: 1, amount: 1.23, currency:'PLN', description:'desc', email:'mariusz.henn@gmail.com', country:'pl', url_status: 'example.com/status', url_return: 'http://example.com/success_transaction'}}
+    subject (:transaction){ Przelewy24::Transaction.new options }
+
+    context '#transaction' do
+      xit 'register transaction' do
+        transaction.register_transaction
+        puts transaction.token
+        expect(transaction.token).to be_a_kind_of String
+      end
+
+      it 'verifying received transaction status' do
+        params =ActionController::Parameters.new({'p24_merchant_id' => 37154,
+                       'p24_pos_id' => 37154,
+                       'p24_session_id' => 1,
+                       'p24_amount'=> 123,
+                       'p24_currency' => 'PLN',
+                       'p24_order_id'=> 18506028,
+                       'p24_method'=> 16,
+                       'p24_statement'=> 'payment for invoice',
+                       'p24_sign'=> '8d2137c81c95c449c7dea25354c34dc4'})
+       expect(transaction.verify_transaction_status(params)).to equal true
+      end
+
+      it {expect(transaction.confirm_transaction).to equal true}
+    end
+
+    context '#test_connection' do
+      it { expect(transaction.test_connection).to equal true }
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'rails4-przelewy24'

data/tasks/przelewy24/rspec.rake

@@ -0,0 +1,3 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: rails4-przelewy24
+version: !ruby/object:Gem::Version
+  version: 0.1.6
+platform: ruby
+authors:
+- Mariusz Henn
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.13.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.13.5
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+description: This gem provide basic methods to communicate with przelewy24 payment
+  system
+email:
+- mariusz.henn@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/przelewy24/configuration.rb
+- lib/przelewy24/transaction.rb
+- lib/przelewy24/version.rb
+- lib/rails4-przelewy24.rb
+- rails4-przelewy24.gemspec
+- spec/przelewy24_spec.rb
+- spec/spec_helper.rb
+- tasks/przelewy24/rspec.rake
+homepage: ''
+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.2.2
+signing_key: 
+specification_version: 4
+summary: przelewy24 payment provider
+test_files:
+- spec/przelewy24_spec.rb
+- spec/spec_helper.rb