dodopayments 2.9.0 → 2.10.0

data/lib/dodopayments/models/integration_config_response.rb

@@ -2,10 +2,10 @@
 
 module Dodopayments
   module Models
-    # 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.
+    # Integration-specific configuration on an entitlement read response.
+    #
+    # For `digital_files` entitlements the response includes presigned download URLs
+    # for each attached file; other integrations match the shape supplied at creation.
     module IntegrationConfigResponse
       extend Dodopayments::Internal::Type::Union
 
@@ -27,82 +27,106 @@ module Dodopayments
 
       class GitHubConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute permission
+        #   Permission to grant on the repository.
         #
-        #   @return [String]
-        required :permission, String
+        #   @return [Symbol, Dodopayments::Models::IntegrationConfigResponse::GitHubConfig::Permission]
+        required :permission, enum: -> { Dodopayments::IntegrationConfigResponse::GitHubConfig::Permission }
 
         # @!attribute target_id
+        #   Repository or organisation slug to grant access to.
         #
         #   @return [String]
         required :target_id, String
 
         # @!method initialize(permission:, target_id:)
-        #   @param permission [String]
-        #   @param target_id [String]
+        #   @param permission [Symbol, Dodopayments::Models::IntegrationConfigResponse::GitHubConfig::Permission] Permission to grant on the repository.
+        #
+        #   @param target_id [String] Repository or organisation slug to grant access to.
+
+        # Permission to grant on the repository.
+        #
+        # @see Dodopayments::Models::IntegrationConfigResponse::GitHubConfig#permission
+        module Permission
+          extend Dodopayments::Internal::Type::Enum
+
+          PULL = :pull
+          PUSH = :push
+          ADMIN = :admin
+          MAINTAIN = :maintain
+          TRIAGE = :triage
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       class DiscordConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute guild_id
+        #   Discord guild (server) ID.
         #
         #   @return [String]
         required :guild_id, String
 
         # @!attribute role_id
+        #   Optional Discord role to assign within the guild.
         #
         #   @return [String, nil]
         optional :role_id, String, nil?: true
 
         # @!method initialize(guild_id:, role_id: nil)
-        #   @param guild_id [String]
-        #   @param role_id [String, nil]
+        #   @param guild_id [String] Discord guild (server) ID.
+        #
+        #   @param role_id [String, nil] Optional Discord role to assign within the guild.
       end
 
       class TelegramConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute chat_id
+        #   Telegram chat ID. For groups this is typically a negative integer.
         #
         #   @return [String]
         required :chat_id, String
 
         # @!method initialize(chat_id:)
-        #   @param chat_id [String]
+        #   @param chat_id [String] Telegram chat ID. For groups this is typically a negative integer.
       end
 
       class FigmaConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute figma_file_id
+        #   Figma file identifier to grant access to.
         #
         #   @return [String]
         required :figma_file_id, String
 
         # @!method initialize(figma_file_id:)
-        #   @param figma_file_id [String]
+        #   @param figma_file_id [String] Figma file identifier to grant access to.
       end
 
       class FramerConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute framer_template_id
+        #   Framer template identifier to grant access to.
         #
         #   @return [String]
         required :framer_template_id, String
 
         # @!method initialize(framer_template_id:)
-        #   @param framer_template_id [String]
+        #   @param framer_template_id [String] Framer template identifier to grant access to.
       end
 
       class NotionConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute notion_template_id
+        #   Notion template identifier to grant access to.
         #
         #   @return [String]
         required :notion_template_id, String
 
         # @!method initialize(notion_template_id:)
-        #   @param notion_template_id [String]
+        #   @param notion_template_id [String] Notion template identifier to grant access to.
       end
 
       class DigitalFilesConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute digital_files
-        #   Populated digital-files payload for entitlement read surfaces. Mirrors
-        #   `DigitalProductDelivery` but is sourced from an entitlement's
-        #   `integration_config` (not a grant) and tags each file with its origin (`legacy`
-        #   vs `ee`).
+        #   Populated digital-files payload with each file's metadata and a short-lived
+        #   presigned download URL.
         #
         #   @return [Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles]
         required :digital_files, -> { Dodopayments::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles }
@@ -112,38 +136,47 @@ module Dodopayments
         #   {Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig} for more
         #   details.
         #
