dodopayments 2.8.1 → 2.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7e056d8254eb39bcce07ee4e2badfa8e49782cd90bce3988ebd4b8d7454ef90
-  data.tar.gz: 552ceebf33b3e812a3e13e68dca3bb8ecaf0f72ba441f3b22752771360487e0e
+  metadata.gz: 9592c9e6302cd0a1142387d606f9696fb9c866bc6dfb6c1cac349a5e4c92366f
+  data.tar.gz: dc7ad233ddeb5bbe053737212fc4491d9d31e6980571d751ff09380ec25b190e
 SHA512:
-  metadata.gz: 5fd46af6587551acf8e3024c0c2b063ecbb153def13531954f4fc83c5f6556d3f1078e31e9e5bfe86a4d084bc1de45f654d82c80ab62458ba826c1c28586712a
-  data.tar.gz: 22fc9cd1c25403b88bba3eda42aa706ac44697b83f7c38eeff7581e6b92715ec236c6d434aaa77d89fb65e7aab11240dfc6ad5b5f3a1036668e30b5b3fe7809b
+  metadata.gz: 907cb238d23b3f98aefc575e056165c94edfeb7aae07906e171050774f034878960eb39c11b4828f6ef49e10efee37aaa2fd09279338091abd669d9add2790ed
+  data.tar.gz: d02a0a0f239c3529dae86d188676d2d414a951dfb484f9176c365f8b9f1650e860a9a28da03a9c2a3bd4bd6d1727b1a1c6f4bb1dbe85d435f200c23fa7d43653

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.9.0 (2026-04-30)
+
+Full Changelog: [v2.8.1...v2.9.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.8.1...v2.9.0)
+
+### Features
+
+* **api:** added more models to make the dx easy ([93de5ac](https://github.com/dodopayments/dodopayments-ruby/commit/93de5ac30132bece06134c8cba70bfbb8fd201eb))
+* **api:** updated openapi spec to v1.97.5 ([03df817](https://github.com/dodopayments/dodopayments-ruby/commit/03df8177c6704f9f6497cd449cb9ce7fc0429ef2))
+
 ## 2.8.1 (2026-04-29)
 
 Full Changelog: [v2.8.0...v2.8.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.8.0...v2.8.1)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.8.1"
+gem "dodopayments", "~> 2.9.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/client.rb

@@ -93,6 +93,9 @@ module Dodopayments
     # @return [Dodopayments::Resources::CreditEntitlements]
     attr_reader :credit_entitlements
 
+    # @return [Dodopayments::Resources::Entitlements]
+    attr_reader :entitlements
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -191,6 +194,7 @@ module Dodopayments
       @meters = Dodopayments::Resources::Meters.new(client: self)
       @balances = Dodopayments::Resources::Balances.new(client: self)
       @credit_entitlements = Dodopayments::Resources::CreditEntitlements.new(client: self)
+      @entitlements = Dodopayments::Resources::Entitlements.new(client: self)
     end
   end
 end

data/lib/dodopayments/models/attach_product_entitlement.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class AttachProductEntitlement < Dodopayments::Internal::Type::BaseModel
+      # @!attribute entitlement_id
+      #   ID of the entitlement to attach to the product
+      #
+      #   @return [String]
+      required :entitlement_id, String
+
+      # @!method initialize(entitlement_id:)
+      #   Request struct for attaching an entitlement to a product.
+      #
+      #   Mirrors the `credit_entitlements` attach shape — every "attach something to a
+      #   product" array takes objects, not bare IDs. Uniform shape leaves room for
+      #   per-attachment settings later without another API break.
+      #
+      #   @param entitlement_id [String] ID of the entitlement to attach to the product
+    end
+  end
+end

data/lib/dodopayments/models/cancellation_feedback.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module CancellationFeedback
+      extend Dodopayments::Internal::Type::Enum
+
+      TOO_EXPENSIVE = :too_expensive
+      MISSING_FEATURES = :missing_features
+      SWITCHED_SERVICE = :switched_service
+      UNUSED = :unused
+      CUSTOMER_SERVICE = :customer_service
+      LOW_QUALITY = :low_quality
+      TOO_COMPLEX = :too_complex
+      OTHER = :other
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/dodopayments/models/checkout_session_flags.rb

@@ -92,7 +92,16 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :redirect_immediately, Dodopayments::Internal::Type::Boolean
 
-      # @!method initialize(allow_currency_selection: nil, allow_customer_editing_city: nil, allow_customer_editing_country: nil, allow_customer_editing_email: nil, allow_customer_editing_name: nil, allow_customer_editing_state: nil, allow_customer_editing_street: nil, allow_customer_editing_tax_id: nil, allow_customer_editing_zipcode: nil, allow_discount_code: nil, allow_phone_number_collection: nil, allow_tax_id: nil, always_create_new_customer: nil, redirect_immediately: nil)
+      # @!attribute require_phone_number
+      #   If true, the customer must provide a phone number to complete checkout. Requires
+      #   `allow_phone_number_collection` to also be true.
+      #
+      #   Default is false
+      #
+      #   @return [Boolean, nil]
+      optional :require_phone_number, Dodopayments::Internal::Type::Boolean
+
+      # @!method initialize(allow_currency_selection: nil, allow_customer_editing_city: nil, allow_customer_editing_country: nil, allow_customer_editing_email: nil, allow_customer_editing_name: nil, allow_customer_editing_state: nil, allow_customer_editing_street: nil, allow_customer_editing_tax_id: nil, allow_customer_editing_zipcode: nil, allow_discount_code: nil, allow_phone_number_collection: nil, allow_tax_id: nil, always_create_new_customer: nil, redirect_immediately: nil, require_phone_number: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionFlags} for more details.
       #
@@ -123,6 +132,8 @@ module Dodopayments
       #   @param always_create_new_customer [Boolean] Set to true if a new customer object should be created.
       #
       #   @param redirect_immediately [Boolean] If true, redirects the customer immediately after payment completion
+      #
+      #   @param require_phone_number [Boolean] If true, the customer must provide a phone number to complete checkout.
     end
   end
 end

data/lib/dodopayments/models/checkout_session_request.rb

@@ -83,6 +83,17 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :force_3ds, Dodopayments::Internal::Type::Boolean, nil?: true
 
+      # @!attribute mandate_min_amount_inr_paise
+      #   Override the merchant-level mandate floor (in INR paise) for INR e-mandates on
+      #   Indian-card recurring payments. The mandate amount sent to the processor is
+      #   `max(this_floor, actual_billing_amount)`, so this is effectively the
+      #   customer-facing authorization ceiling whenever billing is lower. When unset, the
+      #   merchant setting applies; when that's also unset, the system default of ₹15,000
+      #   applies.
+      #
+      #   @return [Integer, nil]
+      optional :mandate_min_amount_inr_paise, Integer, nil?: true
+
       # @!attribute metadata
       #   Additional metadata associated with the payment. Defaults to empty if not
       #   provided.
@@ -140,7 +151,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, cancel_url: nil, confirm: nil, custom_fields: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, product_collection_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, tax_id: nil)
+      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, cancel_url: nil, confirm: nil, custom_fields: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, mandate_min_amount_inr_paise: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, product_collection_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionRequest} for more details.
       #
@@ -168,6 +179,8 @@ module Dodopayments
       #
       #   @param force_3ds [Boolean, nil] Override merchant default 3DS behaviour for this session
       #
+      #   @param mandate_min_amount_inr_paise [Integer, nil] Override the merchant-level mandate floor (in INR paise) for INR
+      #
       #   @param metadata [Hash{Symbol=>String}, nil] Additional metadata associated with the payment. Defaults to empty if not provid
       #
       #   @param minimal_address [Boolean] If true, only zipcode is required when confirm is true; other address fields rem

data/lib/dodopayments/models/credit_entitlements/credit_ledger_entry.rb

@@ -116,6 +116,7 @@ module Dodopayments
           CREDIT_ROLLED_OVER = :credit_rolled_over
           ROLLOVER_FORFEITED = :rollover_forfeited
           OVERAGE_CHARGED = :overage_charged
+          OVERAGE_RESET = :overage_reset
           AUTO_TOP_UP = :auto_top_up
           MANUAL_ADJUSTMENT = :manual_adjustment
           REFUND = :refund

data/lib/dodopayments/models/credit_overage_reset_webhook_event.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class CreditOverageResetWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      # @!attribute business_id
+      #   The business identifier
+      #
+      #   @return [String]
+      required :business_id, String
+
+      # @!attribute data
+      #   Response for a ledger entry
+      #
+      #   @return [Dodopayments::Models::CreditEntitlements::CreditLedgerEntry]
+      required :data, -> { Dodopayments::CreditEntitlements::CreditLedgerEntry }
+
+      # @!attribute timestamp
+      #   The timestamp of when the event occurred
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The event type
+      #
+      #   @return [Symbol, Dodopayments::Models::CreditOverageResetWebhookEvent::Type]
+      required :type, enum: -> { Dodopayments::CreditOverageResetWebhookEvent::Type }
+
+      # @!method initialize(business_id:, data:, timestamp:, type:)
+      #   @param business_id [String] The business identifier
+      #
+      #   @param data [Dodopayments::Models::CreditEntitlements::CreditLedgerEntry] Response for a ledger entry
+      #
+      #   @param timestamp [Time] The timestamp of when the event occurred
+      #
+      #   @param type [Symbol, Dodopayments::Models::CreditOverageResetWebhookEvent::Type] The event type
+
+      # The event type
+      #
+      # @see Dodopayments::Models::CreditOverageResetWebhookEvent#type
+      module Type
+        extend Dodopayments::Internal::Type::Enum
+
+        CREDIT_OVERAGE_RESET = :"credit.overage_reset"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/customer_list_entitlements_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Customers#list_entitlements
+    class CustomerListEntitlementsParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute customer_id
+      #
+      #   @return [String]
+      required :customer_id, String
+
+      # @!method initialize(customer_id:, request_options: {})
+      #   @param customer_id [String]
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/customer_list_entitlements_response.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Customers#list_entitlements
+    class CustomerListEntitlementsResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute items
+      #
+      #   @return [Array<Dodopayments::Models::CustomerListEntitlementsResponse::Item>]
+      required :items,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::CustomerListEntitlementsResponse::Item] }
+
+      # @!method initialize(items:)
+      #   @param items [Array<Dodopayments::Models::CustomerListEntitlementsResponse::Item>]
+
+      class Item < Dodopayments::Internal::Type::BaseModel
+        # @!attribute created_at
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute entitlement_id
+        #   The entitlement this grant belongs to.
+        #
+        #   @return [String]
+        required :entitlement_id, String
+
+        # @!attribute entitlement_name
+        #
+        #   @return [String]
+        required :entitlement_name, String
+
+        # @!attribute grant_id
+        #   Grant id (the per-customer row in `entitlement_grants`).
+        #
+        #   @return [String]
+        required :grant_id, String
+
+        # @!attribute integration_type
+        #
+        #   @return [Symbol, Dodopayments::Models::EntitlementIntegrationType]
+        required :integration_type, enum: -> { Dodopayments::EntitlementIntegrationType }
+
+        # @!attribute status
+        #
+        #   @return [Symbol, Dodopayments::Models::CustomerListEntitlementsResponse::Item::Status]
+        required :status, enum: -> { Dodopayments::Models::CustomerListEntitlementsResponse::Item::Status }
+
+        # @!attribute updated_at
+        #
+        #   @return [Time]
+        required :updated_at, Time
+
+        # @!attribute delivered_at
+        #
+        #   @return [Time, nil]
+        optional :delivered_at, Time, nil?: true
+
+        # @!attribute entitlement_description
+        #
+        #   @return [String, nil]
+        optional :entitlement_description, String, nil?: true
+
+        # @!attribute revoked_at
+        #
+        #   @return [Time, nil]
+        optional :revoked_at, Time, nil?: true
+
+        # @!method initialize(created_at:, entitlement_id:, entitlement_name:, grant_id:, integration_type:, status:, updated_at:, delivered_at: nil, entitlement_description: nil, revoked_at: nil)
+        #   @param created_at [Time]
+        #
+        #   @param entitlement_id [String] The entitlement this grant belongs to.
+        #
+        #   @param entitlement_name [String]
+        #
+        #   @param grant_id [String] Grant id (the per-customer row in `entitlement_grants`).
+        #
+        #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType]
+        #
+        #   @param status [Symbol, Dodopayments::Models::CustomerListEntitlementsResponse::Item::Status]
+        #
+        #   @param updated_at [Time]
+        #
+        #   @param delivered_at [Time, nil]
+        #
+        #   @param entitlement_description [String, nil]
+        #
+        #   @param revoked_at [Time, nil]
+
+        # @see Dodopayments::Models::CustomerListEntitlementsResponse::Item#status
+        module Status
+          extend Dodopayments::Internal::Type::Enum
+
+          PENDING = :pending
+          DELIVERED = :delivered
+          FAILED = :failed
+          REVOKED = :revoked
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/digital_product_delivery.rb

