webpay_by 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e34e902b083183cc3d8ad2c2f136e8afdcc7e239
+  data.tar.gz: c90fa63b5585bf32fc8915dae5162876ff88060d
+SHA512:
+  metadata.gz: 3dcdbf2f33cade320a1fedadf67e30f77a713dd451fa5a3364afb1b3657b5676854413231e77c390ea34b4411cdff8756e0d448845c01b26a733e3554f46f9e9
+  data.tar.gz: fb83f7a6ae7fb81367c3232ce876b160a6da62efab7c9cd220a00d89405401e4f33003161f39423d4489c434f210828718b48233ab76f987d643b4ba5c17968f

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2018 Bexeiitov Nursultan
+
+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,111 @@
+# Гем для работы с webpay.by
+
+Гем для работы с платежной системой WebPay для использования в проектах, использующих Ruby (Ruby On Rails, Sinatra и др.).
+
+WebPay («Вебпей») – белорусская система электронных платежей компании ООО «ВЭБ ПЭЙ», 
+который позволяет осуществлять безопасные платежи при помощи банковских карт VISA и MasterCard 
+в режиме реального времени в любой валюте (BYN, USD, RUB, EUR и т.д.).
+
+WebPay™ Sandbox — это самостоятельное Web-приложение, являющееся прототипом реальной системы и предназначенное для  
+тестирования и ознакомления с возможностями реальной системы WebPay™.
+
+Официальный сайт: https://webpay.by
+
+Документация: https://webpay.by/wp-content/uploads/2016/08/WebPay-Developer-Guide-2.1.2_RU.pdf
+
+## Установка
+
+Добавьте эту строку в ваш Gemfile:
+
+    gem 'webpay_by'
+
+Затем установите gem, используя bundler:
+
+    $ bundle
+
+Или выполните команду:
+
+    $ gem install webpay_by
+
+## Использование (примеры с использованием Ruby On Rails)
+
+### Настройка
+
+Создаем клиент для работы с Webpay
+
+```ruby
+require 'webpay_by/client'
+
+webpay_client = WebpayBy::Client.new(
+  secret_key: 'your_secret_key',
+  billing_id: '000000001',
+  debug_mode: !Rails.env.production?,
+  login:      'your_login',
+  password:   'your_password'
+)
+
+Rails.application.config.webpay_by = webpay_client
+```
+
+Формируем заказ и создаем форму
+
+```ruby
+request = Rails.application.config.webpay_by.request(
+  order_id:   'item-1',
+  seed:       '12.12.2019',
+  back_url:   product_url,
+  notify_url: payments_epay_url,
+  items:      [{price: 100, name: 'Пополнение счёта', quantity: 1}]
+)
+
+@form = request.form
+
+```
+```slim
+= form_tag @form.action_url, method: @form.request_method, id: 'epay-form', enctype: @form.enctype do
+  - @form.fields.each do |key, value|
+    = hidden_field_tag key, value
+  = submit_tag 'Перейти к пополнению'
+```
+Важно: 
+- В режиме разработки, после подтверждения формы оплаты, система может не принять запрос, ссылаясь на неправильный формат wsb_notify_url или wsb_return_url. 
+Это связано с тем, что система валидирует эти поля на реальные домены. 
+Локальный сервер localhost:3000 или адреса с доменными зонами .dev, .localhost и т.д работат не будут.
+Поэтому перед созданием формы передайте в заказ параметры notify_url и back_url c валидными адресами.
+- Если у вас в биллинг-аккаунте подключена возможность приема оплаты и через систему ЕРИП,
+то при тестировании платежей  максимальная длина имени счета (wsb_order_num) равна 10 символам.
+В реальной среде размер этого поля может измениться в зависимости от ограничений, которые будут установлены системой ЕРИП.
+
+После совершения удачного платежа, система WebPay отсылает специально сформированный POST-запрос по адресу,
+указанному в поле wsb_notify_url Интернет-ресурса. В этом запросе содержится информация по платежу.
+Полученную информацию Интернет-ресурс должен проверить в соответствии с требованиями выполнения заказа
+и ответить на запрос кодом: "HTTP/1.0 200 OK".
+
+       
+```ruby
+answer_hash             = params.except(:controller, :action).to_unsafe_h.symbolize_keys
+response                = webpay_client.response answer_hash
+
+if response.approved?
+  user.add_balance response.amount
+end
+
+render nothing: true, status: 200
+``` 
+
+Прежде чем доставить товар (оказать услугу), Интернет-ресурс обязан проверить совершенный покупателем платеж.
+Что такое "подтверждение": когда человек ввел данные карты, нужная сумма только блокируется на ней. Чтобы она
+реально списалась, мы должны сообщить системе Webpay, что услуга оказана и сумму можно списать. Это и есть подтверждение.
+Его нужно делать автоматически, поэтому через cron или аналог надо запускать робота, который будет выбирать
+оплаченные заявки и их подтверджать. 
+
+```ruby
+webpay_client         = Rails.application.config.webpay_by
+confirmation          = webpay_client.confirmation(transaction_id: transaction_id)
+confirmation_response = confirmation.send
+
+# Проверяем ответ от системы на подлинность электронной подписи и подтверждения об оплате
+if confirmation_response.approved?
+ order.update(confirmed: true)
+end
+``` 

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'

