dodopayments 1.68.0 → 1.70.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbc5ebc492dd27b97a18b069e5dafdb0f4699ac2a17723fb53ba75ad64349fdb
-  data.tar.gz: 35f1af6bd6e7b96d17abd850f7f02b70f69743ba499183ad3c4777a3bc87e346
+  metadata.gz: 7932166a1d9dd3a1c92b74bba30f1e90185636d1ff275a488d0a6ec947dfe40f
+  data.tar.gz: 41746077380ff697dc721bbf0b7eb83c3f17a1c500e47f94847b69f0e4627b20
 SHA512:
-  metadata.gz: d69b3e9b87777621c52503650d511596a94851382cd5d8334a008df9062aa7566a8f28a837c0b0a79115c073e99c5251c8a0eecc88043ab22431276fbc2b7f1a
-  data.tar.gz: 78ad85f5dc0512ac803e47dffa6fa96968138db519cdf8cbc95b1e6843162b7ae27dcb371962ea2d1abf2f63c064d23aa257f1c0d0845d2e446267382170edf4
+  metadata.gz: 288ad614c3627a92156c49ba02528256b8ba9e61ece9cfd94c55c8b2aa75ba567d57a443d1d517fa54967f273fc599927486c37114b70c90dde316c785fba26a
+  data.tar.gz: 5676e86af86d993869af700970ad3c6fa1b1a63cdec0014820d708ccbb078d0ee09c7bf0fe164aa6d2cb564d87db6bc32cd18303f9f6830dbf1a99889161d8a5

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.70.0 (2025-12-23)
+
+Full Changelog: [v1.69.0...v1.70.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.69.0...v1.70.0)
+
+### Features
+
+* **api:** manual updates ([83dc45a](https://github.com/dodopayments/dodopayments-ruby/commit/83dc45ae1eae356bc67e34c4eedb01390ff621e5))
+
+## 1.69.0 (2025-12-23)
+
+Full Changelog: [v1.68.0...v1.69.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.68.0...v1.69.0)
+
+### Features
+
+* **api:** manual updates ([702b110](https://github.com/dodopayments/dodopayments-ruby/commit/702b110a222abca719163c70b74ac5be66bee79f))
+
 ## 1.68.0 (2025-12-19)
 
 Full Changelog: [v1.67.2...v1.68.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.67.2...v1.68.0)

data/README.md

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

data/lib/dodopayments/models/checkout_session_request.rb

@@ -83,6 +83,13 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :minimal_address, Dodopayments::Internal::Type::Boolean
 
+      # @!attribute payment_method_id
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :payment_method_id, String, nil?: true
+
       # @!attribute return_url
       #   The url to redirect after payment failure or success.
       #
@@ -106,7 +113,7 @@ module Dodopayments
       #   @return [Dodopayments::Models::CheckoutSessionRequest::SubscriptionData, nil]
       optional :subscription_data, -> { Dodopayments::CheckoutSessionRequest::SubscriptionData }, nil?: true
 
-      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil)
+      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionRequest} for more details.
       #
@@ -134,6 +141,8 @@ module Dodopayments
       #
       #   @param minimal_address [Boolean] If true, only zipcode is required when confirm is true; other address fields rem
       #
+      #   @param payment_method_id [String, nil] Optional payment method ID to use for this checkout session.
+      #
       #   @param return_url [String, nil] The url to redirect after payment failure or success.
       #
       #   @param short_link [Boolean] If true, returns a shortened checkout URL.

data/lib/dodopayments/models/checkout_session_response.rb

@@ -4,22 +4,22 @@ module Dodopayments
   module Models
     # @see Dodopayments::Resources::CheckoutSessions#create
     class CheckoutSessionResponse < Dodopayments::Internal::Type::BaseModel
-      # @!attribute checkout_url
-      #   Checkout url
-      #
-      #   @return [String]
-      required :checkout_url, String
-
       # @!attribute session_id
       #   The ID of the created checkout session
       #
       #   @return [String]
       required :session_id, String
 
-      # @!method initialize(checkout_url:, session_id:)
-      #   @param checkout_url [String] Checkout url
+      # @!attribute checkout_url
+      #   Checkout url (None when payment_method_id is provided)
       #
+      #   @return [String, nil]
+      optional :checkout_url, String, nil?: true
+
+      # @!method initialize(session_id:, checkout_url: nil)
       #   @param session_id [String] The ID of the created checkout session
+      #
+      #   @param checkout_url [String, nil] Checkout url (None when payment_method_id is provided)
     end
   end
 end

data/lib/dodopayments/models/payment_create_params.rb

@@ -70,6 +70,14 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :payment_link, Dodopayments::Internal::Type::Boolean, nil?: true
 
+      # @!attribute payment_method_id
+      #   Optional payment method ID to use for this payment. If provided, customer_id
+      #   must also be provided. The payment method will be validated for eligibility with
+      #   the payment's currency.
+      #
+      #   @return [String, nil]
+      optional :payment_method_id, String, nil?: true
+
       # @!attribute redirect_immediately
       #   If true, redirects the customer immediately after payment completion False by
       #   default
@@ -103,7 +111,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(billing:, customer:, product_cart:, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, payment_link: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
+      # @!method initialize(billing:, customer:, product_cart:, 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, 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.
       #
@@ -125,6 +133,8 @@ module Dodopayments
       #
       #   @param payment_link [Boolean, nil] Whether to generate a payment link. Defaults to false if not specified.
       #
+      #   @param payment_method_id [String, nil] Optional payment method ID to use for this payment.
+      #
       #   @param redirect_immediately [Boolean] If true, redirects the customer immediately after payment completion
       #
       #   @param return_url [String, nil] Optional URL to redirect the customer after payment.

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::ShortLinks#create
+      class ShortLinkCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute slug
+        #   Slug for the short link.
+        #
+        #   @return [String]
+        required :slug, String
+
+        # @!attribute static_checkout_params
+        #   Static Checkout URL parameters to apply to the resulting short URL.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :static_checkout_params, Dodopayments::Internal::Type::HashOf[String], nil?: true
+
+        # @!method initialize(slug:, static_checkout_params: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Products::ShortLinkCreateParams} for more details.
+        #
+        #   @param slug [String] Slug for the short link.
+        #
+        #   @param static_checkout_params [Hash{Symbol=>String}, nil] Static Checkout URL parameters to apply to the resulting
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::ShortLinks#create
+      class ShortLinkCreateResponse < Dodopayments::Internal::Type::BaseModel
+        # @!attribute full_url
+        #   Full URL.
+        #
+        #   @return [String]
+        required :full_url, String
+
+        # @!attribute short_url
+        #   Short URL.
+        #
+        #   @return [String]
+        required :short_url, String
+
+        # @!method initialize(full_url:, short_url:)
+        #   @param full_url [String] Full URL.
+        #
+        #   @param short_url [String] Short URL.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::ShortLinks#list
+      class ShortLinkListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute page_number
+        #   Page number default is 0
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Page size default is 10 max is 100
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!attribute product_id
+        #   Filter by product ID
+        #
+        #   @return [String, nil]
+        optional :product_id, String
+
+        # @!method initialize(page_number: nil, page_size: nil, product_id: nil, request_options: {})
+        #   @param page_number [Integer] Page number default is 0
+        #
+        #   @param page_size [Integer] Page size default is 10 max is 100
+        #
+        #   @param product_id [String] Filter by product ID
+        #
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Products
+      # @see Dodopayments::Resources::Products::ShortLinks#list
+      class ShortLinkListResponse < Dodopayments::Internal::Type::BaseModel
+        # @!attribute created_at
+        #   When the short url was created
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute full_url
+        #   Full URL the short url redirects to
+        #
+        #   @return [String]
+        required :full_url, String
+
+        # @!attribute product_id
+        #   Product ID associated with the short link
+        #
+        #   @return [String]
+        required :product_id, String
+
+        # @!attribute short_url
+        #   Short URL
+        #
+        #   @return [String]
+        required :short_url, String
+
+        # @!method initialize(created_at:, full_url:, product_id:, short_url:)
+        #   @param created_at [Time] When the short url was created
+        #
+        #   @param full_url [String] Full URL the short url redirects to
+        #
+        #   @param product_id [String] Product ID associated with the short link
+        #
+        #   @param short_url [String] Short URL
+      end
+    end
+  end
+end

data/lib/dodopayments/models/subscription_create_params.rb

@@ -95,6 +95,14 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :payment_link, Dodopayments::Internal::Type::Boolean, nil?: true
 
+      # @!attribute payment_method_id
+      #   Optional payment method ID to use for this subscription. If provided,
+      #   customer_id must also be provided (via AttachExistingCustomer). The payment
+      #   method will be validated for eligibility with the subscription's currency.
+      #
+      #   @return [String, nil]
+      optional :payment_method_id, String, nil?: true
+
       # @!attribute redirect_immediately
       #   If true, redirects the customer immediately after payment completion False by
       #   default
@@ -134,7 +142,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :trial_period_days, Integer, nil?: true
 
-      # @!method initialize(billing:, customer:, product_id:, quantity:, addons: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, on_demand: nil, one_time_product_cart: nil, payment_link: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, trial_period_days: nil, request_options: {})
+      # @!method initialize(billing:, customer:, product_id:, quantity:, addons: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, on_demand: nil, one_time_product_cart: nil, payment_link: nil, payment_method_id: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, trial_period_days: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::SubscriptionCreateParams} for more details.
       #
@@ -164,6 +172,8 @@ module Dodopayments
       #
       #   @param payment_link [Boolean, nil] If true, generates a payment link.
       #
+      #   @param payment_method_id [String, nil] Optional payment method ID to use for this subscription.
+      #
       #   @param redirect_immediately [Boolean] If true, redirects the customer immediately after payment completion
       #
       #   @param return_url [String, nil] Optional URL to redirect after successful subscription creation

data/lib/dodopayments/resources/checkout_sessions.rb

@@ -6,7 +6,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::CheckoutSessionCreateParams} for more details.
       #
-      # @overload create(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, request_options: {})
+      # @overload create(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, request_options: {})
       #
       # @param product_cart [Array<Dodopayments::Models::CheckoutSessionRequest::ProductCart>]
       #
@@ -32,6 +32,8 @@ module Dodopayments
       #
       # @param minimal_address [Boolean] If true, only zipcode is required when confirm is true; other address fields rem
       #
+      # @param payment_method_id [String, nil] Optional payment method ID to use for this checkout session.
+      #
       # @param return_url [String, nil] The url to redirect after payment failure or success.
       #
       # @param short_link [Boolean] If true, returns a shortened checkout URL.

data/lib/dodopayments/resources/payments.rb

@@ -8,7 +8,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::PaymentCreateParams} for more details.
       #
-      # @overload create(billing:, customer:, product_cart:, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, payment_link: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
+      # @overload create(billing:, customer:, product_cart:, 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, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
       #
       # @param billing [Dodopayments::Models::BillingAddress] Billing address details for the payment
       #
@@ -28,6 +28,8 @@ module Dodopayments
       #
       # @param payment_link [Boolean, nil] Whether to generate a payment link. Defaults to false if not specified.
       #
+      # @param payment_method_id [String, nil] Optional payment method ID to use for this payment.
+      #
       # @param redirect_immediately [Boolean] If true, redirects the customer immediately after payment completion
       #
       # @param return_url [String, nil] Optional URL to redirect the customer after payment.

data/lib/dodopayments/resources/products/short_links.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Resources
+    class Products
+      class ShortLinks
+        # Some parameter documentations has been truncated, see
+        # {Dodopayments::Models::Products::ShortLinkCreateParams} for more details.
+        #
+        # Gives a Short Checkout URL with custom slug for a product. Uses a Static
+        # Checkout URL under the hood.
+        #
+        # @overload create(id, slug:, static_checkout_params: nil, request_options: {})
+        #
+        # @param id [String] Product Id
+        #
+        # @param slug [String] Slug for the short link.
+        #
+        # @param static_checkout_params [Hash{Symbol=>String}, nil] Static Checkout URL parameters to apply to the resulting
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Dodopayments::Models::Products::ShortLinkCreateResponse]
+        #
+        # @see Dodopayments::Models::Products::ShortLinkCreateParams
+        def create(id, params)
+          parsed, options = Dodopayments::Products::ShortLinkCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["products/%1$s/short_links", id],
+            body: parsed,
+            model: Dodopayments::Models::Products::ShortLinkCreateResponse,
+            options: options
+          )
+        end
+
+        # Lists all short links created by the business.
+        #
+        # @overload list(page_number: nil, page_size: nil, product_id: nil, request_options: {})
+        #
+        # @param page_number [Integer] Page number default is 0
+        #
+        # @param page_size [Integer] Page size default is 10 max is 100
+        #
+        # @param product_id [String] Filter by product ID
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Dodopayments::Internal::DefaultPageNumberPagination<Dodopayments::Models::Products::ShortLinkListResponse>]
+        #
+        # @see Dodopayments::Models::Products::ShortLinkListParams
+        def list(params = {})
+          parsed, options = Dodopayments::Products::ShortLinkListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: "products/short_links",
+            query: parsed,
+            page: Dodopayments::Internal::DefaultPageNumberPagination,
+            model: Dodopayments::Models::Products::ShortLinkListResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Dodopayments::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/resources/products.rb

