dodopayments 2.33.0 → 2.35.0

data/rbi/dodopayments/models/meters/translation_list_params.rbi

@@ -0,0 +1,59 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Meters
+      class TranslationListParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Meters::TranslationListParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Returns only these locales, for example `?locale=fr&locale=de`. With no value,
+        # the response has all the locales.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :locale
+
+        sig { params(locale: T::Array[String]).void }
+        attr_writer :locale
+
+        sig do
+          params(
+            id: String,
+            locale: T::Array[String],
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # Returns only these locales, for example `?locale=fr&locale=de`. With no value,
+          # the response has all the locales.
+          locale: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              locale: T::Array[String],
+              request_options: Dodopayments::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/meters/translation_update_params.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    module Meters
+      class TranslationUpdateParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Meters::TranslationUpdateParams,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        # A locale that the checkout and the customer portal can show.
+        #
+        # The codes are a copy of the checkout locales. `GET /locales` lists them.
+        sig { returns(Dodopayments::Locale::OrSymbol) }
+        attr_accessor :locale
+
+        # The translated description.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :description
+
+        # The translated name.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        sig do
+          params(
+            id: String,
+            locale: Dodopayments::Locale::OrSymbol,
+            description: T.nilable(String),
+            name: T.nilable(String),
+            request_options: Dodopayments::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # A locale that the checkout and the customer portal can show.
+          #
+          # The codes are a copy of the checkout locales. `GET /locales` lists them.
+          locale:,
+          # The translated description.
+          description: nil,
+          # The translated name.
+          name: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              locale: Dodopayments::Locale::OrSymbol,
+              description: T.nilable(String),
+              name: T.nilable(String),
+              request_options: Dodopayments::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/misc_list_locales_params.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class MiscListLocalesParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::MiscListLocalesParams,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      sig do
+        params(request_options: Dodopayments::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig do
+        override.returns({ request_options: Dodopayments::RequestOptions })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/misc_list_locales_response.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    MiscListLocalesResponse =
+      T.let(
+        Dodopayments::Internal::Type::ArrayOf[Dodopayments::LocaleInfo],
+        Dodopayments::Internal::Type::Converter
+      )
+  end
+end

data/rbi/dodopayments/models/payment.rbi

@@ -48,6 +48,12 @@ module Dodopayments
       sig { returns(T::Array[Dodopayments::Dispute]) }
       attr_accessor :disputes
 
+      # True when this payment also bills metered usage or credit overage. The usage is
+      # for the billing cycle before the service period, not for the service period. The
+      # value is set for each payment status. It is false when `charge_type` is null.
+      sig { returns(T::Boolean) }
+      attr_accessor :includes_usage
+
       # True when one payment starts more than one subscription. Read this field to find
       # the payment type. Do not read the length of `subscription_ids`. Do not read
       # `subscription_id` for null.
@@ -86,7 +92,10 @@ module Dodopayments
       # the same as `subscription_ids`. For a plan change charge, the period starts at
       # the plan change and ends at the next billing date. The list is empty unless the
       # payment status is `succeeded`. The list is also empty for a one-time payment, an
-      # on-demand charge, or a payment method update.
+      # on-demand charge, or a payment method update. The list is set for `new`,
+      # `renewal` and `plan_change` charges that succeeded. It can be empty for some
+      # zero-amount payments. A `renewal` with no entry for its subscription bills usage
+      # only. That payment does not extend the service period.
       sig { returns(T::Array[Dodopayments::SubscriptionServicePeriod]) }
       attr_accessor :service_periods
 
@@ -114,6 +123,18 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :total_amount
 
+      # Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+      # Google Pay, this is the expiry of the wallet token, which can differ from the
+      # expiry of the physical card.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_exp_month
+
+      # Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+      # Google Pay, this is the expiry of the wallet token, which can differ from the
+      # expiry of the physical card.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_exp_year
+
       # Cardholder name
       sig { returns(T.nilable(String)) }
       attr_accessor :card_holder_name
@@ -126,14 +147,22 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :card_last_four
 
-      # Card network like VISA, MASTERCARD etc.
+      # Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+      # payments can carry other casing.
       sig { returns(T.nilable(String)) }
       attr_accessor :card_network
 
-      # The type of card DEBIT or CREDIT
+      # The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+      # can carry other casing.
       sig { returns(T.nilable(String)) }
       attr_accessor :card_type
 
+      # The type of subscription charge that this payment is for. Refer to `ChargeType`.
+      # The value is set for each payment status, not only for `succeeded`. The value is
+      # null when this payment charges no subscription.
+      sig { returns(T.nilable(Dodopayments::ChargeType::TaggedSymbol)) }
+      attr_accessor :charge_type
+
       # If payment is made using a checkout session, this field is set to the id of the
       # session.
       sig { returns(T.nilable(String)) }
@@ -165,7 +194,9 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :invoice_id
 
-      # URL to download the invoice PDF for this payment.
+      # DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key. URL to
+      # download the invoice PDF for this payment. The URL has no signed token. If the
+      # business asks for a credential on its invoice links, the URL needs an API key.
       sig { returns(T.nilable(String)) }
       attr_accessor :invoice_url
 
@@ -217,6 +248,22 @@ module Dodopayments
       sig { returns(T.nilable(Integer)) }
       attr_accessor :tax
 
+      # How the cardholder completed the 3DS authentication. The value is null when the
+      # processor does not report it.
+      sig { returns(T.nilable(Dodopayments::ThreeDSFlow::TaggedSymbol)) }
+      attr_accessor :three_ds_flow
+
+      # The result of the 3DS authentication, as the processor reports it. The value is
+      # null when the processor reports no 3DS data, for example when the payment did
+      # not use 3DS.
+      sig { returns(T.nilable(Dodopayments::ThreeDSStatus::TaggedSymbol)) }
+      attr_accessor :three_ds_status
+
+      # The 3DS protocol version, for example `2.2.0`. The value is null when the
+      # processor does not report it.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :three_ds_version
+
       # Timestamp when the payment was last updated
       sig { returns(T.nilable(Time)) }
       attr_accessor :updated_at
@@ -231,6 +278,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           digital_products_delivered: T::Boolean,
           disputes: T::Array[Dodopayments::Dispute::OrHash],
+          includes_usage: T::Boolean,
           is_multi_subscription: T::Boolean,
           is_update_payment_method: T::Boolean,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
@@ -244,11 +292,14 @@ module Dodopayments
           settlement_currency: Dodopayments::Currency::OrSymbol,
           subscription_ids: T::Array[String],
           total_amount: Integer,
+          card_exp_month: T.nilable(String),
+          card_exp_year: T.nilable(String),
           card_holder_name: T.nilable(String),
           card_issuing_country: T.nilable(Dodopayments::CountryCode::OrSymbol),
           card_last_four: T.nilable(String),
           card_network: T.nilable(String),
           card_type: T.nilable(String),
+          charge_type: T.nilable(Dodopayments::ChargeType::OrSymbol),
           checkout_session_id: T.nilable(String),
           custom_field_responses:
             T.nilable(T::Array[Dodopayments::CustomFieldResponse::OrHash]),
@@ -269,6 +320,9 @@ module Dodopayments
           status: T.nilable(Dodopayments::IntentStatus::OrSymbol),
           subscription_id: T.nilable(String),
           tax: T.nilable(Integer),
+          three_ds_flow: T.nilable(Dodopayments::ThreeDSFlow::OrSymbol),
+          three_ds_status: T.nilable(Dodopayments::ThreeDSStatus::OrSymbol),
+          three_ds_version: T.nilable(String),
           updated_at: T.nilable(Time)
         ).returns(T.attached_class)
       end
@@ -289,6 +343,10 @@ module Dodopayments
         digital_products_delivered:,
         # List of disputes associated with this payment
         disputes:,
+        # True when this payment also bills metered usage or credit overage. The usage is
+        # for the billing cycle before the service period, not for the service period. The
+        # value is set for each payment status. It is false when `charge_type` is null.
+        includes_usage:,
         # True when one payment starts more than one subscription. Read this field to find
         # the payment type. Do not read the length of `subscription_ids`. Do not read
         # `subscription_id` for null.
@@ -313,7 +371,10 @@ module Dodopayments
         # the same as `subscription_ids`. For a plan change charge, the period starts at
         # the plan change and ends at the next billing date. The list is empty unless the
         # payment status is `succeeded`. The list is also empty for a one-time payment, an
-        # on-demand charge, or a payment method update.
+        # on-demand charge, or a payment method update. The list is set for `new`,
+        # `renewal` and `plan_change` charges that succeeded. It can be empty for some
+        # zero-amount payments. A `renewal` with no entry for its subscription bills usage
+        # only. That payment does not extend the service period.
         service_periods:,
         # The amount that will be credited to your Dodo balance after currency conversion
         # and processing. Especially relevant for adaptive pricing where the customer's
@@ -331,16 +392,30 @@ module Dodopayments
         # unit (e.g. cents for USD, yen for JPY, fils for KWD — see the currency's decimal
         # places)
         total_amount:,
+        # Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+        # Google Pay, this is the expiry of the wallet token, which can differ from the
+        # expiry of the physical card.
+        card_exp_month: nil,
+        # Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+        # Google Pay, this is the expiry of the wallet token, which can differ from the
+        # expiry of the physical card.
+        card_exp_year: nil,
         # Cardholder name
         card_holder_name: nil,
         # ISO2 country code of the card
         card_issuing_country: nil,
         # The last four digits of the card
         card_last_four: nil,
-        # Card network like VISA, MASTERCARD etc.
+        # Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+        # payments can carry other casing.
         card_network: nil,
-        # The type of card DEBIT or CREDIT
+        # The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+        # can carry other casing.
         card_type: nil,
+        # The type of subscription charge that this payment is for. Refer to `ChargeType`.
+        # The value is set for each payment status, not only for `succeeded`. The value is
+        # null when this payment charges no subscription.
+        charge_type: nil,
         # If payment is made using a checkout session, this field is set to the id of the
         # session.
         checkout_session_id: nil,
@@ -358,7 +433,9 @@ module Dodopayments
         error_message: nil,
         # Invoice ID for this payment. Uses India-specific invoice ID if available.
         invoice_id: nil,
-        # URL to download the invoice PDF for this payment.
+        # DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key. URL to
+        # download the invoice PDF for this payment. The URL has no signed token. If the
+        # business asks for a credential on its invoice links, the URL needs an API key.
         invoice_url: nil,
         # Checkout URL
         payment_link: nil,
@@ -386,6 +463,16 @@ module Dodopayments
         # Amount of tax collected in the currency's smallest unit (e.g. cents for USD, yen
         # for JPY, fils for KWD)
         tax: nil,
+        # How the cardholder completed the 3DS authentication. The value is null when the
+        # processor does not report it.
+        three_ds_flow: nil,
+        # The result of the 3DS authentication, as the processor reports it. The value is
+        # null when the processor reports no 3DS data, for example when the payment did
+        # not use 3DS.
+        three_ds_status: nil,
+        # The 3DS protocol version, for example `2.2.0`. The value is null when the
+        # processor does not report it.
+        three_ds_version: nil,
         # Timestamp when the payment was last updated
         updated_at: nil
       )
@@ -402,6 +489,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             digital_products_delivered: T::Boolean,
             disputes: T::Array[Dodopayments::Dispute],
+            includes_usage: T::Boolean,
             is_multi_subscription: T::Boolean,
             is_update_payment_method: T::Boolean,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
@@ -415,12 +503,15 @@ module Dodopayments
             settlement_currency: Dodopayments::Currency::TaggedSymbol,
             subscription_ids: T::Array[String],
             total_amount: Integer,
+            card_exp_month: T.nilable(String),
+            card_exp_year: T.nilable(String),
             card_holder_name: T.nilable(String),
             card_issuing_country:
               T.nilable(Dodopayments::CountryCode::TaggedSymbol),
             card_last_four: T.nilable(String),
             card_network: T.nilable(String),
             card_type: T.nilable(String),
+            charge_type: T.nilable(Dodopayments::ChargeType::TaggedSymbol),
             checkout_session_id: T.nilable(String),
             custom_field_responses:
               T.nilable(T::Array[Dodopayments::CustomFieldResponse]),
@@ -442,6 +533,10 @@ module Dodopayments
             status: T.nilable(Dodopayments::IntentStatus::TaggedSymbol),
             subscription_id: T.nilable(String),
             tax: T.nilable(Integer),
+            three_ds_flow: T.nilable(Dodopayments::ThreeDSFlow::TaggedSymbol),
+            three_ds_status:
+              T.nilable(Dodopayments::ThreeDSStatus::TaggedSymbol),
+            three_ds_version: T.nilable(String),
             updated_at: T.nilable(Time)
           }
         )

