dodopayments 1.68.0 → 1.70.0

data/rbi/dodopayments/models/products/short_link_create_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Products
+      class ShortLinkCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Products::ShortLinkCreateParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Slug for the short link.
+        sig { returns(String) }
+        attr_accessor :slug
+
+        # Static Checkout URL parameters to apply to the resulting short URL.
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_accessor :static_checkout_params
+
+        sig do
+          params(
+            slug: String,
+            static_checkout_params: T.nilable(T::Hash[Symbol, String]),
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Slug for the short link.
+          slug:,
+          # Static Checkout URL parameters to apply to the resulting short URL.
+          static_checkout_params: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              slug: String,
+              static_checkout_params: T.nilable(T::Hash[Symbol, String]),
+              request_options: Dodopayments::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/products/short_link_create_response.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Products
+      class ShortLinkCreateResponse < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Models::Products::ShortLinkCreateResponse,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Full URL.
+        sig { returns(String) }
+        attr_accessor :full_url
+
+        # Short URL.
+        sig { returns(String) }
+        attr_accessor :short_url
+
+        sig do
+          params(full_url: String, short_url: String).returns(T.attached_class)
+        end
+        def self.new(
+          # Full URL.
+          full_url:,
+          # Short URL.
+          short_url:
+        )
+        end
+
+        sig { override.returns({ full_url: String, short_url: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/products/short_link_list_params.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Products
+      class ShortLinkListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Products::ShortLinkListParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # Page number default is 0
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_number
+
+        sig { params(page_number: Integer).void }
+        attr_writer :page_number
+
+        # Page size default is 10 max is 100
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_size
+
+        sig { params(page_size: Integer).void }
+        attr_writer :page_size
+
+        # Filter by product ID
+        sig { returns(T.nilable(String)) }
+        attr_reader :product_id
+
+        sig { params(product_id: String).void }
+        attr_writer :product_id
+
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            product_id: String,
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Page number default is 0
+          page_number: nil,
+          # Page size default is 10 max is 100
+          page_size: nil,
+          # Filter by product ID
+          product_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              page_number: Integer,
+              page_size: Integer,
+              product_id: String,
+              request_options: Dodopayments::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/products/short_link_list_response.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Products
+      class ShortLinkListResponse < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Models::Products::ShortLinkListResponse,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # When the short url was created
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Full URL the short url redirects to
+        sig { returns(String) }
+        attr_accessor :full_url
+
+        # Product ID associated with the short link
+        sig { returns(String) }
+        attr_accessor :product_id
+
+        # Short URL
+        sig { returns(String) }
+        attr_accessor :short_url
+
+        sig do
+          params(
+            created_at: Time,
+            full_url: String,
+            product_id: String,
+            short_url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # When the short url was created
+          created_at:,
+          # Full URL the short url redirects to
+          full_url:,
+          # Product ID associated with the short link
+          product_id:,
+          # Short URL
+          short_url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              created_at: Time,
+              full_url: String,
+              product_id: String,
+              short_url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/subscription_create_params.rbi

@@ -91,6 +91,12 @@ module Dodopayments
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :payment_link
 
+      # 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.
+      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)) }
@@ -145,6 +151,7 @@ module Dodopayments
           one_time_product_cart:
             T.nilable(T::Array[Dodopayments::OneTimeProductCartItem::OrHash]),
           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),
@@ -187,6 +194,10 @@ module Dodopayments
         one_time_product_cart: nil,
         # If true, generates a payment link. Defaults to false if not specified.
         payment_link: nil,
+        # 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.
+        payment_method_id: nil,
         # If true, redirects the customer immediately after payment completion False by
         # default
         redirect_immediately: nil,
@@ -228,6 +239,7 @@ module Dodopayments
             one_time_product_cart:
               T.nilable(T::Array[Dodopayments::OneTimeProductCartItem]),
             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),

data/rbi/dodopayments/resources/checkout_sessions.rbi

@@ -30,6 +30,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,
@@ -70,6 +71,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.

data/rbi/dodopayments/resources/payments.rbi

@@ -19,6 +19,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),
@@ -53,6 +54,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,

data/rbi/dodopayments/resources/products/short_links.rbi

