dodopayments 2.17.1 → 2.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbbc9fa9d82e0c6e65c55283f6ed071347ee5eeac1991a3cebb88416ae2a5b96
-  data.tar.gz: 479550f1d1243c6b5747d8b81400ed158a20aa88bb56163ceae194de52bb5174
+  metadata.gz: de3e90e0a4cd35644cd9c8ef51c44c19ba4f9af2f0bbded7530ed6a95b082f60
+  data.tar.gz: 731dedea649eb1136b5b7c1b02b7ea1f42cbbcb619d606a90f9150b5dad2b4b9
 SHA512:
-  metadata.gz: 8caabf2fa045e47dc985505bf98e9ee9118242a41d2b11f34ba2d644e438e821eccb386e4bfe6747077ffef3f99b9f88911eecb2c9552de1fdfbe01c0d59d7b9
-  data.tar.gz: 686a9a414ec0dfb94b9ab737357651a3bb8571b4c7c8f2a8818e19915d71679512eb7a086ac3b56ed5b3156c8e22e154c8e5ba4b0df35887f4a450564d97704d
+  metadata.gz: 6ce146d98b0c8613c4a02177dc943c15444914e56d7ba545f6ee96becc372d67150f0b513d43254fe5b834ff1b3008b9998c9b4ced5295e06afea36925fbc9b8
+  data.tar.gz: 3530fa58411532a1f9afe760b06b11bce5f9d60c75b06d1b9be49572a758358663040a1cd24a70914ef3883760b75c47c98f4101aadfbb0bd0f414c1f64ecf16

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.18.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.17.1...v2.18.0) (2026-06-23)
+
+
+### Features
+
+* **api:** regenerate SDK from latest OpenAPI spec ([c67cd5d](https://github.com/dodopayments/dodopayments-ruby/commit/c67cd5d823eb140d150788457cdc813616629904))
+* **api:** regenerate SDK from latest OpenAPI spec ([f73e1f9](https://github.com/dodopayments/dodopayments-ruby/commit/f73e1f90193bae17de02a00cf8f239e02e1fc403))
+
 ## [2.17.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.17.0...v2.17.1) (2026-06-18)
 
 

data/README.md

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

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

@@ -56,6 +56,14 @@ module Dodopayments
         #   @return [Boolean]
         required :is_credit, Dodopayments::Internal::Type::Boolean
 
+        # @!attribute metadata
+        #   Metadata associated with the credit grant's source (the subscription or payment
+        #   created at checkout). Empty when the grant has no resolvable source (e.g.
+        #   credits granted directly via the API).
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :metadata, Dodopayments::Internal::Type::HashOf[String]
+
         # @!attribute overage_after
         #
         #   @return [String]
@@ -92,7 +100,10 @@ module Dodopayments
         #   @return [String, nil]
         optional :reference_type, String, nil?: true
 
-        # @!method initialize(id:, amount:, balance_after:, balance_before:, brand_id:, business_id:, created_at:, credit_entitlement_id:, customer_id:, is_credit:, overage_after:, overage_before:, transaction_type:, description: nil, grant_id: nil, reference_id: nil, reference_type: nil)
+        # @!method initialize(id:, amount:, balance_after:, balance_before:, brand_id:, business_id:, created_at:, credit_entitlement_id:, customer_id:, is_credit:, metadata:, overage_after:, overage_before:, transaction_type:, description: nil, grant_id: nil, reference_id: nil, reference_type: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::CreditEntitlements::CreditLedgerEntry} for more details.
+        #
         #   Response for a ledger entry
         #
         #   @param id [String]
@@ -115,6 +126,8 @@ module Dodopayments
         #
         #   @param is_credit [Boolean]
         #
+        #   @param metadata [Hash{Symbol=>String}] Metadata associated with the credit grant's source (the subscription or
+        #
         #   @param overage_after [String]
         #
         #   @param overage_before [String]

data/lib/dodopayments/models/entitlements/grant_fulfill_license_key_params.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Entitlements
+      # @see Dodopayments::Resources::Entitlements::Grants#fulfill_license_key
+      class GrantFulfillLicenseKeyParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute grant_id
+        #
+        #   @return [String]
+        required :grant_id, String
+
+        # @!attribute key
+        #   The license key value to deliver to the customer.
+        #
+        #   @return [String]
+        required :key, String
+
+        # @!attribute activations_limit
+        #   Per-key activation limit. Defaults to the entitlement's license-key
+        #   configuration.
+        #
+        #   @return [Integer, nil]
+        optional :activations_limit, Integer, nil?: true
+
+        # @!attribute expires_at
+        #   When the key expires. Defaults to the duration in the entitlement's license-key
+        #   configuration.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, nil?: true
+
+        # @!method initialize(grant_id:, key:, activations_limit: nil, expires_at: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Entitlements::GrantFulfillLicenseKeyParams} for more
+        #   details.
+        #
+        #   @param grant_id [String]
+        #
+        #   @param key [String] The license key value to deliver to the customer.
+        #
+        #   @param activations_limit [Integer, nil] Per-key activation limit. Defaults to the entitlement's license-key configuratio
+        #
+        #   @param expires_at [Time, nil] When the key expires. Defaults to the duration in the entitlement's license-key
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/metadata.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @type [Dodopayments::Internal::Type::Converter]
+    Metadata = Dodopayments::Internal::Type::HashOf[String]
+  end
+end

data/lib/dodopayments/models/payment_method_types.rb

@@ -113,6 +113,7 @@ module Dodopayments
       REVOLUT_PAY = :revolut_pay
       NAVER_PAY = :naver_pay
       PAYCO = :payco
+      SATISPAY = :satispay
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/dodopayments/models/product.rb

@@ -136,8 +136,8 @@ module Dodopayments
       #   Pricing mode for localized pricing. NULL means base-only (no localized rules
       #   apply).
       #
-      #   @return [Symbol, Dodopayments::Models::Product::PricingMode, nil]
-      optional :pricing_mode, enum: -> { Dodopayments::Product::PricingMode }, nil?: true
+      #   @return [Symbol, Dodopayments::Models::Products::PricingMode, nil]
+      optional :pricing_mode, enum: -> { Dodopayments::Products::PricingMode }, nil?: true
 
       # @!attribute product_collection_id
       #   The product collection ID this product belongs to, if any
@@ -189,23 +189,9 @@ module Dodopayments
       #
       #   @param name [String, nil] Name of the product, optional.
       #
-      #   @param pricing_mode [Symbol, Dodopayments::Models::Product::PricingMode, nil] Pricing mode for localized pricing. NULL means base-only (no localized rules app
+      #   @param pricing_mode [Symbol, Dodopayments::Models::Products::PricingMode, nil] Pricing mode for localized pricing. NULL means base-only (no localized rules app
       #
       #   @param product_collection_id [String, nil] The product collection ID this product belongs to, if any
-
-      # Pricing mode for localized pricing. NULL means base-only (no localized rules
-      # apply).
-      #
-      # @see Dodopayments::Models::Product#pricing_mode
-      module PricingMode
-        extend Dodopayments::Internal::Type::Enum
-
-        BY_CURRENCY = :by_currency
-        BY_COUNTRY = :by_country
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/dodopayments/models/product_create_params.rb

@@ -125,8 +125,8 @@ module Dodopayments
       #   /products/{id}/localized-prices apply at checkout. NULL means base-only
       #   (existing behavior).
       #
-      #   @return [Symbol, Dodopayments::Models::ProductCreateParams::PricingMode, nil]
-      optional :pricing_mode, enum: -> { Dodopayments::ProductCreateParams::PricingMode }, nil?: true
+      #   @return [Symbol, Dodopayments::Models::Products::PricingMode, nil]
+      optional :pricing_mode, enum: -> { Dodopayments::Products::PricingMode }, nil?: true
 
       # @!method initialize(name:, price:, tax_category:, addons: nil, brand_id: nil, credit_entitlements: nil, description: nil, digital_product_delivery: nil, entitlements: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, metadata: nil, pricing_mode: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
@@ -160,7 +160,7 @@ module Dodopayments
       #
       #   @param metadata [Hash{Symbol=>String}] Additional metadata for the product
       #
-      #   @param pricing_mode [Symbol, Dodopayments::Models::ProductCreateParams::PricingMode, nil] Pricing mode for localized pricing. When set, rules from
+      #   @param pricing_mode [Symbol, Dodopayments::Models::Products::PricingMode, nil] Pricing mode for localized pricing. When set, rules from
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
 
@@ -186,19 +186,6 @@ module Dodopayments
         #
         #   @param instructions [String, nil] Instructions to download and use the digital product
       end
-
-      # Pricing mode for localized pricing. When set, rules from
-      # /products/{id}/localized-prices apply at checkout. NULL means base-only
-      # (existing behavior).
-      module PricingMode
-        extend Dodopayments::Internal::Type::Enum
-
-        BY_CURRENCY = :by_currency
-        BY_COUNTRY = :by_country
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/dodopayments/models/product_list_response.rb

@@ -102,8 +102,8 @@ module Dodopayments
       #   Pricing mode for localized pricing. NULL means base-only (no localized rules
       #   apply).
       #
-      #   @return [Symbol, Dodopayments::Models::ProductListResponse::PricingMode, nil]
-      optional :pricing_mode, enum: -> { Dodopayments::Models::ProductListResponse::PricingMode }, nil?: true
+      #   @return [Symbol, Dodopayments::Models::Products::PricingMode, nil]
+      optional :pricing_mode, enum: -> { Dodopayments::Products::PricingMode }, nil?: true
 
       # @!attribute tax_inclusive
       #   Indicates if the price is tax inclusive
@@ -143,23 +143,9 @@ module Dodopayments
       #
       #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] Details of the price
       #
-      #   @param pricing_mode [Symbol, Dodopayments::Models::ProductListResponse::PricingMode, nil] Pricing mode for localized pricing. NULL means base-only (no localized rules app
+      #   @param pricing_mode [Symbol, Dodopayments::Models::Products::PricingMode, nil] Pricing mode for localized pricing. NULL means base-only (no localized rules app
       #
       #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
-
-      # Pricing mode for localized pricing. NULL means base-only (no localized rules
-      # apply).
-      #
-      # @see Dodopayments::Models::ProductListResponse#pricing_mode
-      module PricingMode
-        extend Dodopayments::Internal::Type::Enum
-
-        BY_CURRENCY = :by_currency
-        BY_COUNTRY = :by_country
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/dodopayments/models/product_update_params.rb

@@ -136,8 +136,8 @@ module Dodopayments
       #   archives all active localized rules for this product). Changing to a different
       #   non-null mode also archives any rules whose mode doesn't match the new mode.
       #
-      #   @return [Symbol, Dodopayments::Models::ProductUpdateParams::PricingMode, nil]
-      optional :pricing_mode, enum: -> { Dodopayments::ProductUpdateParams::PricingMode }, nil?: true
+      #   @return [Symbol, Dodopayments::Models::Products::PricingMode, nil]
+      optional :pricing_mode, enum: -> { Dodopayments::Products::PricingMode }, nil?: true
 
       # @!attribute tax_category
       #   Tax category of the product.
@@ -179,7 +179,7 @@ module Dodopayments
       #
       #   @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] Price details of the product.
       #
-      #   @param pricing_mode [Symbol, Dodopayments::Models::ProductUpdateParams::PricingMode, nil] Update the pricing mode. Omit to leave unchanged; set to null to clear
+      #   @param pricing_mode [Symbol, Dodopayments::Models::Products::PricingMode, nil] Update the pricing mode. Omit to leave unchanged; set to null to clear
       #
       #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory, nil] Tax category of the product.
       #
@@ -215,19 +215,6 @@ module Dodopayments
         #
         #   @param instructions [String, nil] Instructions to download and use the digital product
       end
-
-      # Update the pricing mode. Omit to leave unchanged; set to null to clear (which
-      # archives all active localized rules for this product). Changing to a different
-      # non-null mode also archives any rules whose mode doesn't match the new mode.
-      module PricingMode
-        extend Dodopayments::Internal::Type::Enum
-
-        BY_CURRENCY = :by_currency
-        BY_COUNTRY = :by_country
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/dodopayments/models/products/list_localized_prices_response.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::LocalizedPrices#list
+      class ListLocalizedPricesResponse < Dodopayments::Internal::Type::BaseModel
+        # @!attribute items
+        #
+        #   @return [Array<Dodopayments::Models::Products::LocalizedPrice>]
+        required :items, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Products::LocalizedPrice] }
+
+        # @!method initialize(items:)
+        #   @param items [Array<Dodopayments::Models::Products::LocalizedPrice>]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/products/localized_price.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::LocalizedPrices#create
+      class LocalizedPrice < Dodopayments::Internal::Type::BaseModel
+        # @!attribute id
+        #   Unique identifier for the localized price.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute amount
+        #   Amount in the smallest currency unit (e.g., cents).
+        #
+        #   @return [Integer]
+        required :amount, Integer
+
+        # @!attribute created_at
+        #   Timestamp when the localized price was created.
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute currency
+        #   Currency to charge in.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute mode
+        #   Pricing mode of the rule: by_currency or by_country.
+        #
+        #   @return [Symbol, Dodopayments::Models::Products::PricingMode]
+        required :mode, enum: -> { Dodopayments::Products::PricingMode }
+
+        # @!attribute product_id
+        #   Product this localized price belongs to.
+        #
+        #   @return [String]
+        required :product_id, String
+
+        # @!attribute updated_at
+        #   Timestamp when the localized price was last updated.
+        #
+        #   @return [Time]
+        required :updated_at, Time
+
+        # @!attribute country_code
+        #   Country the rule applies to. Only set when mode is by_country.
+        #
+        #   @return [Symbol, Dodopayments::Models::CountryCode, nil]
+        optional :country_code, enum: -> { Dodopayments::CountryCode }, nil?: true
+
+        # @!method initialize(id:, amount:, created_at:, currency:, mode:, product_id:, updated_at:, country_code: nil)
+        #   @param id [String] Unique identifier for the localized price.
+        #
+        #   @param amount [Integer] Amount in the smallest currency unit (e.g., cents).
+        #
+        #   @param created_at [Time] Timestamp when the localized price was created.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] Currency to charge in.
+        #
+        #   @param mode [Symbol, Dodopayments::Models::Products::PricingMode] Pricing mode of the rule: by_currency or by_country.
+        #
+        #   @param product_id [String] Product this localized price belongs to.
+        #
+        #   @param updated_at [Time] Timestamp when the localized price was last updated.
+        #
+        #   @param country_code [Symbol, Dodopayments::Models::CountryCode, nil] Country the rule applies to. Only set when mode is by_country.
+      end
+    end
+  end
+end

data/lib/dodopayments/models/products/localized_price_archive_params.rb

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

data/lib/dodopayments/models/products/localized_price_create_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::LocalizedPrices#create
+      class LocalizedPriceCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute product_id
+        #
+        #   @return [String]
+        required :product_id, String
+
+        # @!attribute amount
+        #   Amount in the smallest currency unit (e.g., cents). Must be greater than zero.
+        #
+        #   @return [Integer]
+        required :amount, Integer
+
+        # @!attribute currency
+        #   Currency to charge in. Must be a supported currency.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute country_code
+        #   Required when the product's pricing_mode is by_country; forbidden when
+        #   by_currency.
+        #
+        #   @return [Symbol, Dodopayments::Models::CountryCode, nil]
+        optional :country_code, enum: -> { Dodopayments::CountryCode }, nil?: true
+
+        # @!method initialize(product_id:, amount:, currency:, country_code: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Products::LocalizedPriceCreateParams} for more details.
+        #
+        #   @param product_id [String]
+        #
+        #   @param amount [Integer] Amount in the smallest currency unit (e.g., cents). Must be greater than zero.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] Currency to charge in. Must be a supported currency.
+        #
+        #   @param country_code [Symbol, Dodopayments::Models::CountryCode, nil] Required when the product's pricing_mode is by_country; forbidden when by_curren
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/products/localized_price_list_params.rb

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

data/lib/dodopayments/models/products/localized_price_retrieve_params.rb

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

data/lib/dodopayments/models/products/localized_price_update_params.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::LocalizedPrices#update
+      class LocalizedPriceUpdateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute product_id
+        #
+        #   @return [String]
+        required :product_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute amount
+        #   New amount in the smallest currency unit (e.g., cents). Must be greater than
+        #   zero. The currency and country_code of an existing rule cannot be changed.
+        #
+        #   @return [Integer, nil]
+        optional :amount, Integer, nil?: true
+
+        # @!method initialize(product_id:, id:, amount: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Products::LocalizedPriceUpdateParams} for more details.
+        #
+        #   @param product_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param amount [Integer, nil] New amount in the smallest currency unit (e.g., cents). Must be greater
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/products/pricing_mode.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      module PricingMode
+        extend Dodopayments::Internal::Type::Enum
+
+        BY_CURRENCY = :by_currency
+        BY_COUNTRY = :by_country
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/dodopayments/models.rb

@@ -309,6 +309,9 @@ module Dodopayments
 
   LicenseValidateParams = Dodopayments::Models::LicenseValidateParams
 
+  # @type [Dodopayments::Internal::Type::Converter]
+  Metadata = Dodopayments::Models::Metadata
+
   Meter = Dodopayments::Models::Meter
 
   MeterAggregation = Dodopayments::Models::MeterAggregation

data/lib/dodopayments/resources/entitlements/grants.rb

@@ -36,6 +36,41 @@ module Dodopayments
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Dodopayments::Models::Entitlements::GrantFulfillLicenseKeyParams} for more
+        # details.
+        #
+        # For entitlements whose license-key config uses `manual` fulfillment, grants are
+        # created in the `pending` state without a key. Call this endpoint to deliver the
+        # key: the grant moves to `delivered`, the customer is emailed the key, and the
+        # `license_key.created` and `entitlement_grant.delivered` webhook events are sent.
+        #
+        # @overload fulfill_license_key(grant_id, key:, activations_limit: nil, expires_at: nil, request_options: {})
+        #
+        # @param grant_id [String] Grant ID
+        #
+        # @param key [String] The license key value to deliver to the customer.
+        #
+        # @param activations_limit [Integer, nil] Per-key activation limit. Defaults to the entitlement's license-key configuratio
+        #
+        # @param expires_at [Time, nil] When the key expires. Defaults to the duration in the entitlement's license-key
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Dodopayments::Models::Entitlements::EntitlementGrant]
+        #
+        # @see Dodopayments::Models::Entitlements::GrantFulfillLicenseKeyParams
+        def fulfill_license_key(grant_id, params)
+          parsed, options = Dodopayments::Entitlements::GrantFulfillLicenseKeyParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["grants/%1$s/license-key", grant_id],
+            body: parsed,
+            model: Dodopayments::Entitlements::EntitlementGrant,
+            options: options
+          )
+        end
+
         # Revoke a single grant. Idempotent: re-revoking an already-revoked grant returns
         # the grant in its current state.
         #