data/rbi/dodopayments/models/payment_list_response.rbi

@@ -34,6 +34,12 @@ module Dodopayments
       sig { returns(T::Boolean) }
       attr_accessor :has_license_key
 
+      # True when this payment also bills metered usage or credit overage. The usage is
+      # for the billing cycle before the service period, not for the service period. The
+      # value is set for each payment status. It is false when `charge_type` is null.
+      sig { returns(T::Boolean) }
+      attr_accessor :includes_usage
+
       # True when one payment starts more than one subscription. Read this field to find
       # the payment type. Do not read the length of `subscription_ids`. Do not read
       # `subscription_id` for null.
@@ -66,7 +72,10 @@ module Dodopayments
       # the same as `subscription_ids`. For a plan change charge, the period starts at
       # the plan change and ends at the next billing date. The list is empty unless the
       # payment status is `succeeded`. The list is also empty for a one-time payment, an
-      # on-demand charge, or a payment method update.
+      # on-demand charge, or a payment method update. The list is set for `new`,
+      # `renewal` and `plan_change` charges that succeeded. It can be empty for some
+      # zero-amount payments. A `renewal` with no entry for its subscription bills usage
+      # only. That payment does not extend the service period.
       sig { returns(T::Array[Dodopayments::SubscriptionServicePeriod]) }
       attr_accessor :service_periods
 
