cloud_payments 0.0.2 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 02f3745fb8ba27279fbc61b8457ea085e80a423e
-  data.tar.gz: df63c5180c52eb51cfc4a59e009b428cc6b6c3bd
+SHA256:
+  metadata.gz: '059f78713c51718c2fcc7474fe7e734b82dbf19a67b121ed86d3210caf061136'
+  data.tar.gz: 18c43e72122e00f883e41c0261ef614da2d2dd5474a68e1eb771c1b35bf8aa9b
 SHA512:
-  metadata.gz: 52aea99410e9b050a7ed070e9b5642dba502fafa12a4ff034450aa74e319cf1f6767aa38f70399b42b466650da0896599ce234c843cc3eb37e884b657cd30605
-  data.tar.gz: 2f8a19f58a38a67a62aa691b36382f3d23f67d9edee409f7d8d126eb840cc125f8fd81ad30daed3bc54e24526161655b74de76f3d6e8b51cbff17252e67a0fde
+  metadata.gz: a2071a9837d7c2545e0d0df976a964139cba78b85de31af0af556fb6b3335030ceda26ffc38be9aed7f553b67c6d0a6b3e1f21004680bbeeb5baaad0184759ce
+  data.tar.gz: 90c91193460f99b13aff8b04a9c4e325f118b44e99cec44ea33f1a668aa0dfd8afd7281d5481b4e15022c5b7208fb729c1f0b7d15776226139be4cce5c46ab99

data/.travis.yml

@@ -1,8 +1,14 @@
 language: ruby
-env:
-  - CODECLIMATE_REPO_TOKEN=8e9b89269d9aafc2dec2706a43825201de496b743505d7a7666068f7b22b07d
+
 rvm:
-  - 1.9.3
-  - 2.0.0
-  - 2.1.3
-  - rbx-2
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
+  - 2.7
+
+cache: bundler
+
+before_install: gem install bundler
+
+script: bundle exec rspec

data/Gemfile

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in cloud_payments.gemspec
@@ -6,5 +7,4 @@ gemspec
 gem 'oj'
 gem 'pry'
 gem 'rack'
-gem 'webmock', require: 'webmock/rspec'
-gem "codeclimate-test-reporter", group: :test, require: nil
+gem 'webmock'

data/README.md

@@ -1,10 +1,8 @@
 # CloudPayments
 
