mandarin_pay 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c6aa66899bf036fe36b6d408f2a7f123ed8036d6
+  data.tar.gz: 13e097421df68143d2c77129e9d697835104dd8e
+SHA512:
+  metadata.gz: 782885f15b6a4286a390003e57910a855d00d6250f9d168abd44199395fb29d4269d0f6bb5d788eb57d68f49bf0611b3d36a7c5400f0a505fdabbea6fdf0aa6b
+  data.tar.gz: db5859cb85061582a8dfeba7855ce168dd20c34bbde686c5a45286db883f3ea60668f984d325064f46500bf31c86e3b9bb8e065946a3bf693db5a2549fadb638

data/.gitignore

@@ -0,0 +1,29 @@
+.bundle/
+log/*.log
+pkg/
+spec/dummy/log
+spec/dummy/db/*.sqlite3
+spec/dummy/tmp/
+spec/dummy/.sass-cache
+*.gem
+*.rbc
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+rdoc
+spec/reports
+spec/tmp
+spec/version_tmp
+tmp
+.DS_Store
+passenger.3000.log
+passenger.3000.pid.lock
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+Gemfile.lock
+*.swp
+*.swo

data/.rubocop.yml

@@ -0,0 +1,63 @@
+AllCops:
+  Include:
+    - "**/Rakefile"
+    - "**/config.ru"
+  Exclude:
+    - "db/**/*"
+    - "config/**/*"
+    - "script/**/*"
+    - "frontend/**/*"
+    - "vendor/**/*"
+    - "lib/generators/**/*"
+    - "lib/templates/**/*"
+  TargetRubyVersion: 2.3
+
+Rails:
+  Enabled: true
+
+Style/Documentation:
+  Enabled: false
+
+Style/Encoding:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/MultilineOperationIndentation:
+  EnforcedStyle: indented
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Style/IfUnlessModifier:
+  MaxLineLength: 120
+
+Style/WhileUntilModifier:
+  MaxLineLength: 120
+
+Style/LambdaCall:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/ClassLength:
+  CountComments: false
+  Max: 300
+
+Metrics/ModuleLength:
+  CountComments: false
+  Max: 300
+
+Metrics/MethodLength:
+  CountComments: false
+  Max: 15
+
+Metrics/AbcSize:
+  Max: 25
+
+Style/AsciiComments:
+  Description: "Use only ascii symbols in comments."
+  StyleGuide: "https://github.com/bbatsov/ruby-style-guide#english-comments"
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - 2.2.0
+  - 2.3.0

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 1.0.0
+
+* Initial release

data/Gemfile

@@ -0,0 +1,9 @@
+source "http://rubygems.org"
+
+gem "rails", "~> 4.2.0"
+
+group :test do
+  gem "coveralls", require: false
+end
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2016 Alexander Maslov <drakmail@gmail.com>
+
+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,88 @@
+## The MandarinPay gem
+
+by [Drakmail][]
+
+[Drakmail]: http://drakmail.ru
+
+Ruby wrapper for [Mandarin Pay API][]. Make Mandarin Pay to work with your Rails project without pain. MandarinPay took the best from [rubykassa gem][] and [Active Merchant Robokassa integration] but easier to use and setup.
+
+[MandarinPay API]: http://mandarin_pay.com/sites/default/files/protokol_integracii_v0.5.5_0.pdf
+[rubykassa gem]: https://github.com/ZeroOneStudio/rubykassa
+[Active Merchant Robokassa integration]: https://github.com/Shopify/active_merchant/tree/master/lib/active_merchant/billing/integrations/robokassa
+
+## Installation
+
+Add to your `Gemfile`:
+
+    gem "mandarin_pay"
+
+## Usage
+
+Run `rails g mandarin_pay:install`, get an initializer with the following code:
+
+```ruby
+MandarinPay.configure do |config|
+  config.merchant_id = ENV["MANDARINPAY_MERCHANT_ID"]
+  config.sharedsec = ENV["MANDARINPAY_SHAREDSEC"]
+
+  # Result callback is called in MandarinPayController#paid action if valid signature
+  # was generated. It should always return "OK#{ invoice_id }" string, so implement
+  # your custom logic above `render text: notification.success` line
+
+  config.result_callback = ->(notification) { render text: notification.success }
+
+  # Define success or failure callbacks here like:
+
+  # config.success_callback = ->(notification) { render text: 'success' }
+  # config.fail_callback = ->(notification) { redirect_to root_path }
+end
+```
+
+and configure it with your credentials.
+
+Also, you need to specify Result URL, Success URL and Fail URL at the "Technical Settings" (Технические настройки) in your MandarinPay dashboard:
+
+* Result URL: `http://<your_domain>/mandarin_pay/paid`
+* Success URL: `http://<your_domain>/mandarin_pay/success`
+* Fail URL: `http://<your_domain>/mandarin_pay/fail`
+
+To define custom success/fail callbacks you can also use the initializer:
+
+    MandarinPay.configure do |config|
+      ...
+      config.success_callback = ->(notification) { render text: 'success' }
+      config.fail_callback    = ->(notification) { redirect_to root_path }
+      config.result_callback  = ->(notification) { render text: notification.success }
+    end
+
+Lambdas are called in MandarinPayController so you can respond with [any kind that is supported by Rails](http://guides.rubyonrails.org/layouts_and_rendering.html#creating-responses).
+
+NOTE: `result_callback` should always return `"OK"` string. So, implement your custom logic above `render text: notification.success` line.
+
+Once you are done, simply use `pay_form` helper in your view:
+
+    <%= pay_form "Pay with Mandarin Pay", "invoice_number", 20.00 %>
+
+Additionally you may want to pass extra options. There is no problem:
+
+    <%= pay_form "Pay with Mandarin Pay", "invoice_number", 20.00, customer_email: "user@example.com", class: "btn btn-succses", form_class: "mp-form" %>
+
+## Supported Rubies and Rails versions
+
+Rubies: 
+* 2.0.0
+* 2.1.0
+* 2.2.0
+* 2.3.0
+
+Rails:
+* ~> 4.0.0
+* ~> 4.1.0
+* ~> 4.2.0
+
+## License
+
+This project rocks and uses MIT-LICENSE
+Copyright (c) 2016 [Drakmail][]
+
+[Drakmail]: http://drakmail.ru

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/app/controllers/mandarin_pay_controller.rb

@@ -0,0 +1,33 @@
+class MandarinPayController < ApplicationController
+  before_action :create_notification
+
+  def paid
+    if @notification.valid_result_signature?
+      instance_exec @notification, &MandarinPay.result_callback
+    else
+      instance_exec @notification, &MandarinPay.fail_callback
+    end
+  end
+
+  def success
+    if @notification.valid_success_signature?
+      instance_exec @notification, &MandarinPay.success_callback
+    else
+      instance_exec @notification, &MandarinPay.fail_callback
+    end
+  end
+
+  def fail
+    instance_exec @notification, &MandarinPay.fail_callback
+  end
+
+  private
+
+  def create_notification
+    if request.get?
+      @notification = MandarinPay::Notification.new request.query_parameters
+    elsif request.post?
+      @notification = MandarinPay::Notification.new request.request_parameters
+    end
+  end
+end

data/bin/bundler

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'bundler' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("bundler", "bundler")

data/bin/cdiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'cdiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("term-ansicolor", "cdiff")

data/bin/colortab

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'colortab' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("term-ansicolor", "colortab")

data/bin/coveralls

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'coveralls' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("coveralls", "coveralls")

data/bin/decolor

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'decolor' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("term-ansicolor", "decolor")

data/bin/erubis

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'erubis' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("erubis", "erubis")

data/bin/htmldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "htmldiff")

