payabli 2.2.22 → 2.2.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e05bcb36e71a98a3140b47a9a98956dd4fab002cd4f6b61a95bc6bb5c4aecf36
-  data.tar.gz: e8ca856e9e15e5631c42aca5e5976c1d3e1b58a17fc2a09633a115f779dffc4b
+  metadata.gz: f528aa1e62272f5b170b018c20faae13e95f7c23b3f8e2fdac7d75b1eed954e2
+  data.tar.gz: 8d784bc73af21914511f69f54b6c5c2d672ef9b9664c051bc07f2f993f2e5ebb
 SHA512:
-  metadata.gz: 9f4f7bdefed0e39418fb036d4f06919e172656362070e39a29ef3048d41c8b11b660e092b07b7b24522996c5132aa018a7f50c2b2751fbef8f3bec06fd66cd53
-  data.tar.gz: cadf269b6814966eb3409d27df82aa63b3d3caad64ffe5fa5ecce64ae452fa8b971a7318ae761d2ae285dfbc692bf99635bec45c3318e1c98f6844464b0b7407
+  metadata.gz: 521caf9ebad7a41e95b560d29f381a767326aad352eaadfe3144f9da000f9d3bc8776305d451ce28bc48e562e217abfc94c3765c9d734eb28f29888f194e82a3
+  data.tar.gz: fd066b504829b92a04931496b717946d61a87894923f44f502f099cc360c97b7b8a4f1fea3caf2b5e5753dbf79b11f71df6b8c308587651b515fe272f73ba319

data/.fern/metadata.json

@@ -1,10 +1,11 @@
 {
-  "cliVersion": "4.60.0",
+  "cliVersion": "4.94.0",
   "generatorName": "fernapi/fern-ruby-sdk",
-  "generatorVersion": "1.1.2",
+  "generatorVersion": "1.1.13",
   "generatorConfig": {
-    "enableWireTests": true
+    "enableWireTests": true,
+    "rubocopVariableNumberStyle": "snake_case"
   },
-  "originGitCommit": "6415b5451c2da0d2c1cef85dc4081265a866360c",
-  "sdkVersion": "2.2.22"
+  "originGitCommit": "a59c2b2d6ccbf2e800fba96cc3ea9476df69b7b0",
+  "sdkVersion": "2.2.25"
 }

data/.fernignore

@@ -1,4 +1,3 @@
 # Specify files that shouldn't be modified by Fern
-test/unit/custom_test.rb
-.github/workflows/ci.yml
 LICENSE.md
+CONTRIBUTING.md

data/.rubocop.yml

@@ -45,7 +45,7 @@ Layout/LineLength:
   Enabled: false
 
 Naming/VariableNumber:
-  EnforcedStyle: normalcase
+  EnforcedStyle: snake_case
 
 Style/Documentation:
   Enabled: false

data/CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contributing
+
+Thank you for your interest in contributing to the Payabli SDKs!
+We welcome contributions from the community and appreciate your help in improving our SDKs.
+
+## Feature requests
+
+If you would like to request a new feature, please create a new GitHub issue on this repository.
+See the [Issues](../../issues) page and click **New issue** to get started.
+
+Please provide the following information in your feature request:
+- A clear description of the feature
+- The use case for the feature
+- Code examples that demonstrate how the feature would be used (if applicable) 
+
+## Bug reports
+
+If you have found a bug in the SDK, please create a new GitHub issue on this repository.
+See the [Issues](../../issues) page and click **New issue** to get started.
+
+Please provide the following information in your bug report:
+- A clear description of the bug
+- Steps to reproduce the bug
+- Expected behavior
+- Actual behavior
+- Code examples that demonstrate the bug (if applicable)
+
+## Pull requests
+
+Pull requests are welcome; however, Payabli implements all code changes.
+We'll review your pull request and close it. 
+If we have any questions about your pull request, we'll ask you in the comments of the pull request.
+

data/README.md

@@ -73,7 +73,7 @@ require "payabli"
 
 client = Payabli::Client.new(api_key: "<value>")
 
-client.money_in.getpaid(
+client.money_in.getpaidv_2(
   customer_data: {
     customer_id: 4440
   },
@@ -128,7 +128,7 @@ client = Payabli::Client.new(
 )
 
 begin
-    result = client.money_in.getpaid
+    result = client.money_in.getpaidv_2
 rescue Payabli::Errors::TimeoutError
     puts "API didn't respond before our timeout elapsed"
 rescue Payabli::Errors::ServiceUnavailableError
@@ -173,7 +173,7 @@ The SDK defaults to a 60 second timeout. Use the `timeout` option to configure t
 ```ruby
 require "payabli"
 
-response = client.money_in.getpaid(
+response = client.money_in.getpaidv_2(
     ...,
     timeout: 30  # 30 second timeout
 )
@@ -186,7 +186,7 @@ If you would like to send additional headers as part of the request, use the `ad
 ```ruby
 require "payabli"
 
-response = client.money_in.getpaid(
+response = client.money_in.getpaidv_2(
     ...,
     request_options: {
         additional_headers: {
@@ -203,7 +203,7 @@ If you would like to send additional query parameters as part of the request, us
 ```ruby
 require "payabli"
 
-response = client.money_in.getpaid(
+response = client.money_in.getpaidv_2(
     ...,
     request_options: {
         additional_query_parameters: {

data/lib/payabli/client.rb

@@ -10,7 +10,7 @@ module Payabli
       @raw_client = Payabli::Internal::Http::RawClient.new(
         base_url: base_url || Payabli::Environment::SANDBOX,
         headers: {
-          "User-Agent" => "payabli/2.2.22",
+          "User-Agent" => "payabli/2.2.25",
           "X-Fern-Language" => "Ruby",
           requestToken: api_key.to_s
         }
@@ -77,6 +77,11 @@ module Payabli
       @line_item ||= Payabli::LineItem::Client.new(client: @raw_client)
     end
 
+    # @return [Payabli::Management::Client]
+    def management
+      @management ||= Payabli::Management::Client.new(client: @raw_client)
+    end
+
     # @return [Payabli::MoneyIn::Client]
     def money_in
       @money_in ||= Payabli::MoneyIn::Client.new(client: @raw_client)

data/lib/payabli/cloud/client.rb

@@ -90,6 +90,9 @@ module Payabli
         end
       end
 
+      # Use [List devices by paypoint](/developers/api-reference/cloud/get-list-of-devices-for-a-paypoint) instead,
+      # which supports filters, sorting, and pagination.
+      #
       # Get a list of cloud devices registered to an entrypoint.
       #
       # @param request_options [Hash]

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

@@ -31,6 +31,20 @@ module Payabli
         # Child classes should implement:
         # - encode_headers: Returns the encoded HTTP request headers.
         # - encode_body: Returns the encoded HTTP request body.
+
+        private
+
+        # Merges additional_headers from request_options into sdk_headers, filtering out
+        # any keys that collide with SDK-set or client-protected headers (case-insensitive).
+        # @param sdk_headers [Hash] Headers set by the SDK for this request type.
+        # @param protected_keys [Array<String>] Additional header keys that must not be overridden.
+        # @return [Hash] The merged headers.
+        def merge_additional_headers(sdk_headers, protected_keys: [])
+          additional_headers = @request_options&.dig(:additional_headers) || @request_options&.dig("additional_headers") || {}
+          all_protected = (sdk_headers.keys + protected_keys).to_set { |k| k.to_s.downcase }
+          filtered = additional_headers.reject { |key, _| all_protected.include?(key.to_s.downcase) }
+          sdk_headers.merge(filtered)
+        end
       end
     end
   end

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

@@ -43,7 +43,7 @@ module Payabli
             http_request = build_http_request(
               url:,
               method: request.method,
-              headers: request.encode_headers,
+              headers: request.encode_headers(protected_keys: @default_headers.keys),
               body: request.encode_body
             )
 
@@ -120,6 +120,8 @@ module Payabli
           [delay + jitter, 0].max
         end
 
+        LOCALHOST_HOSTS = %w[localhost 127.0.0.1 [::1]].freeze
+
         # @param request [Payabli::Internal::Http::BaseRequest] The HTTP request.
         # @return [URI::Generic] The URL.
         def build_url(request)
@@ -129,14 +131,29 @@ module Payabli
           if request.path.start_with?("http://", "https://")
             url = request.path
             url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
-            return URI.parse(url)
+            parsed = URI.parse(url)
+            validate_https!(parsed)
+            return parsed
           end
 
           path = request.path.start_with?("/") ? request.path[1..] : request.path
           base = request.base_url || @base_url
           url = "#{base.chomp("/")}/#{path}"
           url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
-          URI.parse(url)
+          parsed = URI.parse(url)
+          validate_https!(parsed)
+          parsed
+        end
+
+        # Raises if the URL uses http:// for a non-localhost host, which would
+        # send authentication credentials in plaintext.
+        # @param url [URI::Generic] The parsed URL.
+        def validate_https!(url)
+          return if url.scheme != "http"
+          return if LOCALHOST_HOSTS.include?(url.host)
+
+          raise ArgumentError, "Refusing to send request to non-HTTPS URL: #{url}. " \
+                               "HTTP is only allowed for localhost. Use HTTPS or pass a localhost URL."
         end
 
         # @param url [URI::Generic] The url to the resource.
@@ -180,6 +197,7 @@ module Payabli
 
           http = Net::HTTP.new(url.host, port)
           http.use_ssl = is_https
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER if is_https
           # NOTE: We handle retries at the application level with HTTP status code awareness,
           # so we set max_retries to 0 to disable Net::HTTP's built-in network-level retries.
           http.max_retries = 0

data/lib/payabli/internal/json/request.rb

@@ -21,12 +21,14 @@ module Payabli
         end
 
         # @return [Hash] The encoded HTTP request headers.
-        def encode_headers
-          additional_headers = @request_options&.dig(:additional_headers) || @request_options&.dig("additional_headers") || {}
-          {
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
             "Content-Type" => "application/json",
             "Accept" => "application/json"
-          }.merge(@headers).merge(additional_headers)
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
         end
 
         # @return [String, nil] The encoded HTTP request body.

data/lib/payabli/internal/multipart/multipart_request.rb

@@ -21,11 +21,13 @@ module Payabli
         end
 
         # @return [Hash] The encoded HTTP request headers.
-        def encode_headers
-          additional_headers = @request_options&.dig(:additional_headers) || @request_options&.dig("additional_headers") || {}
-          {
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
             "Content-Type" => @body.content_type
-          }.merge(@headers).merge(additional_headers)
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
         end
 
         # @return [String, nil] The encoded HTTP request body.

data/lib/payabli/internal/types/boolean.rb

@@ -17,7 +17,7 @@ module Payabli
         def self.coerce(value, strict: strict?)
           case value
           when TrueClass, FalseClass
-            value
+            return value
           when Integer
             return value == 1
           when String

data/lib/payabli/internal/types/utils.rb

@@ -81,10 +81,10 @@ module Payabli
                }
               return type.coerce(value, strict: strict)
             else
-              value
+              value # rubocop:disable Lint/Void
             end
           else
-            value
+            value # rubocop:disable Lint/Void
           end
 
           raise Errors::TypeError, "cannot coerce value of type `#{value.class}` to `#{target}`" if strict

data/lib/payabli/management/client.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Management
+    class Client
+      # @param client [Payabli::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Verifies a bank account and returns detailed verification results from the verification network, including bank
+      # name, account status, and response codes. Unlike a pass/fail verification, this endpoint returns granular data
+      # to support decision-making and troubleshooting.
+      #
+      # When bank authentication is enabled for the paypoint's organization, the endpoint performs an identity
+      # verification check on the account holder. Otherwise, it performs an account existence check. When bank
+      # authentication is enabled, the `accountHolderType` and `holderName` fields are required.
+      #
+      # Requires `inboundpayments_create` or `outboundpayments_create` permission.
+      #
+      # @param request_options [Hash]
+      # @param params [Payabli::Management::Types::VerifyAccountDetailsRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :entry
+      #
+      # @return [Payabli::Management::Types::VerifyAccountDetailsResponse]
+      def verify_account_details(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        request_data = Payabli::Management::Types::VerifyAccountDetailsRequest.new(params).to_h
+        non_body_param_names = ["entry"]
+        body = request_data.except(*non_body_param_names)
+
+        request = Payabli::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "Management/verifyAccountDetails/#{URI.encode_uri_component(params[:entry].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Payabli::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Payabli::Management::Types::VerifyAccountDetailsResponse.load(response.body)
+        else
+          error_class = Payabli::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/payabli/management/types/bank_account_verification_details_response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Management
+    module Types
+      # Detailed bank account verification results from the verification network.
+      class BankAccountVerificationDetailsResponse < Internal::Types::Model
+        field :aba, -> { String }, optional: true, nullable: false
+        field :account_number, -> { String }, optional: true, nullable: false, api_name: "accountNumber"
+        field :is_valid, -> { Internal::Types::Boolean }, optional: false, nullable: false, api_name: "isValid"
+        field :error_message, -> { String }, optional: true, nullable: false, api_name: "errorMessage"
+        field :verification_response, -> { String }, optional: true, nullable: false, api_name: "verificationResponse"
+        field :response_code, -> { String }, optional: true, nullable: false, api_name: "responseCode"
+        field :response_value, -> { String }, optional: true, nullable: false, api_name: "responseValue"
+        field :response_description, -> { String }, optional: true, nullable: false, api_name: "responseDescription"
+        field :bank_name, -> { String }, optional: true, nullable: false, api_name: "bankName"
+        field :reported_account_type, -> { String }, optional: true, nullable: false, api_name: "reportedAccountType"
+        field :account_added_date, -> { String }, optional: true, nullable: false, api_name: "accountAddedDate"
+        field :account_last_updated_date, -> { String }, optional: true, nullable: false, api_name: "accountLastUpdatedDate"
+        field :account_closed_date, -> { String }, optional: true, nullable: false, api_name: "accountClosedDate"
+      end
+    end
+  end
+end

data/lib/payabli/management/types/verify_account_details_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Management
+    module Types
+      class VerifyAccountDetailsRequest < Internal::Types::Model
+        field :entry, -> { String }, optional: false, nullable: false
+        field :routing_number, -> { String }, optional: false, nullable: false, api_name: "routingNumber"
+        field :account_number, -> { String }, optional: false, nullable: false, api_name: "accountNumber"
+        field :account_type, -> { String }, optional: true, nullable: false, api_name: "accountType"
+        field :country, -> { String }, optional: true, nullable: false
+        field :account_holder_type, -> { String }, optional: true, nullable: false, api_name: "accountHolderType"
+        field :holder_name, -> { String }, optional: true, nullable: false, api_name: "holderName"
+      end
+    end
+  end
+end

data/lib/payabli/management/types/verify_account_details_response.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Management
+    module Types
+      # Response wrapper for the bank account verification details endpoint.
+      class VerifyAccountDetailsResponse < Internal::Types::Model
+        field :is_success, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "isSuccess"
+        field :response_text, -> { String }, optional: false, nullable: false, api_name: "responseText"
+        field :response_data, -> { Payabli::Management::Types::BankAccountVerificationDetailsResponse }, optional: true, nullable: false, api_name: "responseData"
+      end
+    end
+  end
+end

data/lib/payabli/money_in/client.rb

@@ -299,7 +299,9 @@ module Payabli
 
       # A reversal either refunds or voids a transaction independent of the transaction's settlement status. Send a
       # reversal request for a transaction, and Payabli automatically determines whether it's a refund or void. You
-      # don't need to know whether the transaction is settled or not.
+      # don't need to know whether the transaction is settled or not. This endpoint only works on transactions made with
+      # the v1 API. For v2 transactions, check the transaction's settlement status and call v2 void or v2 refund based
+      # on the result.
       #
       # @param request_options [Hash]
       # @param params [Hash]

data/lib/payabli/money_in/types/transaction_detail_payment_data.rb

@@ -13,7 +13,7 @@ module Payabli
         field :initiator, -> { String }, optional: false, nullable: true
         field :stored_method_usage_type, -> { String }, optional: false, nullable: true, api_name: "storedMethodUsageType"
         field :sequence, -> { String }, optional: false, nullable: true
-        field :order_description, -> { String }, optional: false, nullable: false, api_name: "orderDescription"
+        field :order_description, -> { String }, optional: false, nullable: true, api_name: "orderDescription"
         field :account_id, -> { String }, optional: false, nullable: true, api_name: "accountId"
         field :signature_data, -> { String }, optional: false, nullable: true, api_name: "signatureData"
         field :bin_data, -> { Payabli::Types::BinData }, optional: false, nullable: true, api_name: "binData"

data/lib/payabli/money_out/client.rb

@@ -10,8 +10,9 @@ module Payabli
         @client = client
       end
 
-      # Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use
-      # `referenceId` returned in the response to capture the transaction.
+      # Authorizes transaction for payout.  If you don't pass the `autoCapture` field with a value of `true`, authorized
+      # transactions aren't flagged for settlement until captured.  Use `referenceId` returned in the response to
+      # capture the transaction.
       #
       # @param request_options [Hash]
       # @param params [Payabli::MoneyOutTypes::Types::AuthorizePayoutBody]
@@ -203,7 +204,8 @@ module Payabli
         end
       end
 
-      # Captures a single authorized payout transaction by ID.
+      # Captures a single authorized payout transaction by ID. If the transaction was authorized with `autoCapture` set
+      # to `true`,  you don't need to call this endpoint to capture the transaction for processing.
       #
       # @param request_options [Hash]
       # @param params [Hash]

data/lib/payabli/money_out_types/types/authorize_payout_body.rb

@@ -15,6 +15,7 @@ module Payabli
         field :account_id, -> { String }, optional: true, nullable: false, api_name: "accountId"
         field :subdomain, -> { String }, optional: true, nullable: false
         field :subscription_id, -> { Integer }, optional: true, nullable: false, api_name: "subscriptionId"
+        field :auto_capture, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "autoCapture"
       end
     end
   end

data/lib/payabli/query/client.rb

@@ -512,6 +512,106 @@ module Payabli
         end
       end
 
+      # Returns a list of cloud devices for a single paypoint. Use filters to limit results. Include the `exportFormat`
+      # query parameter to return the results as a file instead of a JSON response.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Payabli::Types::Entry] :entry
+      # @option params [Payabli::Types::ExportFormat, nil] :export_format
+      # @option params [Integer, nil] :from_record
+      # @option params [Integer, nil] :limit_record
+      # @option params [Hash[String, String, nil], nil] :parameters
+      # @option params [String, nil] :sort_by
+      #
+      # @return [Payabli::QueryTypes::Types::QueryDeviceResponse]
+      def list_devices(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        query_param_names = %i[export_format from_record limit_record parameters sort_by]
+        query_params = {}
+        query_params["exportFormat"] = params[:export_format] if params.key?(:export_format)
+        query_params["fromRecord"] = params[:from_record] if params.key?(:from_record)
+        query_params["limitRecord"] = params[:limit_record] if params.key?(:limit_record)
+        query_params["parameters"] = params[:parameters] if params.key?(:parameters)
+        query_params["sortBy"] = params[:sort_by] if params.key?(:sort_by)
+        params = params.except(*query_param_names)
+
+        request = Payabli::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "Query/devices/#{URI.encode_uri_component(params[:entry].to_s)}",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Payabli::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Payabli::QueryTypes::Types::QueryDeviceResponse.load(response.body)
+        else
+          error_class = Payabli::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Returns a list of cloud devices for a single organization. Use filters to limit results. Include the
+      # `exportFormat` query parameter to return the results as a file instead of a JSON response.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :org_id
+      # @option params [Payabli::Types::ExportFormat, nil] :export_format
+      # @option params [Integer, nil] :from_record
+      # @option params [Integer, nil] :limit_record
+      # @option params [Hash[String, String, nil], nil] :parameters
+      # @option params [String, nil] :sort_by
+      #
+      # @return [Payabli::QueryTypes::Types::QueryDeviceResponse]
+      def list_devices_org(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
+        query_param_names = %i[export_format from_record limit_record parameters sort_by]
+        query_params = {}
+        query_params["exportFormat"] = params[:export_format] if params.key?(:export_format)
+        query_params["fromRecord"] = params[:from_record] if params.key?(:from_record)
+        query_params["limitRecord"] = params[:limit_record] if params.key?(:limit_record)
+        query_params["parameters"] = params[:parameters] if params.key?(:parameters)
+        query_params["sortBy"] = params[:sort_by] if params.key?(:sort_by)
+        params = params.except(*query_param_names)
+
+        request = Payabli::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "Query/devices/org/#{URI.encode_uri_component(params[:org_id].to_s)}",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Payabli::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Payabli::QueryTypes::Types::QueryDeviceResponse.load(response.body)
+        else
+          error_class = Payabli::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Returns a list of all reports generated in the last 60 days for a single entrypoint. Use filters to limit
       # results.
       #

data/lib/payabli/query/types/list_devices_org_request.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Query
+    module Types
+      class ListDevicesOrgRequest < Internal::Types::Model
+        field :org_id, -> { Integer }, optional: false, nullable: false, api_name: "orgId"
+        field :export_format, -> { Payabli::Types::ExportFormat }, optional: true, nullable: false, api_name: "exportFormat"
+        field :from_record, -> { Integer }, optional: true, nullable: false, api_name: "fromRecord"
+        field :limit_record, -> { Integer }, optional: true, nullable: false, api_name: "limitRecord"
+        field :parameters, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+        field :sort_by, -> { String }, optional: true, nullable: false, api_name: "sortBy"
+      end
+    end
+  end
+end

data/lib/payabli/query/types/list_devices_request.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Payabli
+  module Query
+    module Types
+      class ListDevicesRequest < Internal::Types::Model
+        field :entry, -> { String }, optional: false, nullable: false
+        field :export_format, -> { Payabli::Types::ExportFormat }, optional: true, nullable: false, api_name: "exportFormat"
+        field :from_record, -> { Integer }, optional: true, nullable: false, api_name: "fromRecord"
+        field :limit_record, -> { Integer }, optional: true, nullable: false, api_name: "limitRecord"
+        field :parameters, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+        field :sort_by, -> { String }, optional: true, nullable: false, api_name: "sortBy"
+      end
+    end
+  end
+end