@@ -6,6 +6,9 @@ module Dodopayments
       # @return [Dodopayments::Resources::Products::Images]
       attr_reader :images
 
+      # @return [Dodopayments::Resources::Products::ShortLinks]
+      attr_reader :short_links
+
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::ProductCreateParams} for more details.
       #
@@ -212,6 +215,7 @@ module Dodopayments
       def initialize(client:)
         @client = client
         @images = Dodopayments::Resources::Products::Images.new(client: client)
+        @short_links = Dodopayments::Resources::Products::ShortLinks.new(client: client)
       end
     end
   end

data/lib/dodopayments/resources/subscriptions.rb

@@ -8,7 +8,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::SubscriptionCreateParams} for more details.
       #
-      # @overload create(billing:, customer:, product_id:, quantity:, addons: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, on_demand: nil, one_time_product_cart: nil, payment_link: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, trial_period_days: nil, request_options: {})
+      # @overload create(billing:, customer:, product_id:, quantity:, addons: nil, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, force_3ds: nil, metadata: nil, on_demand: nil, one_time_product_cart: nil, payment_link: nil, payment_method_id: nil, redirect_immediately: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, tax_id: nil, trial_period_days: nil, request_options: {})
       #
       # @param billing [Dodopayments::Models::BillingAddress] Billing address information for the subscription
       #