@@ -79,14 +88,38 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :total_amount
 
+      # Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+      # Google Pay, this is the expiry of the wallet token, which can differ from the
+      # expiry of the physical card.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_exp_month
+
+      # Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+      # Google Pay, this is the expiry of the wallet token, which can differ from the
+      # expiry of the physical card.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_exp_year
+
       # The last four digits of the card
       sig { returns(T.nilable(String)) }
       attr_accessor :card_last_four
 
-      # Card network like VISA, MASTERCARD etc.
+      # Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+      # payments can carry other casing.
       sig { returns(T.nilable(String)) }
       attr_accessor :card_network
 
+      # The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+      # can carry other casing.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :card_type
+
+      # The type of subscription charge that this payment is for. Refer to `ChargeType`.
+      # The value is set for each payment status, not only for `succeeded`. The value is
+      # null when this payment charges no subscription.
+      sig { returns(T.nilable(Dodopayments::ChargeType::TaggedSymbol)) }
+      attr_accessor :charge_type
+
       # The ID of the checkout session for this payment. The value is null when the
       # payment does not use a checkout session.
       sig { returns(T.nilable(String)) }
@@ -100,7 +133,9 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :invoice_id
 
-      # URL to download the invoice PDF for this payment.
+      # DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key. URL to
+      # download the invoice PDF for this payment. The URL has no signed token. If the
+      # business asks for a credential on its invoice links, the URL needs an API key.
       sig { returns(T.nilable(String)) }
       attr_accessor :invoice_url
 