-        #   @param digital_files [Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles] Populated digital-files payload for entitlement read surfaces. Mirrors
+        #   @param digital_files [Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles] Populated digital-files payload with each file's metadata and a
 
         # @see Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig#digital_files
         class DigitalFiles < Dodopayments::Internal::Type::BaseModel
           # @!attribute files
+          #   One entry per attached file.
           #
           #   @return [Array<Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File>]
           required :files,
                    -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File] }
 
           # @!attribute external_url
+          #   Optional external URL, passed through from the entitlement configuration.
           #
           #   @return [String, nil]
           optional :external_url, String, nil?: true
 
           # @!attribute instructions
+          #   Optional human-readable delivery instructions, passed through from the
+          #   entitlement configuration.
           #
           #   @return [String, nil]
           optional :instructions, String, nil?: true
 
           # @!method initialize(files:, external_url: nil, instructions: nil)
-          #   Populated digital-files payload for entitlement read surfaces. Mirrors
-          #   `DigitalProductDelivery` but is sourced from an entitlement's
-          #   `integration_config` (not a grant) and tags each file with its origin (`legacy`
-          #   vs `ee`).
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles}
+          #   for more details.
+          #
+          #   Populated digital-files payload with each file's metadata and a short-lived
+          #   presigned download URL.
+          #
+          #   @param files [Array<Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File>] One entry per attached file.
           #
-          #   @param files [Array<Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File>]
-          #   @param external_url [String, nil]
-          #   @param instructions [String, nil]
+          #   @param external_url [String, nil] Optional external URL, passed through from the entitlement
+          #
+          #   @param instructions [String, nil] Optional human-readable delivery instructions, passed through from
 
           class File < Dodopayments::Internal::Type::BaseModel
             # @!attribute download_url
+            #   Short-lived presigned URL for downloading the file.
             #
             #   @return [String]
             required :download_url, String
@@ -155,80 +188,87 @@ module Dodopayments
             required :expires_in, Integer
 
             # @!attribute file_id
+            #   Identifier of the attached file.
             #
             #   @return [String]
             required :file_id, String
 
             # @!attribute filename
+            #   Original filename of the attached file.
             #
             #   @return [String]
             required :filename, String
 
-            # @!attribute source
-            #   `"legacy"` for files in `product_files`, `"ee"` for files managed by the
-            #   Entitlements Engine.
-            #
-            #   @return [String]
-            required :source, String
-
             # @!attribute content_type
+            #   Optional content-type declared at upload.
             #
             #   @return [String, nil]
             optional :content_type, String, nil?: true
 
             # @!attribute file_size
+            #   Optional size of the file in bytes.
             #
             #   @return [Integer, nil]
             optional :file_size, Integer, nil?: true
 
-            # @!method initialize(download_url:, expires_in:, file_id:, filename:, source:, content_type: nil, file_size: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {Dodopayments::Models::IntegrationConfigResponse::DigitalFilesConfig::DigitalFiles::File}
-            #   for more details.
+            # @!method initialize(download_url:, expires_in:, file_id:, filename:, content_type: nil, file_size: nil)
+            #   One file in a resolved digital-files payload.
             #
-            #   @param download_url [String]
+            #   @param download_url [String] Short-lived presigned URL for downloading the file.
             #
             #   @param expires_in [Integer] Seconds until `download_url` expires.
             #
-            #   @param file_id [String]
-            #
-            #   @param filename [String]
+            #   @param file_id [String] Identifier of the attached file.
             #
-            #   @param source [String] `"legacy"` for files in `product_files`, `"ee"` for files managed by the
+            #   @param filename [String] Original filename of the attached file.
             #
-            #   @param content_type [String, nil]
+            #   @param content_type [String, nil] Optional content-type declared at upload.
             #
-            #   @param file_size [Integer, nil]
+            #   @param file_size [Integer, nil] Optional size of the file in bytes.
           end
         end
       end
 
       class LicenseKeyConfig < Dodopayments::Internal::Type::BaseModel
         # @!attribute activation_message
+        #   Optional message displayed when a customer activates the license key (≤ 2500
+        #   characters).
         #
         #   @return [String, nil]
         optional :activation_message, String, nil?: true
 
         # @!attribute activations_limit
+        #   Maximum activations allowed per issued license key. Omit for unlimited.
         #
         #   @return [Integer, nil]
         optional :activations_limit, Integer, nil?: true
 
         # @!attribute duration_count
+        #   Validity duration of issued license keys. Provide both `duration_count` and
+        #   `duration_interval` together for a fixed duration; omit both for non-expiring
+        #   keys.
         #
         #   @return [Integer, nil]
         optional :duration_count, Integer, nil?: true
 
         # @!attribute duration_interval