-CloudPayments ruby client (http://cloudpayments.eu/Docs/Integration)
+CloudPayments ruby client (https://developers.cloudpayments.ru/en/)
 
-[![Build Status](https://travis-ci.org/undr/cloud_payments.svg)](https://travis-ci.org/undr/cloud_payments)
-[![Code Climate](https://codeclimate.com/github/undr/cloud_payments/badges/gpa.svg)](https://codeclimate.com/github/undr/cloud_payments)
-[![Test Coverage](https://codeclimate.com/github/undr/cloud_payments/badges/coverage.svg)](https://codeclimate.com/github/undr/cloud_payments)
+[![Build Status](https://travis-ci.org/platmart/cloud_payments.svg)](https://travis-ci.org/platmart/cloud_payments)
 
 ## Installation
 
@@ -30,6 +28,8 @@ $ gem install cloud_payments
 
 ### Configuration
 
+#### Global configuration
+
 ```ruby
 CloudPayments.configure do |c|
   c.host = 'http://localhost:3000'    # By default, it is https://api.cloudpayments.ru
@@ -39,6 +39,28 @@ CloudPayments.configure do |c|
   c.logger = Logger.new('/dev/null')  # By default, it writes logs to stdout
   c.raise_banking_errors = true       # By default, it is not raising banking errors
 end
+
+# API client
+CloudPayments.client.payments.cards.charge(...)
+
+# Webhooks
+CloudPayments.webhooks.on_pay(...)
+```
+
+#### Local configuration
+
+```ruby
+config = CloudPayments::Config.new do |c|
+  # ...
+end
+
+# API client
+client = CloudPayments::Client.new(config)
+client.payments.cards.charge(...)
+
+# Webhooks
+webhooks = CloudPayments::Webhooks.new(config)
+webhooks.on_pay(...)
 ```
 
 ### Test method
@@ -83,6 +105,7 @@ transaction = CloudPayments.client.payments.cards.charge(
 # :card_last_four=>"1111",
 # :card_type=>"Visa",
 # :card_type_code=>0,
+# :issuer=>"Sberbank of Russia",
 # :issuer_bank_country=>"RU",
 # :status=>"Completed",
 # :status_code=>3,
@@ -97,9 +120,69 @@ transaction.token
 # => "a4e67841-abb0-42de-a364-d1d8f9f4b3c0"
 ```
 
+## Kassa Receipt
+
+CloudPayments Kassa API (https://cloudpayments.ru/docs/api/kassa)
+
+```ruby
+CloudPayments.client.kassa.receipt({
+  account_id: "user@example.com",
+  customer_receipt: {
+    items: [
+      {
+        amount: "13350.00",
+        ean13: nil,
+        label: "Good Description",
+        price: "13350.00",
+        quantity: 1.0,
+        vat: nil
+      }
+    ]
+  },
+  inn: "7708806666",
+  invoice_id: "231312312",
+  type: "Income"
+})
+```
+
+## Webhooks
+
+```ruby
+if CloudPayments.webhooks.data_valid?(payload, hmac_token)
+  event = CloudPayments.webhooks.on_recurrent(payload)
+  # or
+  event = CloudPayments.webhooks.on_pay(payload)
+  # or
+  event = CloudPayments.webhooks.on_fail(payload)
+end
+```
+
+with capturing of an exception
+
+```ruby
+rescue_from CloudPayments::Webhooks::HMACError, :handle_hmac_error
+
+before_action -> { CloudPayments.webhooks.validate_data!(payload, hmac_token) }
+
+def pay
+  event = CloudPayments.webhooks.on_pay(payload)
+  # ...
+end
+
+def fail
+  event = CloudPayments.webhooks.on_fail(payload)
+  # ...
+end
+
+def recurrent
+  event = CloudPayments.webhooks.on_recurrent(payload)
+  # ...
+end
+```
+
 ## Contributing
 
-1. Fork it ( https://github.com/undr/cloud_payments/fork )
+1. Fork it ( https://github.com/platmart/cloud_payments/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`)

data/Rakefile

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/cloud_payments.gemspec

@@ -1,4 +1,5 @@
 # coding: utf-8
+# frozen_string_literal: true
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'cloud_payments/version'
@@ -6,11 +7,11 @@ require 'cloud_payments/version'
 Gem::Specification.new do |spec|
   spec.name          = 'cloud_payments'
   spec.version       = CloudPayments::VERSION
-  spec.authors       = ['undr']
-  spec.email         = ['undr@yandex.ru']
+  spec.authors       = ['undr', 'kirillplatonov']
+  spec.email         = ['undr@yandex.ru', 'mail@kirillplatonov.com']
   spec.summary       = %q{CloudPayments ruby client}
   spec.description   = %q{CloudPayments ruby client}
-  spec.homepage      = ''
+  spec.homepage      = 'https://github.com/platmart/cloud_payments'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -19,10 +20,9 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'faraday'
-  spec.add_dependency 'multi_json'
-  spec.add_dependency 'hashie'
+  spec.add_dependency 'multi_json', '~> 1.11'
+  spec.add_dependency 'hashie', '~> 3.4'
 
-  spec.add_development_dependency 'bundler', '~> 1.7'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.9'
 end

data/config.ru

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 require 'cloud_payments'
 require 'rack'

data/lib/cloud_payments.rb

@@ -1,13 +1,14 @@
+# frozen_string_literal: true
 require 'date'
 require 'hashie'
 require 'faraday'
 require 'multi_json'
-require 'pp'
 require 'cloud_payments/version'
 require 'cloud_payments/config'
 require 'cloud_payments/namespaces'
 require 'cloud_payments/models'
 require 'cloud_payments/client'
+require 'cloud_payments/webhooks'
 
 module CloudPayments
   extend self
@@ -31,4 +32,8 @@ module CloudPayments
   def client
     @client ||= Client.new
   end
+
+  def webhooks
+    @webhooks ||= Webhooks.new
+  end
 end

data/lib/cloud_payments/client.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'cloud_payments/client/errors'
 require 'cloud_payments/client/gateway_errors'
 require 'cloud_payments/client/response'
@@ -9,8 +10,8 @@ module CloudPayments
 
     attr_reader :config, :connection
 
-    def initialize
-      @config = CloudPayments.config
+    def initialize(config = nil)
+      @config = config || CloudPayments.config
       @connection = build_connection
     end
 

data/lib/cloud_payments/client/errors.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module CloudPayments
   class Client
     class Error < StandardError; end

data/lib/cloud_payments/client/gateway_errors.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
 module CloudPayments
   class Client
+    class ReasonedGatewayError < StandardError; end
     module GatewayErrors; end
 
     REASON_CODES = {
@@ -29,7 +31,7 @@ module CloudPayments
 
     GATEWAY_ERRORS = REASON_CODES.inject({}) do |result, error|
       status, name = error
-      result[status] = GatewayErrors.const_set(name, Class.new(StandardError))
+      result[status] = GatewayErrors.const_set(name, Class.new(ReasonedGatewayError))
       result
     end
   end

data/lib/cloud_payments/client/response.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module CloudPayments
   class Client
     class Response
@@ -5,7 +6,7 @@ module CloudPayments
 
       def initialize(status, body, headers = {})
         @status, @origin_body, @headers = status, body, headers
-        @origin_body = body.force_encoding('UTF-8') if body.respond_to?(:force_encoding)
+        @origin_body = body.dup.force_encoding('UTF-8') if body.respond_to?(:force_encoding)
       end
 
       def body

data/lib/cloud_payments/client/serializer.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'cloud_payments/client/serializer/base'
 require 'cloud_payments/client/serializer/multi_json'
 

data/lib/cloud_payments/client/serializer/base.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module CloudPayments
   class Client
     module Serializer
@@ -20,7 +21,14 @@ module CloudPayments
 
         def convert_keys_from_api(attributes)
           attributes.each_with_object({}) do |(key, value), result|
-            value = convert_keys_from_api(value) if value.is_a?(Hash)
+            value = case value
+            when Hash
+              convert_keys_from_api(value)
+            when Array
+              value.map { |item| convert_keys_from_api(item) }
+            else
+              value
+            end
 
             key = key.to_s.gsub(/([A-Z\d]+)([A-Z][a-z])/, '\1_\2')
             key.gsub!(/([a-z\d])([A-Z])/, '\1_\2')

data/lib/cloud_payments/client/serializer/multi_json.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module CloudPayments
   class Client
     module Serializer

data/lib/cloud_payments/config.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module CloudPayments
   class Config
     attr_accessor :connection_options, :serializer, :log, :public_key, :secret_key, :host, :raise_banking_errors
@@ -17,6 +18,9 @@ module CloudPayments
       @connection_options = {}
       @connection_block = nil
       @host = 'https://api.cloudpayments.ru'
+      if block_given?
+        yield self
+      end
     end
 
     def logger

data/lib/cloud_payments/models.rb

@@ -1,4 +1,12 @@
+# frozen_string_literal: true
 require 'cloud_payments/models/model'
+require 'cloud_payments/models/like_subscription'
 require 'cloud_payments/models/secure3d'
 require 'cloud_payments/models/transaction'
 require 'cloud_payments/models/subscription'
+require 'cloud_payments/models/order'
+
+require 'cloud_payments/models/on_recurrent'
+require 'cloud_payments/models/on_pay'
+require 'cloud_payments/models/on_fail'
+require 'cloud_payments/models/on_kassa_receipt'

data/lib/cloud_payments/models/like_subscription.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+module CloudPayments
+  module LikeSubscription
+    ACTIVE = 'Active'
+    PAST_DUE = 'PastDue'
+    CANCELLED = 'Cancelled'
+    REJECTED = 'Rejected'
+    EXPIRED = 'Expired'
+
+    def active?
+      status == ACTIVE
+    end
+
+    def past_due?
+      status == PAST_DUE
+    end
+
+    def cancelled?
+      status == CANCELLED
+    end
+
+    def rejected?
+      status == REJECTED
+    end
+
+    def expired?
+      status == EXPIRED
+    end
+  end
+end

data/lib/cloud_payments/models/model.rb

@@ -1,5 +1,14 @@
+# frozen_string_literal: true
+require 'bigdecimal'
+require 'bigdecimal/util'
+
 module CloudPayments
   class Model < Hashie::Trash
     include Hashie::Extensions::IgnoreUndeclared
+
+    DateTimeTransform = ->(v) { DateTime.parse(v) if v && v.respond_to?(:to_s) }
+    DecimalTransform  = ->(v) { v.to_d if v }
+    IntegralTransform = ->(v) { v.to_i if v }
+    BooleanTransform  = ->(v) { (v == '0') ? false : !!v }
   end
 end

data/lib/cloud_payments/models/on_fail.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+module CloudPayments
+  # @see https://cloudpayments.ru/Docs/Notifications#fail CloudPayments API
+  class OnFail < Model
+    property :id, from: :transaction_id, required: true
+    property :amount, transform_with: DecimalTransform, required: true
+    property :currency, required: true
+    property :date_time, transform_with: DateTimeTransform
+    property :card_first_six, required: true
+    property :card_last_four, required: true
+    property :card_type, required: true
+    property :card_exp_date, required: true
+    property :test_mode, required: true
+    property :reason, required: true
+    property :reason_code, required: true
+    property :invoice_id
+    property :account_id
+    property :subscription_id
+    property :name
+    property :email
+    property :ip_address
+    property :ip_country
+    property :ip_city
+    property :ip_region
+    property :ip_district
+    property :issuer
+    property :issuer_bank_country
+    property :description
+    property :metadata, from: :data, default: {}
+  end
+end

data/lib/cloud_payments/models/on_kassa_receipt.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module CloudPayments
+  # @see https://cloudpayments.ru/Docs/Notifications#receipt CloudPayments API
+  class OnKassaReceipt < Model
+    property :id, required: true
+    property :document_number, required: true
+    property :session_number, required: true
+    property :fiscal_sign, required: true
+    property :device_number, required: true
+    property :reg_number, required: true
+    property :inn, required: true
+    property :type, required: true
+    property :ofd, required: true
+    property :url, required: true
+    property :qr_code_url, required: true
+    property :amount, transform_with: DecimalTransform, required: true
+    property :date_time, transform_with: DateTimeTransform
+    property :receipt
+    property :invoice_id
+    property :transaction_id
+    property :account_id
+  end
+end