dodopayments 2.18.0 → 2.19.0

data/rbi/dodopayments/models/entitlements/entitlement_grant.rbi

@@ -43,7 +43,7 @@ module Dodopayments
         attr_accessor :integration_type
 
         # Arbitrary key-value metadata recorded on the grant.
-        sig { returns(T::Hash[Symbol, String]) }
+        sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
         attr_accessor :metadata
 
         # Lifecycle status of the grant.
@@ -83,6 +83,14 @@ module Dodopayments
         sig { returns(T.nilable(String)) }
         attr_accessor :error_message
 
+        # Typed feature payload, present only when the entitlement integration is
+        # `feature_flag`; `null` for every other integration type.
+        sig { returns(T.nilable(Dodopayments::Feature)) }
+        attr_reader :feature
+
+        sig { params(feature: T.nilable(Dodopayments::Feature::OrHash)).void }
+        attr_writer :feature
+
         # License-key delivery payload, present when the entitlement integration is
         # `license_key`.
         sig { returns(T.nilable(Dodopayments::Entitlements::LicenseKeyGrant)) }
@@ -134,7 +142,7 @@ module Dodopayments
             entitlement_id: String,
             integration_type:
               Dodopayments::EntitlementIntegrationType::OrSymbol,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             status:
               Dodopayments::Entitlements::EntitlementGrant::Status::OrSymbol,
             updated_at: Time,
@@ -143,6 +151,7 @@ module Dodopayments
               T.nilable(Dodopayments::DigitalProductDelivery::OrHash),
             error_code: T.nilable(String),
             error_message: T.nilable(String),
+            feature: T.nilable(Dodopayments::Feature::OrHash),
             license_key:
               T.nilable(Dodopayments::Entitlements::LicenseKeyGrant::OrHash),
             oauth_expires_at: T.nilable(Time),
@@ -183,6 +192,9 @@ module Dodopayments
           error_code: nil,
           # Human-readable message reported when delivery failed, when applicable.
           error_message: nil,
+          # Typed feature payload, present only when the entitlement integration is
+          # `feature_flag`; `null` for every other integration type.
+          feature: nil,
           # License-key delivery payload, present when the entitlement integration is
           # `license_key`.
           license_key: nil,
@@ -214,7 +226,7 @@ module Dodopayments
               entitlement_id: String,
               integration_type:
                 Dodopayments::EntitlementIntegrationType::TaggedSymbol,
-              metadata: T::Hash[Symbol, String],
+              metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
               status:
                 Dodopayments::Entitlements::EntitlementGrant::Status::TaggedSymbol,
               updated_at: Time,
@@ -223,6 +235,7 @@ module Dodopayments
                 T.nilable(Dodopayments::DigitalProductDelivery),
               error_code: T.nilable(String),
               error_message: T.nilable(String),
+              feature: T.nilable(Dodopayments::Feature),
               license_key:
                 T.nilable(Dodopayments::Entitlements::LicenseKeyGrant),
               oauth_expires_at: T.nilable(Time),

data/rbi/dodopayments/models/feature.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class Feature < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Dodopayments::Feature, Dodopayments::Internal::AnyHash)
+        end
+
+      # Identifier of the capability this grant confers.
+      sig { returns(String) }
+      attr_accessor :feature_id
+
+      # Type of capability conferred.
+      sig { returns(Dodopayments::FeatureType::TaggedSymbol) }
+      attr_accessor :feature_type
+
+      # Capability conferred by a `feature_flag` grant.
+      sig do
+        params(
+          feature_id: String,
+          feature_type: Dodopayments::FeatureType::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Identifier of the capability this grant confers.
+        feature_id:,
+        # Type of capability conferred.
+        feature_type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            feature_id: String,
+            feature_type: Dodopayments::FeatureType::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/feature_type.rbi

@@ -0,0 +1,21 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    # Type of capability a `feature_flag` entitlement confers.
+    module FeatureType
+      extend Dodopayments::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Dodopayments::FeatureType) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      BOOLEAN = T.let(:boolean, Dodopayments::FeatureType::TaggedSymbol)
+
+      sig do
+        override.returns(T::Array[Dodopayments::FeatureType::TaggedSymbol])
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/integration_config.rbi