data/lib/webpay_by.rb

@@ -0,0 +1,11 @@
+require 'webpay_by/version'
+
+module WebpayBy
+  autoload :Client,               'webpay_by/client'
+  autoload :Confirmation,         'webpay_by/confirmation'
+  autoload :ConfirmationResponse, 'webpay_by/confirmation_response'
+  autoload :Form,                 'webpay_by/form'
+  autoload :Item,                 'webpay_by/item'
+  autoload :Request,              'webpay_by/request'
+  autoload :Response,             'webpay_by/response'
+end

data/lib/webpay_by/client.rb

@@ -0,0 +1,47 @@
+# Клиент для взаимодействия с Webpay. Он предоставляет доступ ко всем возможностям системы онлайн-оплаты.
+# Чтобы создать клиент, вам нужно настроить следующие поля:
+#   billing_id - уникальный идентификатор магазина.
+#   secret_key - секретный ключ, необходим для формирования электронной  подписи каждого Вашего платежа.
+#   debug_mode - поле, указывающее на проведение тестовой оплаты. Для работы с тестовой средой укажите true.
+#   login - имя пользователя.
+#   password - пароль.
+#
+# Пример:
+#
+# webpay_client = WebpayBy::Client.new(
+# secret_key: 'your_secret_key',
+#     billing_id: '000000001',
+#     debug_mode: ENV.development?,
+#     login:      'your_login',
+#     password:   'your_password'
+# )
+#
+require 'digest'
+
+module WebpayBy
+  class Client
+    attr_reader :billing_id, :secret_key, :debug_mode, :login, :password
+
+    alias debug_mode? debug_mode
+
+    def initialize(billing_id:, secret_key:, debug_mode:, login:, password:)
+      @billing_id = billing_id
+      @secret_key = secret_key
+      @debug_mode = debug_mode
+      @login      = login
+      @password   = Digest::MD5.hexdigest password
+    end
+
+    def request(options = {})
+      WebpayBy::Request.new options.merge client: self
+    end
+
+    def response(options = {})
+      WebpayBy::Response.new options.merge client: self
+    end
+
+    def confirmation(options)
+      WebpayBy::Confirmation.new options.merge client: self
+    end
+  end
+end