data/bin/ldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "ldiff")

data/bin/nokogiri

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'nokogiri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("nokogiri", "nokogiri")

data/bin/rackup

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rackup' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rack", "rackup")

data/bin/rails

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rails' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("railties", "rails")

data/bin/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/sprockets

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'sprockets' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("sprockets", "sprockets")

data/bin/term_display

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'term_display' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("term-ansicolor", "term_display")

data/bin/term_mandel

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'term_mandel' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("term-ansicolor", "term_mandel")

data/bin/thor

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'thor' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("thor", "thor")

data/config/routes.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+Rails.application.routes.draw do
+  if MandarinPay::Client.configuration
+    scope "/mandarin_pay" do
+      %w(paid success fail).map do |route|
+        post "/#{route}" => "mandarin_pay##{route}", as: "mandarin_pay_#{route}"
+      end
+    end
+  end
+end

data/lib/generators/mandarin_pay/install_generator.rb

@@ -0,0 +1,10 @@
+require "rails/generators"
+
+module MandarinPay
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path("../templates", __FILE__)
+    def create_initializer_file
+      template "mandarin_pay.rb", File.join("config", "initializers", "mandarin_pay.rb")
+    end
+  end
+end

data/lib/generators/mandarin_pay/templates/mandarin_pay.rb

@@ -0,0 +1,15 @@
+MandarinPay.configure do |config|
+  config.merchant_id = ENV["MANDARINPAY_MERCHANT_ID"]
+  config.sharedsec = ENV["MANDARINPAY_SHAREDSEC"]
+
+  # Result callback is called in MandarinPayController#paid action if valid signature
+  # was generated. It should always return "OK#{ invoice_id }" string, so implement
+  # your custom logic above `render text: notification.success` line
+
+  config.result_callback = ->(notification) { render text: notification.success }
+
+  # Define success or failure callbacks here like:
+
+  # config.success_callback = ->(notification) { render text: 'success' }
+  # config.fail_callback = ->(notification) { redirect_to root_path }
+end

data/lib/mandarin_pay/action_view_extension.rb

@@ -0,0 +1,17 @@
+module MandarinPay
+  module ActionViewExtension
+    def pay_form(phrase, order_id, price, options = {})
+      pi = MandarinPay::PaymentInterface.new
+      class_names = options.delete(:class)
+      form_class = options.delete(:form_class)
+      params = pi.pay_params({ order_id: order_id, price: price }.merge(options))
+      form_tag pi.base_url, method: :post, class: form_class do
+        fields = params.map do |param, value|
+          hidden_field_tag param, value
+        end
+        fields.push submit_tag(phrase, class: class_names)
+        fields.join.html_safe
+      end
+    end
+  end
+end

data/lib/mandarin_pay/client.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "mandarin_pay/configuration"
+
+module MandarinPay
+  class Client
+    class << self
+      attr_accessor :configuration
+
+      def configure
+        self.configuration = MandarinPay::Configuration.new
+        yield configuration
+      end
+    end
+  end
+end

data/lib/mandarin_pay/configuration.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module MandarinPay
+  class Configuration
+    ATTRIBUTES = [:merchant_id, :sharedsec, :success_callback, :fail_callback, :result_callback].freeze
+
+    attr_accessor(*ATTRIBUTES)
+
+    def initialize
+      self.merchant_id      = "your_merchant_id"
+      self.sharedsec        = "sharedsec"
+      self.success_callback = ->(_notification) { render text: "success" }
+      self.fail_callback    = ->(_notification) { render text: "fail" }
+      self.result_callback  = ->(_notification) { render text: notification.success }
+    end
+  end
+end