sberbank-acquiring 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ccbf57e377afcb8ff803721cd4babfa79b4d65a2
-  data.tar.gz: 53e128c622fcb4b1d251c9f5a68dba55cb0e5a47
+  metadata.gz: 70cc909f0de20a79ccda9899ff380c6422c0587b
+  data.tar.gz: 830377d3af8af934be33c8233899a697292667b6
 SHA512:
-  metadata.gz: d663c70963ef9ee8d7ac1876957b2e771da19b5b07c75a4ba3e59ed4b943b3e6c451298a179a684b6aa8a9ee6ce703a9523b80b5ce44991ca91ec9dc7f810afe
-  data.tar.gz: b1e55b21521a2c4a5f29fa75718047132d16c365f0b49aa6d707ab1756852227fcb88ce4d111442d67797327aa5a04fbfab38290ea25dbdab81dadc1ea49d26e
+  metadata.gz: 2a5cc96b444348d7dbb929b964487762cd195812ecbb96ac3df31b9dcddaa9a84b8efb8d611a405baf8888d096bc0155d97928492c70b261206acb1e970db7fb
+  data.tar.gz: f13f87c3aab766f424616da98ad5011ada9a73f8d7fd4c4d063f7d9c01be8cbbeaba88ffb0e7f2bbfa57b2257e4950552577871d3ab5e2e69eb93bd343b806bc

data/README.md

@@ -1,10 +1,19 @@
 # 💳 Sberbank::Acquiring
 
+[![Gem Version](https://badge.fury.io/rb/sberbank-acquiring.svg)](https://badge.fury.io/rb/sberbank-acquiring)
 [![Build Status](https://travis-ci.org/panasyuk/sberbank-acquiring.svg?branch=master)](https://travis-ci.org/panasyuk/sberbank-acquiring)
 
 🔻Ruby Version 2.1 - 2.6 (+ JRuby)
 🎈Никаких сторонних зависимостей
 
+## Основная функциональность
+- Выполнение всех запросов к API эквайринга Сбербанка согласно документации (создание заказов, проверка их статуса и т.д)
+- Выполнение любых запросов к API эквайринга Сбербанка
+- Проверка контрольной суммы callback-уведомлений с симметричной и асимметричной криптографией
+
+**В разработке:**
+- Поддержка ФФД 1.05
+
 ## Описание
 
 GEM sberbank-acquiring предоставляет функциональность для взаимодействия с API эквайринга банка Сбербанк. Он использует RESTful API эквайринга Сбербанка.
@@ -17,7 +26,7 @@ GEM sberbank-acquiring предоставляет функциональност
 # Gemfile
 gem 'sberbank-acquiring', github: 'panasyuk/sberbank-acquiring'
 # или
-gem 'sberbank-acquiring', '~> 0.1.0'
+gem 'sberbank-acquiring', '~> 0.2.1'
 ```
 
 ## Использование
@@ -161,36 +170,30 @@ response.terminal_id # => "123456"
 ### Проверка контрольной суммы callback-уведомлений
 
 API эквайринга Сбербанка поддерживает два вида callback-уведомлений: без контрольной суммы и с контрольной суммой.
-В случае обработки уведомления с контрольной суммой, алгоритм проверки включает в себя выполнение запроса 'getOrderStatusExtended' к API эквайринга для проверки действительного статуса платежа. В остальных случаях требуется проверка параметра `checksum` с использованием симметричного или асимметричного ключа.
+В случае обработки уведомления с контрольной суммой, алгоритм проверки включает в себя выполнение запроса 'getOrderStatusExtended' к API эквайринга для проверки действительного статуса платежа. В остальных случаях требуется проверка параметра `checksum` с использованием [симметричной или асимметричной криптографии](https://securepayments.sberbank.ru/wiki/doku.php/integration:api:callback:start).
 
-#### Симметричный ключ
+#### Симметричная криптография
 
 ```ruby
-# params = {}
+# params = { 'checksum' => '...', ... }
 key = '20546026a3675994185a132875efe41a'
 
-callback_params = params.dup
-checksum = callback_params.delete('checksum')
-
 validator = Sberbank::Acquiring::SymmetricKeyChecksumValidator.new(key)
-if validator.validate(checksum, callback_params)
+if validator.valid?(params)
   # запрос успешно прошел валидацию, контрольная сумма верна
 else
   # запрос не может быть обработан, так как контрольная сумма неверна
 end
 ```
 
-#### Асимметричный ключ
+#### Асимметричная криптография
 
 ```ruby
-# params = {}
+# params = { 'checksum' => '...', ... }
 pem = File.read('< путь до файла сертификата >')
 
-callback_params = params.dup
-checksum = callback_params.delete('checksum')
-
 validator = Sberbank::Acquiring::AsymmetricKeyChecksumValidator.new(pem)
-if validator.validate(checksum, callback_params)
+if validator.valid?(params)
   # запрос успешно прошел валидацию, контрольная сумма верна
 else
   # запрос не может быть обработан, так как контрольная сумма неверна
@@ -199,7 +202,9 @@ end
 
 ## Разработка
 
-После клонирования репозитория, выполните `bin/setup` чтобы установить зависимости. Затем выполните `rake test`, чтобы запустить тесты. Так же можно запустить интерактивную консоль для экспериментов, выполнив `bin/console`.
+- После клонирования репозитория, выполните `bin/setup` чтобы установить зависимости.
+- Затем выполните `rake test`, чтобы запустить тесты.
+- Так же можно запустить интерактивную консоль для экспериментов, выполнив `bin/console`.
 
 ## TODO
 

data/lib/sberbank/acquiring/abstract_checksum_validator.rb

@@ -12,6 +12,11 @@ module Sberbank
         raise NotImplementedError
       end
 
+      def valid?(params)
+        params_to_validate = params.dup
+        validate(params_to_validate.delete('checksum'), params_to_validate)
+      end
+
       private
 
       def digest_class

data/lib/sberbank/acquiring/version.rb

@@ -2,6 +2,6 @@
 
 module Sberbank
   module Acquiring
-    VERSION = '0.2.0'
+    VERSION = '0.2.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sberbank-acquiring
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Aleksandr Panasyuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-27 00:00:00.000000000 Z
+date: 2019-01-29 00:00:00.000000000 Z
 dependencies: []
 description: This is an implementation of Sberbank Acuiring API client
 email:
@@ -58,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.12
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: GEM that makes integration of Sberbank Acquiring easier