pago-sdk 1.0.0

data/lib/pago/v2026_04/services/disputes.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Disputes < ::Pago::Service
+        # List disputes.
+        #
+        # **Scopes**: `disputes:read` `disputes:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param order_id [String, Array<String>, nil] Filter by order ID.
+        # @param status [String, Array<String>, nil] Filter by dispute status.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @param sorting [Array<String>, nil] Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceDispute]
+        def list(organization_id: nil, order_id: nil, status: nil, page: 1, limit: 10, sorting: ["-created_at"])
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/disputes/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "order_id" => order_id, "status" => status, "page" => page, "limit" => limit, "sorting" => sorting },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceDispute.from_json(data)
+        end
+
+        # Enumerate every item of `list`, fetching pages on demand.
+        #
+        # @yieldparam item [Models::Dispute]
+        # @return [Pago::Paginator] when called without a block.
+        def list_each(organization_id: nil, order_id: nil, status: nil, limit: 10, sorting: ["-created_at"], &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, order_id: order_id, status: status, page: page_number, limit: limit, sorting: sorting)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Get a dispute by ID.
+        #
+        # **Scopes**: `disputes:read` `disputes:write`
+        #
+        # @param id [String] The dispute ID.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::Dispute]
+        def get(id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/disputes/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::Dispute.from_json(data)
+        end
+
+        # Accept a dispute, conceding the chargeback.
+        #
+        # Closes the dispute with the processor (settling it as `lost`) and records
+        # the merchant's decision on the dispute's support case.
+        #
+        # **Scopes**: `disputes:write`
+        #
+        # @param id [String] The dispute ID.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::DisputeNotOpenError] on HTTP 409.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::Dispute]
+        def accept(id)
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/disputes/{id}/accept",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 409 => Errors::DisputeNotOpenError, 422 => Errors::HTTPValidationError }
+          )
+          Models::Dispute.from_json(data)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/pago/v2026_04/services/event_types.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class EventTypes < ::Pago::Service
+        # List event types with aggregated statistics.
+        #
+        # **Scopes**: `events:read` `events:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param customer_id [String, Array<String>, nil] Filter by customer ID.
+        # @param external_customer_id [String, Array<String>, nil] Filter by external customer ID.
+        # @param query [String, nil] Query to filter event types by name or label.
+        # @param root_events [Boolean] When true, only return event types with root events (parent_id IS NULL).
+        # @param parent_id [String, nil] Filter by specific parent event ID.
+        # @param source [String, nil] Filter by event source (system or user).
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @param sorting [Array<String>, nil] Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceEventTypeWithStats]
+        def list(organization_id: nil, customer_id: nil, external_customer_id: nil, query: nil, root_events: false, parent_id: nil, source: nil, page: 1, limit: 10, sorting: ["-last_seen"])
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/event-types/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "customer_id" => customer_id, "external_customer_id" => external_customer_id, "query" => query, "root_events" => root_events, "parent_id" => parent_id, "source" => source, "page" => page, "limit" => limit, "sorting" => sorting },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceEventTypeWithStats.from_json(data)
+        end
+
+        # Enumerate every item of `list`, fetching pages on demand.
+        #
+        # @yieldparam item [Models::EventTypeWithStats]
+        # @return [Pago::Paginator] when called without a block.
+        def list_each(organization_id: nil, customer_id: nil, external_customer_id: nil, query: nil, root_events: false, parent_id: nil, source: nil, limit: 10, sorting: ["-last_seen"], &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, customer_id: customer_id, external_customer_id: external_customer_id, query: query, root_events: root_events, parent_id: parent_id, source: source, page: page_number, limit: limit, sorting: sorting)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Update an event type's label.
+        #
+        # **Scopes**: `events:write`
+        #
+        # @param id [String] The event type ID.
+        # @param body [Hash, Models::EventTypeUpdate] the request body.
+        # @raise [Errors::Update404Error] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::EventType]
+        def update(id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/event-types/{id}",
+            path_params: { "id" => id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 404 => Errors::Update404Error, 422 => Errors::HTTPValidationError }
+          )
+          Models::EventType.from_json(data)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/pago/v2026_04/services/events.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Events < ::Pago::Service
+        # List events.
+        #
+        # **Scopes**: `events:read` `events:write`
+        #
+        # @param filter [String, nil] Filter events following filter clauses. JSON string following the same schema a meter filter clause.
+        # @param start_timestamp [String, nil] Filter events after this timestamp.
+        # @param end_timestamp [String, nil] Filter events before this timestamp.
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param customer_id [String, Array<String>, nil] Filter by customer ID.
+        # @param external_customer_id [String, Array<String>, nil] Filter by external customer ID.
+        # @param meter_id [String, nil] Filter by a meter filter clause.
+        # @param name [String, Array<String>, nil] Filter by event name.
+        # @param source [String, Array<String>, nil] Filter by event source.
+        # @param query [String, nil] Query to filter events.
+        # @param parent_id [String, nil] When combined with depth, use this event as the anchor instead of root events.
+        # @param depth [Integer, nil] Fetch descendants up to this depth. When set: 0=root events only, 1=roots+children, etc. Max 5. When not set, returns all events.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @param sorting [Array<String>, nil] Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
+        # @param metadata [Object] Filter by metadata key-value pairs. It uses the `deepObject` style, e.g. `?metadata[key]=value`.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceEvent, Models::ListResourceWithCursorPaginationEvent]
+        def list(filter: nil, start_timestamp: nil, end_timestamp: nil, organization_id: nil, customer_id: nil, external_customer_id: nil, meter_id: nil, name: nil, source: nil, query: nil, parent_id: nil, depth: nil, page: 1, limit: 10, sorting: ["-timestamp"], metadata: nil)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/events/",
+            path_params: {},
+            query: { "filter" => filter, "start_timestamp" => start_timestamp, "end_timestamp" => end_timestamp, "organization_id" => organization_id, "customer_id" => customer_id, "external_customer_id" => external_customer_id, "meter_id" => meter_id, "name" => name, "source" => source, "query" => query, "parent_id" => parent_id, "depth" => depth, "page" => page, "limit" => limit, "sorting" => sorting, "metadata" => metadata },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          ::Pago::Serde.union(data, variants: [Models::ListResourceEvent, Models::ListResourceWithCursorPaginationEvent])
+        end
+
+        # List event names.
+        #
+        # **Scopes**: `events:read` `events:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param customer_id [String, Array<String>, nil] Filter by customer ID.
+        # @param external_customer_id [String, Array<String>, nil] Filter by external customer ID.
+        # @param source [String, Array<String>, nil] Filter by event source.
+        # @param query [String, nil] Query to filter event names.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @param sorting [Array<String>, nil] Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceEventName]
+        def list_names(organization_id: nil, customer_id: nil, external_customer_id: nil, source: nil, query: nil, page: 1, limit: 10, sorting: ["-last_seen"])
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/events/names",
+            path_params: {},
+            query: { "organization_id" => organization_id, "customer_id" => customer_id, "external_customer_id" => external_customer_id, "source" => source, "query" => query, "page" => page, "limit" => limit, "sorting" => sorting },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceEventName.from_json(data)
+        end
+
+        # Enumerate every item of `list_names`, fetching pages on demand.
+        #
+        # @yieldparam item [Models::EventName]
+        # @return [Pago::Paginator] when called without a block.
+        def list_names_each(organization_id: nil, customer_id: nil, external_customer_id: nil, source: nil, query: nil, limit: 10, sorting: ["-last_seen"], &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list_names(organization_id: organization_id, customer_id: customer_id, external_customer_id: external_customer_id, source: source, query: query, page: page_number, limit: limit, sorting: sorting)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Get an event by ID.
+        #
+        # **Scopes**: `events:read` `events:write`
+        #
+        # @param id [String] The event ID.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Object]
+        def get(id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/events/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Event.from_json(data)
+        end
+
+        # Ingest batch of events.
+        #
+        # **Scopes**: `events:write`
+        #
+        # @param body [Hash, Models::EventsIngest] the request body.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::EventsIngestResponse]
+        def ingest(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/events/ingest",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::EventsIngestResponse.from_json(data)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/pago/v2026_04/services/files.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Files < ::Pago::Service
+        # List files.
+        #
+        # **Scopes**: `files:read` `files:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param ids [String, Array<String>, nil] Filter by file ID.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceFileRead]
+        def list(organization_id: nil, ids: nil, page: 1, limit: 10)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/files/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "ids" => ids, "page" => page, "limit" => limit },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceFileRead.from_json(data)
+        end
+
+        # Enumerate every item of `list`, fetching pages on demand.
+        #
+        # @yieldparam item [Object]
+        # @return [Pago::Paginator] when called without a block.
+        def list_each(organization_id: nil, ids: nil, limit: 10, &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, ids: ids, page: page_number, limit: limit)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Create a file.
+        #
+        # **Scopes**: `files:write`
+        #
+        # @param body [Hash, Object] the request body.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::FileUpload]
+        def create(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/files/",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::FileUpload.from_json(data)
+        end
+
+        # Complete a file upload.
+        #
+        # **Scopes**: `files:write`
+        #
+        # @param id_path [String] The file ID.
+        # @param body [Hash, Models::FileUploadCompleted] the request body.
+        # @raise [Errors::NotPermitted] on HTTP 403.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Object]
+        def uploaded(id_path, body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/files/{id}/uploaded",
+            path_params: { "id" => id_path },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::FileRead.from_json(data)
+        end
+
+        # Delete a file.
+        #
+        # **Scopes**: `files:write`
+        #
+        # @param id [String]
+        # @raise [Errors::NotPermitted] on HTTP 403.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [nil]
+        def delete(id)
+          client.request(
+            http_method: "DELETE",
+            path: "/v1/files/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :none,
+            errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+        end
+
+        # Update a file.
+        #
+        # **Scopes**: `files:write`
+        #
+        # @param id [String] The file ID.
+        # @param body [Hash, Models::FilePatch] the request body.
+        # @raise [Errors::NotPermitted] on HTTP 403.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Object]
+        def update(id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/files/{id}",
+            path_params: { "id" => id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::FileRead.from_json(data)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/pago/v2026_04/services/license_keys.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class LicenseKeys < ::Pago::Service
+        # Get license keys connected to the given organization & filters.
+        #
+        # **Scopes**: `license_keys:read` `license_keys:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param benefit_id [String, Array<String>, nil] Filter by benefit ID.
+        # @param status [String, Array<String>, nil] Filter by license key status.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @raise [Errors::Unauthorized] on HTTP 401.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceLicenseKeyRead]
+        def list(organization_id: nil, benefit_id: nil, status: nil, page: 1, limit: 10)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/license-keys/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "benefit_id" => benefit_id, "status" => status, "page" => page, "limit" => limit },
+            response_type: :json,
+            errors: { 401 => Errors::Unauthorized, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceLicenseKeyRead.from_json(data)
+        end
+
+        # Enumerate every item of `list`, fetching pages on demand.
+        #
+        # @yieldparam item [Models::LicenseKeyRead]
+        # @return [Pago::Paginator] when called without a block.
+        def list_each(organization_id: nil, benefit_id: nil, status: nil, limit: 10, &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, benefit_id: benefit_id, status: status, page: page_number, limit: limit)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Get a license key.
+        #
+        # **Scopes**: `license_keys:read` `license_keys:write`
+        #
+        # @param id [String]
+        # @raise [Errors::Unauthorized] on HTTP 401.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::LicenseKeyWithActivations]
+        def get(id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/license-keys/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 401 => Errors::Unauthorized, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::LicenseKeyWithActivations.from_json(data)
+        end
+
+        # Update a license key.
+        #
+        # **Scopes**: `license_keys:write`
+        #
+        # @param id [String]
+        # @param body [Hash, Models::LicenseKeyUpdate] the request body.
+        # @raise [Errors::Unauthorized] on HTTP 401.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::LicenseKeyRead]
+        def update(id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/license-keys/{id}",
+            path_params: { "id" => id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 401 => Errors::Unauthorized, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::LicenseKeyRead.from_json(data)
+        end
+
+        # Get a license key activation.
+        #
+        # **Scopes**: `license_keys:read` `license_keys:write`
+        #
+        # @param id [String]
+        # @param activation_id [String]
+        # @raise [Errors::Unauthorized] on HTTP 401.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::LicenseKeyActivationRead]
+        def get_activation(id, activation_id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/license-keys/{id}/activations/{activation_id}",
+            path_params: { "id" => id, "activation_id" => activation_id },
+            query: {},
+            response_type: :json,
+            errors: { 401 => Errors::Unauthorized, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::LicenseKeyActivationRead.from_json(data)
+        end
+
+        # Validate a license key.
+        #
+        # **Scopes**: `license_keys:write`
+        #
+        # @param body [Hash, Models::LicenseKeyValidate] the request body.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ValidatedLicenseKey]
+        def validate(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/license-keys/validate",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::ValidatedLicenseKey.from_json(data)
+        end
+
+        # Activate a license key instance.
+        #
+        # **Scopes**: `license_keys:write`
+        #
+        # @param body [Hash, Models::LicenseKeyActivate] the request body.
+        # @raise [Errors::NotPermitted] on HTTP 403.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::LicenseKeyActivationRead]
+        def activate(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/license-keys/activate",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::LicenseKeyActivationRead.from_json(data)
+        end
+
+        # Deactivate a license key instance.
+        #
+        # **Scopes**: `license_keys:write`
+        #
+        # @param body [Hash, Models::LicenseKeyDeactivate] the request body.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [nil]
+        def deactivate(body: {})
+          client.request(
+            http_method: "POST",
+            path: "/v1/license-keys/deactivate",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :none,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+        end
+
+      end
+
+    end
+  end
+end

data/lib/pago/v2026_04/services/members.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Members < ::Pago::Service
+        # List members with optional customer ID filter.
+        #
+        # **Scopes**: `members:read` `members:write`
+        #
+        # @param customer_id [String, nil] Filter by customer ID.
+        # @param external_customer_id [String, nil] Filter by customer external ID.
+        # @param role [String, nil] Filter by member role.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @param sorting [Array<String>, nil] Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourceMember]
+        def list_members(customer_id: nil, external_customer_id: nil, role: nil, page: 1, limit: 10, sorting: ["-created_at"])
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/members/",
+            path_params: {},
+            query: { "customer_id" => customer_id, "external_customer_id" => external_customer_id, "role" => role, "page" => page, "limit" => limit, "sorting" => sorting },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceMember.from_json(data)
+        end
+
+        # Enumerate every item of `list_members`, fetching pages on demand.
+        #
+        # @yieldparam item [Models::Member]
+        # @return [Pago::Paginator] when called without a block.
+        def list_members_each(customer_id: nil, external_customer_id: nil, role: nil, limit: 10, sorting: ["-created_at"], &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list_members(customer_id: customer_id, external_customer_id: external_customer_id, role: role, page: page_number, limit: limit, sorting: sorting)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+      end
+
+    end
+  end
+end