data/lib/webpay_by/confirmation.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+#
+# Модель для создания запроса об подтверждении оплаты системе Webpay. Перед созданием заказа обязательно создайте клиента.
+# Прежде чем доставить товар (оказать услугу), Интернет-ресурс обязан проверить совершенный покупателем платеж.
+# Необходимо учитывать, что запрос к тестовой среде необходимо отсылать на адрес https://sandbox.webpay.by, а к реальной среде https://billing.webpay.by
+#
+# Пример:
+#
+# Создаем объект и передаем ему номер транзакции
+# confirmation = webpay_client.confirmation(transaction_id: 'item-1')
+#
+# Создаем пост запрос к банку
+# confirmation.send
+# метод send возвращает объект WebpayBy::ConfirmationResponse, который содержить методы для проверки электронной подписи
+# и подтверждения об оплате
+#
+require 'uri'
+require 'net/https'
+require 'openssl'
+
+module WebpayBy
+  class Confirmation
+    SANDBOX_URL = 'https://sandbox.webpay.by'
+    BILLING_URL = 'https://billing.webpay.by'
+
+    attr_reader :client, :transaction_id
+
+    def initialize(client:, transaction_id:)
+      @client         = client
+      @transaction_id = transaction_id
+    end
+
+    def url_string
+      @client.debug_mode? ? SANDBOX_URL : BILLING_URL
+    end
+
+    # ОТВЕТ ЗА ЗАПРОС НА ПОДТВЕРЖДЕНИЕ: Возвращаемый XML выглядит примерно так (без переносов строк):
+    # <?xml version="1.0" encoding="UTF-8"?>
+    # <wsb_api_response>
+    #   <version>1</version>
+    #   <command>get_transaction</command>
+    #   <status>success</status>
+    #   <fields>
+    #     <transaction_id>123456789</transaction_id>
+    #     <batch_timestamp>31231231</batch_timestamp>
+    #     <currency_id>BYN</currency_id>
+    #     <amount>100</amount>
+    #     <payment_method>cc</payment_method>
+    #     <payment_type>4</payment_type>
+    #     <order_id>584236984</order_id>
+    #     <order_num>5874129</order_num>
+    #     <rrn>154789648154</rrn>
+    #     <wsb_signature>3021e68df9a7200135725c6331369a22</wsb_signature>
+    #   </fields>
+    # </wsb_api_response>
+    def send
+      xml = clear_xml_string api_request_xml
+      response = Net::HTTP.post_form(URI.parse(url_string), {'*API': '', 'API_XML_REQUEST': xml}).body
+      WebpayBy::ConfirmationResponse.new confirmation: self, response: response
+    end
+
+    def clear_xml_string(xml_str)
+      xml_str.gsub("\n", '').gsub(/\s{2,}/, '').gsub(' <', '<')
+    end
+
+    private
+
+    # Для проверки платежа при возврате на страницу Интернет-ресурса, указанному в поле wsb_return_url, необходимо выполнить
+    # API команду биллинга «get_transaction»
+    # Сгенерированный XML выглядит примерно так:
+    # <?xml version="1.0" encoding="ISO-8859-1"?>
+    # <wsb_api_request>
+    #   <command>get_transaction</command>
+    #   <authorization>
+    #     <username>your_username</username>
+    #     <password>your_md5_password</password>
+    #   </authorization>
+    #   <fields>
+    #     <transaction_id>123456789</transaction_id>
+    #   </fields>
+    # </wsb_api_request>
+    def api_request_xml
+      xml = Builder::XmlMarkup.new indent: 2
+      xml.instruct! :xml, encoding: 'ISO-8859-1'
+      xml.wsb_api_request do |req|
+        req.command 'get_transaction'
+
+        req.authorization do |auth|
+          auth.username @client.login
+          auth.password @client.password
+        end
+
+        req.fields do |merch|
+          merch.transaction_id @transaction_id
+        end
+      end
+    end
+  end
+end