+        #   Unit of `duration_count`.
         #
         #   @return [Symbol, Dodopayments::Models::TimeInterval, nil]
         optional :duration_interval, enum: -> { Dodopayments::TimeInterval }, nil?: true
 
         # @!method initialize(activation_message: nil, activations_limit: nil, duration_count: nil, duration_interval: nil)
-        #   @param activation_message [String, nil]
-        #   @param activations_limit [Integer, nil]
-        #   @param duration_count [Integer, nil]
-        #   @param duration_interval [Symbol, Dodopayments::Models::TimeInterval, nil]
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::IntegrationConfigResponse::LicenseKeyConfig} for more
+        #   details.
+        #
+        #   @param activation_message [String, nil] Optional message displayed when a customer activates the license
+        #
+        #   @param activations_limit [Integer, nil] Maximum activations allowed per issued license key. Omit for unlimited.
+        #
+        #   @param duration_count [Integer, nil] Validity duration of issued license keys. Provide both
+        #
+        #   @param duration_interval [Symbol, Dodopayments::Models::TimeInterval, nil] Unit of `duration_count`.
       end
 
       # @!method self.variants

data/lib/dodopayments/models/license_key_created_webhook_event.rb

@@ -23,29 +23,17 @@ module Dodopayments
       # @!attribute type
       #   The event type
       #
-      #   @return [Symbol, Dodopayments::Models::LicenseKeyCreatedWebhookEvent::Type]
-      required :type, enum: -> { Dodopayments::LicenseKeyCreatedWebhookEvent::Type }
+      #   @return [Symbol, :"license_key.created"]
+      required :type, const: :"license_key.created"
 
-      # @!method initialize(business_id:, data:, timestamp:, type:)
+      # @!method initialize(business_id:, data:, timestamp:, type: :"license_key.created")
       #   @param business_id [String] The business identifier
       #
       #   @param data [Dodopayments::Models::LicenseKey]
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
-      #   @param type [Symbol, Dodopayments::Models::LicenseKeyCreatedWebhookEvent::Type] The event type
-
-      # The event type
-      #
-      # @see Dodopayments::Models::LicenseKeyCreatedWebhookEvent#type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        LICENSE_KEY_CREATED = :"license_key.created"
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #   @param type [Symbol, :"license_key.created"] The event type
     end
   end
 end

data/lib/dodopayments/models/payment.rb

@@ -139,11 +139,21 @@ module Dodopayments
                nil?: true
 
       # @!attribute discount_id
-      #   The discount id if discount is applied
+      #   @deprecated Use `discounts` instead.
+      #
+      #   DEPRECATED: Use discounts instead. Returns the first discount's ID if present.
       #
       #   @return [String, nil]
       optional :discount_id, String, nil?: true
 
+      # @!attribute discounts
+      #   All stacked discounts applied, ordered by position
+      #
+      #   @return [Array<Dodopayments::Models::Payment::Discount>, nil]
+      optional :discounts,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Payment::Discount] },
+               nil?: true
+
       # @!attribute error_code
       #   An error code if the payment failed
       #
@@ -233,7 +243,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :updated_at, Time, nil?: true
 
-      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, metadata:, payment_id:, refunds:, settlement_amount:, settlement_currency:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
+      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, metadata:, payment_id:, refunds:, settlement_amount:, settlement_currency:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Payment} for more details.
       #
@@ -279,7 +289,9 @@ module Dodopayments
       #
       #   @param custom_field_responses [Array<Dodopayments::Models::CustomFieldResponse>, nil] Customer's responses to custom fields collected during checkout
       #
-      #   @param discount_id [String, nil] The discount id if discount is applied
+      #   @param discount_id [String, nil] DEPRECATED: Use discounts instead. Returns the first discount's ID if present.
+      #
+      #   @param discounts [Array<Dodopayments::Models::Payment::Discount>, nil] All stacked discounts applied, ordered by position
       #
       #   @param error_code [String, nil] An error code if the payment failed
       #
@@ -309,6 +321,144 @@ module Dodopayments
       #
       #   @param updated_at [Time, nil] Timestamp when the payment was last updated
 
