dodopayments 2.32.2 → 2.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31d8dde0b1d372c536b75511c1ce30d24fa8d6ab550d88d00d3d3448d807bec8
-  data.tar.gz: 97aadbeb4c6baa9f16dd9b99f16c8b17ef7f09648f1cc022b9f29b1cdf0ae972
+  metadata.gz: c11a0d8230c984a0f1edb90a4ec17367c959b1184fb237167022cce1ffabef79
+  data.tar.gz: 65a53d9ea3bef5ff6f6ac1246ad5f58bf661299376465bd244cf89dc46518d6b
 SHA512:
-  metadata.gz: 44bfb6e065329abd8699a19faf88228f368cb149839ddf19dacaea9865b53f4cb5a5e6c8dbdcfa07a904018781c69de2d7892c27c278d52608789d94b9526e14
-  data.tar.gz: 866db267e7e2ff575c3d38c8691f0b257b1bb080de4ff4133fad701e98ecfb6cba799a69db9d3efd4580f729ae0477dd4eadcefa55a952004760200f3e5c5661
+  metadata.gz: 143d2ca167230b620f7fbce7e95bcb0ab604194841690113dd8c58609643d2faf141935105139492e60aa297ccfa70ac896f6b11b1334dcb934f67f6aaa280fd
+  data.tar.gz: b57185159507e699991b8bc47b7a8559260179cc013dadbd48e60bdb17d3d8108a31c689ec8c96bc308a631bac669ad5d09e9f3fab8aecb43718ce42adb95273

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [2.34.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.33.0...v2.34.0) (2026-10-21)
+
+
+### Features
+
+* **api:** payment charge type, usage flag and card details, signed invoice link tokens ([3b6eb1d](https://github.com/dodopayments/dodopayments-ruby/commit/3b6eb1d46ca7c02d279ab66c62a746e8df1f14d3))
+* **api:** payment charge type, usage flag and card details, signed invoice link tokens ([f3d6720](https://github.com/dodopayments/dodopayments-ruby/commit/f3d67205537089c45bd7643f399bece43a7d56f5))
+
+## [2.33.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.32.2...v2.33.0) (2026-10-14)
+
+
+### Features
+
+* **api:** payment service periods, retry attempts and subscription renewal payment_id ([4fc54c1](https://github.com/dodopayments/dodopayments-ruby/commit/4fc54c154ba2b49a904249f27d30a7b5b7fb165d))
+* **api:** payment service periods, retry attempts and subscription renewal payment_id ([53b94e3](https://github.com/dodopayments/dodopayments-ruby/commit/53b94e35bbff1d1882582852e58e9cc592ab1772))
+
 ## [2.32.2](https://github.com/dodopayments/dodopayments-ruby/compare/v2.32.1...v2.32.2) (2026-10-09)
 
 

data/README.md

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

data/lib/dodopayments/internal/type/enum.rb

@@ -17,28 +17,28 @@ module Dodopayments
       # values safely.
       #
       # @example
-      #   # `intent_status` is a `Dodopayments::IntentStatus`
-      #   case intent_status
-      #   when Dodopayments::IntentStatus::SUCCEEDED
+      #   # `charge_type` is a `Dodopayments::ChargeType`
+      #   case charge_type
+      #   when Dodopayments::ChargeType::NEW
       #     # ...
-      #   when Dodopayments::IntentStatus::FAILED
+      #   when Dodopayments::ChargeType::RENEWAL
       #     # ...
-      #   when Dodopayments::IntentStatus::CANCELLED
+      #   when Dodopayments::ChargeType::PLAN_CHANGE
       #     # ...
       #   else
-      #     puts(intent_status)
+      #     puts(charge_type)
       #   end
       #
       # @example
-      #   case intent_status
-      #   in :succeeded
+      #   case charge_type
+      #   in :new
       #     # ...
-      #   in :failed
+      #   in :renewal
       #     # ...
-      #   in :cancelled
+      #   in :plan_change
       #     # ...
       #   else
-      #     puts(intent_status)
+      #     puts(charge_type)
       #   end
       module Enum
         include Dodopayments::Internal::Type::Converter

data/lib/dodopayments/models/balance_ledger_entry.rb

@@ -119,6 +119,9 @@ module Dodopayments
         RESERVE_HOLD = :reserve_hold
         RESERVE_RELEASE = :reserve_release
         MODERATION_FEES = :moderation_fees
+        DODO_FIXED_FEE = :dodo_fixed_fee
+        INTERCHANGE_FEE = :interchange_fee
+        SCHEME_FEE = :scheme_fee
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/balance_retrieve_ledger_params.rb

@@ -266,6 +266,9 @@ module Dodopayments
         RESERVE_HOLD = :reserve_hold
         RESERVE_RELEASE = :reserve_release
         MODERATION_FEES = :moderation_fees
+        DODO_FIXED_FEE = :dodo_fixed_fee
+        INTERCHANGE_FEE = :interchange_fee
+        SCHEME_FEE = :scheme_fee
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/charge_type.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # The type of subscription charge that a payment is for.
+    #
+    # A payment has one invoice, and the invoice has one type. Thus each payment has
+    # one charge type. A payment that charges no subscription has no charge type.
+    #
+    # - `new`: the first payment of one or more subscriptions. A retry of that payment
+    #   is also `new`. A cart with new subscriptions and one-time products is `new`.
+    #   Read the one-time products from `product_cart`.
+    # - `renewal`: a charge at the billing date. A dunning retry and a manual retry of
+    #   that charge are also `renewal`. A `renewal` does not always extend the service
+    #   period. For example, the usage settlement of a paused subscription is a
+    #   `renewal` with `includes_usage` true and no entry in `service_periods`.
+    #   Examine `service_periods` before you extend access.
+    # - `plan_change`: a charge for a plan change. The change applies now or at the
+    #   next billing date.
+    # - `on_demand`: an on-demand charge of an on-demand subscription.
+    module ChargeType
+      extend Dodopayments::Internal::Type::Enum
+
+      NEW = :new
+      RENEWAL = :renewal
+      PLAN_CHANGE = :plan_change
+      ON_DEMAND = :on_demand
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/dodopayments/models/checkout_session_flags.rb

@@ -66,6 +66,9 @@ module Dodopayments
       # @!attribute allow_discount_code
       #   If the customer is allowed to apply discount code, set it to true.
       #
+      #   If this flag is false, the customer cannot change the discount codes. The
+      #   discount codes that you give when you create the session still apply.
+      #
       #   Default is true
       #
       #   @return [Boolean, nil]

data/lib/dodopayments/models/checkout_session_preview_response.rb

@@ -301,6 +301,15 @@ module Dodopayments
         #   @return [Integer, nil]
         optional :discount_cycle, Integer, nil?: true
 
+        # @!attribute monthly_equivalent
+        #   The monthly equivalent of the yearly unit price after discounts, in minor units
+        #   of `currency`. Only the hosted checkout sets it, when the business shows yearly
+        #   plans as monthly. The value is only for display. The order summary shows the
+        #   amounts that we charge.
+        #
+        #   @return [Integer, nil]
+        optional :monthly_equivalent, Integer, nil?: true
+
         # @!attribute name
         #   name of the product
         #
@@ -313,7 +322,7 @@ module Dodopayments
         #   @return [Integer, nil]
         optional :tax, Integer, nil?: true
 
-        # @!method initialize(credit_entitlements:, currency:, discounted_price:, is_subscription:, is_usage_based:, meters:, og_currency:, og_price:, product_id:, quantity:, tax_category:, tax_inclusive:, tax_rate:, addons: nil, description: nil, discount_amount: nil, discount_cycle: nil, name: nil, tax: nil)
+        # @!method initialize(credit_entitlements:, currency:, discounted_price:, is_subscription:, is_usage_based:, meters:, og_currency:, og_price:, product_id:, quantity:, tax_category:, tax_inclusive:, tax_rate:, addons: nil, description: nil, discount_amount: nil, discount_cycle: nil, monthly_equivalent: nil, name: nil, tax: nil)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart} for more
         #   details.
@@ -352,6 +361,8 @@ module Dodopayments
         #
         #   @param discount_cycle [Integer, nil] number of cycles the discount will apply
         #
+        #   @param monthly_equivalent [Integer, nil] The monthly equivalent of the yearly unit price after discounts, in minor units
+        #
         #   @param name [String, nil] name of the product
         #
         #   @param tax [Integer, nil] total tax

data/lib/dodopayments/models/invoices/payment_retrieve_params.rb

@@ -13,8 +13,21 @@ module Dodopayments
         #   @return [String]
         required :payment_id, String
 
-        # @!method initialize(payment_id:, request_options: {})
+        # @!attribute token
+        #   The signed link token. If the business asks for a credential on its invoice
+        #   links, a valid token for this record replaces the credential.
+        #
+        #   @return [String, nil]
+        optional :token, String
+
+        # @!method initialize(payment_id:, token: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Invoices::PaymentRetrieveParams} for more details.
+        #
         #   @param payment_id [String]
+        #
+        #   @param token [String] The signed link token. If the business asks for a credential on its invoice link
+        #
         #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/dodopayments/models/invoices/payment_retrieve_payout_params.rb

@@ -13,8 +13,21 @@ module Dodopayments
         #   @return [String]
         required :payout_id, String
 
-        # @!method initialize(payout_id:, request_options: {})
+        # @!attribute token
+        #   The signed link token. If the business asks for a credential on its invoice
+        #   links, a valid token for this record replaces the credential.
+        #
+        #   @return [String, nil]
+        optional :token, String
+
+        # @!method initialize(payout_id:, token: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Invoices::PaymentRetrievePayoutParams} for more details.
+        #
         #   @param payout_id [String]
+        #
+        #   @param token [String] The signed link token. If the business asks for a credential on its invoice link
+        #
         #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/dodopayments/models/invoices/payment_retrieve_refund_params.rb

@@ -13,8 +13,21 @@ module Dodopayments
         #   @return [String]
         required :refund_id, String
 
-        # @!method initialize(refund_id:, request_options: {})
+        # @!attribute token
+        #   The signed link token. If the business asks for a credential on its invoice
+        #   links, a valid token for this record replaces the credential.
+        #
+        #   @return [String, nil]
+        optional :token, String
+
+        # @!method initialize(refund_id:, token: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Invoices::PaymentRetrieveRefundParams} for more details.
+        #
         #   @param refund_id [String]
+        #
+        #   @param token [String] The signed link token. If the business asks for a credential on its invoice link
+        #
         #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/dodopayments/models/manual_retry_state.rb

@@ -19,6 +19,26 @@ module Dodopayments
       #   @return [Integer]
       required :sends_used, Integer
 
+      # @!attribute automatic_retry_number
+      #   The number of the queued automatic retry, starting at 1.
+      #
+      #   @return [Integer, nil]
+      optional :automatic_retry_number, Integer, nil?: true
+
+      # @!attribute automatic_retry_total
+      #   The number of automatic retries that the current configuration plans for this
+      #   invoice. It is never less than `automatic_retry_number`.
+      #
+      #   @return [Integer, nil]
+      optional :automatic_retry_total, Integer, nil?: true
+
+      # @!attribute next_automatic_retry_at
+      #   When the next automatic retry on this invoice is scheduled. Null when no
+      #   automatic retry is queued or automatic retries are disabled.
+      #
+      #   @return [Time, nil]
+      optional :next_automatic_retry_at, Time, nil?: true
+
       # @!attribute reason
       #   The code `POST` would fail with. Null when `can_retry` is true.
       #
@@ -32,7 +52,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :retry_available_at, Time, nil?: true
 
-      # @!method initialize(can_retry:, sends_allowed:, sends_used:, reason: nil, retry_available_at: nil)
+      # @!method initialize(can_retry:, sends_allowed:, sends_used:, automatic_retry_number: nil, automatic_retry_total: nil, next_automatic_retry_at: nil, reason: nil, retry_available_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::ManualRetryState} for more details.
       #
@@ -42,6 +62,12 @@ module Dodopayments
       #
       #   @param sends_used [Integer]
       #
+      #   @param automatic_retry_number [Integer, nil] The number of the queued automatic retry, starting at 1.
+      #
+      #   @param automatic_retry_total [Integer, nil] The number of automatic retries that the current configuration plans for
+      #
+      #   @param next_automatic_retry_at [Time, nil] When the next automatic retry on this invoice is scheduled. Null when no
+      #
       #   @param reason [String, nil] The code `POST` would fail with. Null when `can_retry` is true.
       #
       #   @param retry_available_at [Time, nil] When the next send becomes available. Null when no send is left, or when

data/lib/dodopayments/models/payment.rb

@@ -52,6 +52,14 @@ module Dodopayments
       #   @return [Array<Dodopayments::Models::Dispute>]
       required :disputes, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Dispute] }
 
+      # @!attribute includes_usage
+      #   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.
+      #
+      #   @return [Boolean]
+      required :includes_usage, Dodopayments::Internal::Type::Boolean
+
       # @!attribute is_multi_subscription
       #   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
@@ -100,6 +108,20 @@ module Dodopayments
       #   @return [Integer]
       required :retry_attempt, Integer
 
+      # @!attribute service_periods
+      #   The service period of each subscription that this payment pays for. The order is
+      #   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. 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.
+      #
+      #   @return [Array<Dodopayments::Models::SubscriptionServicePeriod>]
+      required :service_periods,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::SubscriptionServicePeriod] }
+
       # @!attribute settlement_amount
       #   The amount that will be credited to your Dodo balance after currency conversion
       #   and processing. Especially relevant for adaptive pricing where the customer's
@@ -132,6 +154,22 @@ module Dodopayments
       #   @return [Integer]
       required :total_amount, Integer
 
+      # @!attribute card_exp_month
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :card_exp_month, String, nil?: true
+
+      # @!attribute card_exp_year
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :card_exp_year, String, nil?: true
+
       # @!attribute card_holder_name
       #   Cardholder name
       #
@@ -151,17 +189,27 @@ module Dodopayments
       optional :card_last_four, String, nil?: true
 
       # @!attribute card_network
-      #   Card network like VISA, MASTERCARD etc.
+      #   Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+      #   payments can carry other casing.
       #
       #   @return [String, nil]
       optional :card_network, String, nil?: true
 
       # @!attribute card_type
-      #   The type of card DEBIT or CREDIT
+      #   The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+      #   can carry other casing.
       #
       #   @return [String, nil]
       optional :card_type, String, nil?: true
 
+      # @!attribute charge_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.
+      #
+      #   @return [Symbol, Dodopayments::Models::ChargeType, nil]
+      optional :charge_type, enum: -> { Dodopayments::ChargeType }, nil?: true
+
       # @!attribute checkout_session_id
       #   If payment is made using a checkout session, this field is set to the id of the
       #   session.
@@ -214,7 +262,11 @@ module Dodopayments
       optional :invoice_id, String, nil?: true
 
       # @!attribute invoice_url
-      #   URL to download the invoice PDF for this payment.
+      #   @deprecated Use `GET /invoices/payments/{payment_id}` with an API key.
+      #
+      #   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.
       #
       #   @return [String, nil]
       optional :invoice_url, String, nil?: true
@@ -293,7 +345,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :updated_at, Time, nil?: true
 
-      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, is_multi_subscription:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, subscription_ids:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
+      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, includes_usage:, is_multi_subscription:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, service_periods:, settlement_amount:, settlement_currency:, subscription_ids:, total_amount:, card_exp_month: nil, card_exp_year: nil, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, charge_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Payment} for more details.
       #
@@ -313,6 +365,8 @@ module Dodopayments
       #
       #   @param disputes [Array<Dodopayments::Models::Dispute>] List of disputes associated with this payment
       #
+      #   @param includes_usage [Boolean] True when this payment also bills metered usage or credit overage. The usage is
+      #
       #   @param is_multi_subscription [Boolean] True when one payment starts more than one subscription. Read this field
       #
       #   @param is_update_payment_method [Boolean] Whether this payment was created solely to update a subscription's
@@ -327,6 +381,8 @@ module Dodopayments
       #
       #   @param retry_attempt [Integer] Retry attempt number for subscription renewal payments.
       #
+      #   @param service_periods [Array<Dodopayments::Models::SubscriptionServicePeriod>] The service period of each subscription that this payment pays for.
+      #
       #   @param settlement_amount [Integer] The amount that will be credited to your Dodo balance after currency conversion
       #
       #   @param settlement_currency [Symbol, Dodopayments::Models::Currency] The currency in which the settlement_amount will be credited to your Dodo balanc
@@ -335,15 +391,21 @@ module Dodopayments
       #
       #   @param total_amount [Integer] Total amount charged to the customer including tax, in the currency's smallest u
       #
+      #   @param card_exp_month [String, nil] Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+      #
+      #   @param card_exp_year [String, nil] Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+      #
       #   @param card_holder_name [String, nil] Cardholder name
       #
       #   @param card_issuing_country [Symbol, Dodopayments::Models::CountryCode, nil] ISO2 country code of the card
       #
       #   @param card_last_four [String, nil] The last four digits of the card
       #
-      #   @param card_network [String, nil] Card network like VISA, MASTERCARD etc.
+      #   @param card_network [String, nil] Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older pa
+      #
+      #   @param card_type [String, nil] The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments c
       #
-      #   @param card_type [String, nil] The type of card DEBIT or CREDIT
+      #   @param charge_type [Symbol, Dodopayments::Models::ChargeType, nil] The type of subscription charge that this payment is for. Refer to `ChargeType`.
       #
       #   @param checkout_session_id [String, nil] If payment is made using a checkout session,
       #
@@ -359,7 +421,7 @@ module Dodopayments
       #
       #   @param invoice_id [String, nil] Invoice ID for this payment. Uses India-specific invoice ID if available.
       #
-      #   @param invoice_url [String, nil] URL to download the invoice PDF for this payment.
+      #   @param invoice_url [String, nil] DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key.
       #
       #   @param payment_link [String, nil] Checkout URL
       #

data/lib/dodopayments/models/payment_list_response.rb

@@ -34,6 +34,14 @@ module Dodopayments
       #   @return [Boolean]
       required :has_license_key, Dodopayments::Internal::Type::Boolean
 
+      # @!attribute includes_usage
+      #   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.
+      #
+      #   @return [Boolean]
+      required :includes_usage, Dodopayments::Internal::Type::Boolean
+
       # @!attribute is_multi_subscription
       #   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
@@ -60,6 +68,28 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::PaymentListResponse::PaymentProvider]
       required :payment_provider, enum: -> { Dodopayments::Models::PaymentListResponse::PaymentProvider }
 
+      # @!attribute retry_attempt
+      #   The retry attempt number of this payment. The value is `0` for the original
+      #   payment. Each retry after a failed subscription renewal adds `1`. The value is
+      #   always `0` for a payment that is not for a subscription.
+      #
+      #   @return [Integer]
+      required :retry_attempt, Integer
+
+      # @!attribute service_periods
+      #   The service period of each subscription that this payment pays for. The order is
+      #   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. 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.
+      #
+      #   @return [Array<Dodopayments::Models::SubscriptionServicePeriod>]
+      required :service_periods,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::SubscriptionServicePeriod] }
+
       # @!attribute subscription_ids
       #   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
@@ -73,6 +103,22 @@ module Dodopayments
       #   @return [Integer]
       required :total_amount, Integer
 
+      # @!attribute card_exp_month
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :card_exp_month, String, nil?: true
+
+      # @!attribute card_exp_year
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :card_exp_year, String, nil?: true
+
       # @!attribute card_last_four
       #   The last four digits of the card
       #
@@ -80,11 +126,34 @@ module Dodopayments
       optional :card_last_four, String, nil?: true
 
       # @!attribute card_network
-      #   Card network like VISA, MASTERCARD etc.
+      #   Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older
+      #   payments can carry other casing.
       #
       #   @return [String, nil]
       optional :card_network, String, nil?: true
 
+      # @!attribute card_type
+      #   The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments
+      #   can carry other casing.
+      #
+      #   @return [String, nil]
+      optional :card_type, String, nil?: true
+
+      # @!attribute charge_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.
+      #
+      #   @return [Symbol, Dodopayments::Models::ChargeType, nil]
+      optional :charge_type, enum: -> { Dodopayments::ChargeType }, nil?: true
+
+      # @!attribute checkout_session_id
+      #   The ID of the checkout session for this payment. The value is null when the
+      #   payment does not use a checkout session.
+      #
+      #   @return [String, nil]
+      optional :checkout_session_id, String, nil?: true
+
       # @!attribute dispute_status
       #   The most recent dispute status for this payment. None if no disputes exist.
       #
