monobank-lotarc 1.1.0

data/lib/monobank/resources/personal/auth_request.rb

@@ -0,0 +1,15 @@
+require 'monobank/resources/base'
+
+module Monobank
+  module Resources
+    module Personal
+      class AuthRequest < Base
+        define_fields %w[accept_url]
+
+        def request_id
+          @attributes['token_request_id']
+        end
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/client_info.rb

@@ -0,0 +1,18 @@
+require 'monobank/resources/base'
+require 'monobank/resources/personal/accounts'
+
+module Monobank
+  module Resources
+    module Personal
+      class ClientInfo < Base
+        define_fields %w[name web_hook_url accounts]
+
+        def accounts
+          @attributes['accounts'].map do |account|
+            Monobank::Resources::Personal::Accounts.new(account)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/registration.rb

@@ -0,0 +1,11 @@
+require 'monobank/resources/base'
+
+module Monobank
+  module Resources
+    module Personal
+      class Registration < Base
+        define_fields %w[status]
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/registration_status.rb

@@ -0,0 +1,11 @@
+require 'monobank/resources/base'
+
+module Monobank
+  module Resources
+    module Personal
+      class RegistrationStatus < Base
+        define_fields %w[key_id status]
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/settings.rb

@@ -0,0 +1,11 @@
+require 'monobank/resources/base'
+
+module Monobank
+  module Resources
+    module Personal
+      class Settings < Base
+        define_fields %w[name permissions webhook]
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/statement.rb

@@ -0,0 +1,11 @@
+require 'monobank/resources/base'
+
+module Monobank
+  module Resources
+    module Personal
+      class Statement < Base
+        define_fields %w[id time description mcc hold amount operation_amount currency_code commission_rate cashback_amount balance]
+      end
+    end
+  end
+end

data/lib/monobank/resources/personal/webhook.rb

@@ -0,0 +1,12 @@
+require 'monobank/resources/base'
+require 'monobank/resources/personal/accounts'
+
+module Monobank
+  module Resources
+    module Personal
+      class Webhook < Base
+        define_fields %w[status]
+      end
+    end
+  end
+end

data/lib/monobank/version.rb

@@ -0,0 +1,3 @@
+module Monobank
+  VERSION = "1.1.0"
+end

data/lib/monobank.rb

@@ -0,0 +1,32 @@
+require 'monobank/version'
+require 'monobank/client'
+require 'monobank/corporate'
+require 'monobank/configuration'
+require 'forwardable'
+
+module Monobank
+  extend SingleForwardable
+  def_delegators :client, :bank_currency, :client_info, :statement, :set_webhook
+
+  class << self
+    attr_writer :configuration
+
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def client
+      @client ||= Client.new(token: configuration.token)
+    end
+
+    def reset
+      @configuration = nil
+      @client = nil
+    end
+  end
+end

data/spec/monobank_corporate_spec.rb

