Update generated code for v1726

OPENAPI_VERSION

@@ -1 +1 @@
-v1725
+v1726

lib/stripe/resources/invoice_payment.rb

@@ -2,7 +2,14 @@
 # frozen_string_literal: true
 
 module Stripe
-  # The invoice payment object
+  # Invoice Payments represent payments made against invoices. Invoice Payments can
+  # be accessed in two ways:
+  # 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource.
+  # 2. By using the Invoice Payment retrieve and list endpoints.
+  #
+  # Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.
+  # This resource and its endpoints allows you to easily track if a payment is associated with a specific invoice and
+  # monitor the allocation details of the payments.
   class InvoicePayment < APIResource
     OBJECT_NAME = "invoice_payment"
     def self.object_name
@@ -10,7 +17,7 @@ module Stripe
     end
 
     class Payment < Stripe::StripeObject
-      # ID of the successful charge for this payment when `type` is `charge`.
+      # ID of the successful charge for this payment when `type` is `charge`.Note: charge is only surfaced if the charge object is not associated with a payment intent. If the charge object does have a payment intent, the Invoice Payment surfaces the payment intent instead.
       attr_reader :charge
       # ID of the PaymentIntent associated with this payment when `type` is `payment_intent`. Note: This property is only populated for invoices finalized on or after March 15th, 2019.
       attr_reader :payment_intent

rbi/stripe.rbi

@@ -37382,10 +37382,17 @@ module Stripe
 end
 # typed: true
 module Stripe
-  # The invoice payment object
+  # Invoice Payments represent payments made against invoices. Invoice Payments can
+  # be accessed in two ways:
+  # 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource.
+  # 2. By using the Invoice Payment retrieve and list endpoints.
+  #
+  # Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.
+  # This resource and its endpoints allows you to easily track if a payment is associated with a specific invoice and
+  # monitor the allocation details of the payments.
   class InvoicePayment < APIResource
     class Payment < Stripe::StripeObject
-      # ID of the successful charge for this payment when `type` is `charge`.
+      # ID of the successful charge for this payment when `type` is `charge`.Note: charge is only surfaced if the charge object is not associated with a payment intent. If the charge object does have a payment intent, the Invoice Payment surfaces the payment intent instead.
       sig { returns(T.any(String, Stripe::Charge)) }
       attr_reader :charge
       # ID of the PaymentIntent associated with this payment when `type` is `payment_intent`. Note: This property is only populated for invoices finalized on or after March 15th, 2019.

rbi/stripe/resources/invoice_payment.rbi

@@ -3,10 +3,17 @@
 
 # typed: true
 module Stripe
-  # The invoice payment object
+  # Invoice Payments represent payments made against invoices. Invoice Payments can
+  # be accessed in two ways:
+  # 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource.
+  # 2. By using the Invoice Payment retrieve and list endpoints.
+  #
+  # Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.
+  # This resource and its endpoints allows you to easily track if a payment is associated with a specific invoice and
+  # monitor the allocation details of the payments.
   class InvoicePayment < APIResource
     class Payment < Stripe::StripeObject
-      # ID of the successful charge for this payment when `type` is `charge`.
+      # ID of the successful charge for this payment when `type` is `charge`.Note: charge is only surfaced if the charge object is not associated with a payment intent. If the charge object does have a payment intent, the Invoice Payment surfaces the payment intent instead.
       sig { returns(T.any(String, Stripe::Charge)) }
       attr_reader :charge
       # ID of the PaymentIntent associated with this payment when `type` is `payment_intent`. Note: This property is only populated for invoices finalized on or after March 15th, 2019.