moneta-api 2.0.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 9afe26d1633a8ca7b06ab6e985875eb38321fee4
-  data.tar.gz: a0c02712a1532ee5591144f5758fe39a2e021e49
+SHA256:
+  metadata.gz: c82f9dbd8db0a264f2c5a8aa035592f50c7e5b9ee142a37b0a7bc6ca9bafc407
+  data.tar.gz: b1fded7db6cf946e6f120a449eec29812aa9debeec07851204e77196e2b373cf
 SHA512:
-  metadata.gz: 8f6610a206970c46cd942d5deaeefe267fb5e2a375e586aa8cd7dec48ee41f1a84690e6d1144594ad0397459e87df3f0a948b1499fd3c5a176d35f1618104b76
-  data.tar.gz: c73e6706ca8dff9b853a7562450d954873db2cc09521451760f569b86907525a244fc9cebe8b031513f15bde1fb7f4a3596aa003d9c748132eb9387a9abb87a2
+  metadata.gz: 6effc742a9c1c7c01a879b64548b01b9b8a225b9f91d3f929d456d5ce50567b9d185273335e9165740cfaf96e8fc9eb7a0e64ccc448c37edbc941ae992f7b3b3
+  data.tar.gz: 424967818511b08af3ecfd120f6115e8316a00fcc19be0812f8b3fa6abf1119279bd3335f6e4a4a24ae90acd7e6253dd5691359468f778ad899e71ffd43b9d66

data/CHANGELOG.md

@@ -1,15 +1,19 @@
+## 2.1.1
+- Изменение основного URL.
+## 2.1.0
+- Получение чека монеты в формате PDF с иcпользованием сертификатов
 ## 2.0.0
 
 - Перевод взаимодействия с Moneta.ru с SOAP на JSON.
-  
+
   Interaction with MONETA.RU changed from SOAP to JSON.
-  
+
 - Подключены зависимости Oj и ActiveSupport.
-  
+
   Oj and ActiveSupport added as dependencies.
-  
+
 - Изменились настройки подключения. Доступные опции: `demo_mode`, `logger`, `log_body`, `open_timeout`, `filter`.
-  
+
   Connection settings changed. Available options: `demo_mode`, `logger`, `log_body`, `open_timeout`, `filter`.
 
 ## 1.13.0

data/README.md