@@ -3,32 +3,30 @@
 module Dodopayments
   module Models
     class DigitalProductDelivery < Dodopayments::Internal::Type::BaseModel
+      # @!attribute files
+      #
+      #   @return [Array<Dodopayments::Models::DigitalProductDeliveryFile>]
+      required :files, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::DigitalProductDeliveryFile] }
+
       # @!attribute external_url
-      #   External URL to digital product
       #
       #   @return [String, nil]
       optional :external_url, String, nil?: true
 
-      # @!attribute files
-      #   Uploaded files ids of digital product
-      #
-      #   @return [Array<Dodopayments::Models::DigitalProductDeliveryFile>, nil]
-      optional :files,
-               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::DigitalProductDeliveryFile] },
-               nil?: true
-
       # @!attribute instructions
-      #   Instructions to download and use the digital product
       #
       #   @return [String, nil]
       optional :instructions, String, nil?: true
 
-      # @!method initialize(external_url: nil, files: nil, instructions: nil)
-      #   @param external_url [String, nil] External URL to digital product
-      #
-      #   @param files [Array<Dodopayments::Models::DigitalProductDeliveryFile>, nil] Uploaded files ids of digital product
+      # @!method initialize(files:, external_url: nil, instructions: nil)
+      #   Digital-product-delivery payload for a grant. Populated for grants whose
+      #   entitlement has `integration_type = 'digital_files'`. `files` carries presigned
+      #   download URLs; the source (EE service or legacy in-process S3 presigning) is
+      #   opaque to the caller.
       #
-      #   @param instructions [String, nil] Instructions to download and use the digital product
+      #   @param files [Array<Dodopayments::Models::DigitalProductDeliveryFile>]
+      #   @param external_url [String, nil]
+      #   @param instructions [String, nil]
     end
   end
 end

data/lib/dodopayments/models/digital_product_delivery_file.rb

@@ -3,25 +3,49 @@
 module Dodopayments
   module Models
     class DigitalProductDeliveryFile < Dodopayments::Internal::Type::BaseModel
+      # @!attribute download_url
+      #
+      #   @return [String]
+      required :download_url, String
+
+      # @!attribute expires_in
+      #   Seconds until `download_url` expires.
+      #
+      #   @return [Integer]
+      required :expires_in, Integer
+
       # @!attribute file_id
       #
       #   @return [String]
       required :file_id, String
 
-      # @!attribute file_name
+      # @!attribute filename
       #
       #   @return [String]
-      required :file_name, String
+      required :filename, String
 
-      # @!attribute url
+      # @!attribute content_type
       #
-      #   @return [String]
-      required :url, String
+      #   @return [String, nil]
+      optional :content_type, String, nil?: true
 
-      # @!method initialize(file_id:, file_name:, url:)
+      # @!attribute file_size
+      #
+      #   @return [Integer, nil]
+      optional :file_size, Integer, nil?: true
+
+      # @!method initialize(download_url:, expires_in:, file_id:, filename:, content_type: nil, file_size: nil)
+      #   @param download_url [String]
+      #
+      #   @param expires_in [Integer] Seconds until `download_url` expires.
+      #
       #   @param file_id [String]