@@ -4,12 +4,17 @@ module Dodopayments
   module Models
     # Integration-specific configuration supplied when creating or updating an
     # entitlement. The shape required matches the entitlement's `integration_type`.
+    #
+    # Untagged enum: variants are matched in order. `FeatureFlag` must precede
+    # `LicenseKey`, whose fields are all optional and would otherwise match a
+    # `feature_flag` config.
     module IntegrationConfig
       extend Dodopayments::Internal::Type::Union
 
       Variants =
         T.type_alias do
           T.any(
+            Dodopayments::IntegrationConfig::FeatureFlagConfig,
             Dodopayments::IntegrationConfig::GitHubConfig,
             Dodopayments::IntegrationConfig::DiscordConfig,
             Dodopayments::IntegrationConfig::TelegramConfig,
@@ -21,6 +26,51 @@ module Dodopayments
           )
         end
 
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::IntegrationConfig::FeatureFlagConfig,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Merchant-chosen identifier for the capability this entitlement unlocks. Not
+        # unique across entitlements.
+        sig { returns(String) }
+        attr_accessor :feature_id
+
+        # Type of capability conferred.
+        sig { returns(Dodopayments::FeatureType::OrSymbol) }
+        attr_accessor :feature_type
+
+        sig do
+          params(
+            feature_id: String,
+            feature_type: Dodopayments::FeatureType::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Merchant-chosen identifier for the capability this entitlement unlocks. Not
+          # unique across entitlements.
+          feature_id:,
+          # Type of capability conferred.
+          feature_type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              feature_id: String,
+              feature_type: Dodopayments::FeatureType::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
       class GitHubConfig < Dodopayments::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/dodopayments/models/integration_config_response.rbi

@@ -12,6 +12,7 @@ module Dodopayments
       Variants =
         T.type_alias do
           T.any(
+            Dodopayments::IntegrationConfigResponse::FeatureFlagConfig,
             Dodopayments::IntegrationConfigResponse::GitHubConfig,
             Dodopayments::IntegrationConfigResponse::DiscordConfig,
             Dodopayments::IntegrationConfigResponse::TelegramConfig,
@@ -23,6 +24,49 @@ module Dodopayments
           )
         end
 
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::IntegrationConfigResponse::FeatureFlagConfig,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Merchant-chosen identifier for the capability this entitlement unlocks.
+        sig { returns(String) }
+        attr_accessor :feature_id
+
+        # Type of capability conferred. Only `boolean` is supported today.
+        sig { returns(Dodopayments::FeatureType::TaggedSymbol) }
+        attr_accessor :feature_type
+
+        sig do
+          params(
+            feature_id: String,
+            feature_type: Dodopayments::FeatureType::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Merchant-chosen identifier for the capability this entitlement unlocks.
+          feature_id:,
+          # Type of capability conferred. Only `boolean` is supported today.
+          feature_type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              feature_id: String,
+              feature_type: Dodopayments::FeatureType::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
       class GitHubConfig < Dodopayments::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/dodopayments/models/license_key_duration.rbi

@@ -14,6 +14,7 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :count
 
+      # Unit of a duration count (e.g. license-key validity period).
       sig { returns(Dodopayments::TimeInterval::OrSymbol) }
       attr_accessor :interval
 
@@ -23,7 +24,11 @@ module Dodopayments
           interval: Dodopayments::TimeInterval::OrSymbol
         ).returns(T.attached_class)
       end
-      def self.new(count:, interval:)
+      def self.new(
+        count:,
+        # Unit of a duration count (e.g. license-key validity period).
+        interval:
+      )
       end
 
       sig do

data/rbi/dodopayments/models/metadata.rbi

@@ -2,9 +2,20 @@
 
 module Dodopayments
   module Models
+    # Metadata value can be a string, integer, number, or boolean
+    module MetadataItem
+      extend Dodopayments::Internal::Type::Union
+
+      Variants = T.type_alias { T.any(String, Float, T::Boolean) }
+
+      sig { override.returns(T::Array[Dodopayments::MetadataItem::Variants]) }
+      def self.variants
+      end
+    end
+
     Metadata =
       T.let(
-        Dodopayments::Internal::Type::HashOf[String],
+        Dodopayments::Internal::Type::HashOf[union: Dodopayments::MetadataItem],
         Dodopayments::Internal::Type::Converter
       )
   end

data/rbi/dodopayments/models/payment.rbi

@@ -40,7 +40,7 @@ module Dodopayments
       end
       attr_writer :customer
 
-      # brand id this payment belongs to
+      # Whether the digital products purchased in this payment have been delivered.
       sig { returns(T::Boolean) }
       attr_accessor :digital_products_delivered
 
@@ -49,7 +49,7 @@ module Dodopayments
       attr_accessor :disputes
 
       # Additional custom data associated with the payment
-      sig { returns(T::Hash[Symbol, String]) }
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       # Unique identifier for the payment
@@ -198,7 +198,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           digital_products_delivered: T::Boolean,
           disputes: T::Array[Dodopayments::Dispute::OrHash],
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
           payment_provider: Dodopayments::Payment::PaymentProvider::OrSymbol,
           refunds: T::Array[Dodopayments::RefundListItem::OrHash],
@@ -246,7 +246,7 @@ module Dodopayments
         currency:,
         # Details about the customer who made the payment
         customer:,
-        # brand id this payment belongs to
+        # Whether the digital products purchased in this payment have been delivered.
         digital_products_delivered:,
         # List of disputes associated with this payment
         disputes:,
@@ -340,7 +340,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             digital_products_delivered: T::Boolean,
             disputes: T::Array[Dodopayments::Dispute],
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
             payment_provider:
               Dodopayments::Payment::PaymentProvider::TaggedSymbol,

data/rbi/dodopayments/models/payment_create_params.rbi

@@ -76,10 +76,18 @@ module Dodopayments
 
       # Additional metadata associated with the payment. Defaults to empty if not
       # provided.
-      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      sig do
+        returns(
+          T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
+        )
+      end
       attr_reader :metadata
 
-      sig { params(metadata: T::Hash[Symbol, String]).void }
+      sig do
+        params(
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants]
+        ).void
+      end
       attr_writer :metadata
 
       # Whether to generate a payment link. Defaults to false if not specified.