@@ -4,7 +4,7 @@
 [![Test Coverage](https://codeclimate.com/github/ssnikolay/moneta-api/badges/coverage.svg)](https://codeclimate.com/github/ssnikolay/moneta-api)
 [![Inline docs](http://inch-ci.org/github/ssnikolay/moneta-api.svg?branch=master)](http://inch-ci.org/github/ssnikolay/moneta-api)
 
-[Описание MerchantAPI](https://www.moneta.ru/doc/MONETA.MerchantAPI.v2.ru.pdf) | [RDoc](http://www.rubydoc.info/gems/moneta-api) |
+[Описание MerchantAPI](https://moneta.ru/doc/MONETA.MerchantAPI.v2.ru.pdf) | [RDoc](http://www.rubydoc.info/gems/moneta-api) |
 [Список методов](http://www.rubydoc.info/gems/moneta-api/Moneta/Api/ServiceMethods)
 
 # moneta-api
@@ -18,8 +18,8 @@
 - v1 работает с Moneta.ru при помощи SOAP, v2 при помощи JSON.
 - В v1 числа являются строками, в v2 числами (например, значения `id`).
 - Изменились настройки фильтрации, добавилась настройка `log_body`, убрались `log`, `pretty_print_xml`
-- В аттрибутах ключ-значение (например, результат `FindBankAccounts`), значение всегда строка. 
-  Поэтому например значение поля `is_international` будет строка `"false"`, а не Boolean `false`. 
+- В аттрибутах ключ-значение (например, результат `FindBankAccounts`), значение всегда строка.
+  Поэтому например значение поля `is_international` будет строка `"false"`, а не Boolean `false`.
   Это связано с особенностями работы с Moneta.ru при помощи JSON.
 
 ## Установка
@@ -39,8 +39,11 @@ gem 'moneta-api'
     $ gem install moneta-api
 
 ## Использование
+Есть несколько вариантов работы с сервисами монеты:
+1. API - работа происходит с использованием методов описанных в MONETA.MerchantAPI.v2
+2. FRONT - работа происходит напрямую с интерфейсом монеты.
 
-### Примеры
+### Примеры работы c API
 
 #### Получить данные счета
 
@@ -135,10 +138,48 @@ gem 'moneta-api'
   Moneta::Api::Service.new('username', 'password', { demo_mode: true })
 ```
 
+
+### Примеры работы с FRONT (интерфейс монеты)
+
+#### Получить квинтанцию оплаты в формате PDF
+```ruby
+  require 'moneta/api'
+
+  certificate = OpenSSL::X509::Certificate.new(File.read('cert_path'))
+  private_key = OpenSSL::PKey::RSA.new(File.read('key_path'), 'password')
+
+  service = Moneta::Front::Service.new(certificate, private_key, { demo_mode: true })
+
+  service.get_receipt_pdf(468398)
+  # => 'PDF файл'
+```
+
+**Полный [список методов](http://www.rubydoc.info/gems/moneta-api/Moneta/Front/ServiceMethods), с помощью которых вы можете обратиться к интефейсу moneta.ru**
+
+### Настройки
+**Для работы с интерфейсом монеты понадобиться получение сертификатов, получение подробно описано в [MONETA.MerchantAPI.v2](https://moneta.ru/doc/MONETA.MerchantAPI.v2.ru.pdf)**
+
+Параметры:
+
+ Название                  | Описание
+---------------------------|:----------------------------------------------
+`certificate`              | Сертификат пользователя, полученный от монеты.
+`private_key`              | Приватный ключ, сгенерированный пользователем.
+`:demo_mode`               | Выполнение операций на демо стенде.
+`:open_timeout`            | Таймаут подключения.
+`:filter`                  | Настройка фильтрации содержимого лога.
+
+#### Demo режим
+Для использования тестового сервера (http://demo.moneta.ru) следует инициализировать сервис со специальным флагом
+
+```ruby
+  Moneta::Front::Service.new(certificate, private_key, { demo_mode: true })
+```
+
 ## Contributing
 
 1. Стандартная схема с pull-request workflow
 2. Для локального запуска тестов необходимо создать конфигурационный файл со своими demo доступами
 ```bash
-  echo "username: 'username'\npassword: 'password'" > spec/support/moneta.yml
+  cp spec/support/moneta.example.yml spec/support/moneta.yml
 ```

data/lib/moneta/api/service.rb

@@ -1,9 +1,9 @@
 module Moneta
   module Api
     class Service
-      DEMO = 'https://demo.moneta.ru'
-      PRODUCTION = 'https://www.moneta.ru'
-      URL = '/services'
+      DEMO = Moneta::Constants::Settings::DEMO
+      PRODUCTION = Moneta::Constants::Settings::PRODUCTION
+      URL = Moneta::Constants::Settings::SERVICES_PATH
 
       include ServiceMethods
 

data/lib/moneta/api/version.rb

@@ -1,5 +1,5 @@
 module Moneta
   module Api
-    VERSION = '2.0.0'
+    VERSION = '2.1.1'
   end
 end

data/lib/moneta/api.rb

@@ -1,10 +1,12 @@
 require 'moneta/api/version'
 require 'faraday'
+require 'faraday_middleware'
 require 'oj'
 require 'active_support/core_ext/hash/indifferent_access'
 require 'active_support/core_ext/string/inflections'
 
 require 'moneta/constants/withdrawal'
+require 'moneta/constants/settings'
 require 'moneta/api/options'
 require 'moneta/api/service_methods'
 require 'moneta/api/service'
@@ -122,3 +124,7 @@ require 'moneta/api/responses/approve_phone_send_confirmation_response'
 require 'moneta/api/responses/approve_phone_apply_code_response'
 
 require 'moneta/api/response_factory'
+
+require 'moneta/front/http_exception'
+require 'moneta/front/service_methods'
+require 'moneta/front/service'

data/lib/moneta/constants/settings.rb

@@ -0,0 +1,11 @@
+module Moneta
+  module Constants
+    module Settings
+      DEMO = 'https://demo.moneta.ru'
+      PRODUCTION = 'https://moneta.ru'
+
+      SERVICES_PATH = '/services'
+      CERTIFICATE_PATH = '/x509'
+    end
+  end
+end

data/lib/moneta/front/http_exception.rb

@@ -0,0 +1,13 @@
+module Moneta
+  module Front
+    class HTTPException < StandardError
+      def to_hash
+        { message: message }
+      end
+
+      def inspect
+        "HTTPException: #{ message }"
+      end
+    end
+  end
+end

data/lib/moneta/front/service.rb

@@ -0,0 +1,51 @@
+require 'moneta/api/options'
+
+module Moneta
+  module Front
+    class Service
+      DEMO = Moneta::Constants::Settings::DEMO
+      PRODUCTION = Moneta::Constants::Settings::PRODUCTION
+      PATH = Moneta::Constants::Settings::CERTIFICATE_PATH
+
+      include ServiceMethods
+
+      def initialize(certificate, key, params = {})
+        @certificate = certificate
+        @key = key
+        @connection = connection(Moneta::Api::Options.new(params))
+      end
+
+      def request(url)
+        @connection.get(url)
+      end
+
+      private
+
+      def connection(options)
+        Faraday.new(url: endpoint(options.demo?), ssl: ssl_options) do |faraday|
+          faraday.use ::FaradayMiddleware::FollowRedirects, limit: 10
+
+          if options.logger
+            faraday.response :logger, options.logger, bodies: options.log_bodies? do |logger|
+              options.filter.each do |subject, replacement|
+                logger.filter(/#{ subject }/, replacement)
+              end
+            end
+          end
+
+          faraday.adapter :net_http do |http|
+            http.open_timeout = options.open_timeout
+          end
+        end
+      end
+
+      def endpoint(demo)
+        (demo ? DEMO : PRODUCTION) + PATH
+      end
+
+      def ssl_options
+        { client_cert: @certificate, client_key: @key, verify: false }
+      end
+    end
+  end
+end

data/lib/moneta/front/service_methods.rb

@@ -0,0 +1,26 @@
+module Moneta
+  module Front
+    module ServiceMethods
+      def get_receipt_pdf(operation_id)
+        url = "report/receipt.htm?operationId=#{operation_id}&format=pdf"
+
+        call(url)
+      end
+
+      private
+
+      def call(url)
+        response = request(url)
+
+        case response.status
+        when 200..230 then response.body
+        else
+          raise Moneta::Front::HTTPException.new("Status code: #{response.status}")
+        end
+
+      rescue Faraday::Error => e
+        raise Moneta::Front::HTTPException.new(e.message)
+      end
+    end
+  end
+end

data/moneta-api.gemspec

@@ -21,10 +21,11 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.0'
 
   spec.add_dependency 'faraday', '~> 0.11.0'
+  spec.add_dependency 'faraday_middleware', '~> 0.12'
   spec.add_dependency 'activesupport', '>= 4.0.0'
   spec.add_dependency 'oj', '>= 2.16'
 
-  spec.add_development_dependency 'bundler', '~> 1'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake', '~> 10'
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rspec'

data/spec/lib/moneta/api/service_spec.rb

@@ -34,7 +34,7 @@ describe Moneta::Api::Service do
     context 'when demo mode' do
       let(:params) { {} }
 
-      its(:host) { is_expected.to eq 'www.moneta.ru' }
+      its(:host) { is_expected.to eq 'moneta.ru' }
     end
   end
 

data/spec/lib/moneta/front/service_spec.rb

@@ -0,0 +1,38 @@
+describe Moneta::Front::Service, vcr: true do
+  let(:params) { { demo_mode: true } }
+
+  let(:service) { described_class.new($cert, $cert_private_key, params) }
+
+  describe '#request' do
+    subject { service.request(path) }
+
+    context 'when success request' do
+      let(:path) { 'report/receipt.htm?operationId=467339&format=pdf' }
+
+      its(:status) { is_expected.to eq 200 }
+    end
+
+    context 'when bad request' do
+      let(:path) { 'report/receipt.htm' }
+      its(:status) { is_expected.to eq 400 }
+    end
+  end
+
+  describe '#get_receipt_pdf' do
+    subject { service.get_receipt_pdf(operation_id) }
+
+    context 'when success request' do
+      let(:operation_id) { 467339 }
+
+      it 'Must be a PDF' do
+        expect(subject[0, 4]).to eq('%PDF')
+      end
+    end
+
+    context 'when bad request' do
+      let(:operation_id) { 'report/receipt.htm' }
+
+      it { expect { subject }.to raise_error(Moneta::Front::HTTPException) }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -17,9 +17,15 @@ end
 
 config = YAML.load(File.read(File.join(Dir.pwd, 'spec/support/moneta.yml')))
 
+cert_path = File.join(Dir.pwd, config['cert_path'])
+cert_private_key_path = File.join(Dir.pwd, config['cert_private_key_path'])
+
 $username = config['username']
 $password = config['password']
 
+$cert = OpenSSL::X509::Certificate.new(File.read(cert_path))
+$cert_private_key = OpenSSL::PKey::RSA.new(File.read(cert_private_key_path), config['private_key_password'])
+
 class WebHelper
   def self.with_real_connection
     WebMock.allow_net_connect!
@@ -35,6 +41,7 @@ VCR.configure do |config|
   config.hook_into :webmock
   config.filter_sensitive_data('<USERNAME>') { $username }
   config.filter_sensitive_data('<PASSWORD>') { $password }
+  config.filter_sensitive_data('<CERT_PASSWORD>') { $cert_pass }
   config.ignore_hosts 'codeclimate.com'
 end
 

data/spec/support/moneta-certificate.pem

@@ -0,0 +1,29 @@
+-----BEGIN CERTIFICATE-----
+MIIE7zCCAtegAwIBAgICKKQwDQYJKoZIhvcNAQEFBQAwgaYxCzAJBgNVBAYTAlJV
+MRAwDgYDVQQIDAdNYXJpIEVsMRQwEgYDVQQHDAtZb3Noa2FyLU9sYTEcMBoGA1UE
+CgwTTkNPIE1PTkVUQS5SVSAoTExDKTERMA8GA1UECwwIVGVjaERlcHQxFzAVBgNV
+BAMMDmRlbW8ubW9uZXRhLnJ1MSUwIwYJKoZIhvcNAQkBFhZ0ZWNoLnN1cHBvcnRA
+bW9uZXRhLnJ1MB4XDTE3MTEwMzEwMjU0OFoXDTE4MTEwMzEwMjU0OFowVzELMAkG
+A1UEBhMCUlUxEjAQBgNVBAgMCVRhdGFyc3RhbjEOMAwGA1UEBwwFS2F6YW4xFDAS
+BgNVBAoMC1J1bnRpbWUgTExDMQ4wDAYDVQQDDAVEYW1pcjCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBAL1q0kiaP6pr3f2jtH9CMCYWF+Oc9aMOQuzoU7P5
+xETxePfBZu8h2smB8WsrHjlHbj/LI8XxH5kGYzomri7XrbC6osfTQR2Up9yuPvJw
+9rV1h0bEUQ2I7y1ns0d5kCFaIqOOpFp04eF16/xqjYFcZqF6triw2IBfcDRnRSnY
+5x9cR6lyeXhnjDNCcMHyzfXcnPUzUycEyaDVVKO/gNcFJInZcblyAobM2ja07Ji/
+sOI5GB6RpEKKdRMBfSjGf9cDrm/33heeVGCiVUK9rxT9lv44e+FwhmMEApuPVc9m
+xVJ6j8aBlb+Y0+zEdVEysUNAuu7+gUEMQgAGU7IH/mWVeSkCAwEAAaN1MHMwHwYD
+VR0jBBgwFoAUEmi7gDDSEybKT6yoaTS7VAvOxqQwHQYDVR0OBBYEFNL2nqzYd5/5
+TxLSNRBe5Jsym9KSMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBMGA1Ud
+JQQMMAoGCCsGAQUFBwMCMA0GCSqGSIb3DQEBBQUAA4ICAQApsU1xN+lA8iT2x9MP
+Tn/W//de5tBOFAKUnefzQrpjkqf94vzQ0j2z06g2nwRNDuVeit9g/r5iZpHiJh1K
+Joz2F4WPGZNeWAszDwiXfMDsCsQOuw2zq4WYa4rOOLMs+IgLR9tKhDspgbLl396U
+3MEHz5N9Lb5Pfiu/1klFE+SO/9q9HtyLn5lNkbyfxrzoKfyWpHwYZi8dofkHPNgI
+qPOIjQwedPv5SUWdWghSdsjQ6NvptUnCWgJOQzaHVPJLq01wdRLhz/lL316b59YH
+/VcGwmZcXwEwUVvIgDdE0ieNjHJwfp+OZJqRGszvHOh89fE8zvtSOysqvLvmSv3E
+sHemrnQ18Fr3P7kOr4kfbsB9DMheaxPyp9yTQ7t+r3YOkJK8HxxNavAIchner/lU
+sfWioutD1qzCI8Ex5JG6gWOltDEs6A7w2ro9zyAIjelpq8R3rnGd8c6LXbClqJdr
+1x3EU9DjAhWb8+JWNKlv9doR+EAUFHvjtojWfoWNcRxoVIAoio1qsDega0MibFVr
+9lWGMkGhsTIXOOk5KpmcTT3eLD5ZJNXLXRcYa0tj60QH9xTaTtJbfJJ3KhV8vPdO
+2sc+QRWbIjD5+MpJkSPFMMsHbHm2LO/FvrpcMExVOYZ+UXhvzfah1HiIZ2sr353f
+HnFMtpar7U/YZvkoIL4fOpKWQA==
+-----END CERTIFICATE-----

data/spec/support/moneta-private.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQC9atJImj+qa939
+o7R/QjAmFhfjnPWjDkLs6FOz+cRE8Xj3wWbvIdrJgfFrKx45R24/yyPF8R+ZBmM6
+Jq4u162wuqLH00EdlKfcrj7ycPa1dYdGxFENiO8tZ7NHeZAhWiKjjqRadOHhdev8
+ao2BXGahera4sNiAX3A0Z0Up2OcfXEepcnl4Z4wzQnDB8s313Jz1M1MnBMmg1VSj
+v4DXBSSJ2XG5cgKGzNo2tOyYv7DiORgekaRCinUTAX0oxn/XA65v994XnlRgolVC
+va8U/Zb+OHvhcIZjBAKbj1XPZsVSeo/GgZW/mNPsxHVRMrFDQLru/oFBDEIABlOy
+B/5llXkpAgMBAAECggEAQYHU8ajuxbiCUHqyLKSuVC2l22DoDpkbCiWa9Q43E4TT
+ShPHzoHN0Yyv+lkyHasXdNaDK6ylOd3cqTrBWI/ckNcq/qKPzXQgzZAxUtVAbScV
+PqMcSOsHlJNdjCV9dBthCWGGc4YirD+E+om7IHbdQ5FV6e+3IEZhXq4sXDmYTN6b
+i+I+TWiEAvnUrY1qm8+o3xqdvadnD2ixcNRlbAi6uzMUkhTqPy/g6POSzPtTKYF7
+LQOssf6e1mxoLihevkBFVqwrshvXSanKkVu1q2QMlWaXHUzSCs0BtZQB3mRBu+XB
+2AC1afQai4Ubr7nT/XfBz52u+bh59Tmq+qGDXnm+gQKBgQDqNSPkBj8yb30aw1nj
+0vo987jNtaFeA+PdPwMCr952YjSgMzaOV9irSQjCHqTQS5JLoUGc32Tof1fWH8kc
+pCgt7IKTGn1hdvQotPMHhve9vuFI/rQ6YIPF0+USUSmNwbKbwmSzK5SzqkdvwXD/
+xfAO5qMlb4A6cAlQvXXHLl/L+QKBgQDPCsTz5fG2VSN7tDr2Hh1hJ4xhXSKIu8ri
+cOzmbEwL8AeVhhR1wJQEXBM/FX/dIlcYDA9SyOkcnAeNRrjFlPn6/DqzrbJSWXRL
+ziiMkew7Yld5rwRGl6w5uURpfB1APQMeefsNT5AZQtepTmjW08fjFHtoNFyD7FcN
+dM71vS2CsQKBgQC2Bl0BoNVHJp0tyrw3M8bnlV+BCXQD9LQJRSra0MLucT8Dbyos
+kRvFa/rRnC1t8f4ep5KuEHWFuUsUERomF3Ne1d1Z5RGjSWdTp+bmZ8BuCUdgiwyZ
+/l8LxrbXeJr6IJvnMLtBAVMOG/5vXgGr2DPN8PTFaJZZVK/4v3clOeacSQKBgQC9
+DcVoPKjpaHa9J4bLZBZJt7Ys1cGJ/4i0Go+HnI4YPHaAZ21ZVJ8UGAuPCA+4mfnT
+QHfhjQmnkSYoL9LawD0/nH/xwALbxUk3Symlqj1+wD7GIzURTL/7+Ztpguam2M93
+TcUbk3IuTuXkeG+s8rdMOFCzh1SPNgkLhYTRyYu8EQKBgQC117MNYc1JG5d3PkWC
+Q3xAkXPS14sRKlP4cE8m2ZyCoT04mFAP6hydlGtbUz8sDhwMwbHZVkROqrhnkzsT
+7MXifPU7Z4+Z15LzhFC8j8EdfebFlDCpXbhHMIHfFnZMGpLEPbPyOncTXA4QvjHf
+i63SHI1R9T/c8KXfFZhvIzfUVw==
+-----END PRIVATE KEY-----

data/spec/support/moneta.example.yml

@@ -1,2 +1,6 @@
 username: 'username'
 password: 'password'
+
+cert_path: 'spec/support/moneta-certificate.pem'
+cert_private_key_path: 'spec/support/moneta-private.key'
+private_key_password: