qiwi-pay 0.1.0

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "qiwi-pay"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/qiwi-pay.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module QiwiPay
+  # Web Payment Form interface interaction implementation
+  # @see https://developer.qiwi.com/ru/qiwipay/index.html?php#qiwipay-wpf
+  module Wpf
+    # QiwiPay WPF host
+    ENDPOINT_HOST = 'pay.qiwi.com'
+
+    # QiwiPay WPF endpoint
+    ENDPOINT_PATH = '/paypage/initial'
+  end
+
+  # JSON API interaction implementation
+  # @see https://developer.qiwi.com/ru/qiwipay/index.html?json#section-6
+  module Api
+    # QiwiPay API host
+    ENDPOINT_HOST = 'acquiring.qiwi.com'
+
+    # QiwiPay API endpoint
+    ENDPOINT_PATH = '/merchant/direct'
+  end
+end
+
+require "qiwi-pay/version"
+require "qiwi-pay/messages_for_codes"
+require "qiwi-pay/payment_operation"
+require "qiwi-pay/cheque"
+require "qiwi-pay/credentials"
+require "qiwi-pay/signature"
+require "qiwi-pay/confirmation"
+
+require "qiwi-pay/wpf/payment_operation"
+require "qiwi-pay/wpf/sale_operation"
+require "qiwi-pay/wpf/auth_operation"
+
+require "qiwi-pay/api/payment_operation"
+require "qiwi-pay/api/capture_operation"
+require "qiwi-pay/api/refund_operation"
+require "qiwi-pay/api/reversal_operation"
+require "qiwi-pay/api/status_operation"
+require "qiwi-pay/api/response"

data/lib/qiwi-pay/api/capture_operation.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module QiwiPay::Api
+  # Подтверждение авторизации в случае двухшагового сценария оплаты
+  #
+  # @note Параметры запроса
+  #   merchant_site Обязательно integer  Идентификатор сайта ТСП
+  #   txn_id        Обязательно integer  Идентификатор транзакции
+  #   cheque        Опционально string   Данные для кассового чека по 54-ФЗ
+  #
+  # @example Запрос
+  #   {
+  #     "opcode": 5,
+  #     "merchant_site": 99,
+  #     "txn_id": "172001",
+  #     "sign": "bb5c48ea540035e6b7c03c8184f74f09d26e9286a9b8f34b236b1bf2587e4268"
+  #   }
+  #
+  # @example Ответ
+  #   {
+  #     "txn_id":172001,
+  #     "txn_status":3,
+  #     "txn_type":2,
+  #     "txn_date": "2017-03-09T17:16:06+00:00",
+  #     "error_code":0
+  #   }
+  class CaptureOperation < PaymentOperation
+    # Код операции sale
+    def self.opcode
+      5
+    end
+
+    # Описание операции
+    def self.description
+      'Подтверждение авторизации в случае двухшагового сценария оплаты'
+    end
+
+    private
+
+    def self.in_params
+      %i[merchant_site txn_id cheque].freeze
+    end
+  end
+end

data/lib/qiwi-pay/api/payment_operation.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'rest_client'
+
+module QiwiPay::Api
+  # General QiwiPay API payment operation request
+  class PaymentOperation < QiwiPay::PaymentOperation
+    # @return [Response]
+    def perform
+      res = RestClient::Resource.new(
+        url,
+        ssl_client_cert: credentials.certificate,
+        ssl_client_key:  credentials.key,
+        verify_ssl:      OpenSSL::SSL::VERIFY_PEER
+      ).post(request_params.to_json)
+
+      Response.new res.code, res.body
+    end
+
+    private
+
+    def url
+      URI::HTTPS.build(
+        host: ENDPOINT_HOST,
+        path: ENDPOINT_PATH
+      ).to_s
+    end
+  end
+end

data/lib/qiwi-pay/api/refund_operation.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module QiwiPay::Api
+  # Операция возврата платежа (средства возвращаются в течение 30 дней)
+  #
+  # @note Параметры запроса
+  #   merchant_site Обязательно integer    Идентификатор сайта ТСП
+  #   txn_id        Обязательно integer    Идентификатор транзакции
+  #   amount        Опционально string(20) Сумма операции
+  #   cheque        Опционально string     Данные для кассового чека по 54-ФЗ
+  #
+  # @example Запрос
+  #   {
+  #     "opcode":7,
+  #     "merchant_site": 99,
+  #     "txn_id": 181001,
+  #     "amount": "700",
+  #     "sign": "bb5c48ea540035e6b7c03c8184f74f09d26e9286a9b8f34b236b1bf2587e4268"
+  #   }
+  #
+  # @example Ответ
+  #   {
+  #     "txn_id":182001,
+  #     "txn_status":3,
+  #     "txn_type":3,
+  #     "txn_date": "2017-03-09T17:16:06+00:00",
+  #     "error_code":0,
+  #     "amount": 700
+  #   }
+  class RefundOperation < PaymentOperation
+    # Код операции sale
+    def self.opcode
+      7
+    end
+
+    # Описание операции
+    def self.description
+      'Возврат платежа'
+    end
+
+    private
+
+    def self.in_params
+      %i[merchant_site txn_id amount cheque].freeze
+    end
+  end
+end

