payabli 3.0.4 → 3.0.6

data/lib/payabli/funding/client.rb

@@ -21,13 +21,22 @@ module Payabli
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.funding.deposit_funds(
+      #     amount: 10,
+      #     entrypoint: "48acde49",
+      #     account_id: "333"
+      #   )
+      #
       # @return [Payabli::Types::DepositFundsResponse]
       def deposit_funds(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "Funding/depositFunds",
+          headers: headers,
           body: Payabli::Funding::Types::DepositFundsRequest.new(params).to_h,
           request_options: request_options
         )

data/lib/payabli/ghost_card/client.rb

@@ -28,6 +28,26 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Payabli::Types::Entry] :entry
       #
+      # @example
+      #   client.ghost_card.create_ghost_card(
+      #     entry: "8cfec329267",
+      #     vendor_id: 456,
+      #     expense_limit: 500,
+      #     amount: 500,
+      #     max_number_of_uses: 3,
+      #     exact_amount: false,
+      #     expense_limit_period: "monthly",
+      #     billing_cycle: "monthly",
+      #     billing_cycle_day: "1",
+      #     daily_transaction_count: 5,
+      #     daily_amount_limit: 200,
+      #     transaction_amount_limit: 100,
+      #     mcc: "5411",
+      #     tcc: "R",
+      #     misc_1: "PO-98765",
+      #     misc_2: "Dept-Finance"
+      #   )
+      #
       # @return [Payabli::Types::CreateGhostCardResponse]
       def create_ghost_card(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -35,10 +55,12 @@ module Payabli
         non_body_param_names = %w[entry]
         body = request_data.except(*non_body_param_names)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "MoneyOutCard/GhostCard/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           body: body,
           request_options: request_options
         )
@@ -67,6 +89,13 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Payabli::Types::Entry] :entry
       #
+      # @example
+      #   client.ghost_card.update_card(
+      #     entry: "8cfec329267",
+      #     card_token: "gc_abc123def456",
+      #     status: "Cancelled"
+      #   )
+      #
       # @return [Payabli::Types::PayabliApiResponse]
       def update_card(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -74,10 +103,12 @@ module Payabli
         non_body_param_names = %w[entry]
         body = request_data.except(*non_body_param_names)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "PATCH",
           path: "MoneyOutCard/card/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           body: body,
           request_options: request_options
         )

data/lib/payabli/hosted_payment_pages/client.rb

@@ -23,13 +23,21 @@ module Payabli
       # @option params [String] :entry
       # @option params [String] :subdomain
       #
+      # @example
+      #   client.hosted_payment_pages.load_page(
+      #     entry: "8cfec329267",
+      #     subdomain: "pay-your-fees-1"
+      #   )
+      #
       # @return [Payabli::Types::PayabliPages]
       def load_page(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Paypoint/load/#{URI.encode_uri_component(params[:entry].to_s)}/#{URI.encode_uri_component(params[:subdomain].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin
@@ -60,6 +68,12 @@ module Payabli
       # @option params [String] :entry
       # @option params [String, nil] :idempotency_key
       #
+      # @example
+      #   client.hosted_payment_pages.new_page(
+      #     entry: "8cfec329267",
+      #     idempotency_key: "6B29FC40-CA47-1067-B31D-00DD010662DA"
+      #   )
+      #
       # @return [Payabli::Types::PayabliApiResponse00Responsedatanonobject]
       def new_page(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -69,6 +83,7 @@ module Payabli
         headers = {}
         headers["idempotencyKey"] = params[:idempotency_key] if params[:idempotency_key]
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }]).merge(headers)
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
@@ -103,13 +118,21 @@ module Payabli
       # @option params [String] :entry
       # @option params [String] :subdomain
       #
+      # @example
+      #   client.hosted_payment_pages.save_page(
+      #     entry: "8cfec329267",
+      #     subdomain: "pay-your-fees-1"
+      #   )
+      #
       # @return [Payabli::Types::PayabliApiResponse00Responsedatanonobject]
       def save_page(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "PUT",
           path: "Paypoint/#{URI.encode_uri_component(params[:entry].to_s)}/#{URI.encode_uri_component(params[:subdomain].to_s)}",
+          headers: headers,
           body: Payabli::Types::PayabliPages.new(params).to_h,
           request_options: request_options
         )

data/lib/payabli/import/client.rb

@@ -22,6 +22,9 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :entry
       #
+      # @example
+      #   client.import.import_bills(entry: "8cfec329267")
+      #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_bills(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -29,10 +32,12 @@ module Payabli
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::Multipart::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "Import/billsForm/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           body: body,
           request_options: request_options
         )