@@ -0,0 +1,290 @@
+describe Monobank::Corporate do
+  let(:key_id) { nil }
+
+  before do
+    allow(Time).to receive(:now).and_return(Time.parse('2024-01-31'))
+
+    fake_private_key = OpenSSL::PKey::EC.new
+    allow(fake_private_key).to(receive(:sign)) { |_, args| "__SIGNED__#{args}" }
+    allow_any_instance_of(Monobank::Auth::Corporate).to receive(:init_key).and_return(fake_private_key)
+
+    allow(Base64).to(receive(:strict_encode64)) { |arg| "__BASE64__#{arg}" }
+
+    Monobank::Corporate.configure(private_key: 'FAKE PRIVATE KEY', key_id:)
+  end
+
+  context '.registration' do
+    before do
+      stub_request(:post, 'https://api.monobank.ua/personal/auth/registration').
+        with(
+          body: {
+            "pubkey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZZd0VBWUhLb1pJemow...",
+            "name": "ТОВ \"Ворона\"",
+            "description": "Ми робимо найрозумніший PFM з усіх можливих і нам потрібен доступ до виписка користувача, щоб створювати красиву статистику",
+            "contactPerson": "Роман Шевченко",
+            "phone": "380671234567",
+            "email": "etс@example.com",
+            "logo": "iVBORw0KGgoAAAANSUhEUgAAAUAAAACECAYAAADhnvK8AAAapElEQVR42..."
+          }.to_json,
+          headers: {
+            'X-Sign'=>'__BASE64____SIGNED__1706652000/personal/auth/registration',
+            'X-Time'=>'1706652000'
+          }).
+        to_return(status: 200, body: { status: 'New' }.to_json, headers: {'Content-Type' => 'application/json'})
+    end
+
+    it 'returns correct data' do
+      result = Monobank::Corporate.registration(
+        public_key: 'LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZZd0VBWUhLb1pJemow...',
+        name: 'ТОВ "Ворона"',
+        description: 'Ми робимо найрозумніший PFM з усіх можливих і нам потрібен доступ до виписка користувача, щоб створювати красиву статистику',
+        contact_person: 'Роман Шевченко',
+        phone: '380671234567',
+        email: 'etс@example.com',
+        logo: 'iVBORw0KGgoAAAANSUhEUgAAAUAAAACECAYAAADhnvK8AAAapElEQVR42...'
+      )
+
+      expect(result.status).to eq 'New'
+    end
+  end
+
+  context '.registration_status' do
+    before do
+      stub_request(:post, 'https://api.monobank.ua/personal/auth/registration/status').
+        with(
+          body: {
+            "pubkey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZZd0VBWUhLb1pJemow..."
+          }.to_json,
+          headers: {
+            'X-Sign' => '__BASE64____SIGNED__1706652000/personal/auth/registration/status',
+            'X-Time' => '1706652000'
+          }).
+        to_return(
+          status: 200,
+          body: { status: 'Approved', keyId: '28a75537175a018645e6f8b14be7681791e701e0' }.to_json,
+          headers: {'Content-Type' => 'application/json'}
+        )
+    end
+
+    it 'returns correct data' do
+      result = Monobank::Corporate.registration_status(public_key: 'LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZZd0VBWUhLb1pJemow...')
+
+      expect(result.status).to eq 'Approved'
+      expect(result.key_id).to eq '28a75537175a018645e6f8b14be7681791e701e0'
+    end
+  end
+
+  context 'with key_id' do
+    let(:key_id) { '28a75537175a018645e6f8b14be7681791e701e0' }
+
+    context '.set_webhook' do
+      before do
+        stub_request(:post, 'https://api.monobank.ua/personal/corp/webhook').
+          with(
+            body: {'webHookUrl': 'https://example.com/some_random_data_for_security'}.to_json,
+            headers: {
+              'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+              'X-Sign' => '__BASE64____SIGNED__1706652000/personal/corp/webhook',
+              'X-Time' => '1706652000'
+            }).
+          to_return(status: 200, body: {'status' => 'ok'}.to_json, headers: {'Content-Type' => 'application/json'})
+      end
+
+      it 'returns correct data' do
+        result = Monobank::Corporate.set_webhook(url: 'https://example.com/some_random_data_for_security')
+
+        expect(result.status).to eq 'ok'
+      end
+    end
+
+    context '.settings' do
+      before do
+        stub_request(:post, 'https://api.monobank.ua/personal/corp/settings').
+          with(
+            headers: {
+              'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+              'X-Sign' => '__BASE64____SIGNED__1706652000/personal/corp/settings',
+              'X-Time' => '1706652000'
+            }).
+          to_return(
+            status: 200,
+            body: {
+              "pubkey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZZd0VBWUhLb1pJemow...",
+              "name": "Компанія",
+              "permission": "psf",
+              "logo": "iVBORw0KGgoAAAANSUhEUgAAAUAAAACECAYAAADhnvK8AAAapElEQVR42...",
+              "webhook": "https://example.com/mono/corp/webhook/maybesomegibberishuniquestringbutnotnecessarily"
+            }.to_json,
+            headers: {'Content-Type' => 'application/json'}
+          )
+      end
+
+      it 'returns correct data' do
+        result = Monobank::Corporate.settings
+
+        expect(result.name).to eq 'Компанія'
+        expect(result.webhook).to eq 'https://example.com/mono/corp/webhook/maybesomegibberishuniquestringbutnotnecessarily'
+      end
+    end
+
+    context '.auth_request' do
+      let(:headers) { {} }
+
+      before do
+        stub_request(:post, 'https://api.monobank.ua/personal/auth/request').
+          with(
+            headers: {
+              'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+              'X-Sign' => '__BASE64____SIGNED__1706652000/personal/auth/request',
+              'X-Time' => '1706652000',
+              **headers
+            }).
+          to_return(
+            status: 200,
+            body: {
+              "tokenRequestId": "uLkwh3NzFAfEkj7urj5C7AU_",
+              "acceptUrl": "https://mbnk.app/auth/uLkwh3NzFAfEkj7urj5C7AU_"
+            }.to_json,
+            headers: {'Content-Type' => 'application/json'}
+          )
+      end
+
+      it 'returns correct data' do
+        result = Monobank::Corporate.auth_request
+
+        expect(result.request_id).to eq 'uLkwh3NzFAfEkj7urj5C7AU_'
+        expect(result.accept_url).to eq 'https://mbnk.app/auth/uLkwh3NzFAfEkj7urj5C7AU_'
+      end
+
+      context 'when a callback is passed' do
+        let(:headers) { {'X-Callback' => 'https://example.com' }}
+
+        it 'returns passes it as headers' do
+          result = Monobank::Corporate.auth_request(callback: 'https://example.com')
+
+          expect(result.request_id).to eq 'uLkwh3NzFAfEkj7urj5C7AU_'
+          expect(result.accept_url).to eq 'https://mbnk.app/auth/uLkwh3NzFAfEkj7urj5C7AU_'
+        end
+      end
+    end
+
+    context 'with request_id' do
+      let(:request_id) { 'uLkwh3NzFAfEkj7urj5C7AU_' }
+
+      context '.auth_check' do
+        before do
+          stub_request(:get, 'https://api.monobank.ua/personal/auth/request').
+            with(
+              headers: {
+                'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+                'X-Request-Id' => 'uLkwh3NzFAfEkj7urj5C7AU_',
+                'X-Sign' => '__BASE64____SIGNED__1706652000uLkwh3NzFAfEkj7urj5C7AU_/personal/auth/request',
+                'X-Time' => '1706652000'
+              }).
+            to_return(
+              status: 200,
+              body: { status: 'ok' }.to_json,
+              headers: {'Content-Type' => 'application/json'}
+            )
+        end
+
+        it 'returns correct data' do
+          result = Monobank::Corporate.auth_check(request_id:)
+
+          expect(result.status).to eq 'ok'
+        end
+      end
+
+      context '.client_info' do
+        before do
+          stub_request(:get, 'https://api.monobank.ua/personal/client-info').
+            with(
+              headers: {
+                'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+                'X-Request-Id' => 'uLkwh3NzFAfEkj7urj5C7AU_',
+                'X-Sign' => '__BASE64____SIGNED__1706652000uLkwh3NzFAfEkj7urj5C7AU_/personal/client-info',
+                'X-Time' => '1706652000'
+              }).
+            to_return(
+              status: 200,
+              body: {
+                "clientId": "3MSaMMtczs",
+                "name": "Мазепа Іван",
+                "webHookUrl": "https://mysomesite.copm/some_random_data_for_security",
+                "permissions": "psf",
+                "accounts": [
+                  {
+                    "id": "kKGVoZuHWzqVoZuH",
+                    "sendId": "uHWzqVoZuH",
+                    "balance": 10000000,
+                    "creditLimit": 10000000,
+                    "type": "black",
+                    "currencyCode": 980,
+                    "cashbackType": "UAH",
+                    "maskedPan": [
+                      "537541******1234"
+                    ],
+                    "iban": "UA733220010000026201234567890"
+                  }
+                ]
+              }.to_json,
+              headers: {'Content-Type' => 'application/json'}
+            )
+        end
+
+        it 'returns correct data' do
+          result = Monobank::Corporate.client_info(request_id:)
+
+          expect(result.name).to eq 'Мазепа Іван'
+          expect(result.accounts.length).to eq 1
+        end
+      end
+
+      context '.statement' do
+        before do
+          stub_request(:get, 'https://api.monobank.ua/personal/statement/0/1546304461').
+            with(
+              headers: {
+                'X-Key-Id' => '28a75537175a018645e6f8b14be7681791e701e0',
+                'X-Request-Id' => 'uLkwh3NzFAfEkj7urj5C7AU_',
+                'X-Sign' => '__BASE64____SIGNED__1706652000uLkwh3NzFAfEkj7urj5C7AU_/personal/statement/0/1546304461',
+                'X-Time' => '1706652000'
+              }).
+            to_return(
+              status: 200,
+              body: [
+                {
+                  "id": "ZuHWzqkKGVo=",
+                  "time": 1554466347,
+                  "description": "Покупка щастя",
+                  "mcc": 7997,
+                  "originalMcc": 7997,
+                  "hold": false,
+                  "amount": -95000,
+                  "operationAmount": -95000,
+                  "currencyCode": 980,
+                  "commissionRate": 0,
+                  "cashbackAmount": 19000,
+                  "balance": 10050000,
+                  "comment": "За каву",
+                  "receiptId": "XXXX-XXXX-XXXX-XXXX",
+                  "counterEdrpou": "3096889974",
+                  "counterIban": "UA898999980000355639201001404",
+                  "counterName": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ «ВОРОНА»"
+                }
+              ].to_json,
+              headers: {'Content-Type' => 'application/json'}
+            )
+        end
+
+        it 'returns correct data' do
+          result = Monobank::Corporate.statement(request_id:, account_id: 0, from: 1546304461)
+
+          expect(result.first.id).to eq 'ZuHWzqkKGVo='
+          expect(result.first.amount).to eq -95000
+          expect(result.first.currency_code).to eq 980
+        end
+      end
+    end
+  end
+end