+      class Discount < Dodopayments::Internal::Type::BaseModel
+        # @!attribute amount
+        #   The discount amount (basis points for percentage, USD cents for flat)
+        #
+        #   @return [Integer]
+        required :amount, Integer
+
+        # @!attribute business_id
+        #   The business this discount belongs to
+        #
+        #   @return [String]
+        required :business_id, String
+
+        # @!attribute code
+        #   The discount code
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute created_at
+        #   Timestamp when the discount was created
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute discount_id
+        #   The unique discount ID
+        #
+        #   @return [String]
+        required :discount_id, String
+
+        # @!attribute metadata
+        #   Additional metadata
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :metadata, Dodopayments::Internal::Type::HashOf[String]
+
+        # @!attribute position
+        #   Position of this discount in the stack (0-based)
+        #
+        #   @return [Integer]
+        required :position, Integer
+
+        # @!attribute preserve_on_plan_change
+        #   Whether this discount should be preserved when a subscription changes plans
+        #
+        #   @return [Boolean]
+        required :preserve_on_plan_change, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute restricted_to
+        #   List of product IDs to which this discount is restricted
+        #
+        #   @return [Array<String>]
+        required :restricted_to, Dodopayments::Internal::Type::ArrayOf[String]
+
+        # @!attribute times_used
+        #   How many times this discount has been used
+        #
+        #   @return [Integer]
+        required :times_used, Integer
+
+        # @!attribute type
+        #   The type of discount
+        #
+        #   @return [Symbol, Dodopayments::Models::DiscountType]
+        required :type, enum: -> { Dodopayments::DiscountType }
+
+        # @!attribute cycles_remaining
+        #   Remaining billing cycles for this discount on this subscription (None for
+        #   one-time payments)
+        #
+        #   @return [Integer, nil]
+        optional :cycles_remaining, Integer, nil?: true
+
+        # @!attribute expires_at
+        #   Optional date/time after which discount is expired
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, nil?: true
+
+        # @!attribute name
+        #   Name for the Discount
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute subscription_cycles
+        #   Number of subscription billing cycles this discount is valid for
+        #
+        #   @return [Integer, nil]
+        optional :subscription_cycles, Integer, nil?: true
+
+        # @!attribute usage_limit
+        #   Usage limit for this discount, if any
+        #
+        #   @return [Integer, nil]
+        optional :usage_limit, Integer, nil?: true
+
+        # @!method initialize(amount:, business_id:, code:, created_at:, discount_id:, metadata:, position:, preserve_on_plan_change:, restricted_to:, times_used:, type:, cycles_remaining: nil, expires_at: nil, name: nil, subscription_cycles: nil, usage_limit: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Payment::Discount} for more details.
+        #
+        #   Response struct for a discount with its position in a stack and optional
+        #   cycle-tracking information (for subscriptions).
+        #
+        #   @param amount [Integer] The discount amount (basis points for percentage, USD cents for flat)
+        #
+        #   @param business_id [String] The business this discount belongs to
+        #
+        #   @param code [String] The discount code
+        #
+        #   @param created_at [Time] Timestamp when the discount was created
+        #
+        #   @param discount_id [String] The unique discount ID
+        #
+        #   @param metadata [Hash{Symbol=>String}] Additional metadata
+        #
+        #   @param position [Integer] Position of this discount in the stack (0-based)
+        #
+        #   @param preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans
+        #
+        #   @param restricted_to [Array<String>] List of product IDs to which this discount is restricted
+        #
+        #   @param times_used [Integer] How many times this discount has been used
+        #
+        #   @param type [Symbol, Dodopayments::Models::DiscountType] The type of discount
+        #
+        #   @param cycles_remaining [Integer, nil] Remaining billing cycles for this discount on this subscription (None for one-ti
+        #
+        #   @param expires_at [Time, nil] Optional date/time after which discount is expired
+        #
+        #   @param name [String, nil] Name for the Discount
+        #
+        #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for
+        #
+        #   @param usage_limit [Integer, nil] Usage limit for this discount, if any
+      end
+
       class ProductCart < Dodopayments::Internal::Type::BaseModel
         # @!attribute product_id
         #

data/lib/dodopayments/models/payment_cancelled_webhook_event.rb

@@ -23,29 +23,17 @@ module Dodopayments
       # @!attribute type
       #   The event type
       #
-      #   @return [Symbol, Dodopayments::Models::PaymentCancelledWebhookEvent::Type]
-      required :type, enum: -> { Dodopayments::PaymentCancelledWebhookEvent::Type }
+      #   @return [Symbol, :"payment.cancelled"]
+      required :type, const: :"payment.cancelled"
 
