pay24 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9274a3468a62dc80013cc7386a800536d77d9339
+  data.tar.gz: a8891b5ad107c2f354da099a2fdcfa0f91782ad9
+SHA512:
+  metadata.gz: 1441fc399559a096428b839278019a8b2e4ecb9f58b5d9eb6d1f1897cca8beed4f9b2eca91502218d0dda8a8b9867089a72be878390495974aaf91c893d96b1c
+  data.tar.gz: 676e733a8c43f2e382c1b2320fee34c94e2de6cee5a5a5978c40218f76d6517a85f906d9fdb892d7b78decf0c44df7d7880b2a5d5e4f3fd2f742a9920fbc61c2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2019 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,23 @@
+# Гем для работы с pay24
+
+Гем для работы с платежной системой Pay24 для использования в проектах, использующих Ruby (Ruby On Rails, Sinatra и др.).
+
+Платежная система «Pay24» создана в 2014 году, с самого начала осуществляет свою деятельность на рынке приема платежей. 
+В 2015 году Компания получила две лицензии Национального Банка Кыргызской Республики.
+
+Официальный сайт: https://pay24.asia/
+
+## Установка
+
+Добавьте эту строку в ваш Gemfile:
+
+    gem 'pay24'
+
+Затем установите gem, используя bundler:
+
+    $ bundle
+
+Или выполните команду:
+
+    $ gem install pay24
+

data/Rakefile

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

data/lib/pay24.rb

@@ -0,0 +1,7 @@
+require 'pay24/version'
+
+module Pay24
+  autoload :ResponseHandler,  'pay24/response_handler'
+  autoload :Result,           'pay24/result'
+  autoload :Errors,           'pay24/errors'
+end

data/lib/pay24/errors.rb

@@ -0,0 +1,21 @@
+require 'builder'
+
+module Pay24
+  module Errors
+    attr_reader :code, :message, :result_code
+
+    # фатальные ошибки начинаются с ERROR_, остальные - с других символов
+    SUCCESS                                   = :ok                               # non-fatal
+    TEMPORARY_ERROR                           = :temporary_error                  # non-fatal
+    ERROR_INVALID_USER_ID_FORMAT              = :user_id_does_not_match_format    #     fatal
+    ERROR_USER_NOT_FOUND                      = :user_not_found                   #     fatal
+    ERROR_PAYMENT_DENIED_BY_PROVIDER          = :payment_denied_by_provider       #     fatal
+    ERROR_PAYMENT_DENIED_FOR_TECHNICAL_REASON = :payment_denied_tech_reason       #     fatal
+    ERROR_INACTIVE_USER                       = :inactive_user                    #     fatal
+    PAYMENT_PROCESSING_NOT_FINISHED           = :payment_processing_not_finished  # non-fatal
+    ERROR_SUM_IS_TOO_SMALL                    = :sum_is_too_small                 #     fatal
+    ERROR_SUM_IS_TOO_LARGE                    = :sum_is_too_large                 #     fatal
+    ERROR_CANNOT_CHECK_USER_ACCOUNT_STATE     = :cannot_check_account_state       #     fatal
+    ERROR_INTERNAL                            = :internal_error                   #     fatal
+  end
+end

data/lib/pay24/response_handler.rb