@@ -36,6 +36,8 @@ module Dodopayments
       #
       # @param payment_link [Boolean, nil] If true, generates a payment link.
       #
+      # @param payment_method_id [String, nil] Optional payment method ID to use for this subscription.
+      #
       # @param redirect_immediately [Boolean] If true, redirects the customer immediately after payment completion
       #
       # @param return_url [String, nil] Optional URL to redirect after successful subscription creation

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "1.68.0"
+  VERSION = "1.70.0"
 end

data/lib/dodopayments.rb

@@ -192,6 +192,10 @@ require_relative "dodopayments/models/product_list_response"
 require_relative "dodopayments/models/product_retrieve_params"
 require_relative "dodopayments/models/products/image_update_params"
 require_relative "dodopayments/models/products/image_update_response"
+require_relative "dodopayments/models/products/short_link_create_params"
+require_relative "dodopayments/models/products/short_link_create_response"
+require_relative "dodopayments/models/products/short_link_list_params"
+require_relative "dodopayments/models/products/short_link_list_response"
 require_relative "dodopayments/models/product_unarchive_params"
 require_relative "dodopayments/models/product_update_files_params"
 require_relative "dodopayments/models/product_update_files_response"
@@ -281,6 +285,7 @@ require_relative "dodopayments/resources/payments"
 require_relative "dodopayments/resources/payouts"
 require_relative "dodopayments/resources/products"
 require_relative "dodopayments/resources/products/images"