@@ -63,6 +68,9 @@ module Payabli
       # @option params [Payabli::Types::Entrypointfield] :entry
       # @option params [Integer, nil] :replace_existing
       #
+      # @example
+      #   client.import.import_customer(entry: "8cfec329267")
+      #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_customer(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -70,10 +78,12 @@ module Payabli
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::Multipart::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "Import/customersForm/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           body: body,
           request_options: request_options
         )
@@ -103,6 +113,9 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Payabli::Types::Entrypointfield] :entry
       #
+      # @example
+      #   client.import.import_vendor(entry: "8cfec329267")
+      #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_vendor(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -110,10 +123,12 @@ module Payabli
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::Multipart::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "Import/vendorsForm/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           body: body,
           request_options: request_options
         )

data/lib/payabli/internal/http/raw_client.rb

@@ -177,6 +177,18 @@ module Payabli
           @auth_provider.auth_headers
         end
 
+        # Resolves the auth headers for a single endpoint given its declared security
+        # requirements. Under endpoint-security each endpoint applies only the schemes it
+        # declares, so it delegates to the routing auth provider with its own `security`.
+        # Returns an empty hash when no auth provider is configured.
+        # @param security [Array, nil] The endpoint's security requirements.
+        # @return [Hash] The auth headers to send for this endpoint.
+        def auth_headers_for_endpoint(security:)
+          return {} if @auth_provider.nil?
+
+          @auth_provider.auth_headers_for_endpoint(security: security)
+        end
+
         # @param url [URI::Generic] The url to the resource.
         # @param method [String] The HTTP method to use.
         # @param headers [Hash] The headers for the request.
@@ -197,9 +209,23 @@ module Payabli
           request_headers.each { |name, value| request[name] = value }
           request.body = body if body
 
+          # Net::HTTP disables its transparent gzip/deflate decoding as soon as an
+          # Accept-Encoding header is set explicitly on the request. Re-enable it so
+          # that compressed response bodies are still inflated.
+          request.extend(DecodeContent) if request_headers.keys.any? { |name| name.to_s.casecmp("accept-encoding").zero? }
+
           request
         end
 
+        # Keeps Net::HTTP's transparent gzip/deflate response decoding enabled
+        # even when an Accept-Encoding header is set explicitly on the request.
+        # @api private
+        module DecodeContent
+          def decode_content # rubocop:disable Naming/PredicateMethod
+            true
+          end
+        end
+
         # @param query [Hash] The query for the request.
         # @return [String, nil] The encoded query.
         def encode_query(query)

data/lib/payabli/internal/oauth_provider.rb

@@ -12,18 +12,24 @@ module Payabli
       def initialize(auth_client:, options:)
         @auth_client = auth_client
         @options = options
+        @mutex = Mutex.new
         @access_token = nil
         @expires_at = nil
       end
 
       # Returns a cached access token, refreshing if necessary.
       # Refreshes the token if it's nil, or if we're within the buffer period before expiration.
+      # Only one thread refreshes the token at a time.
       #
       # @return [String]
       def token
-        return refresh if @access_token.nil? || token_needs_refresh?
+        return @access_token unless @access_token.nil? || token_needs_refresh?
 
-        @access_token
+        @mutex.synchronize do
+          return @access_token unless @access_token.nil? || token_needs_refresh?
+
+          refresh
+        end
       end
 
       # Returns the authentication headers to be included in requests.

data/lib/payabli/internal/routing_auth_provider.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Internal
+    class RoutingAuthProvider
+      # @param api_key [untyped]
+      # @param oauth_provider [untyped]
+      #
+      # @return [void]
+      def initialize(api_key: nil, oauth_provider: nil)
+        @api_key = api_key
+        @oauth_provider = oauth_provider
+      end
+
+      # Endpoint-security applies auth per-endpoint, so no auth headers are added to every request.
+      #
+      # @return [Hash[String, String]]
+      def auth_headers
+        {}
+      end
+
+      # Returns the auth headers for a single endpoint given its static security requirements.
+      # Builds only the headers for the first requirement whose schemes all have credentials available (OR across the
+      # list, AND within a requirement). Raises when none is satisfiable.
+      #
+      # @param security [untyped]
+      #
+      # @return [Hash[String, String]]
+      def auth_headers_for_endpoint(security:)
+        return {} if security.nil? || security.empty?
+
+        available_auth_headers = {}
+        available_auth_headers["APIKeyAuth"] = { "requestToken" => @api_key.to_s } unless @api_key.nil?
+        available_auth_headers["BearerAuth"] = @oauth_provider.auth_headers unless @oauth_provider.nil?
+
+        security.each do |requirement|
+          next unless requirement.keys.all? { |scheme_key| available_auth_headers.key?(scheme_key) }
+
+          combined_headers = {}
+          requirement.each_key { |scheme_key| combined_headers.merge!(available_auth_headers[scheme_key]) }
+          return combined_headers
+        end
+
+        missing_schemes = security.map do |requirement|
+          requirement.keys.reject { |scheme_key| available_auth_headers.key?(scheme_key) }.join(" AND ")
+        end
+        raise ArgumentError, "No authentication credentials provided that satisfy the endpoint's security requirements. Please provide credentials for: #{missing_schemes.join(" OR ")}"
+      end
+    end
+  end
+end