data/lib/webpay_by/confirmation_response.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+#
+# Модель для подтверждении оплаты системе Webpay.
+# Пример:
+#
+# Создаем объект и передаем ему номер транзакции
+# confirmation = webpay_client.confirmation(transaction_id: 'item-1')
+#
+# Создаем пост запрос к банку
+# confirmation_response = confirmation.send
+#
+# Проверяем ответ от системы на подлинность электронной подписи и подтверждения об оплате
+#
+require 'digest'
+require 'active_support/core_ext/hash'
+
+module WebpayBy
+  class ConfirmationResponse
+    PAYMENT_TYPES = {
+      'Completed':      'Завершенная',
+      'Declined':       'Отклоненная',
+      'Pending':        'Вобработке',
+      'Authorized':     'Авторизованная',
+      'Refunded':       'Возвращенная',
+      'System':         'Системная',
+      'Voided':         'Сброшенная после авторизации',
+      'Failed':         'Ошибка в проведении операции',
+      'Partial Voided': 'Частичный сброс',
+      'Recurrent':      'Рекуррентный платеж'
+    }
+
+    # Успешной оплате соответствуют следующие значения: Completed, Authorized, Recurrent
+    # Ниже храним в константе их типы
+    SUCCESSFUL_TYPE_INDEXES = %w( 1 4 10 )
+
+    attr_reader :confirmation, :response, :parsed_response
+
+    def initialize(confirmation:, response:)
+      @confirmation     = confirmation
+      @response         = response
+      @parsed_response  = Hash.from_xml(@response).deep_symbolize_keys rescue {}
+    end
+
+    def wsb_api_response
+      @parsed_response[:wsb_api_response] || {}
+    end
+
+    def response_fields
+      wsb_api_response[:fields] || {}
+    end
+
+    # Проверка аутентичности XML-документа, пришедшего от банка
+    def valid_signature?
+      return false unless response_fields.any?
+
+      signature == response_fields[:wsb_signature]
+    end
+
+    def signature
+      signed_fields = %i( transaction_id batch_timestamp currency_id amount payment_method payment_type order_id rrn )
+      signed_attrs  = response_fields.values_at *signed_fields
+      signed_attrs  << @confirmation.client.secret_key
+      Digest::MD5.hexdigest signed_attrs.join
+    end
+
+    def approved?
+      payment_type_index = response_fields[:payment_type]
+      valid_signature? && payment_type_index.in?(SUCCESSFUL_TYPE_INDEXES)
+    end
+  end
+end

data/lib/webpay_by/form.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+#
+# Модель для формирования формы оплаты. Перед созданием заказа обязательно создайте заказ(Wepbay::Request).
+# Для оплаты заказа необходимо сформировать форму со специальными полями, и POST методом перенаправить покупателя на страницу оплаты.
+# Для тестирования необходимо указать адрес https://securesandbox.webpay.by, для совершения реальных платежей − https://payment.webpay.by.
+#
+# Все необходимые поля уже настроены в объекте заказа. Дополнительно можно настроить следующие поля:
+#   language_id - идентификатор языка формы оплаты. По умолчанию russian.
+#
+# Пример:
+#
+# request = webpay_client.request(
+#   order_id:   'item-1',
+#   seed:       '12.12.2019',
+#   back_url:   product_url,
+#   notify_url: payments_epay_url,
+#   items:      [{price: 100, name: 'Пополнение счёта', quantity: 1}]
+# )
+#
+# form = request.form(language_id: 'english')
+#
+module WebpayBy
+  class Form
+    SANDBOX_URL     = 'https://securesandbox.webpay.by'
+    LIVE_URL        = 'https://payment.webpay.by'
+    APP_VERSION     = 2
+    LANGUAGE_LIST   = %w( russian english )
+    REQUEST_METHOD  = 'post'
+    ENCTYPE         = 'application/x-www-form-urlencoded'
+
+    attr_reader :request, :version, :language_id, :request_method, :enctype
+
+    def initialize(request:, language_id: nil)
+      @request        = request
+      @language_id  ||= LANGUAGE_LIST.first
+      @version        = APP_VERSION
+      @request_method = REQUEST_METHOD
+      @enctype        = ENCTYPE
+
+      raise "Unsupported language, must be one of #{LANGUAGE_LIST.join ', '}" unless LANGUAGE_LIST.include? @language_id
+    end
+
+    def action_url
+      @request.client.debug_mode? ? SANDBOX_URL : LIVE_URL
+    end
+
+    def fields
+      fields_with_values = {
+        '*scart':         '',
+        wsb_version:      @version,
+        wsb_language_id:  @language_id,
+        wsb_storeid:      @request.client.billing_id,
+        wsb_order_num:    @request.order_id,
+        wsb_test:         @request.test_mode,
+        wsb_currency_id:  @request.currency_id,
+        wsb_seed:         @request.seed,
+        wsb_total:        @request.total,
+        wsb_signature:    @request.signature,
+        wsb_return_url:   @request.back_url,
+        wsb_notify_url:   @request.notify_url
+      }
+
+      @request.items.each_with_index do |item, i|
+        fields_with_values.merge!(
+          "wsb_invoice_item_name[#{i}]":      item.name,
+          "wsb_invoice_item_quantity[#{i}]":  item.quantity,
+          "wsb_invoice_item_price[#{i}]":     item.price
+        )
+      end
+
+      fields_with_values.compact
+    end
+  end
+end