@@ -0,0 +1,107 @@
+require 'builder'
+
+# Обработчик входящих платежей Pay24.
+#
+# transaction_id      целое число длиной до 28 знаков
+# sum                 Сумма платежа, дробное число с точностью до сотых, в качестве разделителя используется точка
+# transaction_date    дата платежа (дата получения запроса от клиента)
+# account             ID пользователя, строка, содержащая буквы, цифры и спецсимволы, длиной до 200 символов.
+#
+# Передача информации о платеже провайдеру производится системой в 2 этапа:
+#   command=check   Проверка возможности совершения платежа. Запись информации о платеже у поставщика
+#   command=pay     Подтверждение проведения платежа
+#
+module Pay24
+  class ResponseHandler
+    include Pay24::Errors
+
+    attr_reader :command, :account, :transaction_id, :transaction_date, :sum
+
+    EMAIL_REGEX         = /\A[^@\s]+@([^@\s]+\.)+[^@\s]+\z/
+    IDENTIFICATOR_REGEX = /\A\d+\z/
+
+    REQUEST_HANDLERS = {
+      pay:   :osmp_pay,
+      check: :check_if_account_is_valid,
+    }.freeze
+
+    def initialize(params: {}, find_user_callback: nil, payment_callback: nil, raise_on_error: false)
+      @command            = params[:command]
+      @account            = params[:account]
+      @transaction_id     = params[:txn_id]
+      @transaction_date   = params[:txn_date]
+      @sum                = params[:sum]
+      @find_user_callback = find_user_callback
+      @payment_callback   = payment_callback
+      @raise_on_error     = raise_on_error
+      freeze
+    end
+
+    def command_is_valid?
+      @command.to_sym.in?(REQUEST_HANDLERS.keys)
+    end
+
+    def payment_command?
+      @command.to_sym == :pay
+    end
+
+    def run_command
+      result_code = if command_is_valid?
+                      send(REQUEST_HANDLERS[@command.to_sym]) || ERROR_INTERNAL
+                    else
+                      ERROR_INTERNAL
+                    end
+
+      Pay24::Result.new(result_code)
+    end
+
+    def requested_account
+      @find_user_callback.(@account) rescue ERROR_CANNOT_CHECK_USER_ACCOUNT_STATE
+    end
+
+    def generate_xml(result, comment = '')
+      xml = Builder::XmlMarkup.new indent: 2
+      xml.instruct!
+      xml.response do |req|
+        req.result  result.code
+        req.comment comment
+        if payment_command?
+          req.txn_id      @transaction_id
+          req.sum         @sum
+        end
+      end
+    end
+
+    private
+
+    def osmp_pay
+      return check_if_account_is_valid if check_if_account_is_valid != SUCCESS
+
+      sum         = @sum.to_f.abs
+      result_code = nil
+
+      begin
+        raise PaymentIsZero, 'Попытка пополнить баланс на 0 единиц через Pay24' if sum.zero?
+
+        @payment_callback.(requested_account, sum)
+      rescue => e
+        raise e if @raise_on_error
+        result_code = ERROR_INTERNAL
+      else
+        result_code = SUCCESS
+      end
+
+      result_code
+    end
+
+    def check_if_account_is_valid
+      if @account =~ EMAIL_REGEX || @account =~ IDENTIFICATOR_REGEX
+        requested_account.present? ? SUCCESS : ERROR_USER_NOT_FOUND
+      else
+        ERROR_INVALID_USER_ID_FORMAT
+      end
+    end
+
+    class PaymentIsZero < StandardError; end
+  end
+end

data/lib/pay24/result.rb

@@ -0,0 +1,84 @@
+require 'builder'
+
+# Модель для вывода результата обработчика.
+#
+# code            код результата
+# message_code    комментарий
+# result_code     названия результата
+#
+module Pay24
+  class Result
+    include Pay24::Errors
+
+    attr_reader :code, :message, :result_code
+
+    # назание неточно, тут не только ошибки. MESSAGES_TO_PAYMENT_GATEWAY
+    ERRORS = {
+      SUCCESS => {
+        message: 'OK',
+        code:    0,
+      },
+      TEMPORARY_ERROR => {
+        message: 'Временная ошибка. Повторите запрос позже',
+        code:    1,
+      },
+      ERROR_INVALID_USER_ID_FORMAT => {
+        message: 'Неверный формат идентификатора абонента',
+        code:    4,
+      },
+      ERROR_USER_NOT_FOUND => {
+        message: 'Идентификатор абонента не найден (Нет такого пользователя)',
+        code:    5,
+      },
+      ERROR_PAYMENT_DENIED_BY_PROVIDER => {
+        message: 'Прием платежа запрещен провайдером',
+        code:    7,
+      },
+      ERROR_PAYMENT_DENIED_FOR_TECHNICAL_REASON => {
+        message: 'Прием платежа запрещен по техническим причинам',
+        code:    8,
+      },
+      ERROR_INACTIVE_USER => {
+        message: 'Счет абонента не активен',
+        code:    79,
+      },
+      PAYMENT_PROCESSING_NOT_FINISHED => {
+        message: 'Проведение платежа не окончено (При отмене платежа – отмена еще не подтверждена. Система отправит повторный запрос через некоторое время.)',
+        code:    90,
+      },
+      ERROR_SUM_IS_TOO_SMALL => {
+        message: 'Сумма слишком мала',
+        code:    241,
+      },
+      ERROR_SUM_IS_TOO_LARGE => {
+        message: 'Сумма слишком велика',
+        code:    242,
+      },
+      ERROR_CANNOT_CHECK_USER_ACCOUNT_STATE => {
+        message: 'Невозможно проверить состояние счета',
+        code:    243,
+      },
+      ERROR_INTERNAL => {
+        message: 'Другая ошибка провайдера',
+        code:    300,
+      },
+    }.freeze
+
+    NON_FATAL_ERRORS = %i{ ok temporary_error payment_processing_not_finished }.freeze
+
+    def initialize(result_code)
+      @result_code = result_code
+      @message     = ERRORS.try(:[], result_code).try(:[], :message)
+      @code        = ERRORS.try(:[], result_code).try(:[], :code)
+    end
+
+    def failure?
+      !success?
+    end
+
+    def success?
+      @result_code.to_sym.in? NON_FATAL_ERRORS
+    end
+
+  end
+end

data/lib/pay24/version.rb

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

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: pay24
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bexeiitov Nursultan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-03 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'
+description: Adds the ability to work with the payment system pay24.
+email:
+- bekseitov@mail.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/pay24.rb
+- lib/pay24/errors.rb
+- lib/pay24/response_handler.rb
+- lib/pay24/result.rb
+- lib/pay24/version.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: pay24 gem
+test_files: []