data/spec/monobank_spec.rb

@@ -0,0 +1,147 @@
+describe Monobank do
+  let(:token) { 'FAKE_TOKEN' }
+
+  context '.bank_currency' do
+    before do
+      stub_request(:get, "https://api.monobank.ua/bank/currency").
+        to_return(
+          status: 200,
+          body: [
+            {
+              'currencyCodeA' => 840,
+              'currencyCodeB' => 980,
+              'date' => 1552392228,
+              'rateSell' => 27,
+              'rateBuy' => 27.2,
+              'rateCross' => 27.1
+            }
+          ].to_json,
+          headers: {'Content-Type' => 'application/json'}
+        )
+    end
+
+    it 'returns correct data' do
+      result = Monobank.bank_currency
+      expect(result.first.currency_code_a).to eq 840
+    end
+  end
+
+  context '.client_info' do
+    before do
+      stub_request(:get, "https://api.monobank.ua/personal/client-info").
+        with(headers: {'X-Token' => 'FAKE_TOKEN'}).
+        to_return(
+          status: 200,
+          body: {
+            "clientId": "3MSaMMtczs",
+            "name": "Мазепа Іван",
+            "webHookUrl": "https://example.com/some_random_data_for_security",
+            "permissions": "psfj",
+            "accounts": [
+              {
+                "id": "kKGVoZuHWzqVoZuH",
+                "sendId": "uHWzqVoZuH",
+                "balance": 10000000,
+                "creditLimit": 10000000,
+                "type": "black",
+                "currencyCode": 980,
+                "cashbackType": "UAH",
+                "maskedPan": [
+                  "537541******1234"
+                ],
+                "iban": "UA733220010000026201234567890"
+              }
+            ],
+            "jars": [
+              {
+                "id": "kKGVoZuHWzqVoZuH",
+                "sendId": "uHWzqVoZuH",
+                "title": "На тепловізор",
+                "description": "На тепловізор",
+                "currencyCode": 980,
+                "balance": 1000000,
+                "goal": 10000000
+              }
+            ]
+          }.to_json,
+          headers: {'Content-Type' => 'application/json'}
+        )
+    end
+
+    it 'returns correct data' do
+      result = Monobank.client_info(token:)
+      expect(result.name).to eq 'Мазепа Іван'
+      expect(result.accounts.length).to eq 1
+      expect(result.accounts.first.type).to eq 'black'
+      expect(result.accounts.first.currency_code).to eq 980
+      expect(result.attributes).to match hash_including(
+        'accounts' => array_including([
+          hash_including(
+            "currency_code" => 980
+          )
+        ])
+      )
+    end
+  end
+
+  context '.statement' do
+    before do
+      stub_request(:get, "https://api.monobank.ua/personal/statement/0/1546304461").
+        with(headers: {'X-Token' => 'FAKE_TOKEN'}).
+        to_return(
+          status: 200,
+          body: [
+            {
+              "id": "ZuHWzqkKGVo=",
+              "time": 1554466347,
+              "description": "Покупка щастя",
+              "mcc": 7997,
+              "originalMcc": 7997,
+              "hold": false,
+              "amount": -95000,
+              "operationAmount": -95000,
+              "currencyCode": 980,
+              "commissionRate": 0,
+              "cashbackAmount": 19000,
+              "balance": 10050000,
+              "comment": "За каву",
+              "receiptId": "XXXX-XXXX-XXXX-XXXX",
+              "invoiceId": "2103.в.27",
+              "counterEdrpou": "3096889974",
+              "counterIban": "UA898999980000355639201001404",
+              "counterName": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ «ВОРОНА»"
+            }
+          ].to_json,
+          headers: {'Content-Type' => 'application/json'}
+        )
+    end
+
+    it 'returns correct data' do
+      result = Monobank.statement(token:, account_id: 0, from: 1546304461)
+      expect(result.first.id).to eq 'ZuHWzqkKGVo='
+      expect(result.first.amount).to eq -95000
+      expect(result.first.currency_code).to eq 980
+    end
+  end
+
+  context '.set_webhook' do
+    before do
+      stub_request(:post, "https://api.monobank.ua/personal/webhook").
+        with(
+          body: {'webHookUrl': 'https://example.com/some_random_data_for_security'}.to_json,
+          headers: {
+            'Accept'=>'*/*',
+            'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3',
+            'User-Agent'=>'Ruby',
+            'X-Token'=>'FAKE_TOKEN'
+          }).
+        to_return(status: 200, body: {'status' => 'ok'}.to_json, headers: {'Content-Type' => 'application/json'})
+    end
+
+    it 'returns correct data' do
+      result = Monobank.set_webhook(token:, url: 'https://example.com/some_random_data_for_security')
+
+      expect(result.status).to eq 'ok'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+ENV['RAILS_ENV'] ||= 'test'
+
+require 'webmock/rspec'
+
+require 'monobank'
+
+ENGINE_RAILS_ROOT = File.join(File.dirname(__FILE__), '../')
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[File.join(ENGINE_RAILS_ROOT, 'spec/support/**/*.rb')].each { |f| require f }
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+end