pago-sdk 1.0.0

data/lib/pago/v2026_04/unions.rb

@@ -0,0 +1,739 @@
+# frozen_string_literal: true
+
+module Pago
+  module V2026_04
+    # Polymorphic schemas of the 2026-04 API.
+    #
+    # Ruby has no union type, so a union is a factory module instead: call
+    # `.from_json` and get back the concrete model the payload describes.
+    # Tagged unions dispatch on their discriminator property; untagged ones fall
+    # back to matching the payload against the declared keys of each variant.
+    # An unrecognised payload is returned as a plain `Hash` rather than raising.
+    module Unions
+      # Variants: Models::BenefitCustom, Models::BenefitDiscord, Models::BenefitGitHubRepository, Models::BenefitDownloadables, Models::BenefitLicenseKeys, Models::BenefitMeterCredit, Models::BenefitFeatureFlag, Models::BenefitSlackSharedChannel.
+      module Benefit
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "custom" => Models::BenefitCustom,
+            "discord" => Models::BenefitDiscord,
+            "downloadables" => Models::BenefitDownloadables,
+            "feature_flag" => Models::BenefitFeatureFlag,
+            "github_repository" => Models::BenefitGitHubRepository,
+            "license_keys" => Models::BenefitLicenseKeys,
+            "meter_credit" => Models::BenefitMeterCredit,
+            "slack_shared_channel" => Models::BenefitSlackSharedChannel
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::BenefitCustom, Models::BenefitDiscord, Models::BenefitGitHubRepository, Models::BenefitDownloadables, Models::BenefitLicenseKeys, Models::BenefitMeterCredit, Models::BenefitFeatureFlag, Models::BenefitSlackSharedChannel].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::BenefitCustomCreate, Models::BenefitDiscordCreate, Models::BenefitGitHubRepositoryCreate, Models::BenefitDownloadablesCreate, Models::BenefitLicenseKeysCreate, Models::BenefitMeterCreditCreate, Models::BenefitFeatureFlagCreate, Models::BenefitSlackSharedChannelCreate.
+      module BenefitCreate
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "custom" => Models::BenefitCustomCreate,
+            "discord" => Models::BenefitDiscordCreate,
+            "downloadables" => Models::BenefitDownloadablesCreate,
+            "feature_flag" => Models::BenefitFeatureFlagCreate,
+            "github_repository" => Models::BenefitGitHubRepositoryCreate,
+            "license_keys" => Models::BenefitLicenseKeysCreate,
+            "meter_credit" => Models::BenefitMeterCreditCreate,
+            "slack_shared_channel" => Models::BenefitSlackSharedChannelCreate
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::BenefitCustomCreate, Models::BenefitDiscordCreate, Models::BenefitGitHubRepositoryCreate, Models::BenefitDownloadablesCreate, Models::BenefitLicenseKeysCreate, Models::BenefitMeterCreditCreate, Models::BenefitFeatureFlagCreate, Models::BenefitSlackSharedChannelCreate].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::BenefitGrantDiscordWebhook, Models::BenefitGrantCustomWebhook, Models::BenefitGrantGitHubRepositoryWebhook, Models::BenefitGrantDownloadablesWebhook, Models::BenefitGrantLicenseKeysWebhook, Models::BenefitGrantMeterCreditWebhook, Models::BenefitGrantFeatureFlagWebhook, Models::BenefitGrantSlackSharedChannelWebhook.
+      module BenefitGrantWebhook
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::BenefitGrantDiscordWebhook, Models::BenefitGrantCustomWebhook, Models::BenefitGrantGitHubRepositoryWebhook, Models::BenefitGrantDownloadablesWebhook, Models::BenefitGrantLicenseKeysWebhook, Models::BenefitGrantMeterCreditWebhook, Models::BenefitGrantFeatureFlagWebhook, Models::BenefitGrantSlackSharedChannelWebhook].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::AlreadyActiveSubscriptionError, Models::NotOpenCheckout, Models::PaymentNotReady, Models::TrialAlreadyRedeemed.
+      module CheckoutForbiddenError
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::AlreadyActiveSubscriptionError, Models::NotOpenCheckout, Models::PaymentNotReady, Models::TrialAlreadyRedeemed].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CheckoutLinkCreateProductPrice, Models::CheckoutLinkCreateProduct, Models::CheckoutLinkCreateProducts.
+      module CheckoutLinkCreate
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CheckoutLinkCreateProductPrice, Models::CheckoutLinkCreateProduct, Models::CheckoutLinkCreateProducts].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomFieldText, Models::CustomFieldNumber, Models::CustomFieldDate, Models::CustomFieldCheckbox, Models::CustomFieldSelect.
+      module CustomField
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "checkbox" => Models::CustomFieldCheckbox,
+            "date" => Models::CustomFieldDate,
+            "number" => Models::CustomFieldNumber,
+            "select" => Models::CustomFieldSelect,
+            "text" => Models::CustomFieldText
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomFieldText, Models::CustomFieldNumber, Models::CustomFieldDate, Models::CustomFieldCheckbox, Models::CustomFieldSelect].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomFieldCreateText, Models::CustomFieldCreateNumber, Models::CustomFieldCreateDate, Models::CustomFieldCreateCheckbox, Models::CustomFieldCreateSelect.
+      module CustomFieldCreate
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "checkbox" => Models::CustomFieldCreateCheckbox,
+            "date" => Models::CustomFieldCreateDate,
+            "number" => Models::CustomFieldCreateNumber,
+            "select" => Models::CustomFieldCreateSelect,
+            "text" => Models::CustomFieldCreateText
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomFieldCreateText, Models::CustomFieldCreateNumber, Models::CustomFieldCreateDate, Models::CustomFieldCreateCheckbox, Models::CustomFieldCreateSelect].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomFieldUpdateText, Models::CustomFieldUpdateNumber, Models::CustomFieldUpdateDate, Models::CustomFieldUpdateCheckbox, Models::CustomFieldUpdateSelect.
+      module CustomFieldUpdate
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "checkbox" => Models::CustomFieldUpdateCheckbox,
+            "date" => Models::CustomFieldUpdateDate,
+            "number" => Models::CustomFieldUpdateNumber,
+            "select" => Models::CustomFieldUpdateSelect,
+            "text" => Models::CustomFieldUpdateText
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomFieldUpdateText, Models::CustomFieldUpdateNumber, Models::CustomFieldUpdateDate, Models::CustomFieldUpdateCheckbox, Models::CustomFieldUpdateSelect].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerIndividual, Models::CustomerTeam.
+      module Customer
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "individual" => Models::CustomerIndividual,
+            "team" => Models::CustomerTeam
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerIndividual, Models::CustomerTeam].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerBenefitGrantDiscord, Models::CustomerBenefitGrantGitHubRepository, Models::CustomerBenefitGrantDownloadables, Models::CustomerBenefitGrantLicenseKeys, Models::CustomerBenefitGrantCustom, Models::CustomerBenefitGrantMeterCredit, Models::CustomerBenefitGrantFeatureFlag, Models::CustomerBenefitGrantSlackSharedChannel.
+      module CustomerBenefitGrant
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerBenefitGrantDiscord, Models::CustomerBenefitGrantGitHubRepository, Models::CustomerBenefitGrantDownloadables, Models::CustomerBenefitGrantLicenseKeys, Models::CustomerBenefitGrantCustom, Models::CustomerBenefitGrantMeterCredit, Models::CustomerBenefitGrantFeatureFlag, Models::CustomerBenefitGrantSlackSharedChannel].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerBenefitGrantDiscordUpdate, Models::CustomerBenefitGrantGitHubRepositoryUpdate, Models::CustomerBenefitGrantDownloadablesUpdate, Models::CustomerBenefitGrantLicenseKeysUpdate, Models::CustomerBenefitGrantCustomUpdate, Models::CustomerBenefitGrantMeterCreditUpdate, Models::CustomerBenefitGrantFeatureFlagUpdate, Models::CustomerBenefitGrantSlackSharedChannelUpdate.
+      module CustomerBenefitGrantUpdate
+        DISCRIMINATOR = "benefit_type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "custom" => Models::CustomerBenefitGrantCustomUpdate,
+            "discord" => Models::CustomerBenefitGrantDiscordUpdate,
+            "downloadables" => Models::CustomerBenefitGrantDownloadablesUpdate,
+            "feature_flag" => Models::CustomerBenefitGrantFeatureFlagUpdate,
+            "github_repository" => Models::CustomerBenefitGrantGitHubRepositoryUpdate,
+            "license_keys" => Models::CustomerBenefitGrantLicenseKeysUpdate,
+            "meter_credit" => Models::CustomerBenefitGrantMeterCreditUpdate,
+            "slack_shared_channel" => Models::CustomerBenefitGrantSlackSharedChannelUpdate
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerBenefitGrantDiscordUpdate, Models::CustomerBenefitGrantGitHubRepositoryUpdate, Models::CustomerBenefitGrantDownloadablesUpdate, Models::CustomerBenefitGrantLicenseKeysUpdate, Models::CustomerBenefitGrantCustomUpdate, Models::CustomerBenefitGrantMeterCreditUpdate, Models::CustomerBenefitGrantFeatureFlagUpdate, Models::CustomerBenefitGrantSlackSharedChannelUpdate].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerIndividualCreate, Models::CustomerTeamCreate.
+      module CustomerCreate
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerIndividualCreate, Models::CustomerTeamCreate].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::PaymentMethodCard, Models::PaymentMethodGeneric.
+      module CustomerPaymentMethod
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::PaymentMethodCard, Models::PaymentMethodGeneric].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerPaymentMethodCreateSucceededResponse, Models::CustomerPaymentMethodCreateRequiresActionResponse.
+      module CustomerPaymentMethodCreateResponse
+        DISCRIMINATOR = "status"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "requires_action" => Models::CustomerPaymentMethodCreateRequiresActionResponse,
+            "succeeded" => Models::CustomerPaymentMethodCreateSucceededResponse
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerPaymentMethodCreateSucceededResponse, Models::CustomerPaymentMethodCreateRequiresActionResponse].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerStateIndividual, Models::CustomerStateTeam.
+      module CustomerState
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "individual" => Models::CustomerStateIndividual,
+            "team" => Models::CustomerStateTeam
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerStateIndividual, Models::CustomerStateTeam].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerSubscriptionUpdateProduct, Models::CustomerSubscriptionUpdateSeats, Models::CustomerSubscriptionCancel, Models::CustomerSubscriptionPause, Models::CustomerSubscriptionResume, Models::CustomerSubscriptionUpdateClear.
+      module CustomerSubscriptionUpdate
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerSubscriptionUpdateProduct, Models::CustomerSubscriptionUpdateSeats, Models::CustomerSubscriptionCancel, Models::CustomerSubscriptionPause, Models::CustomerSubscriptionResume, Models::CustomerSubscriptionUpdateClear].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::DiscountFixedOnceForeverDuration, Models::DiscountFixedRepeatDuration, Models::DiscountPercentageOnceForeverDuration, Models::DiscountPercentageRepeatDuration.
+      module Discount
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::DiscountFixedOnceForeverDuration, Models::DiscountFixedRepeatDuration, Models::DiscountPercentageOnceForeverDuration, Models::DiscountPercentageRepeatDuration].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::DiscountFixedCreate, Models::DiscountPercentageCreate.
+      module DiscountCreate
+        DISCRIMINATOR = "type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "fixed" => Models::DiscountFixedCreate,
+            "percentage" => Models::DiscountPercentageCreate
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::DiscountFixedCreate, Models::DiscountPercentageCreate].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Object, Models::UserEvent.
+      module Event
+        DISCRIMINATOR = "source"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "system" => Unions::SystemEvent,
+            "user" => Models::UserEvent
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Unions::SystemEvent, Models::UserEvent].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::DownloadableFileCreate, Models::ProductMediaFileCreate, Models::OrganizationAvatarFileCreate, Models::SupportCaseAttachmentFileCreate.
+      module FileCreate
+        DISCRIMINATOR = "service"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "downloadable" => Models::DownloadableFileCreate,
+            "organization_avatar" => Models::OrganizationAvatarFileCreate,
+            "product_media" => Models::ProductMediaFileCreate,
+            "support_case_attachment" => Models::SupportCaseAttachmentFileCreate
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::DownloadableFileCreate, Models::ProductMediaFileCreate, Models::OrganizationAvatarFileCreate, Models::SupportCaseAttachmentFileCreate].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::DownloadableFileRead, Models::ProductMediaFileRead, Models::OrganizationAvatarFileRead, Models::SupportCaseAttachmentFileRead.
+      module FileRead
+        DISCRIMINATOR = "service"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "downloadable" => Models::DownloadableFileRead,
+            "organization_avatar" => Models::OrganizationAvatarFileRead,
+            "product_media" => Models::ProductMediaFileRead,
+            "support_case_attachment" => Models::SupportCaseAttachmentFileRead
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::DownloadableFileRead, Models::ProductMediaFileRead, Models::OrganizationAvatarFileRead, Models::SupportCaseAttachmentFileRead].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::LegacyRecurringProductPriceFixed, Models::LegacyRecurringProductPriceCustom.
+      module LegacyRecurringProductPrice
+        DISCRIMINATOR = "amount_type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "custom" => Models::LegacyRecurringProductPriceCustom,
+            "fixed" => Models::LegacyRecurringProductPriceFixed
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::LegacyRecurringProductPriceFixed, Models::LegacyRecurringProductPriceCustom].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Hash{String => String, Integer, Boolean, Array<String>, Array<Integer>, Array<Boolean>}, nil.
+      module MetadataQuery
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CardPayment, Models::GenericPayment.
+      module Payment
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CardPayment, Models::GenericPayment].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::CustomerPaymentMethodCard, Models::CustomerPaymentMethodGeneric.
+      module PaymentMethod
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::CustomerPaymentMethodCard, Models::CustomerPaymentMethodGeneric].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::ProductCreateRecurring, Models::ProductCreateOneTime.
+      module ProductCreate
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::ProductCreateRecurring, Models::ProductCreateOneTime].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::ProductPriceFixed, Models::ProductPriceCustom, Models::ProductPriceSeatBased, Models::ProductPriceMeteredUnit.
+      module ProductPrice
+        DISCRIMINATOR = "amount_type"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "custom" => Models::ProductPriceCustom,
+            "fixed" => Models::ProductPriceFixed,
+            "metered_unit" => Models::ProductPriceMeteredUnit,
+            "seat_based" => Models::ProductPriceSeatBased
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::ProductPriceFixed, Models::ProductPriceCustom, Models::ProductPriceSeatBased, Models::ProductPriceMeteredUnit].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::SubscriptionUpdateBase, Models::SubscriptionUpdateSeats, Models::SubscriptionUpdateBillingPeriod, Models::SubscriptionCancel, Models::SubscriptionRevoke, Models::SubscriptionPause, Models::SubscriptionResume, Models::SubscriptionUpdateClear.
+      module SubscriptionUpdate
+        DISCRIMINATOR = nil
+
+        # @return [nil] this union carries no usable discriminator mapping.
+        def self.mapping = nil
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::SubscriptionUpdateBase, Models::SubscriptionUpdateSeats, Models::SubscriptionUpdateBillingPeriod, Models::SubscriptionCancel, Models::SubscriptionRevoke, Models::SubscriptionPause, Models::SubscriptionResume, Models::SubscriptionUpdateClear].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+      # Variants: Models::MeterCreditEvent, Models::MeterResetEvent, Models::BenefitGrantedEvent, Models::BenefitCycledEvent, Models::BenefitUpdatedEvent, Models::BenefitRevokedEvent, Models::SubscriptionCreatedEvent, Models::SubscriptionUpdatedEvent, Models::SubscriptionCycledEvent, Models::SubscriptionCanceledEvent, Models::SubscriptionRevokedEvent, Models::SubscriptionPastDueEvent, Models::SubscriptionReactivatedEvent, Models::SubscriptionPausedEvent, Models::SubscriptionResumedEvent, Models::SubscriptionUncanceledEvent, Models::SubscriptionProductUpdatedEvent, Models::SubscriptionSeatsUpdatedEvent, Models::SubscriptionBillingPeriodUpdatedEvent, Models::SubscriptionUpdateClearedEvent, Models::OrderPaidEvent, Models::OrderRefundedEvent, Models::OrderVoidedEvent, Models::CheckoutCreatedEvent, Models::CustomerCreatedEvent, Models::CustomerUpdatedEvent, Models::CustomerDeletedEvent, Models::BalanceOrderEvent, Models::BalanceCreditOrderEvent, Models::BalanceRefundEvent, Models::BalanceRefundReversalEvent, Models::BalanceDisputeEvent, Models::BalanceDisputeReversalEvent.
+      module SystemEvent
+        DISCRIMINATOR = "name"
+
+        # @return [Hash{String => Class}] discriminator value to model class.
+        def self.mapping
+          @mapping ||= {
+            "balance.credit_order" => Models::BalanceCreditOrderEvent,
+            "balance.dispute" => Models::BalanceDisputeEvent,
+            "balance.dispute_reversal" => Models::BalanceDisputeReversalEvent,
+            "balance.order" => Models::BalanceOrderEvent,
+            "balance.refund" => Models::BalanceRefundEvent,
+            "balance.refund_reversal" => Models::BalanceRefundReversalEvent,
+            "benefit.cycled" => Models::BenefitCycledEvent,
+            "benefit.granted" => Models::BenefitGrantedEvent,
+            "benefit.revoked" => Models::BenefitRevokedEvent,
+            "benefit.updated" => Models::BenefitUpdatedEvent,
+            "checkout.created" => Models::CheckoutCreatedEvent,
+            "customer.created" => Models::CustomerCreatedEvent,
+            "customer.deleted" => Models::CustomerDeletedEvent,
+            "customer.updated" => Models::CustomerUpdatedEvent,
+            "meter.credited" => Models::MeterCreditEvent,
+            "meter.reset" => Models::MeterResetEvent,
+            "order.paid" => Models::OrderPaidEvent,
+            "order.refunded" => Models::OrderRefundedEvent,
+            "order.voided" => Models::OrderVoidedEvent,
+            "subscription.billing_period_updated" => Models::SubscriptionBillingPeriodUpdatedEvent,
+            "subscription.canceled" => Models::SubscriptionCanceledEvent,
+            "subscription.created" => Models::SubscriptionCreatedEvent,
+            "subscription.cycled" => Models::SubscriptionCycledEvent,
+            "subscription.past_due" => Models::SubscriptionPastDueEvent,
+            "subscription.paused" => Models::SubscriptionPausedEvent,
+            "subscription.product_updated" => Models::SubscriptionProductUpdatedEvent,
+            "subscription.reactivated" => Models::SubscriptionReactivatedEvent,
+            "subscription.resumed" => Models::SubscriptionResumedEvent,
+            "subscription.revoked" => Models::SubscriptionRevokedEvent,
+            "subscription.seats_updated" => Models::SubscriptionSeatsUpdatedEvent,
+            "subscription.uncanceled" => Models::SubscriptionUncanceledEvent,
+            "subscription.update_cleared" => Models::SubscriptionUpdateClearedEvent,
+            "subscription.updated" => Models::SubscriptionUpdatedEvent
+          }.freeze
+        end
+
+        # @return [Array<Class>] every model this union can resolve to.
+        def self.variants
+          @variants ||= [Models::MeterCreditEvent, Models::MeterResetEvent, Models::BenefitGrantedEvent, Models::BenefitCycledEvent, Models::BenefitUpdatedEvent, Models::BenefitRevokedEvent, Models::SubscriptionCreatedEvent, Models::SubscriptionUpdatedEvent, Models::SubscriptionCycledEvent, Models::SubscriptionCanceledEvent, Models::SubscriptionRevokedEvent, Models::SubscriptionPastDueEvent, Models::SubscriptionReactivatedEvent, Models::SubscriptionPausedEvent, Models::SubscriptionResumedEvent, Models::SubscriptionUncanceledEvent, Models::SubscriptionProductUpdatedEvent, Models::SubscriptionSeatsUpdatedEvent, Models::SubscriptionBillingPeriodUpdatedEvent, Models::SubscriptionUpdateClearedEvent, Models::OrderPaidEvent, Models::OrderRefundedEvent, Models::OrderVoidedEvent, Models::CheckoutCreatedEvent, Models::CustomerCreatedEvent, Models::CustomerUpdatedEvent, Models::CustomerDeletedEvent, Models::BalanceOrderEvent, Models::BalanceCreditOrderEvent, Models::BalanceRefundEvent, Models::BalanceRefundReversalEvent, Models::BalanceDisputeEvent, Models::BalanceDisputeReversalEvent].freeze
+        end
+
+        # @param data [Hash, String, nil]
+        # @return [Object, nil] the resolved variant, or the raw payload.
+        def self.from_json(data)
+          data = ::JSON.parse(data) if data.is_a?(String)
+          ::Pago::Serde.union(data, discriminator: DISCRIMINATOR, mapping: mapping, variants: variants)
+        end
+      end
+
+    end
+  end
+end