-      # @!method initialize(business_id:, data:, timestamp:, type:)
+      # @!method initialize(business_id:, data:, timestamp:, type: :"payment.cancelled")
       #   @param business_id [String] The business identifier
       #
       #   @param data [Dodopayments::Models::Payment]
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
-      #   @param type [Symbol, Dodopayments::Models::PaymentCancelledWebhookEvent::Type] The event type
-
-      # The event type
-      #
-      # @see Dodopayments::Models::PaymentCancelledWebhookEvent#type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        PAYMENT_CANCELLED = :"payment.cancelled"
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #   @param type [Symbol, :"payment.cancelled"] The event type
     end
   end
 end

data/lib/dodopayments/models/payment_create_params.rb

@@ -53,11 +53,21 @@ module Dodopayments
       optional :billing_currency, enum: -> { Dodopayments::Currency }, nil?: true
 
       # @!attribute discount_code
-      #   Discount Code to apply to the transaction
+      #   @deprecated Use `discount_id` instead.
+      #
+      #   DEPRECATED: Use discount_codes instead. Cannot be used together with
+      #   discount_codes.
       #
       #   @return [String, nil]
       optional :discount_code, String, nil?: true
 
+      # @!attribute discount_codes
+      #   Stacked discount codes to apply, in order of application. Max 20. Cannot be used
+      #   together with discount_code.
+      #
+      #   @return [Array<String>, nil]
+      optional :discount_codes, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute force_3ds
       #   Override merchant default 3DS behaviour for this payment
       #
@@ -126,7 +136,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(billing:, customer:, product_cart:, adaptive_currency_fees_inclusive: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, payment_link: nil, payment_method_id: nil, redirect_immediately: nil, require_phone_number: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
+      # @!method initialize(billing:, customer:, product_cart:, adaptive_currency_fees_inclusive: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, discount_codes: nil, force_3ds: nil, metadata: nil, payment_link: nil, payment_method_id: nil, redirect_immediately: nil, require_phone_number: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::PaymentCreateParams} for more details.
       #
@@ -142,7 +152,9 @@ module Dodopayments
       #
       #   @param billing_currency [Symbol, Dodopayments::Models::Currency, nil] Fix the currency in which the end customer is billed.
       #
-      #   @param discount_code [String, nil] Discount Code to apply to the transaction
+      #   @param discount_code [String, nil] DEPRECATED: Use discount_codes instead. Cannot be used together with discount_co
+      #
+      #   @param discount_codes [Array<String>, nil] Stacked discount codes to apply, in order of application. Max 20.
       #
       #   @param force_3ds [Boolean, nil] Override merchant default 3DS behaviour for this payment
       #

data/lib/dodopayments/models/payment_create_response.rb

@@ -36,11 +36,20 @@ module Dodopayments
       required :total_amount, Integer
 
       # @!attribute discount_id
-      #   The discount id if discount is applied
+      #   @deprecated Use `discounts` instead.
+      #
+      #   DEPRECATED: Use discount_ids instead. Returns the first discount's ID if
+      #   present.
       #
       #   @return [String, nil]
       optional :discount_id, String, nil?: true
 
+      # @!attribute discount_ids
+      #   All stacked discount IDs applied, in order of application
+      #
+      #   @return [Array<String>, nil]
+      optional :discount_ids, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute expires_on
       #   Expiry timestamp of the payment link
       #
@@ -61,7 +70,7 @@ module Dodopayments
                -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::OneTimeProductCartItem] },
                nil?: true
 
-      # @!method initialize(client_secret:, customer:, metadata:, payment_id:, total_amount:, discount_id: nil, expires_on: nil, payment_link: nil, product_cart: nil)
+      # @!method initialize(client_secret:, customer:, metadata:, payment_id:, total_amount:, discount_id: nil, discount_ids: nil, expires_on: nil, payment_link: nil, product_cart: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::PaymentCreateResponse} for more details.
       #
@@ -75,7 +84,9 @@ module Dodopayments
       #
       #   @param total_amount [Integer] Total amount of the payment in smallest currency unit (e.g. cents)
       #
-      #   @param discount_id [String, nil] The discount id if discount is applied
+      #   @param discount_id [String, nil] DEPRECATED: Use discount_ids instead. Returns the first discount's ID if present
+      #
+      #   @param discount_ids [Array<String>, nil] All stacked discount IDs applied, in order of application
       #
       #   @param expires_on [Time, nil] Expiry timestamp of the payment link
       #