dodopayments 1.71.1 → 1.73.0

data/rbi/dodopayments/models/payment_method_types.rbi

@@ -9,205 +9,37 @@ module Dodopayments
         T.type_alias { T.all(Symbol, Dodopayments::PaymentMethodTypes) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-      ACH = T.let(:ach, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      AFFIRM = T.let(:affirm, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      AFTERPAY_CLEARPAY =
-        T.let(
-          :afterpay_clearpay,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ALFAMART =
-        T.let(:alfamart, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ALI_PAY = T.let(:ali_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ALI_PAY_HK =
-        T.let(:ali_pay_hk, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ALMA = T.let(:alma, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      AMAZON_PAY =
-        T.let(:amazon_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      CREDIT = T.let(:credit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      DEBIT = T.let(:debit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      UPI_COLLECT =
+        T.let(:upi_collect, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      UPI_INTENT =
+        T.let(:upi_intent, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       APPLE_PAY =
         T.let(:apple_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ATOME = T.let(:atome, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BACS = T.let(:bacs, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BANCONTACT_CARD =
-        T.let(:bancontact_card, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BECS = T.let(:becs, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BENEFIT = T.let(:benefit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BIZUM = T.let(:bizum, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BLIK = T.let(:blik, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BOLETO = T.let(:boleto, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BCA_BANK_TRANSFER =
-        T.let(
-          :bca_bank_transfer,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      BNI_VA = T.let(:bni_va, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      BRI_VA = T.let(:bri_va, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      CARD_REDIRECT =
-        T.let(:card_redirect, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      CIMB_VA = T.let(:cimb_va, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      CLASSIC = T.let(:classic, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      CREDIT = T.let(:credit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      CRYPTO_CURRENCY =
-        T.let(:crypto_currency, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       CASHAPP = T.let(:cashapp, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      DANA = T.let(:dana, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      DANAMON_VA =
-        T.let(:danamon_va, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      DEBIT = T.let(:debit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      DUIT_NOW =
-        T.let(:duit_now, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      EFECTY = T.let(:efecty, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      EFT = T.let(:eft, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      EPS = T.let(:eps, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      FPS = T.let(:fps, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      EVOUCHER =
-        T.let(:evoucher, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      GIROPAY = T.let(:giropay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      GIVEX = T.let(:givex, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       GOOGLE_PAY =
         T.let(:google_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      GO_PAY = T.let(:go_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      GCASH = T.let(:gcash, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      IDEAL = T.let(:ideal, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      INTERAC = T.let(:interac, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      INDOMARET =
-        T.let(:indomaret, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      KLARNA = T.let(:klarna, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      KAKAO_PAY =
-        T.let(:kakao_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      LOCAL_BANK_REDIRECT =
-        T.let(
-          :local_bank_redirect,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      MANDIRI_VA =
-        T.let(:mandiri_va, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      KNET = T.let(:knet, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      MB_WAY = T.let(:mb_way, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      MOBILE_PAY =
-        T.let(:mobile_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      MOMO = T.let(:momo, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      MOMO_ATM =
-        T.let(:momo_atm, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       MULTIBANCO =
         T.let(:multibanco, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ONLINE_BANKING_THAILAND =
-        T.let(
-          :online_banking_thailand,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ONLINE_BANKING_CZECH_REPUBLIC =
-        T.let(
-          :online_banking_czech_republic,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ONLINE_BANKING_FINLAND =
-        T.let(
-          :online_banking_finland,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ONLINE_BANKING_FPX =
-        T.let(
-          :online_banking_fpx,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ONLINE_BANKING_POLAND =
-        T.let(
-          :online_banking_poland,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      ONLINE_BANKING_SLOVAKIA =
-        T.let(
-          :online_banking_slovakia,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      OXXO = T.let(:oxxo, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAGO_EFECTIVO =
-        T.let(:pago_efectivo, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PERMATA_BANK_TRANSFER =
-        T.let(
-          :permata_bank_transfer,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      OPEN_BANKING_UK =
-        T.let(:open_banking_uk, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAY_BRIGHT =
-        T.let(:pay_bright, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAYPAL = T.let(:paypal, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAZE = T.let(:paze, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PIX = T.let(:pix, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAY_SAFE_CARD =
-        T.let(:pay_safe_card, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      BANCONTACT_CARD =
+        T.let(:bancontact_card, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      EPS = T.let(:eps, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      IDEAL = T.let(:ideal, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       PRZELEWY24 =
         T.let(:przelewy24, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PROMPT_PAY =
-        T.let(:prompt_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PSE = T.let(:pse, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      RED_COMPRA =
-        T.let(:red_compra, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      RED_PAGOS =
-        T.let(:red_pagos, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SAMSUNG_PAY =
-        T.let(:samsung_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      PAYPAL = T.let(:paypal, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      AFFIRM = T.let(:affirm, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      KLARNA = T.let(:klarna, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       SEPA = T.let(:sepa, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SEPA_BANK_TRANSFER =
-        T.let(
-          :sepa_bank_transfer,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      SOFORT = T.let(:sofort, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SWISH = T.let(:swish, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      TOUCH_N_GO =
-        T.let(:touch_n_go, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      TRUSTLY = T.let(:trustly, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      TWINT = T.let(:twint, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      UPI_COLLECT =
-        T.let(:upi_collect, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      UPI_INTENT =
-        T.let(:upi_intent, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      VIPPS = T.let(:vipps, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      VIET_QR = T.let(:viet_qr, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      VENMO = T.let(:venmo, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      WALLEY = T.let(:walley, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      WE_CHAT_PAY =
-        T.let(:we_chat_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SEVEN_ELEVEN =
-        T.let(:seven_eleven, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      LAWSON = T.let(:lawson, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      MINI_STOP =
-        T.let(:mini_stop, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      FAMILY_MART =
-        T.let(:family_mart, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SEICOMART =
-        T.let(:seicomart, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAY_EASY =
-        T.let(:pay_easy, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      LOCAL_BANK_TRANSFER =
-        T.let(
-          :local_bank_transfer,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      MIFINITY =
-        T.let(:mifinity, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      OPEN_BANKING_PIS =
-        T.let(:open_banking_pis, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      DIRECT_CARRIER_BILLING =
-        T.let(
-          :direct_carrier_billing,
-          Dodopayments::PaymentMethodTypes::TaggedSymbol
-        )
-      INSTANT_BANK_TRANSFER =
+      ACH = T.let(:ach, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      AMAZON_PAY =
+        T.let(:amazon_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
+      AFTERPAY_CLEARPAY =
         T.let(
-          :instant_bank_transfer,
+          :afterpay_clearpay,
           Dodopayments::PaymentMethodTypes::TaggedSymbol
         )
-      BILLIE = T.let(:billie, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      ZIP = T.let(:zip, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      REVOLUT_PAY =
-        T.let(:revolut_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      NAVER_PAY =
-        T.let(:naver_pay, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      PAYCO = T.let(:payco, Dodopayments::PaymentMethodTypes::TaggedSymbol)
 
       sig do
         override.returns(

data/rbi/dodopayments/models/product.rbi

@@ -94,6 +94,10 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
+      # The product collection ID this product belongs to, if any
+      sig { returns(T.nilable(String)) }
+      attr_accessor :product_collection_id
+
       sig do
         params(
           brand_id: String,
@@ -120,7 +124,8 @@ module Dodopayments
           license_key_activations_limit: T.nilable(Integer),
           license_key_duration:
             T.nilable(Dodopayments::LicenseKeyDuration::OrHash),
-          name: T.nilable(String)
+          name: T.nilable(String),
+          product_collection_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -157,7 +162,9 @@ module Dodopayments
         # Duration of the license key validity, if enabled.
         license_key_duration: nil,
         # Name of the product, optional.
-        name: nil
+        name: nil,
+        # The product collection ID this product belongs to, if any
+        product_collection_id: nil
       )
       end
 
@@ -182,7 +189,8 @@ module Dodopayments
             license_key_activation_message: T.nilable(String),
             license_key_activations_limit: T.nilable(Integer),
             license_key_duration: T.nilable(Dodopayments::LicenseKeyDuration),
-            name: T.nilable(String)
+            name: T.nilable(String),
+            product_collection_id: T.nilable(String)
           }
         )
       end

data/rbi/dodopayments/models/subscription_change_plan_params.rbi

@@ -35,6 +35,11 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::AttachAddon])) }
       attr_accessor :addons
 
+      # Metadata for the payment. If not passed, the metadata of the subscription will
+      # be taken
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_accessor :metadata
+
       sig do
         params(
           product_id: String,
@@ -42,6 +47,7 @@ module Dodopayments
             Dodopayments::SubscriptionChangePlanParams::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          metadata: T.nilable(T::Hash[Symbol, String]),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -55,6 +61,9 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Metadata for the payment. If not passed, the metadata of the subscription will
+        # be taken
+        metadata: nil,
         request_options: {}
       )
       end
@@ -67,6 +76,7 @@ module Dodopayments
               Dodopayments::SubscriptionChangePlanParams::ProrationBillingMode::OrSymbol,
             quantity: Integer,
             addons: T.nilable(T::Array[Dodopayments::AttachAddon]),
+            metadata: T.nilable(T::Hash[Symbol, String]),
             request_options: Dodopayments::RequestOptions
           }
         )

data/rbi/dodopayments/models/subscription_preview_change_plan_params.rbi

@@ -35,6 +35,11 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::AttachAddon])) }
       attr_accessor :addons
 
+      # Metadata for the payment. If not passed, the metadata of the subscription will
+      # be taken
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_accessor :metadata
+
       sig do
         params(
           product_id: String,
@@ -42,6 +47,7 @@ module Dodopayments
             Dodopayments::SubscriptionPreviewChangePlanParams::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          metadata: T.nilable(T::Hash[Symbol, String]),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -55,6 +61,9 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Metadata for the payment. If not passed, the metadata of the subscription will
+        # be taken
+        metadata: nil,
         request_options: {}
       )
       end
@@ -67,6 +76,7 @@ module Dodopayments
               Dodopayments::SubscriptionPreviewChangePlanParams::ProrationBillingMode::OrSymbol,
             quantity: Integer,
             addons: T.nilable(T::Array[Dodopayments::AttachAddon]),
+            metadata: T.nilable(T::Hash[Symbol, String]),
             request_options: Dodopayments::RequestOptions
           }
         )

data/rbi/dodopayments/models.rbi

@@ -38,6 +38,9 @@ module Dodopayments
   CheckoutSessionCreateParams =
     Dodopayments::Models::CheckoutSessionCreateParams
 
+  CheckoutSessionPreviewParams =
+    Dodopayments::Models::CheckoutSessionPreviewParams
+
   CheckoutSessionRequest = Dodopayments::Models::CheckoutSessionRequest
 
   CheckoutSessionResponse = Dodopayments::Models::CheckoutSessionResponse
@@ -82,6 +85,9 @@ module Dodopayments
 
   DiscountListParams = Dodopayments::Models::DiscountListParams
 
+  DiscountRetrieveByCodeParams =
+    Dodopayments::Models::DiscountRetrieveByCodeParams
+
   DiscountRetrieveParams = Dodopayments::Models::DiscountRetrieveParams
 
   DiscountType = Dodopayments::Models::DiscountType

data/rbi/dodopayments/resources/checkout_sessions.rbi

@@ -31,6 +31,7 @@ module Dodopayments
           metadata: T.nilable(T::Hash[Symbol, String]),
           minimal_address: T::Boolean,
           payment_method_id: T.nilable(String),
+          product_collection_id: T.nilable(String),
           return_url: T.nilable(String),
           short_link: T::Boolean,
           show_saved_payment_methods: T::Boolean,
@@ -74,6 +75,8 @@ module Dodopayments
         # Optional payment method ID to use for this checkout session. Only allowed when
         # `confirm` is true. If provided, existing customer id must also be provided.
         payment_method_id: nil,
+        # Product collection ID for collection-based checkout flow
+        product_collection_id: nil,
         # The url to redirect after payment failure or success.
         return_url: nil,
         # If true, returns a shortened checkout URL. Defaults to false if not specified.
@@ -94,6 +97,91 @@ module Dodopayments
       def retrieve(id, request_options: {})
       end
 
+      sig do
+        params(
+          product_cart:
+            T::Array[Dodopayments::CheckoutSessionRequest::ProductCart::OrHash],
+          allowed_payment_method_types:
+            T.nilable(T::Array[Dodopayments::PaymentMethodTypes::OrSymbol]),
+          billing_address:
+            T.nilable(
+              Dodopayments::CheckoutSessionRequest::BillingAddress::OrHash
+            ),
+          billing_currency: T.nilable(Dodopayments::Currency::OrSymbol),
+          confirm: T::Boolean,
+          customer:
+            T.nilable(
+              T.any(
+                Dodopayments::AttachExistingCustomer::OrHash,
+                Dodopayments::NewCustomer::OrHash
+              )
+            ),
+          customization:
+            Dodopayments::CheckoutSessionRequest::Customization::OrHash,
+          discount_code: T.nilable(String),
+          feature_flags:
+            Dodopayments::CheckoutSessionRequest::FeatureFlags::OrHash,
+          force_3ds: T.nilable(T::Boolean),
+          metadata: T.nilable(T::Hash[Symbol, String]),
+          minimal_address: T::Boolean,
+          payment_method_id: T.nilable(String),
+          product_collection_id: T.nilable(String),
+          return_url: T.nilable(String),
+          short_link: T::Boolean,
+          show_saved_payment_methods: T::Boolean,
+          subscription_data:
+            T.nilable(
+              Dodopayments::CheckoutSessionRequest::SubscriptionData::OrHash
+            ),
+          request_options: Dodopayments::RequestOptions::OrHash
+        ).returns(Dodopayments::Models::CheckoutSessionPreviewResponse)
+      end
+      def preview(
+        product_cart:,
+        # Customers will never see payment methods that are not in this list. However,
+        # adding a method here does not guarantee customers will see it. Availability
+        # still depends on other factors (e.g., customer location, merchant settings).
+        #
+        # Disclaimar: Always provide 'credit' and 'debit' as a fallback. If all payment
+        # methods are unavailable, checkout session will fail.
+        allowed_payment_method_types: nil,
+        # Billing address information for the session
+        billing_address: nil,
+        # This field is ingored if adaptive pricing is disabled
+        billing_currency: nil,
+        # If confirm is true, all the details will be finalized. If required data is
+        # missing, an API error is thrown.
+        confirm: nil,
+        # Customer details for the session
+        customer: nil,
+        # Customization for the checkout session page
+        customization: nil,
+        discount_code: nil,
+        feature_flags: nil,
+        # Override merchant default 3DS behaviour for this session
+        force_3ds: nil,
+        # Additional metadata associated with the payment. Defaults to empty if not
+        # provided.
+        metadata: nil,
+        # If true, only zipcode is required when confirm is true; other address fields
+        # remain optional
+        minimal_address: nil,
+        # Optional payment method ID to use for this checkout session. Only allowed when
+        # `confirm` is true. If provided, existing customer id must also be provided.
+        payment_method_id: nil,
+        # Product collection ID for collection-based checkout flow
+        product_collection_id: nil,
+        # The url to redirect after payment failure or success.
+        return_url: nil,
+        # If true, returns a shortened checkout URL. Defaults to false if not specified.
+        short_link: nil,
+        # Display saved payment methods of a returning customer False by default
+        show_saved_payment_methods: nil,
+        subscription_data: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Dodopayments::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/dodopayments/resources/discounts.rbi

@@ -143,6 +143,22 @@ module Dodopayments
       )
       end
 
+      # Validate and fetch a discount by its code name (e.g., "SAVE20"). This allows
+      # real-time validation directly against the API using the human-readable discount
+      # code instead of requiring the internal discount_id.
+      sig do
+        params(
+          code: String,
+          request_options: Dodopayments::RequestOptions::OrHash
+        ).returns(Dodopayments::Discount)
+      end
+      def retrieve_by_code(
+        # The discount code (e.g., 'SAVE20')
+        code,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Dodopayments::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -179,6 +179,7 @@ module Dodopayments
             Dodopayments::SubscriptionChangePlanParams::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          metadata: T.nilable(T::Hash[Symbol, String]),
           request_options: Dodopayments::RequestOptions::OrHash
         ).void
       end
@@ -194,6 +195,9 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Metadata for the payment. If not passed, the metadata of the subscription will
+        # be taken
+        metadata: nil,
         request_options: {}
       )
       end
@@ -246,6 +250,7 @@ module Dodopayments
             Dodopayments::SubscriptionPreviewChangePlanParams::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          metadata: T.nilable(T::Hash[Symbol, String]),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(Dodopayments::Models::SubscriptionPreviewChangePlanResponse)
       end
@@ -261,6 +266,9 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Metadata for the payment. If not passed, the metadata of the subscription will
+        # be taken
+        metadata: nil,
         request_options: {}
       )
       end

data/sig/dodopayments/models/checkout_session_preview_params.rbs

@@ -0,0 +1,15 @@
+module Dodopayments
+  module Models
+    type checkout_session_preview_params =
+      {  } & Dodopayments::Internal::Type::request_parameters
+
+    class CheckoutSessionPreviewParams < Dodopayments::Models::CheckoutSessionRequest
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      def initialize: (?request_options: Dodopayments::request_opts) -> void
+
+      def to_hash: -> { request_options: Dodopayments::RequestOptions }
+    end
+  end
+end