pago-sdk 1.0.0

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

@@ -0,0 +1,556 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Customers < ::Pago::Service
+        # @return [Members]
+        def members = @members ||= Members.new(client)
+
+        # List customers.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param email [String, nil] Filter by exact email.
+        # @param query [String, nil] Filter by name, email, or external ID.
+        # @param active [Boolean, nil] Filter by active customers, i.e. customers with at least one trialing, active or past_due subscription.
+        # @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::ListResourceCustomer]
+        def list(organization_id: nil, email: nil, query: nil, active: nil, page: 1, limit: 10, sorting: ["-created_at"], metadata: nil)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "email" => email, "query" => query, "active" => active, "page" => page, "limit" => limit, "sorting" => sorting, "metadata" => metadata },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceCustomer.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, email: nil, query: nil, active: nil, limit: 10, sorting: ["-created_at"], metadata: nil, &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, email: email, query: query, active: active, page: page_number, limit: limit, sorting: sorting, metadata: metadata)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Create a customer.
+        #
+        # **Scopes**: `customers: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 [Object]
+        def create(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/customers/",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Unions::Customer.from_json(data)
+        end
+
+        # Export customers as a CSV file.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [String]
+        def export(organization_id: nil)
+          client.request(
+            http_method: "GET",
+            path: "/v1/customers/export",
+            path_params: {},
+            query: { "organization_id" => organization_id },
+            response_type: :text,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+        end
+
+        # Get a customer by ID.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param id [String] The customer 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/customers/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Customer.from_json(data)
+        end
+
+        # Delete a customer.
+        #
+        # This action cannot be undone and will immediately:
+        # - Cancel any active subscriptions for the customer
+        # - Revoke all their benefits
+        # - Clear any `external_id`
+        #
+        # Use it only in the context of deleting a user within your
+        # own service. Otherwise, use more granular API endpoints to cancel
+        # a specific subscription or revoke certain benefits.
+        #
+        # Note: The customers information will nonetheless be retained for historic
+        # orders and subscriptions.
+        #
+        # Set `anonymize=true` to also anonymize PII for GDPR compliance.
+        #
+        # **Scopes**: `customers:write`
+        #
+        # @param id [String] The customer ID.
+        # @param anonymize [Boolean] If true, also anonymize the customer's personal data for GDPR compliance. This replaces email with a hashed version, hashes name and billing name (name preserved for businesses with tax_id), clears billing address, and removes OAuth account data.
+        # @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, anonymize: false)
+          client.request(
+            http_method: "DELETE",
+            path: "/v1/customers/{id}",
+            path_params: { "id" => id },
+            query: { "anonymize" => anonymize },
+            response_type: :none,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+        end
+
+        # Update a customer.
+        #
+        # **Scopes**: `customers:write`
+        #
+        # @param id [String] The customer ID.
+        # @param body [Hash, Models::CustomerUpdate] 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 [Object]
+        def update(id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/customers/{id}",
+            path_params: { "id" => id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Customer.from_json(data)
+        end
+
+        # Get a customer by external ID.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param external_id [String] The customer external 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_external(external_id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/external/{external_id}",
+            path_params: { "external_id" => external_id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Customer.from_json(data)
+        end
+
+        # Delete a customer by external ID.
+        #
+        # Immediately cancels any active subscriptions and revokes any active benefits.
+        #
+        # Set `anonymize=true` to also anonymize PII for GDPR compliance.
+        #
+        # **Scopes**: `customers:write`
+        #
+        # @param external_id [String] The customer external ID.
+        # @param anonymize [Boolean] If true, also anonymize the customer's personal data for GDPR compliance.
+        # @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_external(external_id, anonymize: false)
+          client.request(
+            http_method: "DELETE",
+            path: "/v1/customers/external/{external_id}",
+            path_params: { "external_id" => external_id },
+            query: { "anonymize" => anonymize },
+            response_type: :none,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+        end
+
+        # Update a customer by external ID.
+        #
+        # **Scopes**: `customers:write`
+        #
+        # @param external_id [String] The customer external ID.
+        # @param body [Hash, Models::CustomerUpdateExternalID] 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 [Object]
+        def update_external(external_id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/customers/external/{external_id}",
+            path_params: { "external_id" => external_id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Customer.from_json(data)
+        end
+
+        # Get a customer state by ID.
+        #
+        # The customer state includes information about
+        # the customer's active subscriptions and benefits.
+        #
+        # It's the ideal endpoint to use when you need to get a full overview
+        # of a customer's status.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param id [String] The customer 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_state(id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/{id}/state",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::CustomerState.from_json(data)
+        end
+
+        # Get a customer state by external ID.
+        #
+        # The customer state includes information about
+        # the customer's active subscriptions and benefits.
+        #
+        # It's the ideal endpoint to use when you need to get a full overview
+        # of a customer's status.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param external_id [String] The customer external 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_state_external(external_id)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/external/{external_id}/state",
+            path_params: { "external_id" => external_id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::CustomerState.from_json(data)
+        end
+
+        # Get saved payment methods of a customer.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param id [String] The customer ID.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourcePaymentMethod]
+        def list_payment_methods(id, page: 1, limit: 10)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/{id}/payment-methods",
+            path_params: { "id" => id },
+            query: { "page" => page, "limit" => limit },
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourcePaymentMethod.from_json(data)
+        end
+
+        # Enumerate every item of `list_payment_methods`, fetching pages on demand.
+        #
+        # @yieldparam item [Object]
+        # @return [Pago::Paginator] when called without a block.
+        def list_payment_methods_each(id, limit: 10, &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list_payment_methods(id, page: page_number, limit: limit)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Get saved payment methods of a customer by external ID.
+        #
+        # **Scopes**: `customers:read` `customers:write`
+        #
+        # @param external_id [String] The customer external ID.
+        # @param page [Integer] Page number, defaults to 1.
+        # @param limit [Integer] Size of a page, defaults to 10. Maximum is 100.
+        # @raise [Errors::ResourceNotFound] on HTTP 404.
+        # @raise [Errors::HTTPValidationError] on HTTP 422.
+        # @raise [Pago::NetworkError] when the request never reached the API.
+        # @return [Models::ListResourcePaymentMethod]
+        def list_payment_methods_external(external_id, page: 1, limit: 10)
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/customers/external/{external_id}/payment-methods",
+            path_params: { "external_id" => external_id },
+            query: { "page" => page, "limit" => limit },
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourcePaymentMethod.from_json(data)
+        end
+
+        # Enumerate every item of `list_payment_methods_external`, fetching pages on demand.
+        #
+        # @yieldparam item [Object]
+        # @return [Pago::Paginator] when called without a block.
+        def list_payment_methods_external_each(external_id, limit: 10, &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list_payment_methods_external(external_id, page: page_number, limit: limit)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        class Members < ::Pago::Service
+          # Create a new member for a customer.
+          #
+          # Only B2B customers with the member management feature enabled can add members.
+          # The authenticated user or organization must have access to the customer's organization.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param id [String] The customer ID.
+          # @param body [Hash, Models::MemberCreateFromCustomer] 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::Member]
+          def create(id, body: {})
+            data = client.request(
+              http_method: "POST",
+              path: "/v1/customers/{id}/members",
+              path_params: { "id" => id },
+              query: {},
+              body: body,
+              response_type: :json,
+              errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+          # Create a new member for a customer identified by its external ID.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param external_id_path [String] The customer external ID.
+          # @param body [Hash, Models::MemberCreateFromCustomer] the request body.
+          # @raise [Errors::NotPermitted] on HTTP 403.
+          # @raise [Errors::ResourceNotFound] on HTTP 404.
+          # @raise [Errors::AmbiguousExternalCustomerID] on HTTP 409.
+          # @raise [Errors::HTTPValidationError] on HTTP 422.
+          # @raise [Pago::NetworkError] when the request never reached the API.
+          # @return [Models::Member]
+          def create_external(external_id_path, body: {})
+            data = client.request(
+              http_method: "POST",
+              path: "/v1/customers/external/{external_id}/members",
+              path_params: { "external_id" => external_id_path },
+              query: {},
+              body: body,
+              response_type: :json,
+              errors: { 403 => Errors::NotPermitted, 404 => Errors::ResourceNotFound, 409 => Errors::AmbiguousExternalCustomerID, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+          # Get a member of a customer by its ID.
+          #
+          # **Scopes**: `members:read` `members:write`
+          #
+          # @param id [String] The customer ID.
+          # @param member_id [String]
+          # @raise [Errors::ResourceNotFound] on HTTP 404.
+          # @raise [Errors::HTTPValidationError] on HTTP 422.
+          # @raise [Pago::NetworkError] when the request never reached the API.
+          # @return [Models::Member]
+          def get(id, member_id)
+            data = client.request(
+              http_method: "GET",
+              path: "/v1/customers/{id}/members/{member_id}",
+              path_params: { "id" => id, "member_id" => member_id },
+              query: {},
+              response_type: :json,
+              errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+          # Delete a member of a customer.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param id [String] The customer ID.
+          # @param member_id [String]
+          # @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, member_id)
+            client.request(
+              http_method: "DELETE",
+              path: "/v1/customers/{id}/members/{member_id}",
+              path_params: { "id" => id, "member_id" => member_id },
+              query: {},
+              response_type: :none,
+              errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+            )
+          end
+
+          # Update a member of a customer.
+          #
+          # Only name, email and role can be updated.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param id [String] The customer ID.
+          # @param member_id [String]
+          # @param body [Hash, Models::MemberUpdate] 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::Member]
+          def update(id, member_id, body: {})
+            data = client.request(
+              http_method: "PATCH",
+              path: "/v1/customers/{id}/members/{member_id}",
+              path_params: { "id" => id, "member_id" => member_id },
+              query: {},
+              body: body,
+              response_type: :json,
+              errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+          # Get a member by external ID for a customer identified by its external ID.
+          #
+          # **Scopes**: `members:read` `members:write`
+          #
+          # @param external_id [String] The customer external ID.
+          # @param member_external_id [String] The member external ID.
+          # @raise [Errors::ResourceNotFound] on HTTP 404.
+          # @raise [Errors::AmbiguousExternalCustomerID] on HTTP 409.
+          # @raise [Errors::HTTPValidationError] on HTTP 422.
+          # @raise [Pago::NetworkError] when the request never reached the API.
+          # @return [Models::Member]
+          def get_external(external_id, member_external_id)
+            data = client.request(
+              http_method: "GET",
+              path: "/v1/customers/external/{external_id}/members/{member_external_id}",
+              path_params: { "external_id" => external_id, "member_external_id" => member_external_id },
+              query: {},
+              response_type: :json,
+              errors: { 404 => Errors::ResourceNotFound, 409 => Errors::AmbiguousExternalCustomerID, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+          # Delete a member by external ID for a customer identified by its external ID.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param external_id [String] The customer external ID.
+          # @param member_external_id [String] The member external ID.
+          # @raise [Errors::ResourceNotFound] on HTTP 404.
+          # @raise [Errors::AmbiguousExternalCustomerID] on HTTP 409.
+          # @raise [Errors::HTTPValidationError] on HTTP 422.
+          # @raise [Pago::NetworkError] when the request never reached the API.
+          # @return [nil]
+          def delete_external(external_id, member_external_id)
+            client.request(
+              http_method: "DELETE",
+              path: "/v1/customers/external/{external_id}/members/{member_external_id}",
+              path_params: { "external_id" => external_id, "member_external_id" => member_external_id },
+              query: {},
+              response_type: :none,
+              errors: { 404 => Errors::ResourceNotFound, 409 => Errors::AmbiguousExternalCustomerID, 422 => Errors::HTTPValidationError }
+            )
+          end
+
+          # Update a member by external ID for a customer identified by its external ID.
+          #
+          # **Scopes**: `members:write`
+          #
+          # @param external_id [String] The customer external ID.
+          # @param member_external_id [String] The member external ID.
+          # @param body [Hash, Models::MemberUpdate] the request body.
+          # @raise [Errors::ResourceNotFound] on HTTP 404.
+          # @raise [Errors::AmbiguousExternalCustomerID] on HTTP 409.
+          # @raise [Errors::HTTPValidationError] on HTTP 422.
+          # @raise [Pago::NetworkError] when the request never reached the API.
+          # @return [Models::Member]
+          def update_external(external_id, member_external_id, body: {})
+            data = client.request(
+              http_method: "PATCH",
+              path: "/v1/customers/external/{external_id}/members/{member_external_id}",
+              path_params: { "external_id" => external_id, "member_external_id" => member_external_id },
+              query: {},
+              body: body,
+              response_type: :json,
+              errors: { 404 => Errors::ResourceNotFound, 409 => Errors::AmbiguousExternalCustomerID, 422 => Errors::HTTPValidationError }
+            )
+            Models::Member.from_json(data)
+          end
+
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    module Services
+      class Discounts < ::Pago::Service
+        # List discounts.
+        #
+        # **Scopes**: `discounts:read` `discounts:write`
+        #
+        # @param organization_id [String, Array<String>, nil] Filter by organization ID.
+        # @param query [String, nil] Filter by name.
+        # @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::ListResourceDiscount]
+        def list(organization_id: nil, query: nil, page: 1, limit: 10, sorting: ["-created_at"])
+          data = client.request(
+            http_method: "GET",
+            path: "/v1/discounts/",
+            path_params: {},
+            query: { "organization_id" => organization_id, "query" => query, "page" => page, "limit" => limit, "sorting" => sorting },
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Models::ListResourceDiscount.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, query: nil, limit: 10, sorting: ["-created_at"], &block)
+          paginator = ::Pago::Paginator.new do |page_number|
+            list(organization_id: organization_id, query: query, page: page_number, limit: limit, sorting: sorting)
+          end
+          block ? paginator.each(&block) : paginator
+        end
+
+        # Create a discount.
+        #
+        # **Scopes**: `discounts: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 [Object]
+        def create(body: {})
+          data = client.request(
+            http_method: "POST",
+            path: "/v1/discounts/",
+            path_params: {},
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 422 => Errors::HTTPValidationError }
+          )
+          Unions::Discount.from_json(data)
+        end
+
+        # Get a discount by ID.
+        #
+        # **Scopes**: `discounts:read` `discounts:write`
+        #
+        # @param id [String] The discount 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/discounts/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Discount.from_json(data)
+        end
+
+        # Delete a discount.
+        #
+        # **Scopes**: `discounts:write`
+        #
+        # @param id [String] The discount ID.
+        # @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/discounts/{id}",
+            path_params: { "id" => id },
+            query: {},
+            response_type: :none,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+        end
+
+        # Update a discount.
+        #
+        # **Scopes**: `discounts:write`
+        #
+        # @param id [String] The discount ID.
+        # @param body [Hash, Models::DiscountUpdate] 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 [Object]
+        def update(id, body: {})
+          data = client.request(
+            http_method: "PATCH",
+            path: "/v1/discounts/{id}",
+            path_params: { "id" => id },
+            query: {},
+            body: body,
+            response_type: :json,
+            errors: { 404 => Errors::ResourceNotFound, 422 => Errors::HTTPValidationError }
+          )
+          Unions::Discount.from_json(data)
+        end
+
+      end
+
+    end
+  end
+end