@@ -98,7 +167,11 @@ module Dodopayments
       optional :invoice_id, String, nil?: true
 
       # @!attribute invoice_url
-      #   URL to download the invoice PDF for this payment.
+      #   @deprecated Use `GET /invoices/payments/{payment_id}` with an API key.
+      #
+      #   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.
       #
       #   @return [String, nil]
       optional :invoice_url, String, nil?: true
@@ -130,7 +203,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :subscription_id, String, nil?: true
 
-      # @!method initialize(brand_id:, created_at:, currency:, customer:, digital_products_delivered:, has_license_key:, is_multi_subscription:, metadata:, payment_id:, payment_provider:, subscription_ids:, total_amount:, card_last_four: nil, card_network: nil, dispute_status: nil, invoice_id: nil, invoice_url: nil, payment_method: nil, payment_method_type: nil, refund_status: nil, status: nil, subscription_id: nil)
+      # @!method initialize(brand_id:, created_at:, currency:, customer:, digital_products_delivered:, has_license_key:, includes_usage:, is_multi_subscription:, metadata:, payment_id:, payment_provider:, retry_attempt:, service_periods:, subscription_ids:, total_amount:, card_exp_month: nil, card_exp_year: nil, card_last_four: nil, card_network: nil, card_type: nil, charge_type: nil, checkout_session_id: nil, dispute_status: nil, invoice_id: nil, invoice_url: nil, payment_method: nil, payment_method_type: nil, refund_status: nil, status: nil, subscription_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::PaymentListResponse} for more details.
       #