+require_relative "dodopayments/resources/products/short_links"
 require_relative "dodopayments/resources/refunds"
 require_relative "dodopayments/resources/subscriptions"
 require_relative "dodopayments/resources/usage_events"

data/rbi/dodopayments/models/checkout_session_request.rbi

@@ -115,6 +115,11 @@ module Dodopayments
       sig { params(minimal_address: T::Boolean).void }
       attr_writer :minimal_address
 
+      # 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.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :payment_method_id
+
       # The url to redirect after payment failure or success.
       sig { returns(T.nilable(String)) }
       attr_accessor :return_url
@@ -177,6 +182,7 @@ module Dodopayments
           force_3ds: T.nilable(T::Boolean),
           metadata: T.nilable(T::Hash[Symbol, String]),
           minimal_address: T::Boolean,
+          payment_method_id: T.nilable(String),
           return_url: T.nilable(String),
           short_link: T::Boolean,
           show_saved_payment_methods: T::Boolean,
@@ -216,6 +222,9 @@ module Dodopayments
         # 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,
         # 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.
@@ -250,6 +259,7 @@ module Dodopayments
             force_3ds: T.nilable(T::Boolean),
             metadata: T.nilable(T::Hash[Symbol, String]),
             minimal_address: T::Boolean,
+            payment_method_id: T.nilable(String),
             return_url: T.nilable(String),
             short_link: T::Boolean,
             show_saved_payment_methods: T::Boolean,