-      #   @param file_name [String]
-      #   @param url [String]
+      #
+      #   @param filename [String]
+      #
+      #   @param content_type [String, nil]
+      #
+      #   @param file_size [Integer, nil]
     end
   end
 end

data/lib/dodopayments/models/entitlement.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Entitlements#create
+    class Entitlement < Dodopayments::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute business_id
+      #
+      #   @return [String]
+      required :business_id, String
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute integration_config
+      #   Public-facing variant of [`IntegrationConfig`]. Mirrors every variant shape on
+      #   the wire EXCEPT `DigitalFiles`, which is replaced with a hydrated
+      #   `digital_files` object (resolved download URLs etc.). The persisted JSONB stays
+      #   ID-only via [`IntegrationConfig`]; this enum is response-only.
+      #
+      #   @return [Dodopayments::Models::IntegrationConfigResponse::GitHubConfig, Dodopayments::Models::IntegrationConfigResponse::DiscordConfig, Dodopayments::Models::IntegrationConfigResponse::TelegramConfig, Dodopayments::Models::IntegrationConfigResponse::FigmaConfig, Dodopayments::Models::IntegrationConfigResponse::FramerConfig, Dodopayments::Models::IntegrationConfigResponse::NotionConfig, Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig, Dodopayments::Models::IntegrationConfigResponse::LicenseKeyConfig]
+      required :integration_config, union: -> { Dodopayments::IntegrationConfigResponse }
+
+      # @!attribute integration_type
+      #
+      #   @return [Symbol, Dodopayments::Models::EntitlementIntegrationType]
+      required :integration_type, enum: -> { Dodopayments::EntitlementIntegrationType }
+
+      # @!attribute is_active
+      #
+      #   @return [Boolean]
+      required :is_active, Dodopayments::Internal::Type::Boolean
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute updated_at
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute metadata
+      #
+      #   @return [Object, nil]
+      optional :metadata, Dodopayments::Internal::Type::Unknown
+
+      # @!method initialize(id:, business_id:, created_at:, integration_config:, integration_type:, is_active:, name:, updated_at:, description: nil, metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::Entitlement} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param business_id [String]
+      #
+      #   @param created_at [Time]
+      #
+      #   @param integration_config [Dodopayments::Models::IntegrationConfigResponse::GitHubConfig, Dodopayments::Models::IntegrationConfigResponse::DiscordConfig, Dodopayments::Models::IntegrationConfigResponse::TelegramConfig, Dodopayments::Models::IntegrationConfigResponse::FigmaConfig, Dodopayments::Models::IntegrationConfigResponse::FramerConfig, Dodopayments::Models::IntegrationConfigResponse::NotionConfig, Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig, Dodopayments::Models::IntegrationConfigResponse::LicenseKeyConfig] Public-facing variant of [`IntegrationConfig`]. Mirrors every variant
+      #
+      #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType]
+      #
+      #   @param is_active [Boolean]
+      #
+      #   @param name [String]
+      #
+      #   @param updated_at [Time]
+      #
+      #   @param description [String, nil]
+      #
+      #   @param metadata [Object]
+    end
+  end
+end

