dodopayments 2.18.1 → 2.19.0

data/rbi/dodopayments/resources/discounts.rbi

@@ -11,7 +11,7 @@ module Dodopayments
           type: Dodopayments::DiscountType::OrSymbol,
           code: T.nilable(String),
           expires_at: T.nilable(Time),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           name: T.nilable(String),
           preserve_on_plan_change: T::Boolean,
           restricted_to: T.nilable(T::Array[String]),
@@ -74,7 +74,8 @@ module Dodopayments
           amount: T.nilable(Integer),
           code: T.nilable(String),
           expires_at: T.nilable(Time),
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           name: T.nilable(String),
           preserve_on_plan_change: T.nilable(T::Boolean),
           restricted_to: T.nilable(T::Array[String]),

data/rbi/dodopayments/resources/entitlements.rbi

@@ -14,6 +14,7 @@ module Dodopayments
         params(
           integration_config:
             T.any(
+              Dodopayments::IntegrationConfig::FeatureFlagConfig::OrHash,
               Dodopayments::IntegrationConfig::GitHubConfig::OrHash,
               Dodopayments::IntegrationConfig::DiscordConfig::OrHash,
               Dodopayments::IntegrationConfig::TelegramConfig::OrHash,
@@ -26,7 +27,7 @@ module Dodopayments
           integration_type: Dodopayments::EntitlementIntegrationType::OrSymbol,
           name: String,
           description: T.nilable(String),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(Dodopayments::Entitlement)
       end
@@ -67,6 +68,7 @@ module Dodopayments
           integration_config:
             T.nilable(
               T.any(
+                Dodopayments::IntegrationConfig::FeatureFlagConfig::OrHash,
                 Dodopayments::IntegrationConfig::GitHubConfig::OrHash,
                 Dodopayments::IntegrationConfig::DiscordConfig::OrHash,
                 Dodopayments::IntegrationConfig::TelegramConfig::OrHash,
@@ -77,7 +79,8 @@ module Dodopayments
                 Dodopayments::IntegrationConfig::LicenseKeyConfig::OrHash
               )
             ),
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           name: T.nilable(String),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(Dodopayments::Entitlement)
@@ -88,7 +91,12 @@ module Dodopayments
         description: nil,
         # 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.
         integration_config: nil,
+        # Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
         metadata: nil,
         name: nil,
         request_options: {}

data/rbi/dodopayments/resources/payments.rbi

@@ -20,7 +20,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/resources/products.rbi

@@ -38,7 +38,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
@@ -131,7 +131,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(

data/rbi/dodopayments/resources/refunds.rbi

@@ -8,7 +8,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(Dodopayments::Refund)

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -22,7 +22,7 @@ module Dodopayments
           discount_codes: T.nilable(T::Array[String]),
           force_3ds: T.nilable(T::Boolean),
           mandate_min_amount_inr_paise: T.nilable(Integer),
-          metadata: T::Hash[Symbol, String],
+          metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           on_demand: T.nilable(Dodopayments::OnDemandSubscription::OrHash),
           one_time_product_cart:
             T.nilable(T::Array[Dodopayments::OneTimeProductCartItem::OrHash]),
@@ -150,7 +150,8 @@ module Dodopayments
             T.nilable(
               Dodopayments::SubscriptionUpdateParams::DisableOnDemand::OrHash
             ),
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           next_billing_date: T.nilable(Time),
           status: T.nilable(Dodopayments::SubscriptionStatus::OrSymbol),
           tax_id: T.nilable(String),
@@ -179,6 +180,7 @@ module Dodopayments
         customer_business_name: nil,
         customer_name: nil,
         disable_on_demand: nil,
+        # Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
         metadata: nil,
         next_billing_date: nil,
         status: nil,
@@ -251,7 +253,8 @@ module Dodopayments
           discount_codes: T.nilable(T::Array[String]),
           effective_at:
             Dodopayments::UpdateSubscriptionPlanReq::EffectiveAt::OrSymbol,
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           on_payment_failure:
             T.nilable(
               Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol
@@ -311,7 +314,8 @@ module Dodopayments
             T.nilable(
               Dodopayments::SubscriptionChargeParams::CustomerBalanceConfig::OrHash
             ),
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           product_currency: T.nilable(Dodopayments::Currency::OrSymbol),
           product_description: T.nilable(String),
           request_options: Dodopayments::RequestOptions::OrHash
@@ -355,7 +359,8 @@ module Dodopayments
           discount_codes: T.nilable(T::Array[String]),
           effective_at:
             Dodopayments::UpdateSubscriptionPlanReq::EffectiveAt::OrSymbol,
-          metadata: T.nilable(T::Hash[Symbol, String]),
+          metadata:
+            T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]),
           on_payment_failure:
             T.nilable(
               Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol

data/sig/dodopayments/models/customer_list_entitlement_grants_params.rbs

@@ -0,0 +1,98 @@
+module Dodopayments
+  module Models
+    type customer_list_entitlement_grants_params =
+      {
+        customer_id: String,
+        integration_type: Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type,
+        page_number: Integer,
+        page_size: Integer,
+        status: Dodopayments::Models::CustomerListEntitlementGrantsParams::status
+      }
+      & Dodopayments::Internal::Type::request_parameters
+
+    class CustomerListEntitlementGrantsParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      attr_accessor customer_id: String
+
+      attr_reader integration_type: Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type?
+
+      def integration_type=: (
+        Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type
+      ) -> Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type
+
+      attr_reader page_number: Integer?
+
+      def page_number=: (Integer) -> Integer
+
+      attr_reader page_size: Integer?
+
+      def page_size=: (Integer) -> Integer
+
+      attr_reader status: Dodopayments::Models::CustomerListEntitlementGrantsParams::status?
+
+      def status=: (
+        Dodopayments::Models::CustomerListEntitlementGrantsParams::status
+      ) -> Dodopayments::Models::CustomerListEntitlementGrantsParams::status
+
+      def initialize: (
+        customer_id: String,
+        ?integration_type: Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type,
+        ?page_number: Integer,
+        ?page_size: Integer,
+        ?status: Dodopayments::Models::CustomerListEntitlementGrantsParams::status,
+        ?request_options: Dodopayments::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        customer_id: String,
+        integration_type: Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type,
+        page_number: Integer,
+        page_size: Integer,
+        status: Dodopayments::Models::CustomerListEntitlementGrantsParams::status,
+        request_options: Dodopayments::RequestOptions
+      }
+
+      type integration_type =
+        :discord
+        | :telegram
+        | :github
+        | :figma
+        | :framer
+        | :notion
+        | :digital_files
+        | :license_key
+        | :feature_flag
+
+      module IntegrationType
+        extend Dodopayments::Internal::Type::Enum
+
+        DISCORD: :discord
+        TELEGRAM: :telegram
+        GITHUB: :github
+        FIGMA: :figma
+        FRAMER: :framer
+        NOTION: :notion
+        DIGITAL_FILES: :digital_files
+        LICENSE_KEY: :license_key
+        FEATURE_FLAG: :feature_flag
+
+        def self?.values: -> ::Array[Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type]
+      end
+
+      type status = :Pending | :Delivered | :Failed | :Revoked
+
+      module Status
+        extend Dodopayments::Internal::Type::Enum
+
+        PENDING: :Pending
+        DELIVERED: :Delivered
+        FAILED: :Failed
+        REVOKED: :Revoked
+
+        def self?.values: -> ::Array[Dodopayments::Models::CustomerListEntitlementGrantsParams::status]
+      end
+    end
+  end
+end

data/sig/dodopayments/models/entitlement_integration_type.rbs

@@ -9,6 +9,7 @@ module Dodopayments
       | :notion
       | :digital_files
       | :license_key
+      | :feature_flag
 
     module EntitlementIntegrationType
       extend Dodopayments::Internal::Type::Enum
@@ -21,6 +22,7 @@ module Dodopayments
       NOTION: :notion
       DIGITAL_FILES: :digital_files
       LICENSE_KEY: :license_key
+      FEATURE_FLAG: :feature_flag
 
       def self?.values: -> ::Array[Dodopayments::Models::entitlement_integration_type]
     end

data/sig/dodopayments/models/entitlement_list_params.rbs

@@ -49,6 +49,7 @@ module Dodopayments
         | :notion
         | :digital_files
         | :license_key
+        | :feature_flag
 
       module IntegrationType
         extend Dodopayments::Internal::Type::Enum
@@ -61,6 +62,7 @@ module Dodopayments
         NOTION: :notion
         DIGITAL_FILES: :digital_files
         LICENSE_KEY: :license_key
+        FEATURE_FLAG: :feature_flag
 
         def self?.values: -> ::Array[Dodopayments::Models::EntitlementListParams::integration_type]
       end

data/sig/dodopayments/models/entitlements/entitlement_grant.rbs

@@ -19,6 +19,7 @@ module Dodopayments
           digital_product_delivery: Dodopayments::DigitalProductDelivery?,
           error_code: String?,
           error_message: String?,
+          feature: Dodopayments::Feature?,
           license_key: Dodopayments::Entitlements::LicenseKeyGrant?,
           oauth_expires_at: Time?,
           oauth_url: String?,
@@ -57,6 +58,8 @@ module Dodopayments
 
         attr_accessor error_message: String?
 
+        attr_accessor feature: Dodopayments::Feature?
+
         attr_accessor license_key: Dodopayments::Entitlements::LicenseKeyGrant?
 
         attr_accessor oauth_expires_at: Time?
@@ -86,6 +89,7 @@ module Dodopayments
           ?digital_product_delivery: Dodopayments::DigitalProductDelivery?,
           ?error_code: String?,
           ?error_message: String?,
+          ?feature: Dodopayments::Feature?,
           ?license_key: Dodopayments::Entitlements::LicenseKeyGrant?,
           ?oauth_expires_at: Time?,
           ?oauth_url: String?,
@@ -110,6 +114,7 @@ module Dodopayments
           digital_product_delivery: Dodopayments::DigitalProductDelivery?,
           error_code: String?,
           error_message: String?,
+          feature: Dodopayments::Feature?,
           license_key: Dodopayments::Entitlements::LicenseKeyGrant?,
           oauth_expires_at: Time?,
           oauth_url: String?,

data/sig/dodopayments/models/feature.rbs

@@ -0,0 +1,22 @@
+module Dodopayments
+  module Models
+    type feature =
+      { feature_id: String, feature_type: Dodopayments::Models::feature_type }
+
+    class Feature < Dodopayments::Internal::Type::BaseModel
+      attr_accessor feature_id: String
+
+      attr_accessor feature_type: Dodopayments::Models::feature_type
+
+      def initialize: (
+        feature_id: String,
+        feature_type: Dodopayments::Models::feature_type
+      ) -> void
+
+      def to_hash: -> {
+        feature_id: String,
+        feature_type: Dodopayments::Models::feature_type
+      }
+    end
+  end
+end

data/sig/dodopayments/models/feature_type.rbs

@@ -0,0 +1,13 @@
+module Dodopayments
+  module Models
+    type feature_type = :boolean
+
+    module FeatureType
+      extend Dodopayments::Internal::Type::Enum
+
+      BOOLEAN: :boolean
+
+      def self?.values: -> ::Array[Dodopayments::Models::feature_type]
+    end
+  end
+end

data/sig/dodopayments/models/integration_config.rbs

@@ -1,7 +1,8 @@
 module Dodopayments
   module Models
     type integration_config =
-      Dodopayments::IntegrationConfig::GitHubConfig
+      Dodopayments::IntegrationConfig::FeatureFlagConfig
+      | Dodopayments::IntegrationConfig::GitHubConfig
       | Dodopayments::IntegrationConfig::DiscordConfig
       | Dodopayments::IntegrationConfig::TelegramConfig
       | Dodopayments::IntegrationConfig::FigmaConfig
@@ -13,6 +14,25 @@ module Dodopayments
     module IntegrationConfig
       extend Dodopayments::Internal::Type::Union
 
+      type feature_flag_config =
+        { feature_id: String, feature_type: Dodopayments::Models::feature_type }
+
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        attr_accessor feature_id: String
+
+        attr_accessor feature_type: Dodopayments::Models::feature_type
+
+        def initialize: (
+          feature_id: String,
+          feature_type: Dodopayments::Models::feature_type
+        ) -> void
+
+        def to_hash: -> {
+          feature_id: String,
+          feature_type: Dodopayments::Models::feature_type
+        }
+      end
+
       type github_config =
         {
           permission: Dodopayments::Models::github_permission,

data/sig/dodopayments/models/integration_config_response.rbs

@@ -1,7 +1,8 @@
 module Dodopayments
   module Models
     type integration_config_response =
-      Dodopayments::IntegrationConfigResponse::GitHubConfig
+      Dodopayments::IntegrationConfigResponse::FeatureFlagConfig
+      | Dodopayments::IntegrationConfigResponse::GitHubConfig
       | Dodopayments::IntegrationConfigResponse::DiscordConfig
       | Dodopayments::IntegrationConfigResponse::TelegramConfig
       | Dodopayments::IntegrationConfigResponse::FigmaConfig
@@ -13,6 +14,25 @@ module Dodopayments
     module IntegrationConfigResponse
       extend Dodopayments::Internal::Type::Union
 
+      type feature_flag_config =
+        { feature_id: String, feature_type: Dodopayments::Models::feature_type }
+
+      class FeatureFlagConfig < Dodopayments::Internal::Type::BaseModel
+        attr_accessor feature_id: String
+
+        attr_accessor feature_type: Dodopayments::Models::feature_type
+
+        def initialize: (
+          feature_id: String,
+          feature_type: Dodopayments::Models::feature_type
+        ) -> void
+
+        def to_hash: -> {
+          feature_id: String,
+          feature_type: Dodopayments::Models::feature_type
+        }
+      end
+
       type github_config =
         {
           permission: Dodopayments::Models::github_permission,

data/sig/dodopayments/models/metadata.rbs

@@ -1,6 +1,14 @@
 module Dodopayments
   module Models
-    type metadata = ::Hash[Symbol, String]
+    type metadata_item = String | Float | bool
+
+    module MetadataItem
+      extend Dodopayments::Internal::Type::Union
+
+      def self?.variants: -> ::Array[Dodopayments::Models::metadata_item]
+    end
+
+    type metadata = ::Hash[Symbol, Dodopayments::Models::metadata_item]
 
     Metadata: Dodopayments::Internal::Type::Converter
   end

data/sig/dodopayments/models.rbs

@@ -125,6 +125,8 @@ module Dodopayments
 
   class CustomerListCreditEntitlementsParams = Dodopayments::Models::CustomerListCreditEntitlementsParams
 
+  class CustomerListEntitlementGrantsParams = Dodopayments::Models::CustomerListEntitlementGrantsParams
+
   class CustomerListEntitlementsParams = Dodopayments::Models::CustomerListEntitlementsParams
 
   class CustomerListParams = Dodopayments::Models::CustomerListParams
@@ -223,6 +225,10 @@ module Dodopayments
 
   class EventInput = Dodopayments::Models::EventInput
 
+  class Feature = Dodopayments::Models::Feature
+
+  module FeatureType = Dodopayments::Models::FeatureType
+
   module FilterOperator = Dodopayments::Models::FilterOperator
 
   module FilterType = Dodopayments::Models::FilterType
@@ -271,6 +277,8 @@ module Dodopayments
 
   Metadata: Dodopayments::Internal::Type::Converter
 
+  type metadata_item = Dodopayments::Models::metadata_item
+
   class Meter = Dodopayments::Models::Meter
 
   class MeterAggregation = Dodopayments::Models::MeterAggregation

data/sig/dodopayments/resources/customers.rbs

@@ -48,6 +48,15 @@ module Dodopayments
         ?request_options: Dodopayments::request_opts
       ) -> Dodopayments::Models::CustomerListCreditEntitlementsResponse
 
+      def list_entitlement_grants: (
+        String customer_id,
+        ?integration_type: Dodopayments::Models::CustomerListEntitlementGrantsParams::integration_type,
+        ?page_number: Integer,
+        ?page_size: Integer,
+        ?status: Dodopayments::Models::CustomerListEntitlementGrantsParams::status,
+        ?request_options: Dodopayments::request_opts
+      ) -> Dodopayments::Internal::DefaultPageNumberPagination[Dodopayments::Entitlements::EntitlementGrant]
+
       def list_entitlements: (
         String customer_id,
         ?request_options: Dodopayments::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dodopayments
 version: !ruby/object:Gem::Version
-  version: 2.18.1
+  version: 2.19.0
 platform: ruby
 authors:
 - Dodo Payments
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-27 00:00:00.000000000 Z
+date: 2026-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -164,6 +164,7 @@ files:
 - lib/dodopayments/models/customer_limited_details.rb
 - lib/dodopayments/models/customer_list_credit_entitlements_params.rb
 - lib/dodopayments/models/customer_list_credit_entitlements_response.rb
+- lib/dodopayments/models/customer_list_entitlement_grants_params.rb
 - lib/dodopayments/models/customer_list_entitlements_params.rb
 - lib/dodopayments/models/customer_list_entitlements_response.rb
 - lib/dodopayments/models/customer_list_params.rb
@@ -227,6 +228,8 @@ files:
 - lib/dodopayments/models/entitlements/license_key_grant.rb
 - lib/dodopayments/models/event.rb
 - lib/dodopayments/models/event_input.rb
+- lib/dodopayments/models/feature.rb
+- lib/dodopayments/models/feature_type.rb
 - lib/dodopayments/models/filter_operator.rb
 - lib/dodopayments/models/filter_type.rb
 - lib/dodopayments/models/get_dispute.rb
@@ -546,6 +549,7 @@ files:
 - rbi/dodopayments/models/customer_limited_details.rbi
 - rbi/dodopayments/models/customer_list_credit_entitlements_params.rbi
 - rbi/dodopayments/models/customer_list_credit_entitlements_response.rbi
+- rbi/dodopayments/models/customer_list_entitlement_grants_params.rbi
 - rbi/dodopayments/models/customer_list_entitlements_params.rbi
 - rbi/dodopayments/models/customer_list_entitlements_response.rbi
 - rbi/dodopayments/models/customer_list_params.rbi
@@ -609,6 +613,8 @@ files:
 - rbi/dodopayments/models/entitlements/license_key_grant.rbi
 - rbi/dodopayments/models/event.rbi
 - rbi/dodopayments/models/event_input.rbi
+- rbi/dodopayments/models/feature.rbi
+- rbi/dodopayments/models/feature_type.rbi
 - rbi/dodopayments/models/filter_operator.rbi
 - rbi/dodopayments/models/filter_type.rbi
 - rbi/dodopayments/models/get_dispute.rbi
@@ -927,6 +933,7 @@ files:
 - sig/dodopayments/models/customer_limited_details.rbs
 - sig/dodopayments/models/customer_list_credit_entitlements_params.rbs
 - sig/dodopayments/models/customer_list_credit_entitlements_response.rbs
+- sig/dodopayments/models/customer_list_entitlement_grants_params.rbs
 - sig/dodopayments/models/customer_list_entitlements_params.rbs
 - sig/dodopayments/models/customer_list_entitlements_response.rbs
 - sig/dodopayments/models/customer_list_params.rbs
@@ -990,6 +997,8 @@ files:
 - sig/dodopayments/models/entitlements/license_key_grant.rbs
 - sig/dodopayments/models/event.rbs
 - sig/dodopayments/models/event_input.rbs
+- sig/dodopayments/models/feature.rbs
+- sig/dodopayments/models/feature_type.rbs
 - sig/dodopayments/models/filter_operator.rbs
 - sig/dodopayments/models/filter_type.rbs
 - sig/dodopayments/models/get_dispute.rbs