data/lib/webpay_by/item.rb

@@ -0,0 +1,22 @@
+# Модель для создания товара для заказа.
+# Чтобы создать товар, вам нужно настроить следующие поля:
+#   name - Наименование единицы товара.
+#   quantity - Количество единиц товара, целое число, обозначающее, количество единиц товара каждого наименования.
+#   price - Цена единицы товара, число, определяющее стоимость каждой единицы товара (BYN, USD, EUR, RUB с 2 знаками после запятой или точки).
+#
+# Пример:
+#
+# WebpayBy::Item.new price: 100, name: 'Пополнение счёта', quantity: 1
+#
+module WebpayBy
+  class Item
+    attr_reader :name, :quantity, :price, :total
+
+    def initialize(name:, quantity:, price:)
+      @price     = price
+      @quantity  = quantity
+      @name      = name
+      @total     = @quantity * @price
+    end
+  end
+end

data/lib/webpay_by/request.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+#
+# Модель для формирования заказа. Перед созданием заказа обязательно создайте клиента.
+# Чтобы создать заказ, вам нужно настроить следующие поля:
+#   seed - случайная последовательность символов , участвующих в формировании электронной подписи заказа.
+#   order_id - уникальный идентификатор заказа, присваиваемый магазином.
+#   back_url - URL адрес на который возвращается покупатель в случае успешной оплаты.
+#   notify_url - данный URL вызывается вне зависимости от того, был ли переход по URL в поле wsb_return_url или нет.
+#   items - список товаров к оплате.
+#   currency_id - идентификатор валюты. Буквенный трехзначный код валюты согласно ISO4271. По умолчанию BYN(белорусский рубль).
+#
+# Пример:
+#
+# request = webpay_client.request(
+#   order_id:   'item-1',
+#   seed:       '12.12.2019',
+#   back_url:   product_url,
+#   notify_url: payments_epay_url,
+#   items:      [{price: 100, name: 'Пополнение счёта', quantity: 1}]
+# )
+#
+require 'digest'
+
+module WebpayBy
+  class Request
+    CURRENCIES = %w( BYN USD EUR RUB )
+
+    attr_reader :client, :seed, :order_id, :currency_id, :back_url, :notify_url, :items
+
+    def initialize(client:, seed:, order_id:, back_url:, notify_url:, items:, currency_id: nil)
+      @client         = client
+      @order_id       = order_id
+      @seed           = seed
+      @currency_id  ||= CURRENCIES.first
+      @back_url       = back_url
+      @notify_url     = notify_url
+      @items          = items.map { |item| item.is_a?(WebpayBy::Item) ? item : WebpayBy::Item.new(item) }
+
+      raise "Unsupported currency, must be one of #{CURRENCIES.join ', '}" unless CURRENCIES.include? @currency_id
+    end
+
+    def total
+      @items.map(&:total).sum
+    end
+
+    def test_mode
+      @client.debug_mode? ? 1 : 0
+    end
+
+    # Электронная подпись формируется для предотвращения изменений в форме платежа и должна присутствовать в каждой форме заказа.
+    # Все заказы без электронной подписи не будут рассматриваться системой WebPay
+    def signature
+      signed_attrs = [@seed, @client.billing_id, @order_id, test_mode, @currency_id, total, @client.secret_key].join
+
+      Digest::SHA1.hexdigest signed_attrs
+    end
+
+    def form(options = {})
+      WebpayBy::Form.new options.merge request: self
+    end
+  end
+end