@@ -123,6 +158,22 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :subscription_id
 
+      # How the cardholder completed the 3DS authentication. The value is null when the
+      # processor does not report it.
+      sig { returns(T.nilable(Dodopayments::ThreeDSFlow::TaggedSymbol)) }
+      attr_accessor :three_ds_flow
+
+      # The result of the 3DS authentication, as the processor reports it. The value is
+      # null when the processor reports no 3DS data, for example when the payment did
+      # not use 3DS.
+      sig { returns(T.nilable(Dodopayments::ThreeDSStatus::TaggedSymbol)) }
+      attr_accessor :three_ds_status
+
+      # The 3DS protocol version, for example `2.2.0`. The value is null when the
+      # processor does not report it.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :three_ds_version
+
       sig do
         params(
           brand_id: String,
@@ -131,6 +182,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           digital_products_delivered: T::Boolean,
           has_license_key: T::Boolean,
+          includes_usage: T::Boolean,
           is_multi_subscription: T::Boolean,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
@@ -141,8 +193,12 @@ module Dodopayments
             T::Array[Dodopayments::SubscriptionServicePeriod::OrHash],
           subscription_ids: T::Array[String],
           total_amount: Integer,
+          card_exp_month: T.nilable(String),
+          card_exp_year: T.nilable(String),
           card_last_four: T.nilable(String),
           card_network: T.nilable(String),
+          card_type: T.nilable(String),
+          charge_type: T.nilable(Dodopayments::ChargeType::OrSymbol),
           checkout_session_id: T.nilable(String),
           dispute_status: T.nilable(Dodopayments::DisputeStatus::OrSymbol),
           invoice_id: T.nilable(String),
@@ -151,7 +207,10 @@ module Dodopayments
           payment_method_type: T.nilable(String),
           refund_status: T.nilable(Dodopayments::PaymentRefundStatus::OrSymbol),
           status: T.nilable(Dodopayments::IntentStatus::OrSymbol),
-          subscription_id: T.nilable(String)
+          subscription_id: T.nilable(String),
+          three_ds_flow: T.nilable(Dodopayments::ThreeDSFlow::OrSymbol),
+          three_ds_status: T.nilable(Dodopayments::ThreeDSStatus::OrSymbol),
+          three_ds_version: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -161,6 +220,10 @@ module Dodopayments
         customer:,
         digital_products_delivered:,
         has_license_key:,
+        # True when this payment also bills metered usage or credit overage. The usage is
+        # for the billing cycle before the service period, not for the service period. The
+        # value is set for each payment status. It is false when `charge_type` is null.
+        includes_usage:,
         # True when one payment starts more than one subscription. Read this field to find
         # the payment type. Do not read the length of `subscription_ids`. Do not read
         # `subscription_id` for null.
@@ -179,17 +242,36 @@ module Dodopayments
         # the same as `subscription_ids`. For a plan change charge, the period starts at
         # the plan change and ends at the next billing date. The list is empty unless the
         # payment status is `succeeded`. The list is also empty for a one-time payment, an
-        # on-demand charge, or a payment method update.
+        # on-demand charge, or a payment method update. The list is set for `new`,
+        # `renewal` and `plan_change` charges that succeeded. It can be empty for some
+        # zero-amount payments. A `renewal` with no entry for its subscription bills usage
+        # only. That payment does not extend the service period.
         service_periods:,
         # Every subscription that this payment starts or charges, in a stable order. It is
         # empty for a one-time payment. It holds the value of `subscription_id` when the
         # payment names one subscription.
         subscription_ids:,
         total_amount:,
+        # Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+        # Google Pay, this is the expiry of the wallet token, which can differ from the
+        # expiry of the physical card.
+        card_exp_month: nil,
+        # Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+        # Google Pay, this is the expiry of the wallet token, which can differ from the
+        # expiry of the physical card.
+        card_exp_year: nil,
         # The last four digits of the card
         card_last_four: nil,
-        # Card network like VISA, MASTERCARD etc.
+        # Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+        # payments can carry other casing.
         card_network: nil,
+        # The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+        # can carry other casing.
+        card_type: nil,
+        # The type of subscription charge that this payment is for. Refer to `ChargeType`.
+        # The value is set for each payment status, not only for `succeeded`. The value is
+        # null when this payment charges no subscription.
+        charge_type: nil,
         # The ID of the checkout session for this payment. The value is null when the
         # payment does not use a checkout session.
         checkout_session_id: nil,
@@ -197,7 +279,9 @@ module Dodopayments
         dispute_status: nil,
         # Invoice ID for this payment. Uses India-specific invoice ID if available.
         invoice_id: nil,
-        # URL to download the invoice PDF for this payment.
+        # DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key. URL to
+        # download the invoice PDF for this payment. The URL has no signed token. If the
+        # business asks for a credential on its invoice links, the URL needs an API key.
         invoice_url: nil,
         payment_method: nil,
         payment_method_type: nil,
@@ -205,7 +289,17 @@ module Dodopayments
         # exist.
         refund_status: nil,
         status: nil,
-        subscription_id: nil
+        subscription_id: nil,
+        # How the cardholder completed the 3DS authentication. The value is null when the
+        # processor does not report it.
+        three_ds_flow: nil,
+        # The result of the 3DS authentication, as the processor reports it. The value is
+        # null when the processor reports no 3DS data, for example when the payment did
+        # not use 3DS.
+        three_ds_status: nil,
+        # The 3DS protocol version, for example `2.2.0`. The value is null when the
+        # processor does not report it.
+        three_ds_version: nil
       )
       end
 
