virementmaitrise 0.6.2

data/lib/virementmaitrise/ais_client.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require 'virementmaitrise/api/ais/connect'
+require 'virementmaitrise/api/ais/accounts'
+require 'virementmaitrise/api/ais/transactions'
+require 'virementmaitrise/api/ais/account_holders'
+require 'virementmaitrise/api/ais/delete_customer'
+require 'virementmaitrise/api/ais/authorize'
+require 'virementmaitrise/api/ais/authorize_decoupled'
+require 'virementmaitrise/utils/json_parser'
+
+module VirementMaitrise
+  class AisClient
+    DEFAULT_ENVIRONMENT = 'sandbox'
+    ENVIRONMENTS = %w[test sandbox production].freeze
+
+    def initialize(config)
+      raise ArgumentError, "app_id is required" if config[:app_id].nil?
+      @app_id = config[:app_id]
+      raise ArgumentError, "app_secret is required" if config[:app_secret].nil?
+      @app_secret = config[:app_secret]
+      raise ArgumentError, "private_key is required" if config[:private_key].nil?
+      @private_key = config[:private_key]
+
+      env_value = (config[:environment] || DEFAULT_ENVIRONMENT).to_s.downcase
+      unless ENVIRONMENTS.include?(env_value)
+        raise ArgumentError, "#{env_value} is not a valid environment. Options are [#{ENVIRONMENTS.join(', ')}]"
+      end
+
+      @environment = env_value
+    end
+
+    # Getters
+    attr_reader :app_id, :app_secret, :private_key, :environment, :token, :token_expires_in, :refresh_token
+
+    private
+
+    def require_token!
+      raise VirementMaitrise::ValidationException, 'Token is required. Please call generate_token first.' if @token.nil?
+    end
+
+    public
+
+    #  Methodes
+    def connect(state, redirect_uri, scope = nil)
+      res = VirementMaitrise::Ais::Connect.generate self, state, redirect_uri, scope
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'connect')
+    end
+
+    def generate_token(auth_code)
+      res = VirementMaitrise::Authentication.get_access_token self, auth_code
+      body = VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'access token')
+      @token = body['access_token']
+      @token_expires_in = body['expires_in']
+      @refresh_token = body['refresh_token']
+
+      body
+    end
+
+    def generate_refresh_token(refresh_token = nil)
+      res = VirementMaitrise::Authentication.refresh_token self, (refresh_token || @refresh_token)
+      body = VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'refresh token')
+      @token = body['access_token']
+
+      body
+    end
+
+    def accounts(customer_id:, account_id: nil, remove_nulls: nil, withBalances: nil)
+      require_token!
+      res = VirementMaitrise::Ais::Accounts.get self, customer_id, account_id, remove_nulls, withBalances
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'accounts')
+    end
+
+    def transactions(customer_id:, account_id:, remove_nulls: nil, convert_dates: nil, filters: nil)
+      require_token!
+      res = VirementMaitrise::Ais::Transactions.get self, customer_id, account_id, remove_nulls, convert_dates, filters
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'transactions')
+    end
+
+    def account_holders(customer_id:, remove_nulls: nil)
+      require_token!
+      res = VirementMaitrise::Ais::AccountHolders.get self, customer_id, remove_nulls
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'account holders')
+    end
+
+    def delete_customer(customer_id:)
+      require_token!
+      res = VirementMaitrise::Ais::DeleteCustomer.delete self, customer_id
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'delete customer')
+    end
+
+    def authorize(provider_id:, redirect_uri:, app_id_auth: false, state: nil, x_psu_id: nil, x_psu_ip_address: nil)
+      require_token!
+      res = VirementMaitrise::Ais::Authorize.get self, app_id_auth, provider_id, redirect_uri, state, x_psu_id,
+                                           x_psu_ip_address
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'authorize')
+    end
+
+    def authorize_decoupled(provider_id:, polling_id:, app_id_auth: false)
+      require_token!
+      res = VirementMaitrise::Ais::AuthorizeDecoupled.get self, app_id_auth, provider_id, polling_id
+
+      VirementMaitrise::Utils::JsonParser.safe_parse(res.body, context: 'authorize decoupled')
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/account_holders.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class AccountHolders
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def get(client, customer_id, remove_nulls)
+          @client = client
+
+          # Do the request
+          _request customer_id, remove_nulls
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(customer_id, remove_nulls)
+          # Get the url request
+          url = _endpoint customer_id
+
+          # Build uri params
+          params = {}
+          params['remove_nulls'] = remove_nulls if remove_nulls
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(customer_id)
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::ACCOUNTHOLDERS}/#{customer_id}/accountholders"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/accounts.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class Accounts
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def get(client, customer_id, account_id, remove_nulls, withBalances)
+          @client = client
+
+          # Do the request
+          _request customer_id, account_id, remove_nulls, withBalances
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(customer_id, account_id, remove_nulls, withBalances)
+          # Get the url request
+          url = _endpoint customer_id, account_id
+
+          # Build uri params
+          params = {}
+          params['remove_nulls'] = remove_nulls if remove_nulls
+          params['withBalances'] = withBalances if withBalances
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(customer_id, account_id)
+          base = "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::ACCOUNTS}/#{customer_id}/accounts"
+          account_id ? "#{base}/#{account_id}" : base
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/authorize.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class Authorize
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def get(client, app_id_auth, provider_id, redirect_uri, state, x_psu_id, x_psu_ip_address)
+          @client = client
+
+          # Do the request
+          _request app_id_auth, provider_id, redirect_uri, state, x_psu_id, x_psu_ip_address
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(app_id_auth, provider_id, redirect_uri, state, x_psu_id, x_psu_ip_address)
+          # Get the url request
+          url = _endpoint provider_id
+
+          # Build uri params
+          params = {}
+          params['response_type'] = 'code' if app_id_auth
+          params['redirect_uri'] = redirect_uri if redirect_uri
+          params['state'] = state if state
+          params['model'] = 'redirect'
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Build additional headers
+          additional_headers = {}
+          additional_headers['app_id'] = @client.app_id if app_id_auth
+          additional_headers['x-psu-id'] = x_psu_id if x_psu_id
+          additional_headers['x-psu-ip-address'] = x_psu_ip_address if x_psu_ip_address
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true,
+            additional_headers: additional_headers,
+            disableAuthorization: app_id_auth ? true : false
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(provider_id)
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::AUTHORIZE}/#{provider_id}/authorize"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/authorize_decoupled.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class AuthorizeDecoupled
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def get(client, app_id_auth, provider_id, polling_id)
+          @client = client
+
+          # Do the request
+          _request app_id_auth, provider_id, polling_id
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(app_id_auth, provider_id, polling_id)
+          # Get the url request
+          url = _endpoint provider_id, polling_id
+
+          # Build uri params
+          params = {}
+          params['response_type'] = 'code' if app_id_auth
+          params['model'] = 'decoupled'
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Build additional headers
+          additional_headers = {}
+          additional_headers['app_id'] = @client.app_id if app_id_auth
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true,
+            additional_headers: additional_headers,
+            disableAuthorization: app_id_auth ? true : false
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(provider_id, polling_id)
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::AUTHORIZE}/#{provider_id}/authorize/decoupled/#{polling_id}"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/connect.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class Connect
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def generate(client, state, redirect_uri, scope)
+          @client = client
+
+          # Do the request
+          _request state, redirect_uri, scope
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(state, redirect_uri, scope)
+          # Get the url request
+          url = _endpoint
+
+          # Build uri params
+          params = {}
+          params['state'] = state
+          params['redirect_uri'] = redirect_uri
+          params['scope'] = scope if scope
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Build additional headers
+          additional_headers = {}
+          additional_headers['app_id'] = @client.app_id
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            secure_headers: true,
+            additional_headers: additional_headers
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::CONNECT}"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/delete_customer.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+
+module VirementMaitrise
+  module Ais
+    class DeleteCustomer
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def delete(client, customer_id)
+          @client = client
+
+          # Do the request
+          _request customer_id
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(customer_id)
+          # Get the url request
+          url = _endpoint customer_id
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.delete(
+            url: url,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(customer_id)
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::CUSTOMER}/#{customer_id}"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/ais/transactions.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/validation'
+require 'virementmaitrise/exceptions'
+require 'virementmaitrise/utils/date'
+require 'virementmaitrise/utils/constants'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  module Ais
+    class Transactions
+      class << self
+        # ------------ PUBLIC METHOD ------------
+        def get(client, customer_id, account_id, remove_nulls, convert_dates, filters)
+          @client = client
+
+          # Do the request
+          _request customer_id, account_id, remove_nulls, convert_dates, filters
+        end
+
+        private
+
+        # ------------ REQUEST ------------
+        def _request(customer_id, account_id, remove_nulls, convert_dates, filters)
+          # Get the url request
+          url = _endpoint customer_id, account_id
+
+          # Build uri params
+          params = {}
+          params['remove_nulls'] = remove_nulls if remove_nulls
+          params['convert_dates'] = convert_dates if convert_dates
+          filters.each { |key, value| params[key] = value } if filters
+
+          query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+          # Do connect request
+          VirementMaitrise::Faraday::Authentication::Connection.get(
+            url: url + query_string,
+            client: @client,
+            custom_content_type: 'application/json',
+            bearer: "Bearer #{@client.token}",
+            secure_headers: true
+          )
+        end
+
+        # ------------ API ENDPOINT ------------
+        def _endpoint(customer_id, account_id)
+          "#{_api_base_url}/#{VirementMaitrise::Api::Endpoints::Ais::TRANSACTIONS}/#{customer_id}/accounts/#{account_id}/transactions"
+        end
+
+        # ------------ BASE URL ------------
+        def _api_base_url
+          VirementMaitrise::Api::BaseUrl::FINTECTURE_API_URL[@client.environment.to_sym]
+        end
+
+      end
+    end
+  end
+end