data/lib/webpay_by/response.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+#
+# После совершения удачного платежа, система WebPay отсылает специально сформированный POST-запрос по адресу,
+# указанному в поле wsb_notify_url Интернет-ресурса. В этом запросе содержится информация по платежу.
+# Полученную информацию Интернет-ресурс должен проверить в соответствии с требованиями выполнения заказа
+# и ответить на запрос кодом: "HTTP/1.0 200 OK".
+# Это модель служит для работы с полученные от системы запросом. Перед созданием заказа обязательно создайте клиента.
+# Поля содержащиеся в запросе:
+#   batch_timestamp - время совершения транзакции.
+#   currency_id - валюта транзакции.
+#   amount - сумма транзакции.
+#   payment_method - метод совершения транзакции.
+#   order_id - номер заказа в системе WebPay.
+#   site_order_id - номер (имя) заказа, присвоенное магазином.
+#   transaction_id - номер транзакции.
+#   payment_type - тип транзакции.
+#   rrn - номер транзакции в системе Visa/MasterCard.
+#   wsb_signature - электронная подпись.
+#
+# Пример:
+#
+# response = webpay_client.response request.params
+# response.valid_signature?
+#
+require 'digest'
+
+module WebpayBy
+  class Response
+    SUCCESSFUL_TYPE_INDEXES = %w( 1 4 )
+
+    attr_reader :client, :batch_timestamp, :currency_id, :amount, :payment_method, :order_id, :site_order_id,
+                :transaction_id, :payment_type, :rrn
+
+    def initialize(options = {})
+      @client           = options[:client]
+      @batch_timestamp  = options[:batch_timestamp]
+      @currency_id      = options[:currency_id]
+      @amount           = options[:amount]
+      @payment_method   = options[:payment_method]
+      @order_id         = options[:order_id]
+      @site_order_id    = options[:site_order_id]
+      @transaction_id   = options[:transaction_id]
+      @payment_type     = options[:payment_type]
+      @rrn              = options[:rrn]
+      @wsb_signature    = options[:wsb_signature]
+    end
+
+    def approved?
+      valid_signature? && @payment_type.in?(SUCCESSFUL_TYPE_INDEXES)
+    end
+
+    # wsb_signature представляет собой hex-последовательность и является результатом выполнения функции MD 5.
+    # В качестве аргумента функции MD5  служит текстовая последовательность, полученная путем простой конкатенации
+    def valid_signature?
+      @wsb_signature.to_s == signature
+    end
+
+    def signature
+      signed_attrs = [@batch_timestamp, @currency_id, @amount, @payment_method, @order_id, @site_order_id,
+                      @transaction_id, @payment_type, @rrn, @client.secret_key].join
+
+      Digest::MD5.hexdigest signed_attrs
+    end
+  end
+end

data/lib/webpay_by/version.rb

@@ -0,0 +1,3 @@
+module WebpayBy
+  VERSION = '0.0.1'
+end