@@ -0,0 +1,59 @@
+# typed: strong
+
+module Dodopayments
+  module Resources
+    class Products
+      class ShortLinks
+        # Gives a Short Checkout URL with custom slug for a product. Uses a Static
+        # Checkout URL under the hood.
+        sig do
+          params(
+            id: String,
+            slug: String,
+            static_checkout_params: T.nilable(T::Hash[Symbol, String]),
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(Dodopayments::Models::Products::ShortLinkCreateResponse)
+        end
+        def create(
+          # Product Id
+          id,
+          # Slug for the short link.
+          slug:,
+          # Static Checkout URL parameters to apply to the resulting short URL.
+          static_checkout_params: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists all short links created by the business.
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            product_id: String,
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(
+            Dodopayments::Internal::DefaultPageNumberPagination[
+              Dodopayments::Models::Products::ShortLinkListResponse
+            ]
+          )
+        end
+        def list(
+          # Page number default is 0
+          page_number: nil,
+          # Page size default is 10 max is 100
+          page_size: nil,
+          # Filter by product ID
+          product_id: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Dodopayments::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/resources/products.rbi

@@ -6,6 +6,9 @@ module Dodopayments
       sig { returns(Dodopayments::Resources::Products::Images) }
       attr_reader :images
 
+      sig { returns(Dodopayments::Resources::Products::ShortLinks) }
+      attr_reader :short_links
+
       sig do
         params(
           name: String,

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -24,6 +24,7 @@ module Dodopayments
           one_time_product_cart:
             T.nilable(T::Array[Dodopayments::OneTimeProductCartItem::OrHash]),
           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),
@@ -66,6 +67,10 @@ module Dodopayments
         one_time_product_cart: nil,
         # If true, generates a payment link. Defaults to false if not specified.
         payment_link: nil,
+        # 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.
+        payment_method_id: nil,
         # If true, redirects the customer immediately after payment completion False by
         # default
         redirect_immediately: nil,

data/sig/dodopayments/models/checkout_session_request.rbs

@@ -14,6 +14,7 @@ module Dodopayments
         :force_3ds => bool?,
         metadata: ::Hash[Symbol, String]?,
         minimal_address: bool,
+        payment_method_id: String?,
         return_url: String?,
         short_link: bool,
         show_saved_payment_methods: bool,
@@ -57,6 +58,8 @@ module Dodopayments
 
       def minimal_address=: (bool) -> bool
 
+      attr_accessor payment_method_id: String?
+
       attr_accessor return_url: String?
 
       attr_reader short_link: bool?
@@ -82,6 +85,7 @@ module Dodopayments
         ?force_3ds: bool?,
         ?metadata: ::Hash[Symbol, String]?,
         ?minimal_address: bool,
+        ?payment_method_id: String?,
         ?return_url: String?,
         ?short_link: bool,
         ?show_saved_payment_methods: bool,
@@ -101,6 +105,7 @@ module Dodopayments
         :force_3ds => bool?,
         metadata: ::Hash[Symbol, String]?,
         minimal_address: bool,
+        payment_method_id: String?,
         return_url: String?,
         short_link: bool,
         show_saved_payment_methods: bool,

data/sig/dodopayments/models/checkout_session_response.rbs

@@ -1,16 +1,16 @@
 module Dodopayments
   module Models
     type checkout_session_response =
-      { checkout_url: String, session_id: String }
+      { session_id: String, checkout_url: String? }
 
     class CheckoutSessionResponse < Dodopayments::Internal::Type::BaseModel
-      attr_accessor checkout_url: String
-
       attr_accessor session_id: String
 
-      def initialize: (checkout_url: String, session_id: String) -> void
+      attr_accessor checkout_url: String?
+
+      def initialize: (session_id: String, ?checkout_url: String?) -> void
 
-      def to_hash: -> { checkout_url: String, session_id: String }
+      def to_hash: -> { session_id: String, checkout_url: String? }
     end
   end
 end

data/sig/dodopayments/models/payment_create_params.rbs

@@ -11,6 +11,7 @@ module Dodopayments
         :force_3ds => bool?,
         metadata: ::Hash[Symbol, String],
         payment_link: bool?,
+        payment_method_id: String?,
         redirect_immediately: bool,
         return_url: String?,
         short_link: bool?,
@@ -43,6 +44,8 @@ module Dodopayments
 
       attr_accessor payment_link: bool?
 
+      attr_accessor payment_method_id: String?
+
       attr_reader redirect_immediately: bool?
 
       def redirect_immediately=: (bool) -> bool
@@ -67,6 +70,7 @@ module Dodopayments
         ?force_3ds: bool?,
         ?metadata: ::Hash[Symbol, String],
         ?payment_link: bool?,
+        ?payment_method_id: String?,
         ?redirect_immediately: bool,
         ?return_url: String?,
         ?short_link: bool?,
@@ -85,6 +89,7 @@ module Dodopayments
         :force_3ds => bool?,
         metadata: ::Hash[Symbol, String],
         payment_link: bool?,
+        payment_method_id: String?,
         redirect_immediately: bool,
         return_url: String?,
         short_link: bool?,

data/sig/dodopayments/models/products/short_link_create_params.rbs

@@ -0,0 +1,30 @@
+module Dodopayments
+  module Models
+    module Products
+      type short_link_create_params =
+        { slug: String, static_checkout_params: ::Hash[Symbol, String]? }
+        & Dodopayments::Internal::Type::request_parameters
+
+      class ShortLinkCreateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        attr_accessor slug: String
+
+        attr_accessor static_checkout_params: ::Hash[Symbol, String]?
+
+        def initialize: (
+          slug: String,
+          ?static_checkout_params: ::Hash[Symbol, String]?,
+          ?request_options: Dodopayments::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          slug: String,
+          static_checkout_params: ::Hash[Symbol, String]?,
+          request_options: Dodopayments::RequestOptions
+        }
+      end
+    end
+  end
+end

data/sig/dodopayments/models/products/short_link_create_response.rbs

@@ -0,0 +1,17 @@
+module Dodopayments
+  module Models
+    module Products
+      type short_link_create_response = { full_url: String, short_url: String }
+
+      class ShortLinkCreateResponse < Dodopayments::Internal::Type::BaseModel
+        attr_accessor full_url: String
+
+        attr_accessor short_url: String
+
+        def initialize: (full_url: String, short_url: String) -> void
+
+        def to_hash: -> { full_url: String, short_url: String }
+      end
+    end
+  end
+end

data/sig/dodopayments/models/products/short_link_list_params.rbs

@@ -0,0 +1,40 @@
+module Dodopayments
+  module Models
+    module Products
+      type short_link_list_params =
+        { page_number: Integer, page_size: Integer, product_id: String }
+        & Dodopayments::Internal::Type::request_parameters
+
+      class ShortLinkListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        attr_reader page_number: Integer?
+
+        def page_number=: (Integer) -> Integer
+
+        attr_reader page_size: Integer?
+
+        def page_size=: (Integer) -> Integer
+
+        attr_reader product_id: String?
+
+        def product_id=: (String) -> String
+
+        def initialize: (
+          ?page_number: Integer,
+          ?page_size: Integer,
+          ?product_id: String,
+          ?request_options: Dodopayments::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          page_number: Integer,
+          page_size: Integer,
+          product_id: String,
+          request_options: Dodopayments::RequestOptions
+        }
+      end
+    end
+  end
+end

data/sig/dodopayments/models/products/short_link_list_response.rbs

@@ -0,0 +1,37 @@
+module Dodopayments
+  module Models
+    module Products
+      type short_link_list_response =
+        {
+          created_at: Time,
+          full_url: String,
+          product_id: String,
+          short_url: String
+        }
+
+      class ShortLinkListResponse < Dodopayments::Internal::Type::BaseModel
+        attr_accessor created_at: Time
+
+        attr_accessor full_url: String
+
+        attr_accessor product_id: String
+
+        attr_accessor short_url: String
+
+        def initialize: (
+          created_at: Time,
+          full_url: String,
+          product_id: String,
+          short_url: String
+        ) -> void
+
+        def to_hash: -> {
+          created_at: Time,
+          full_url: String,
+          product_id: String,
+          short_url: String
+        }
+      end
+    end
+  end
+end

data/sig/dodopayments/models/subscription_create_params.rbs

@@ -15,6 +15,7 @@ module Dodopayments
         on_demand: Dodopayments::OnDemandSubscription?,
         one_time_product_cart: ::Array[Dodopayments::OneTimeProductCartItem]?,
         payment_link: bool?,
+        payment_method_id: String?,
         redirect_immediately: bool,
         return_url: String?,
         short_link: bool?,
@@ -56,6 +57,8 @@ module Dodopayments
 
       attr_accessor payment_link: bool?
 
+      attr_accessor payment_method_id: String?
+
       attr_reader redirect_immediately: bool?
 
       def redirect_immediately=: (bool) -> bool
@@ -86,6 +89,7 @@ module Dodopayments
         ?on_demand: Dodopayments::OnDemandSubscription?,
         ?one_time_product_cart: ::Array[Dodopayments::OneTimeProductCartItem]?,
         ?payment_link: bool?,
+        ?payment_method_id: String?,
         ?redirect_immediately: bool,
         ?return_url: String?,
         ?short_link: bool?,
@@ -109,6 +113,7 @@ module Dodopayments
         on_demand: Dodopayments::OnDemandSubscription?,
         one_time_product_cart: ::Array[Dodopayments::OneTimeProductCartItem]?,
         payment_link: bool?,
+        payment_method_id: String?,
         redirect_immediately: bool,
         return_url: String?,
         short_link: bool?,

data/sig/dodopayments/resources/checkout_sessions.rbs

@@ -14,6 +14,7 @@ module Dodopayments
         ?force_3ds: bool?,
         ?metadata: ::Hash[Symbol, String]?,
         ?minimal_address: bool,
+        ?payment_method_id: String?,
         ?return_url: String?,
         ?short_link: bool,
         ?show_saved_payment_methods: bool,

data/sig/dodopayments/resources/payments.rbs

@@ -11,6 +11,7 @@ module Dodopayments
         ?force_3ds: bool?,
         ?metadata: ::Hash[Symbol, String],
         ?payment_link: bool?,
+        ?payment_method_id: String?,
         ?redirect_immediately: bool,
         ?return_url: String?,
         ?short_link: bool?,