data/lib/payabli/invoice/client.rb

@@ -23,6 +23,40 @@ module Payabli
       # @option params [Boolean, nil] :force_customer_creation
       # @option params [String, nil] :idempotency_key
       #
+      # @example
+      #   client.invoice.add_invoice(
+      #     entry: "8cfec329267",
+      #     customer_data: {
+      #       first_name: "Tamara",
+      #       last_name: "Bagratoni",
+      #       customer_number: "C-90010"
+      #     },
+      #     invoice_data: {
+      #       items: [{
+      #         item_product_name: "Adventure Consult",
+      #         item_description: "Consultation for Georgian tours",
+      #         item_cost: 100,
+      #         item_qty: 2,
+      #         item_mode: 2,
+      #         item_total_amount: 200
+      #       }, {
+      #         item_product_name: "Deposit ",
+      #         item_description: "Deposit for trip planning",
+      #         item_cost: 882.37,
+      #         item_qty: 1,
+      #         item_mode: 2,
+      #         item_total_amount: 882.37
+      #       }],
+      #       invoice_date: "2025-10-19",
+      #       invoice_type: 0,
+      #       invoice_status: 1,
+      #       frequency: "onetime",
+      #       invoice_amount: 1082.37,
+      #       discount: 10,
+      #       invoice_number: "INV-2345"
+      #     }
+      #   )
+      #
       # @return [Payabli::Types::InvoiceResponseWithoutData]
       def add_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -37,6 +71,7 @@ module Payabli
         headers = {}
         headers["idempotencyKey"] = params[:idempotency_key] if params[:idempotency_key]
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }]).merge(headers)
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
@@ -73,16 +108,24 @@ module Payabli
       # @option params [String] :filename
       # @option params [Boolean, nil] :return_object
       #
+      # @example
+      #   client.invoice.get_attached_file_from_invoice(
+      #     id_invoice: 1,
+      #     filename: "filename"
+      #   )
+      #
       # @return [Payabli::Types::FileContent]
       def get_attached_file_from_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_params = {}
         query_params["returnObject"] = params[:return_object] if params.key?(:return_object)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Invoice/attachedFileFromInvoice/#{URI.encode_uri_component(params[:id_invoice].to_s)}/#{URI.encode_uri_component(params[:filename].to_s)}",
+          headers: headers,
           query: query_params,
           request_options: request_options
         )
@@ -112,13 +155,21 @@ module Payabli
       # @option params [Integer] :id_invoice
       # @option params [String] :filename
       #
+      # @example
+      #   client.invoice.delete_attached_from_invoice(
+      #     id_invoice: 23548884,
+      #     filename: "0_Bill.pdf"
+      #   )
+      #
       # @return [Payabli::Types::InvoiceResponseWithoutData]
       def delete_attached_from_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "DELETE",
           path: "Invoice/attachedFileFromInvoice/#{URI.encode_uri_component(params[:id_invoice].to_s)}/#{URI.encode_uri_component(params[:filename].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin
@@ -146,13 +197,18 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Integer] :id_invoice
       #
+      # @example
+      #   client.invoice.get_invoice(id_invoice: 23548884)
+      #
       # @return [Payabli::Types::GetInvoiceRecord]
       def get_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Invoice/#{URI.encode_uri_component(params[:id_invoice].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin
@@ -181,6 +237,22 @@ module Payabli
       # @option params [Integer] :id_invoice
       # @option params [Boolean, nil] :force_customer_creation
       #