data/spec/models/webpay_by_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+require './lib/webpay_by'
+
+describe WebpayBy::Client do
+  let(:webpay_client) do
+    WebpayBy::Client.new(
+        secret_key: 'your_secret_key',
+        billing_id: '000000001',
+        debug_mode: true,
+        login:      'your_login',
+        password:   'your_password'
+    )
+  end
+
+  describe 'Формирования заказа' do
+    it 'сгенерирует правильную электронную подпись' do
+      request = webpay_client.request(
+          order_id:   'item-1',
+          seed:       '12.12.2019',
+          back_url:   'test.com',
+          notify_url: 'test.com/notify',
+          items:      [{price: 100, name: 'Пополнение счёта', quantity: 1}]
+      )
+
+      # seed='12.12.2019' billing_id='000000001' order_id='item-1' test_mode=1 currency_id'BYN'
+      # amount=100 secret_key='your_secret_key'
+      valid_signature = '42fc5bd5f26360789488073d2d8e535f9e16e2f9'
+
+      expect(request.signature).to eq valid_signature
+    end
+  end
+
+  describe 'Ответ банка' do
+    it 'возвращает валидную электронную подпись' do
+      answer_params = {
+        batch_timestamp:  '10.10.2019',
+        currency_id:      'BYN',
+        amount:           '100',
+        payment_method:   'cc',
+        order_id:         '1111',
+        site_order_id:    'item-1',
+        transaction_id:   '1',
+        payment_type:     '4',
+        rrn:              '01',
+        wsb_signature:    '62a2ab40e7ae1630883e1f8e2f284f8a'
+      }
+
+      response = webpay_client.response answer_params
+
+      expect(response.signature).to eq answer_params[:wsb_signature]
+    end
+  end
+
+  describe 'Подтверждения об оплате банку' do
+    it 'ответ возвращает валидную электронную подпись' do
+      xml_response = <<-XML.gsub("\n", '').gsub(/\s{2,}/, '').gsub(' <', '<')
+        <?xml version="1.0" encoding="UTF-8"?>
+        <wsb_api_response>
+          <version>1</version>
+          <command>get_transaction</command>
+          <status>success</status>
+          <fields>
+            <transaction_id>1</transaction_id>
+            <batch_timestamp>31231231</batch_timestamp>
+            <currency_id>BYN</currency_id>
+            <amount>100</amount>
+            <payment_method>cc</payment_method>
+            <payment_type>4</payment_type>
+            <order_id>item-1</order_id>
+            <order_num>1111</order_num>
+            <rrn>1</rrn>
+            <wsb_signature>7f0276873ce8e701c6fe36912fe5fb33</wsb_signature>
+          </fields>
+        </wsb_api_response>
+      XML
+
+      confirmation          = webpay_client.confirmation(transaction_id: '1')
+      confirmation_response = WebpayBy::ConfirmationResponse.new(confirmation: confirmation, response: xml_response)
+
+      expect(confirmation_response.signature).to eq confirmation_response.response_fields[:wsb_signature]
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: webpay_by
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bexeiitov Nursultan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-01-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+- !ruby/object:Gem::Dependency
+  name: builder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds the ability to work with the payment system webpay.by.
+email:
+- bekseitov@mail.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/webpay_by.rb
+- lib/webpay_by/client.rb
+- lib/webpay_by/confirmation.rb
+- lib/webpay_by/confirmation_response.rb
+- lib/webpay_by/form.rb
+- lib/webpay_by/item.rb
+- lib/webpay_by/request.rb
+- lib/webpay_by/response.rb
+- lib/webpay_by/version.rb
+- spec/models/webpay_by_spec.rb
+- spec/spec_helper.rb
+homepage: http://neoweb.kz
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: webpay.by gem
+test_files:
+- spec/models/webpay_by_spec.rb
+- spec/spec_helper.rb