data/lib/virementmaitrise/api/auth/authentication.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'faraday'
+require 'virementmaitrise/utils/query_builder'
+
+module VirementMaitrise
+  class Authentication
+    class << self
+      def authorize(redirect_uri, state = nil)
+        params = {
+          response_type: 'code',
+          app_id: VirementMaitrise.app_id,
+          redirect_uri: redirect_uri,
+          state: state
+        }
+        query_string = VirementMaitrise::Utils::QueryBuilder.build_query_string(params)
+
+        ::Faraday.get "#{token_authorize_endpoint}#{query_string}"
+      end
+
+      def get_access_token(client, auth_code = nil)
+        @client = client
+        body = access_token_data auth_code
+
+        VirementMaitrise::Faraday::Authentication::Connection.post url: access_token_url, req_body: body, client: client
+      end
+
+      def refresh_token(client, refresh_token)
+        @client = client
+        body = refresh_token_data refresh_token
+
+        VirementMaitrise::Faraday::Authentication::Connection.post url: refresh_token_url, req_body: body, client: client
+      end
+
+      private
+
+      def base_url
+        VirementMaitrise::Api::BaseUrl::FINTECTURE_OAUTH_URL[@client.environment.to_sym]
+      end
+
+      def token_authorize_endpoint
+        "#{base_url}#{VirementMaitrise::Api::Endpoints::Authentication::OAUTH_TOKEN_AUTHORIZE}"
+      end
+
+      def access_token_url
+        "#{base_url}#{VirementMaitrise::Api::Endpoints::Authentication::OAUTH_ACCESS_TOKEN}"
+      end
+
+      def refresh_token_url
+        "#{base_url}#{VirementMaitrise::Api::Endpoints::Authentication::OAUTH_REFRESH_TOKEN}"
+      end
+
+      def access_token_data(auth_code)
+        data = {
+          scope: 'PIS',
+          app_id: @client.app_id,
+          grant_type: 'client_credentials'
+        }
+
+        if auth_code
+          data = {
+            scope: 'AIS',
+            code: auth_code,
+            grant_type: 'authorization_code'
+          }
+        end
+
+        data
+      end
+
+      def refresh_token_data(refresh_token)
+        {
+          grant_type: 'refresh_token',
+          refresh_token: refresh_token
+        }
+      end
+    end
+  end
+end