+      # @example
+      #   client.invoice.edit_invoice(
+      #     id_invoice: 23548884,
+      #     invoice_data: {
+      #       items: [{
+      #         item_product_name: "Deposit",
+      #         item_description: "Deposit for trip planning",
+      #         item_cost: 882.37,
+      #         item_qty: 1
+      #       }],
+      #       invoice_date: "2025-10-19",
+      #       invoice_amount: 982.37,
+      #       invoice_number: "INV-2345"
+      #     }
+      #   )
+      #
       # @return [Payabli::Types::InvoiceResponseWithoutData]
       def edit_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -192,10 +264,12 @@ module Payabli
         query_params["forceCustomerCreation"] = params[:force_customer_creation] if params.key?(:force_customer_creation)
         params = params.except(*query_param_names)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "PUT",
           path: "Invoice/#{URI.encode_uri_component(params[:id_invoice].to_s)}",
+          headers: headers,
           query: query_params,
           body: Payabli::Types::InvoiceDataRequest.new(body_params).to_h,
           request_options: request_options
@@ -225,13 +299,18 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Integer] :id_invoice
       #
+      # @example
+      #   client.invoice.delete_invoice(id_invoice: 23548884)
+      #
       # @return [Payabli::Types::InvoiceResponseWithoutData]
       def delete_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "DELETE",
           path: "Invoice/#{URI.encode_uri_component(params[:id_invoice].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin
@@ -259,13 +338,18 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :entry
       #
+      # @example
+      #   client.invoice.get_invoice_number(entry: "8cfec329267")
+      #
       # @return [Payabli::Types::InvoiceNumberResponse]
       def get_invoice_number(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Invoice/getNumber/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin
@@ -299,6 +383,14 @@ module Payabli
       # @option params [Hash[String, String, nil], nil] :parameters
       # @option params [String, nil] :sort_by
       #
+      # @example
+      #   client.invoice.list_invoices(
+      #     entry: "8cfec329267",
+      #     from_record: 251,
+      #     limit_record: 0,
+      #     sort_by: "desc(field_name)"
+      #   )
+      #
       # @return [Payabli::Types::QueryInvoiceResponse]
       def list_invoices(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -309,10 +401,12 @@ module Payabli
         query_params["parameters"] = params[:parameters] if params.key?(:parameters)
         query_params["sortBy"] = params[:sort_by] if params.key?(:sort_by)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Query/invoices/#{URI.encode_uri_component(params[:entry].to_s)}",
+          headers: headers,
           query: query_params,
           request_options: request_options
         )
@@ -347,6 +441,14 @@ module Payabli
       # @option params [Hash[String, String, nil], nil] :parameters
       # @option params [String, nil] :sort_by
       #
+      # @example
+      #   client.invoice.list_invoices_org(
+      #     org_id: 123,
+      #     from_record: 251,
+      #     limit_record: 0,
+      #     sort_by: "desc(field_name)"
+      #   )
+      #
       # @return [Payabli::Types::QueryInvoiceResponse]
       def list_invoices_org(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -357,10 +459,12 @@ module Payabli
         query_params["parameters"] = params[:parameters] if params.key?(:parameters)
         query_params["sortBy"] = params[:sort_by] if params.key?(:sort_by)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Query/invoices/org/#{URI.encode_uri_component(params[:org_id].to_s)}",
+          headers: headers,
           query: query_params,
           request_options: request_options
         )
@@ -391,6 +495,13 @@ module Payabli
       # @option params [Boolean, nil] :attachfile
       # @option params [String, nil] :mail_2
       #
+      # @example
+      #   client.invoice.send_invoice(
+      #     id_invoice: 23548884,
+      #     attachfile: true,
+      #     mail_2: "tamara@example.com"
+      #   )
+      #
       # @return [Payabli::Types::SendInvoiceResponse]
       def send_invoice(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
@@ -398,10 +509,12 @@ module Payabli
         query_params["attachfile"] = params[:attachfile] if params.key?(:attachfile)
         query_params["mail2"] = params[:mail_2] if params.key?(:mail_2)
 
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Invoice/send/#{URI.encode_uri_component(params[:id_invoice].to_s)}",
+          headers: headers,
           query: query_params,
           request_options: request_options
         )
@@ -430,13 +543,18 @@ module Payabli
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Integer] :id_invoice
       #
+      # @example
+      #   client.invoice.get_invoice_pdf(id_invoice: 23548884)
+      #
       # @return [Hash[String, Object]]
       def get_invoice_pdf(request_options: {}, **params)
         params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        headers = @client.auth_headers_for_endpoint(security: [{ "BearerAuth" => [] }, { "APIKeyAuth" => [] }])
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
           path: "Export/invoicePdf/#{URI.encode_uri_component(params[:id_invoice].to_s)}",
+          headers: headers,
           request_options: request_options
         )
         begin