data/lib/qiwi-pay/api/response.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'ostruct'
+
+module QiwiPay::Api
+  # QiwiPay API response
+  class Response < OpenStruct
+    include QiwiPay::MessagesForCodes
+
+    # Parameters of integer type
+    INTEGER_PARAMS = %w[
+      txn_id
+      txn_status
+      txn_type
+      error_code
+      currency
+    ]
+
+    # @param response_code [Integer] HTTP response status code
+    # @param response_body [String] Response body in JSON
+    def initialize(response_code, response_body)
+      params = JSON.parse(response_body)
+      (INTEGER_PARAMS & params.keys).each do |p|
+        params[p] = params[p] && params[p].to_i
+      end
+      super params
+      send(:http_code=, response_code)
+    end
+
+    def success?
+      http_code == 200 && error_code == 0
+    end
+  end
+end

data/lib/qiwi-pay/api/reversal_operation.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module QiwiPay::Api
+  # Операция отмены платежа (средства расхолдируются практически сразу)
+  #
+  # @note Параметры запроса
+  #   merchant_site Обязательно integer    Идентификатор сайта ТСП
+  #   txn_id        Обязательно integer    Идентификатор транзакции
+  #   amount        Опционально string(20) Сумма операции
+  #   cheque        Опционально string     Данные для кассового чека по 54-ФЗ
+  #
+  # @example Запрос
+  #   {
+  #     "opcode":6,
+  #     "merchant_site": 99,
+  #     "txn_id": 181001,
+  #     "amount": "700",
+  #     "sign": "bb5c48ea540035e6b7c03c8184f74f09d26e9286a9b8f34b236b1bf2587e4268"
+  #   }
+  #
+  # @example Ответ
+  #   {
+  #     "txn_id":182001,
+  #     "txn_status":3,
+  #     "txn_type":4,
+  #     "txn_date": "2017-03-09T17:16:06+00:00",
+  #     "error_code":0,
+  #     "amount": 700
+  #   }
+  class ReversalOperation < PaymentOperation
+    # Код операции sale
+    def self.opcode
+      6
+    end
+
+    # Описание операции
+    def self.description
+      'Отмена платежа'
+    end
+
+    private
+
+    def self.in_params
+      %i[merchant_site txn_id amount cheque].freeze
+    end
+  end
+end

data/lib/qiwi-pay/api/status_operation.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module QiwiPay::Api
+  # Запрос статуса операции
+  #
+  # @note Параметры запроса
+  #   merchant_site Обязательно integer     Идентификатор сайта ТСП
+  #   txn_id        Опционально integer     Идентификатор транзакции
+  #   order_id      Опционально string(256) Уникальный номер заказа в системе ТСП
+  #
+  # @example Запрос
+  #   {
+  #     "opcode":30,
+  #     "merchant_site": 99,
+  #     "order_id": "41324123412342",
+  #     "sign": "bb5c48ea540035e6b7c03c8184f74f09d26e9286a9b8f34b236b1bf2587e4268"
+  #   }
+  #
+  # @example Ответ
+  #   {
+  #     "transactions": [
+  #       {
+  #         "error_code": 0,
+  #         "txn_id": 3666050,
+  #         "txn_status": 2,
+  #         "txn_type": 2,
+  #         "txn_date": "2017-03-09T17:16:06+00:00",
+  #         "pan": "400000******0002",
+  #         "amount": 10000,
+  #         "currency": 643,
+  #         "auth_code": "181218",
+  #         "merchant_site": 99,
+  #         "card_name": "cardholder name",
+  #         "card_bank": "",
+  #         "order_id": "41324123412342"
+  #       },
+  #       {
+  #         "error_code": 0,
+  #         "txn_id": 3684050,
+  #         "txn_status": 3,
+  #         "txn_type": 4,
+  #         "txn_date": "2017-03-09T17:16:09+00:00",
+  #         "pan": "400000******0002",
+  #         "amount": 100,
+  #         "currency": 643,
+  #         "merchant_site": 99,
+  #         "card_name": "cardholder name",
+  #         "card_bank": ""
+  #       },
+  #       {
+  #         "error_code": 0,
+  #         "txn_id": 3685050,
+  #         "txn_status": 3,
+  #         "txn_type": 4,
+  #         "txn_date": "2017-03-19T17:16:06+00:00",
+  #         "pan": "400000******0002",
+  #         "amount": 100,
+  #         "currency": 643,
+  #         "merchant_site": 99,
+  #         "card_name": "cardholder name",
+  #         "card_bank": ""
+  #       }
+  #     ],
+  #     "error_code": 0
+  #   }
+  class StatusOperation < PaymentOperation
+    # Код операции sale
+    def self.opcode
+      30
+    end
+
+    # Описание операции
+    def self.description
+      'Запрос статуса операции'
+    end
+
+    private
+
+    def self.in_params
+      %i[merchant_site txn_id order_id].freeze
+    end
+  end
+end