@@ -146,6 +219,8 @@ module Dodopayments
       #
       #   @param has_license_key [Boolean]
       #
+      #   @param includes_usage [Boolean] True when this payment also bills metered usage or credit overage. The usage is
+      #
       #   @param is_multi_subscription [Boolean] True when one payment starts more than one subscription. Read this field
       #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
@@ -154,19 +229,33 @@ module Dodopayments
       #
       #   @param payment_provider [Symbol, Dodopayments::Models::PaymentListResponse::PaymentProvider] Which processor handled this payment. `stripe` / `adyen` for BYOP routes
       #
+      #   @param retry_attempt [Integer] The retry attempt number of this payment. The value is `0` for the original
+      #
+      #   @param service_periods [Array<Dodopayments::Models::SubscriptionServicePeriod>] The service period of each subscription that this payment pays for.
+      #
       #   @param subscription_ids [Array<String>] Every subscription that this payment starts or charges, in a stable order.
       #
       #   @param total_amount [Integer]
       #
+      #   @param card_exp_month [String, nil] Expiry month of the card, as two digits from `01` to `12`. For Apple Pay and
+      #
+      #   @param card_exp_year [String, nil] Expiry year of the card, as four digits, for example `2029`. For Apple Pay and
+      #
       #   @param card_last_four [String, nil] The last four digits of the card
       #
-      #   @param card_network [String, nil] Card network like VISA, MASTERCARD etc.
+      #   @param card_network [String, nil] Card network, in lowercase, for example `visa`, `mastercard` or `amex`. Older pa
+      #
+      #   @param card_type [String, nil] The type of card, in lowercase: `credit`, `debit` or `prepaid`. Older payments c
+      #
+      #   @param charge_type [Symbol, Dodopayments::Models::ChargeType, nil] The type of subscription charge that this payment is for. Refer to `ChargeType`.
+      #
+      #   @param checkout_session_id [String, nil] The ID of the checkout session for this payment. The value is null when
       #
       #   @param dispute_status [Symbol, Dodopayments::Models::DisputeStatus, nil] The most recent dispute status for this payment. None if no disputes exist.
       #
       #   @param invoice_id [String, nil] Invoice ID for this payment. Uses India-specific invoice ID if available.
       #
-      #   @param invoice_url [String, nil] URL to download the invoice PDF for this payment.
+      #   @param invoice_url [String, nil] DEPRECATED: Use `GET /invoices/payments/{payment_id}` with an API key.
       #
       #   @param payment_method [String, nil]
       #