@@ -218,6 +312,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             digital_products_delivered: T::Boolean,
             has_license_key: T::Boolean,
+            includes_usage: T::Boolean,
             is_multi_subscription: T::Boolean,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
@@ -227,8 +322,12 @@ module Dodopayments
             service_periods: T::Array[Dodopayments::SubscriptionServicePeriod],
             subscription_ids: T::Array[String],
             total_amount: Integer,
+            card_exp_month: T.nilable(String),
+            card_exp_year: T.nilable(String),
             card_last_four: T.nilable(String),
             card_network: T.nilable(String),
+            card_type: T.nilable(String),
+            charge_type: T.nilable(Dodopayments::ChargeType::TaggedSymbol),
             checkout_session_id: T.nilable(String),
             dispute_status:
               T.nilable(Dodopayments::DisputeStatus::TaggedSymbol),
@@ -239,7 +338,11 @@ module Dodopayments
             refund_status:
               T.nilable(Dodopayments::PaymentRefundStatus::TaggedSymbol),
             status: T.nilable(Dodopayments::IntentStatus::TaggedSymbol),
-            subscription_id: T.nilable(String)
+            subscription_id: T.nilable(String),
+            three_ds_flow: T.nilable(Dodopayments::ThreeDSFlow::TaggedSymbol),
+            three_ds_status:
+              T.nilable(Dodopayments::ThreeDSStatus::TaggedSymbol),
+            three_ds_version: T.nilable(String)
           }
         )
       end