data/lib/dodopayments/models/entitlement_create_params.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Entitlements#create
+    class EntitlementCreateParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute integration_config
+      #   Platform-specific configuration (validated per integration_type)
+      #
+      #   @return [Dodopayments::Models::IntegrationConfig::GitHubConfig, Dodopayments::Models::IntegrationConfig::DiscordConfig, Dodopayments::Models::IntegrationConfig::TelegramConfig, Dodopayments::Models::IntegrationConfig::FigmaConfig, Dodopayments::Models::IntegrationConfig::FramerConfig, Dodopayments::Models::IntegrationConfig::NotionConfig, Dodopayments::Models::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::IntegrationConfig::LicenseKeyConfig]
+      required :integration_config, union: -> { Dodopayments::IntegrationConfig }
+
+      # @!attribute integration_type
+      #   Which platform integration this entitlement uses
+      #
+      #   @return [Symbol, Dodopayments::Models::EntitlementIntegrationType]
+      required :integration_type, enum: -> { Dodopayments::EntitlementIntegrationType }
+
+      # @!attribute name
+      #   Display name for this entitlement
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute description
+      #   Optional description
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute metadata
+      #   Optional user-facing metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Dodopayments::Internal::Type::HashOf[String], nil?: true
+
+      # @!method initialize(integration_config:, integration_type:, name:, description: nil, metadata: nil, request_options: {})
+      #   @param integration_config [Dodopayments::Models::IntegrationConfig::GitHubConfig, Dodopayments::Models::IntegrationConfig::DiscordConfig, Dodopayments::Models::IntegrationConfig::TelegramConfig, Dodopayments::Models::IntegrationConfig::FigmaConfig, Dodopayments::Models::IntegrationConfig::FramerConfig, Dodopayments::Models::IntegrationConfig::NotionConfig, Dodopayments::Models::IntegrationConfig::DigitalFilesConfig, Dodopayments::Models::IntegrationConfig::LicenseKeyConfig] Platform-specific configuration (validated per integration_type)
+      #
+      #   @param integration_type [Symbol, Dodopayments::Models::EntitlementIntegrationType] Which platform integration this entitlement uses
+      #
+      #   @param name [String] Display name for this entitlement
+      #
+      #   @param description [String, nil] Optional description
+      #
+      #   @param metadata [Hash{Symbol=>String}, nil] Optional user-facing metadata
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/entitlement_delete_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Entitlements#delete
+    class EntitlementDeleteParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end