@@ -147,7 +155,7 @@ module Dodopayments
           discount_code: T.nilable(String),
           discount_codes: T.nilable(T::Array[String]),
           force_3ds: T.nilable(T::Boolean),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_link: T.nilable(T::Boolean),
           payment_method_id: T.nilable(String),
           redirect_immediately: T::Boolean,
@@ -239,7 +247,7 @@ module Dodopayments
             discount_code: T.nilable(String),
             discount_codes: T.nilable(T::Array[String]),
             force_3ds: T.nilable(T::Boolean),
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_link: T.nilable(T::Boolean),
             payment_method_id: T.nilable(String),
             redirect_immediately: T::Boolean,

data/rbi/dodopayments/models/payment_create_response.rbi

@@ -26,7 +26,7 @@ module Dodopayments
       attr_writer :customer
 
       # Additional metadata associated with the payment
-      sig { returns(T::Hash[Symbol, String]) }
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       # Unique identifier for the payment
@@ -63,7 +63,7 @@ module Dodopayments
         params(
           client_secret: String,
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
           total_amount: Integer,
           discount_id: T.nilable(String),
@@ -106,7 +106,7 @@ module Dodopayments
           {
             client_secret: String,
             customer: Dodopayments::CustomerLimitedDetails,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
             total_amount: Integer,
             discount_id: T.nilable(String),

data/rbi/dodopayments/models/payment_list_response.rbi

@@ -34,7 +34,8 @@ module Dodopayments
       sig { returns(T::Boolean) }
       attr_accessor :has_license_key
 
-      sig { returns(T::Hash[Symbol, String]) }
+      # Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       sig { returns(String) }
@@ -99,7 +100,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           digital_products_delivered: T::Boolean,
           has_license_key: T::Boolean,
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
           payment_provider:
             Dodopayments::Models::PaymentListResponse::PaymentProvider::OrSymbol,
@@ -123,6 +124,7 @@ module Dodopayments
         customer:,
         digital_products_delivered:,
         has_license_key:,
+        # Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
         metadata:,
         payment_id:,
         # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
@@ -158,7 +160,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             digital_products_delivered: T::Boolean,
             has_license_key: T::Boolean,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
             payment_provider:
               Dodopayments::Models::PaymentListResponse::PaymentProvider::TaggedSymbol,

data/rbi/dodopayments/models/product.rbi

@@ -36,7 +36,7 @@ module Dodopayments
       attr_accessor :license_key_enabled
 
       # Additional custom data associated with the product
-      sig { returns(T::Hash[Symbol, String]) }
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       # Pricing information for the product.
@@ -126,7 +126,7 @@ module Dodopayments
             T::Array[Dodopayments::ProductEntitlementSummary::OrHash],
           is_recurring: T::Boolean,
           license_key_enabled: T::Boolean,
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           price:
             T.any(
               Dodopayments::Price::OneTimePrice::OrHash,
@@ -211,7 +211,7 @@ module Dodopayments
             entitlements: T::Array[Dodopayments::ProductEntitlementSummary],
             is_recurring: T::Boolean,
             license_key_enabled: T::Boolean,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             price: Dodopayments::Price::Variants,
             product_id: String,
             tax_category: Dodopayments::TaxCategory::TaggedSymbol,

data/rbi/dodopayments/models/product_create_params.rbi

@@ -118,10 +118,18 @@ module Dodopayments
       attr_accessor :license_key_enabled
 
       # Additional metadata for the product
-      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      sig do
+        returns(
+          T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
+        )
+      end
       attr_reader :metadata
 
-      sig { params(metadata: T::Hash[Symbol, String]).void }
+      sig do
+        params(
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants]
+        ).void
+      end
       attr_writer :metadata
 
       # Pricing mode for localized pricing. When set, rules from
@@ -156,7 +164,7 @@ module Dodopayments
           license_key_duration:
             T.nilable(Dodopayments::LicenseKeyDuration::OrHash),
           license_key_enabled: T.nilable(T::Boolean),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           pricing_mode:
             T.nilable(Dodopayments::Products::PricingMode::OrSymbol),
           request_options: Dodopayments::RequestOptions::OrHash
@@ -242,7 +250,7 @@ module Dodopayments
             license_key_activations_limit: T.nilable(Integer),
             license_key_duration: T.nilable(Dodopayments::LicenseKeyDuration),
             license_key_enabled: T.nilable(T::Boolean),
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             pricing_mode:
               T.nilable(Dodopayments::Products::PricingMode::OrSymbol),
             request_options: Dodopayments::RequestOptions

data/rbi/dodopayments/models/product_entitlement_summary.rbi

@@ -41,6 +41,7 @@ module Dodopayments
           id: String,
           integration_config:
             T.any(
+              Dodopayments::IntegrationConfigResponse::FeatureFlagConfig::OrHash,
               Dodopayments::IntegrationConfigResponse::GitHubConfig::OrHash,
               Dodopayments::IntegrationConfigResponse::DiscordConfig::OrHash,
               Dodopayments::IntegrationConfigResponse::TelegramConfig::OrHash,

data/rbi/dodopayments/models/product_list_response.rbi

@@ -28,7 +28,7 @@ module Dodopayments
       attr_accessor :is_recurring
 
       # Additional custom data associated with the product
-      sig { returns(T::Hash[Symbol, String]) }
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       # Unique identifier for the product.
@@ -94,7 +94,7 @@ module Dodopayments
           entitlements:
             T::Array[Dodopayments::ProductEntitlementSummary::OrHash],
           is_recurring: T::Boolean,
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           product_id: String,
           tax_category: Dodopayments::TaxCategory::OrSymbol,
           updated_at: Time,
@@ -169,7 +169,7 @@ module Dodopayments
             created_at: Time,
             entitlements: T::Array[Dodopayments::ProductEntitlementSummary],
             is_recurring: T::Boolean,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             product_id: String,
             tax_category: Dodopayments::TaxCategory::TaggedSymbol,
             updated_at: Time,

data/rbi/dodopayments/models/product_update_params.rbi

@@ -111,7 +111,11 @@ module Dodopayments
       attr_accessor :license_key_enabled
 
       # Additional metadata for the product
-      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      sig do
+        returns(
+          T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
+        )
+      end
       attr_accessor :metadata
 
       # Name of the product, optional and must be at most 100 characters.
@@ -162,7 +166,8 @@ module Dodopayments
           license_key_duration:
             T.nilable(Dodopayments::LicenseKeyDuration::OrHash),
           license_key_enabled: T.nilable(T::Boolean),
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           name: T.nilable(String),
           price:
             T.nilable(
@@ -261,7 +266,8 @@ module Dodopayments
             license_key_activations_limit: T.nilable(Integer),
             license_key_duration: T.nilable(Dodopayments::LicenseKeyDuration),
             license_key_enabled: T.nilable(T::Boolean),
-            metadata: T.nilable(T::Hash[Symbol, String]),
+            metadata:
+              T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
             name: T.nilable(String),
             price:
               T.nilable(

data/rbi/dodopayments/models/refund.rbi

@@ -34,7 +34,7 @@ module Dodopayments
       attr_accessor :is_partial
 
       # Additional metadata stored with the refund.
-      sig { returns(T::Hash[Symbol, String]) }
+      sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
 
       # The unique identifier of the payment associated with the refund.
@@ -68,7 +68,7 @@ module Dodopayments
           created_at: Time,
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           is_partial: T::Boolean,
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
           refund_id: String,
           status: Dodopayments::RefundStatus::OrSymbol,
@@ -113,7 +113,7 @@ module Dodopayments
             created_at: Time,
             customer: Dodopayments::CustomerLimitedDetails,
             is_partial: T::Boolean,
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
             refund_id: String,
             status: Dodopayments::RefundStatus::TaggedSymbol,

data/rbi/dodopayments/models/refund_create_params.rbi

@@ -25,10 +25,18 @@ module Dodopayments
       attr_accessor :items
 
       # Additional metadata associated with the refund.
-      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      sig do
+        returns(
+          T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
+        )
+      end
       attr_reader :metadata
 
-      sig { params(metadata: T::Hash[Symbol, String]).void }
+      sig do
+        params(
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants]
+        ).void
+      end
       attr_writer :metadata
 
       # The reason for the refund, if any. Maximum length is 3000 characters. Optional.
@@ -40,7 +48,7 @@ module Dodopayments
           payment_id: String,
           items:
             T.nilable(T::Array[Dodopayments::RefundCreateParams::Item::OrHash]),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           reason: T.nilable(String),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -63,7 +71,7 @@ module Dodopayments
           {
             payment_id: String,
             items: T.nilable(T::Array[Dodopayments::RefundCreateParams::Item]),
-            metadata: T::Hash[Symbol, String],
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             reason: T.nilable(String),
             request_options: Dodopayments::RequestOptions
           }