data/lib/qiwi-pay/cheque.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+require 'base64'
+require 'zlib'
+require 'json'
+
+module QiwiPay
+  # Чек 54-ФЗ
+  class Cheque
+    # Возможные значения НДС
+    module VAT
+      # не облагается НДС
+      NONE = 6
+      # облагается НДС по ставке 0%
+      VAT_0 = 5
+      # облагается НДС по ставке 10%
+      VAT_10 = 2
+      # облагается НДС по ставке 18%
+      VAT_18 = 1
+      # облагается НДС по ставке 10/110
+      VAT_110 = 4
+      # облагается НДС по ставке 18/118
+      VAT_118 = 3
+    end
+
+    # Возможные значения системы налогообложения
+    module TaxMode
+      # 0 — Общая система налогообложения
+      OSN = 0
+      # 1 — Упрощенная система налогообложения (Доход)
+      USN_D = 1
+      # 2 — Упрощенная СН (Доход минус Расход)
+      USN_DR = 2
+      # 3 — Единый налог на вмененный доход
+      ENVD = 3
+      # 4 — Единый сельскохозяйственный налог
+      ESHD = 4
+      # 5 — Патентная система налогообложения
+      PSN = 5
+    end
+
+    # Возможные значения типов чеков
+    module Type
+      # Приход
+      INFLOW = 1
+      # Возврат прихода
+      INFLOW_REVERSE = 2
+      # Расход
+      OUTFLOW = 3
+      # Возврат расхода
+      OUTFLOW_REVERSE = 4
+    end
+
+    # @option params seller_id [Integer] ИНН организации, для которой пробивается чек
+    # @option params cheque_type [Integer] Признак расчета (тэг 1054):
+    #                                      1.  Приход
+    #                                      2.  Возврат прихода
+    #                                      3.  Расход
+    #                                      4.  Возврат расхода
+    # @option params customer_contact [String] Телефон или электронный адрес покупателя (тэг 1008)
+    # @option params tax_system [Integer] Система налогообложения (тэг 1055):
+    #                                     0 – Общая, ОСН
+    #                                     1 – Упрощенная доход, УСН доход
+    #                                     2 – Упрощенная доход минус расход, УСН доход - расход
+    #                                     3 – Единый налог на вмененный доход, ЕНВД
+    #                                     4 – Единый сельскохозяйственный налог, ЕСН
+    #                                     5 – Патентная система налогообложения, Патент
+    # @option params positions [Array<Hash>] Массив товаров
+    def initialize(params)
+      @json = JSON.fast_generate params
+    end
+
+    # @return [String] cheque as JSON
+    # @example
+    #   {
+    #     "seller_id" : 3123011520,
+    #     "cheque_type" : 1,
+    #     "customer_contact" : "foo@domain.tld",
+    #     "tax_system" : 1,
+    #     "positions" : [
+    #       {
+    #         "quantity" : 2,
+    #         "price" : 322.94,
+    #         "tax" : 4,
+    #         "description" : "Товар/Услуга 1"
+    #       },
+    #       {
+    #         "quantity" : 1,
+    #         "price" : 500,
+    #         "tax" : 4,
+    #         "description" : "Товар/Услуга 2"
+    #       }
+    #     ]
+    #   }
+    def to_json
+      @json
+    end
+
+    # @return [String] Encoded cheque
+    def encode
+      Base64.strict_encode64(Zlib::Deflate.deflate(to_json))
+    end
+  end
+end