payneteasy-payneteasyapi 0.1.0

data/doc/payment-scenarios/03-return-transactions.md

@@ -0,0 +1,52 @@
+# Return transactions
+
+Список запросов сценария:
+* [Запрос "return"](#return)
+* [Запрос "status"](#status)
+
+## Общие положения
+
+* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Return transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Return_Transactions).
+* Описание правил валидации можно найти в описании метода **[Validator::validateByRule()](../library-internals/02-validator.md#validateByRule)**.
+* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
+
+## <a name="return"></a> Запрос "return"
+
+Запрос применяется для возврата средств на счет клиента.
+Перед выполнением этого запроса необходимо провести платеж, средства за который будут возвращены.
+После выполнения данного запроса необходимо выполнить серию запросов "**status**" для обновления статуса платежа. Для этого сервис мерчанта может вывести самообновляющуюся страницу, каждая перезагрузка которой будет выполнять запрос "**status**".
+
+##### Обязательные параметры запроса
+
+Поле запроса    |Цепочка свойств платежа|Правило валидации
+----------------|-----------------------|-----------------
+client_orderid  |payment.clientId       |Validator::ID
+orderid         |payment.paynetId       |Validator::ID
+amount          |payment.amount         |Validator::AMOUNT
+currency        |payment.currency       |Validator::CURRENCY
+comment         |payment.comment        |Validator::MEDIUM_STRING
+login           |queryConfig.login      |Validator::MEDIUM_STRING
+
+[Пример выполнения запроса return](../../example/return.php)
+
+## <a name="status"></a> Запрос "status"
+
+Запрос применяется для проверки статуса платежа. Обычно требуется серия таких запросов из-за того, что обработка платежа занимает некоторое время. В зависимости от статуса платежа обработка результата этого запроса может происходить несколькими путями.
+
+##### Необходимо обновление платежа
+
+В том случае, если статус платежа не изменился (значение поля **status** - **processing**) и нет необходимости в дополнительных шагах авторизации, то запустить проверку статуса еще раз.
+
+##### Обработка платежа завершена
+
+В ответе на запрос поле **status** содержит результат обработки платежа - **approved**, **filtered**, **declined**, **error**
+
+##### Обязательные параметры запроса
+
+Поле запроса    |Цепочка свойств платежа|Правило валидации
+----------------|-----------------------|-----------------
+client_orderid  |payment.clientId       |Validator::ID
+orderid         |payment.paynetId       |Validator::ID
+login           |queryConfig.login      |Validator::MEDIUM_STRING
+
+[Пример выполнения запроса status](../../example/status.php)

data/doc/payment-scenarios/04-recurrent-transactions.md

@@ -0,0 +1,110 @@
+# Recurrent transactions
+
+Список запросов сценария:
+* [Запрос "create-card-ref"](#create-card-ref)
+* [Запрос "get-card-info"](#get-card-info)
+* [Запрос "make-rebill"](#make-rebill)
+* [Запрос "status"](#status)
+
+## Общие положения
+
+* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Recurrent transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Recurrent_Transactions).
+* Описание правил валидации можно найти в описании метода **[Validator::validateByRule()](../library-internals/02-validator.md#validateByRule)**.
+* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
+
+## <a name="create-card-ref"></a> Запрос "create-card-ref"
+
+Запрос применяется для получения id для кредитной карты, сохраненной на стороне PaynetEasy. Этот id позволяет совершать повторные платежи без ввода данных кредитной карты как на стороне сервиса мерчанта так и на стороне PaynetEasy.
+Перед выполнением этого запроса необходимо выполнить один из следующих сценариев для проверки данных, которые ввел клиент:
+* [Sale Transactions](00-sale-transactions.md)
+* [Preauth/Capture Transactions](01-preauth-capture-transactions.md)
+* [Payment Form Integration](05-payment-form-integration.md)
+
+##### Обязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа        |Правило валидации
+--------------------|-------------------------------|-----------------
+client_orderid      |clientId                       |Validator::ID
+orderid             |paynetId                       |Validator::ID
+login               |queryConfig.login              |Validator::MEDIUM_STRING
+
+[Пример выполнения запроса create-card-ref](../../example/create-card-ref.php)
+
+После выполнения данного запроса будет получен id сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова
+`$payment->getRecurrentCardFrom()`, а к ее id с помощью вызова `$payment->getRecurrentCardFrom()->getCardReferenceId()`
+
+## <a name="get-card-info"></a> Запрос "get-card-info"
+
+Запрос применяется для получения некоторых данных сохраненной кредитной карты.
+Перед выполнением данного запроса необходимо выполнить запрос [create-card-ref](#create-card-ref).
+
+##### Обязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа    |Правило валидации
+--------------------|---------------------------|-----------------
+cardrefid           |recurrentCardFrom.paynetId |Validator::ID
+login               |queryConfig.login          |Validator::MEDIUM_STRING
+
+[Пример выполнения запроса get-card-info](../../example/get-card-info.php)
+
+После выполнения данного запроса будут получены данные сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова `$payment->getRecurrentCardFrom()`. В объекте будут заполнены следующие данные:
+* **cardPrintedName** - данные доступны с помощью вызова `$payment->getRecurrentCardFrom()->getСardPrintedName()`
+* **expireYear** - данные доступны с помощью вызова `$payment->getRecurrentCardFrom()->getExpireYear()`
+* **expireMonth** - данные доступны с помощью вызова `$payment->getRecurrentCardFrom()->getExpireMonth()`
+* **bin** - данные доступны с помощью вызова `$payment->getRecurrentCardFrom()->getBin()`
+* **lastFourDigits** - данные доступны с помощью вызова `$payment->getRecurrentCardFrom()->getLastFourDigits()`
+
+## <a name="make-rebill"></a> Запрос "make-rebill"
+
+Запрос применяется для списания средств с кредитной карты клиента.
+Перед выполнением данного запроса необходимо выполнить запрос [create-card-ref](#create-card-ref).
+После выполнения данного запроса необходимо выполнить серию запросов "**status**" для обновления статуса платежа. Для этого сервис мерчанта может вывести самообновляющуюся страницу, каждая перезагрузка которой будет выполнять запрос "**status**".
+
+##### Обязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа            |Правило валидации
+--------------------|-----------------------------------|-----------------
+client_orderid      |payment.clientId                   |Validator::ID
+order_desc          |payment.description                |Validator::LONG_STRING
+amount              |payment.amount                     |Validator::AMOUNT
+currency            |payment.currency                   |Validator::CURRENCY
+ipaddress           |payment.customer.ipAddress         |Validator::IP
+cardrefid           |payment.recurrentCardFrom.paynetId |Validator::ID
+login               |queryConfig.login                  |Validator::MEDIUM_STRING
+
+##### Необязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа        |Правило валидации
+--------------------|-------------------------------|-----------------
+comment             |payment.comment                |Validator::MEDIUM_STRING
+cvv2                |payment.recurrentCardFrom.cvv2 |Validator::CVV2
+server_callback_url |queryConfig.callbackUrl        |Validator::URL
+
+[Пример выполнения запроса make-rebill](../../example/make-rebill.php)
+
+## <a name="status"></a> Запрос "status"
+
+Запрос применяется для проверки статуса платежа. Обычно требуется серия таких запросов из-за того, что обработка платежа занимает некоторое время. В зависимости от статуса платежа обработка результата этого запроса может происходить несколькими путями.
+
+##### Необходимо обновление платежа
+
+В том случае, если статус платежа не изменился (значение поля **status** - **processing**) и нет необходимости в дополнительных шагах авторизации, то запустить проверку статуса еще раз.
+
+##### Обработка платежа завершена
+
+В ответе на запрос поле **status** содержит результат обработки платежа - **approved**, **filtered**, **declined**, **error**
+
+##### Обязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа|Правило валидации
+--------------------|-----------------------|-----------------
+client_orderid      |payment.clientId       |Validator::ID
+orderid             |payment.paynetId       |Validator::ID
+login               |queryConfig.login      |Validator::MEDIUM_STRING
+
+[Пример выполнения запроса status](../../example/status.php)
+
+## <a name="callback"></a> Обработка обратного вызова
+
+После завершения обработки платежа на стороне PaynetEasy, данные с результатом обработки передаются в сервис мерчанта с помощью обратного вызова. Это необходимо, чтобы платеж был обработан сервисом мерчанта независимо от того, выполнил пользователь корректно возврат с шлюза PaynetEasy или нет.
+[Подробнее о Merchant callbacks](06-merchant-callbacks.md)

data/doc/payment-scenarios/05-payment-form-integration.md

@@ -0,0 +1,59 @@
+# Payment form integration
+
+## Общие положения
+
+* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Payment form integration расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Payment_Form_integration).
+* Описание правил валидации можно найти в описании метода **[Validator::validateByRule()](../library-internals/02-validator.md#validateByRule)**.
+* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
+
+## <a name="form"></a> Запросы "sale-form", "preauth-form", "transfer-form"
+
+* **sale-form** - применяется для оплаты с помощью кредитной карты
+* **preauth-form** - применяется для блокирования части средств кредитной карты клиента. После успешного завершения этого запроса для списания средств с карты клиента необходимо выполнить запрос **[capture](01-preauth-capture-transactions.md#capture)**
+* **transfer-form** - применяется для перевода средств с одного счета на другой
+
+При выполнении запросов информация о карте вводится на стороне PaynetEasy.
+
+##### Обязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа            |Правило валидации
+--------------------|-----------------------------------|-----------------
+client_orderid      |payment.clientId                   |Validator::ID
+order_desc          |payment.description                |Validator::LONG_STRING
+amount              |payment.amount                     |Validator::AMOUNT
+currency            |payment.currency                   |Validator::CURRENCY
+address1            |payment.billingAddress.firstLine   |Validator::MEDIUM_STRING
+city                |payment.billingAddress.city        |Validator::MEDIUM_STRING
+zip_code            |payment.billingAddress.zipCode     |Validator::ZIP_CODE
+country             |payment.billingAddress.country     |Validator::COUNTRY
+phone               |payment.billingAddress.phone       |Validator::PHONE
+ipaddress           |payment.customer.ipAddress         |Validator::IP
+email               |payment.customer.email             |Validator::EMAIL
+redirect_url        |queryConfig.redirectUrl            |Validator::URL
+
+##### Необязательные параметры запроса
+
+Поле запроса        |Цепочка свойств платежа            |Правило валидации
+--------------------|-----------------------------------|-----------------
+first_name          |payment.customer.firstName         |Validator::MEDIUM_STRING
+last_name           |payment.customer.lastName          |Validator::MEDIUM_STRING
+ssn                 |payment.customer.ssn               |Validator::SSN
+birthday            |payment.customer.birthday          |Validator::DATE
+state               |payment.billingAddress.state       |Validator::COUNTRY
+cell_phone          |payment.billingAddress.cellPhone   |Validator::PHONE
+site_url            |queryConfig.siteUrl                |Validator::URL
+server_callback_url |queryConfig.callbackUrl            |Validator::URL
+
+[Пример выполнения запроса sale-form](../../example/sale-form.php)
+[Пример выполнения запроса preauth-form](../../example/preauth-form.php)
+[Пример выполнения запроса transfer-form](../../example/transfer-form.php)
+
+## <a name="form-redirect"> Обработка результата платежа после возвращения клиента с платежной формы
+
+При возвращении пользователя с платежной формы на сервис мерчанта будут переданы данные с результатом обработки платежа. Обработка этих данных описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
+
+## <a name="callback"></a> Обработка обратного вызова
+
+После завершения обработки платежа на стороне PaynetEasy, данные с результатом обработки передаются в сервис мерчанта с помощью обратного вызова. Это необходимо, чтобы платеж был обработан сервисом мерчанта независимо от того, выполнил пользователь корректно возврат с шлюза PaynetEasy или нет. Обработка этих данных совпадает с обработкой данных для [sale-form, preauth-form или transfer-form](05-payment-form-integration.md) и описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
+
+[Подробнее о Merchant callbacks](06-merchant-callbacks.md)

data/doc/payment-scenarios/06-merchant-callbacks.md

@@ -0,0 +1,29 @@
+# Merchant callbacks
+
+## Общие положения
+
+* В данной статье описывается исключительно работа с библиотекой. Полная информация о Merchant callbacks расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Merchant_Callbacks).
+* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
+
+## <a name="main-callbacks"></a> Sale, Return, Chargeback callbacks
+
+После завершения обработки платежа на стороне PaynetEasy, данные с результатом обработки передаются в сервис мерчанта с помощью обратного вызова. Это необходимо, чтобы платеж был обработан сервисом мерчанта независимо от того, выполнил пользователь корректно возврат с шлюза PaynetEasy или нет. Обработка этих данных совпадает с обработкой данных для [sale-form, preauth-form или transfer-form](05-payment-form-integration.md) и описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
+При обработке платежа библиотека сначала проверяет наличие необходимых полей в данных обратного вызова, а потом сравнивает значения некоторых полей в платеже и данных обратного вызова. После проверки в платеже обновляется поле **status**.
+
+##### Обязательные параметры данных обратного вызова
+
+Поле запроса        |Цепочка свойств платежа для проверки
+--------------------|---------------------------------------
+orderid             |payment.paynetId
+merchant_order      |payment.clientId
+client_orderid      |payment.clientId
+amount              |payment.amount
+status              |
+type                |
+control             |
+
+[Пример выполнения запроса sale](../../example/sale.php#L102)
+[Пример выполнения запроса preauth](../../example/preauth.php#L102)
+[Пример выполнения запроса sale-form](../../example/sale-form.php#L81)
+[Пример выполнения запроса preauth-form](../../example/preauth-form.php#81)
+[Пример выполнения запроса transfer-form](../../example/transfer-form.php#81)

data/example/capture.rb

@@ -0,0 +1,12 @@
+require 'paynet_easy_api'
+require_relative './common/functions'
+
+payment_transaction = PaymentTransaction.new(
+{
+  'payment'       => Payment.new(
+  {
+    'client_id'     => 'CLIENT-112244',
+    'paynet_id'     =>  1969596,
+  }),
+  'query_config'  =>  query_config
+})

data/example/common/functions.rb

@@ -0,0 +1,56 @@
+require 'paynet_easy_api'
+
+query_config = -> () do
+  QueryConfig.new(
+  {
+    # Точка входа для аккаунта мерчанта, выдается при подключении
+    'end_point'                 =>  253,
+    # Логин мерчанта, выдается при подключении
+    'login'                     => 'rp-merchant1',
+    # Ключ мерчанта для подписывания запросов, выдается при подключении
+    'signing_key'               => '3FD4E71A-D84E-411D-A613-40A0FB9DED3A',
+    # URL на который пользователь будет перенаправлен после окончания запроса
+    'redirect_url'              => "http://{$_SERVER['HTTP_HOST']}/{$_SERVER['REQUEST_URI']}?stage=processCustomerReturn",
+    # URL на который пользователь будет перенаправлен после окончания запроса
+    'callback_url'              => "http://{$_SERVER['HTTP_HOST']}/{$_SERVER['REQUEST_URI']}?stage=processPaynetEasyCallback",
+    # Режим работы библиотеки: sandbox, production
+    'gateway_mode'              => QueryConfig::GATEWAY_MODE_SANDBOX,
+    # Ссылка на шлюз PaynetEasy для режима работы sandbox
+    'gateway_url_sandbox'       => 'https://sandbox.domain.com/paynet/api/v2/',
+    # Ссылка на шлюз PaynetEasy для режима работы production
+    'gateway_url_production'    => 'https://payment.domain.com/paynet/api/v2/'
+  })
+end
+
+load_payment_transaction = ->() do
+end
+
+save_payment_transaction = ->() do
+end
+
+display_wait_page = ->() do
+end
+
+display_response_html = ->(response) do
+end
+
+redirect_to_response_url = ->() do
+end
+
+display_ended_payment = ->() do
+end
+
+display_exception = ->() do
+end
+
+payment_processor = ->() do
+  PaymentProcessor.new(
+  {
+    PaymentProcessor::HANDLER_CATCH_EXCEPTION     => display_exception,
+    PaymentProcessor::HANDLER_SAVE_CHANGES        => save_payment_transaction,
+    PaymentProcessor::HANDLER_STATUS_UPDATE       => display_wait_page,
+    PaymentProcessor::HANDLER_REDIRECT            => redirect_to_response_url,
+    PaymentProcessor::HANDLER_SHOW_HTML           => display_response_html,
+    PaymentProcessor::HANDLER_FINISH_PROCESSING   => display_ended_payment
+  })
+end

data/lib/paynet_easy/paynet_easy_api/callback/callback_factory.rb

@@ -0,0 +1,47 @@
+require 'util/string'
+require 'callback/callback_prototype'
+
+module PaynetEasy::PaynetEasyApi::Callback
+  class CallbackFactory
+    @@allowed_payneteasy_callback_types =
+    [
+      'sale',
+      'revers al',
+      'chargeback'
+    ]
+
+    # Get callback processor by callback type
+    #
+    # @param    callback_type   [String]              Callback type
+    #
+    # @return                   [CallbackPrototype]   Callback processor
+    def callback(callback_type)
+      callback_class = "#{callback_type.camelize}Callback"
+      callback_file  = "callback/#{callback_type}_callback"
+
+      begin
+        instantiate_callback callback_file, callback_class, callback_type
+      rescue LoadError => error
+        if @@allowed_payneteasy_callback_types.include? callback_type
+          instantiate_callback 'callback/paynet_easy_callback', 'PaynetEasyCallback', callback_type
+        else
+          raise error
+        end
+      end
+    end
+
+    protected
+
+    # Load callback class file and return new callback object
+    #
+    # @param    callback_file     [String]              Callback class file
+    # @param    callback_class    [String]              Callback class
+    # @param    callback_type     [String]              Callback type
+    #
+    # @return                     [CallbackPrototype]   Callback object
+    def instantiate_callback(callback_file, callback_class, callback_type)
+      require callback_file
+      PaynetEasy::PaynetEasyApi::Callback.const_get(callback_class).new(callback_type)
+    end
+  end
+end

data/lib/paynet_easy/paynet_easy_api/callback/callback_prototype.rb

@@ -0,0 +1,186 @@
+require 'digest/sha1'
+require 'payment_data/payment_transaction'
+require 'transport/callback_response'
+require 'error/validation_error'
+require 'util/property_accessor'
+
+module PaynetEasy::PaynetEasyApi::Callback
+  class CallbackPrototype
+    include PaynetEasy::PaynetEasyApi::PaymentData
+    include PaynetEasy::PaynetEasyApi::Transport
+    include PaynetEasy::PaynetEasyApi::Error
+    include PaynetEasy::PaynetEasyApi::Util
+
+    # Allowed callback statuses
+    @allowed_statuses =
+    [
+      PaymentTransaction::STATUS_APPROVED,
+      PaymentTransaction::STATUS_DECLINED,
+      PaymentTransaction::STATUS_FILTERED,
+      PaymentTransaction::STATUS_ERROR
+    ]
+
+    # Callback fields definition if format:
+    # [
+    #   [<first callback field name>:string, <first payment transaction property path>:string]
+    #   [<second callback field name>:string, <second payment transaction property path>:string]
+    #   ...
+    #   [<last callback field name>:string, <last payment transaction property path>:string]
+    # ]
+    #
+    # If property name present in field definition,
+    # callback response field value and payment transaction property value will be compared.
+    # If values not equal validation exception will be raised.
+    @callback_fields_definition =
+    [
+      ['orderid',        'payment.paynet_id'],
+      ['merchant_order', 'payment.client_id'],
+      ['client_orderid', 'payment.client_id'],
+      ['amount',         'payment.amount'],
+      ['status',          nil],
+      ['type',            nil],
+      ['control',         nil]
+    ]
+
+    def initialize(callback_type)
+      @callback_type = callback_type
+      validate_callback_definition
+    end
+
+    # Process API gateway Response and update Payment transaction
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction for update
+    # @param    callback_response     [CallbackResponse]      PaynetEasy callback
+    #
+    # @return                         [CallbackResponse]      PaynetEasy callback
+    def process_callback(payment_transaction, callback_response)
+      begin
+        validate_callback payment_transaction, callback_response
+      rescue Exception => error
+        payment_transaction.add_error error
+        payment_transaction.status = PaymentTransaction::STATUS_ERROR
+
+        raise error
+      end
+
+      update_payment_transaction payment_transaction, callback_response
+
+      if callback_response.error?
+        raise callback_response.error
+      end
+
+      callback_response
+    end
+
+    protected
+
+    # Validates callback
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction
+    # @param    callback_response     [CallbackResponse]      Callback from PaynetEasy
+    def validate_callback(payment_transaction, callback_response)
+      validate_query_config payment_transaction
+      validate_signature payment_transaction, callback_response
+
+      unless allowed_statuses.include? callback_response.status
+        raise ValidationError, "Invalid callback status: '#{callback_response.status}'"
+      end
+
+      error_message   = ''
+      missed_fields   = []
+      unequal_fields  = []
+
+      callback_fields_definition.each do |field_name, property_path|
+        if callback_response.fetch(field_name, nil).nil?
+          missed_fields << field_name
+        elsif property_path
+          property_value = PropertyAccessor.get_value payment_transaction, property_path, false
+          callback_value = callback_response.fetch field_name
+
+          if property_value.to_s != callback_value.to_s
+            unequal_fields << "CallbackResponse field '#{field_name}' value '#{callback_value}' does not " +
+                              "equal PaymentTransaction property '#{property_path}' value '#{property_value}'."
+          end
+        end
+      end
+
+      unless missed_fields.empty?
+        error_message << "Some required fields missed or empty in CallbackResponse: \n#{missed_fields.join(', ')}. \n"
+      end
+
+      unless unequal_fields.empty?
+        error_message << "Some fields from CallbackResponse unequal properties " +
+                         "from PaymentTransaction: \n#{unequal_fields.join(" \n")}"
+      end
+
+      unless error_message.empty?
+        raise ValidationError, error_message
+      end
+    end
+
+    # Validates payment transaction query config
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction
+    def validate_query_config(payment_transaction)
+      unless payment_transaction.query_config.signing_key
+        raise ValidationError, "Property 'signing_key' does not defined in PaymentTransaction property 'query_config'"
+      end
+    end
+
+    # Validate callback response control code
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction for control code checking
+    # @param    callback_response     [CallbackResponse]      Callback for control code checking
+    def validate_signature(payment_transaction, callback_response)
+      expected_control_code = Digest::SHA1.hexdigest(
+        callback_response.status +
+        callback_response.payment_paynet_id.to_s +
+        callback_response.payment_client_id.to_s +
+        payment_transaction.query_config.signing_key
+      )
+
+      if expected_control_code != callback_response.control_code
+        raise ValidationError, "Actual control code '#{callback_response.control_code}' does " +
+                               "not equal expected '#{expected_control_code}'"
+      end
+    end
+
+    # Updates Payment transaction by Callback data
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction for updating
+    # @param    callback_response     [CallbackResponse]      Callback for payment transaction updating
+    def update_payment_transaction(payment_transaction, callback_response)
+      payment_transaction.status = callback_response.status
+      payment_transaction.payment.paynet_id = callback_response.payment_paynet_id
+
+      if callback_response.error? || callback_response.declined?
+        payment_transaction.add_error callback_response.error
+      end
+    end
+
+    # Validates callback object definition
+    def validate_callback_definition
+      raise RuntimeError, 'You must configure @allowed_statuses'            if allowed_statuses.empty?
+      raise RuntimeError, 'You must configure @callback_fields_definition'  if callback_fields_definition.empty?
+    end
+
+    class << self
+      # Make instance variables available in child classes
+      def inherited(subclass)
+        instance_variables.each do |variable_name|
+          subclass.instance_variable_set variable_name, instance_variable_get(variable_name)
+        end
+      end
+    end
+
+    # @return   [Array]
+    def allowed_statuses
+      self.class.instance_variable_get :@allowed_statuses
+    end
+
+    # @return   [Array]
+    def callback_fields_definition
+      self.class.instance_variable_get :@callback_fields_definition
+    end
+  end
+end

data/lib/paynet_easy/paynet_easy_api/callback/customer_return_callback.rb

@@ -0,0 +1,28 @@
+require 'callback/callback_prototype'
+
+module PaynetEasy::PaynetEasyApi::Callback
+  class CustomerReturnCallback < CallbackPrototype
+    @callback_fields_definition =
+    [
+      ['orderid',        'payment.paynet_id'],
+      ['merchant_order', 'payment.client_id'],
+      ['client_orderid', 'payment.client_id'],
+      ['status',          nil],
+      ['control',         nil]
+    ]
+
+    protected
+
+    # Validates callback
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction
+    # @param    callback_response     [CallbackResponse]      Callback from PaynetEasy
+    def validate_callback(payment_transaction, callback_response)
+      unless payment_transaction.processing?
+        raise ValidationError, 'Only processing payment transaction can be processed'
+      end
+
+      super payment_transaction, callback_response
+    end
+  end
+end

data/lib/paynet_easy/paynet_easy_api/callback/paynet_easy_callback.rb

@@ -0,0 +1,44 @@
+require 'callback/callback_prototype'
+require 'payment_data/payment_transaction'
+
+module PaynetEasy::PaynetEasyApi::Callback
+  class PaynetEasyCallback < CallbackPrototype
+    include PaynetEasy::PaynetEasyApi::PaymentData
+
+    @callback_fields_definition =
+    [
+      ['orderid',        'payment.paynet_id'],
+      ['merchant_order', 'payment.client_id'],
+      ['client_orderid', 'payment.client_id'],
+      ['amount',         'payment.amount'],
+      ['status',          nil],
+      ['type',            nil],
+      ['control',         nil]
+    ]
+
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction for update
+    # @param    callback_response     [CallbackResponse]      PaynetEasy callback
+    #
+    # @return                         [CallbackResponse]      PaynetEasy callback
+    def process_callback(payment_transaction, callback_response)
+      payment_transaction.processor_type = PaymentTransaction::PROCESSOR_CALLBACK
+      payment_transaction.processor_name = @callback_type
+
+      super payment_transaction, callback_response
+    end
+
+    protected
+
+    # Validates callback
+    #
+    # @param    payment_transaction   [PaymentTransaction]    Payment transaction
+    # @param    callback_response     [CallbackResponse]      Callback from PaynetEasy
+    def validate_callback(payment_transaction, callback_response)
+      unless payment_transaction.new?
+        raise ValidationError, 'Only new payment transaction can be processed'
+      end
+
+      super payment_transaction, callback_response
+    end
+  end
+end

data/lib/paynet_easy/paynet_easy_api/error/paynet_error.rb

@@ -0,0 +1,4 @@
+module PaynetEasy::PaynetEasyApi::Error
+  class PaynetError < RuntimeError
+  end
+end

data/lib/paynet_easy/paynet_easy_api/error/request_error.rb

@@ -0,0 +1,6 @@
+require 'error/paynet_error'
+
+module PaynetEasy::PaynetEasyApi::Error
+  class RequestError < PaynetError
+  end
+end

data/lib/paynet_easy/paynet_easy_api/error/response_error.rb

@@ -0,0 +1,6 @@
+require 'error/paynet_error'
+
+module PaynetEasy::PaynetEasyApi::Error
+  class ResponseError < PaynetError
+  end
+end