data/rbi/dodopayments/models/checkout_session_response.rbi

@@ -11,28 +11,32 @@ module Dodopayments
           )
         end
 
-      # Checkout url
-      sig { returns(String) }
-      attr_accessor :checkout_url
-
       # The ID of the created checkout session
       sig { returns(String) }
       attr_accessor :session_id
 
+      # Checkout url (None when payment_method_id is provided)
+      sig { returns(T.nilable(String)) }
+      attr_accessor :checkout_url
+
       sig do
-        params(checkout_url: String, session_id: String).returns(
+        params(session_id: String, checkout_url: T.nilable(String)).returns(
           T.attached_class
         )
       end
       def self.new(
-        # Checkout url
-        checkout_url:,
         # The ID of the created checkout session
-        session_id:
+        session_id:,
+        # Checkout url (None when payment_method_id is provided)
+        checkout_url: nil
       )
       end
 
-      sig { override.returns({ checkout_url: String, session_id: String }) }
+      sig do
+        override.returns(
+          { session_id: String, checkout_url: T.nilable(String) }
+        )
+      end
       def to_hash
       end
     end

data/rbi/dodopayments/models/payment_create_params.rbi

@@ -69,6 +69,12 @@ module Dodopayments
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :payment_link
 
+      # Optional payment method ID to use for this payment. If provided, customer_id
+      # must also be provided. The payment method will be validated for eligibility with
+      # the payment's currency.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :payment_method_id
+
       # If true, redirects the customer immediately after payment completion False by
       # default
       sig { returns(T.nilable(T::Boolean)) }
@@ -114,6 +120,7 @@ module Dodopayments
           force_3ds: T.nilable(T::Boolean),
           metadata: T::Hash[Symbol, String],
           payment_link: T.nilable(T::Boolean),
+          payment_method_id: T.nilable(String),
           redirect_immediately: T::Boolean,
           return_url: T.nilable(String),
           short_link: T.nilable(T::Boolean),
@@ -148,6 +155,10 @@ module Dodopayments
         metadata: nil,
         # Whether to generate a payment link. Defaults to false if not specified.
         payment_link: nil,
+        # Optional payment method ID to use for this payment. If provided, customer_id
+        # must also be provided. The payment method will be validated for eligibility with
+        # the payment's currency.
+        payment_method_id: nil,
         # If true, redirects the customer immediately after payment completion False by
         # default
         redirect_immediately: nil,
@@ -182,6 +193,7 @@ module Dodopayments
             force_3ds: T.nilable(T::Boolean),
             metadata: T::Hash[Symbol, String],
             payment_link: T.nilable(T::Boolean),
+            payment_method_id: T.nilable(String),
             redirect_immediately: T::Boolean,
             return_url: T.nilable(String),
             short_link: T.nilable(T::Boolean),