Merge upstream and update generated code for v2101 and

Author: stripe-openapi[bot]

API_VERSION

@@ -1 +1 @@
-173b24e412b55604d1775225f1560f5218fbaeca
+b7d9dec4da43fdbe727b3b4d8007a7099aa61beb

OPENAPI_VERSION

@@ -1 +1 @@
-v2096
+v2101

lib/Invoice.php

@@ -55,7 +55,7 @@
  * @property null|bool $auto_advance Controls whether Stripe performs <a href="https://stripe.com/docs/invoicing/integration/automatic-advancement-collection">automatic collection</a> of the invoice. If <code>false</code>, the invoice's state doesn't automatically advance without an explicit action.
  * @property (object{disabled_reason: null|string, enabled: bool, liability: null|(object{account?: Account|string, type: string}&StripeObject), provider: null|string, status: null|string}&StripeObject) $automatic_tax
  * @property null|int $automatically_finalizes_at The time when this invoice is currently scheduled to be automatically finalized. The field will be <code>null</code> if the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always be <code>null</code> - see <code>finalized_at</code> for the time when an already-finalized invoice was finalized.
- * @property null|string $billing_reason <p>Indicates the reason why the invoice was created.</p><p>* <code>manual</code>: Unrelated to a subscription, for example, created via the invoice editor. * <code>subscription</code>: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds. * <code>subscription_create</code>: A new subscription was created. * <code>subscription_cycle</code>: A subscription advanced into a new period. * <code>subscription_threshold</code>: A subscription reached a billing threshold. * <code>subscription_update</code>: A subscription was updated. * <code>upcoming</code>: Reserved for simulated invoices, per the upcoming invoice endpoint.</p>
+ * @property null|string $billing_reason <p>Indicates the reason why the invoice was created.</p><p>* <code>manual</code>: Unrelated to a subscription, for example, created via the invoice editor. * <code>subscription</code>: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds. * <code>subscription_create</code>: A new subscription was created. * <code>subscription_cycle</code>: A subscription advanced into a new period. * <code>subscription_threshold</code>: A subscription reached a billing threshold. * <code>subscription_update</code>: A subscription was updated. * <code>upcoming</code>: Reserved for upcoming invoices created through the Create Preview Invoice API or when an <code>invoice.upcoming</code> event is generated for an upcoming invoice on a subscription.</p>
  * @property string $collection_method Either <code>charge_automatically</code>, or <code>send_invoice</code>. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions.
  * @property null|(object{client_secret: string, type: string}&StripeObject) $confirmation_secret The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.

lib/PaymentIntentAmountDetailsLineItem.php

@@ -7,14 +7,14 @@
 /**
  * @property string $id Unique identifier for the object.
  * @property string $object String representing the object's type. Objects of the same type share the same value.
- * @property null|int $discount_amount The amount an item was discounted for. Positive integer.
+ * @property null|int $discount_amount <p>The discount applied on this line item represented in the <a href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. An integer greater than 0.</p><p>This field is mutually exclusive with the <code>amount_details[discount_amount]</code> field.</p>
  * @property null|(object{card?: (object{commodity_code: null|string}&StripeObject), card_present?: (object{commodity_code: null|string}&StripeObject), klarna?: (object{image_url: null|string, product_url: null|string, reference: null|string, subscription_reference: null|string}&StripeObject), paypal?: (object{category?: string, description?: string, sold_by?: string}&StripeObject)}&StripeObject) $payment_method_options Payment method-specific information for line items.
- * @property null|string $product_code Unique identifier of the product. At most 12 characters long.
- * @property string $product_name Name of the product. At most 100 characters long.
- * @property int $quantity Number of items of the product. Positive integer.
+ * @property null|string $product_code The product code of the line item, such as an SKU. Required for L3 rates. At most 12 characters long.
+ * @property string $product_name <p>The product name of the line item. Required for L3 rates. At most 1024 characters long.</p><p>For Cards, this field is truncated to 26 alphanumeric characters before being sent to the card networks. For Paypal, this field is truncated to 127 characters.</p>
+ * @property int $quantity The quantity of items. Required for L3 rates. An integer greater than 0.
  * @property null|(object{total_tax_amount: int}&StripeObject) $tax Contains information about the tax on the item.
- * @property int $unit_cost Cost of the product. Non-negative integer.
- * @property null|string $unit_of_measure A unit of measure for the line item, such as gallons, feet, meters, etc.
+ * @property int $unit_cost The unit cost of the line item represented in the <a href="https://stripe.com/docs/currencies#zero-decimal">smallest currency unit</a>. Required for L3 rates. An integer greater than or equal to 0.
+ * @property null|string $unit_of_measure A unit of measure for the line item, such as gallons, feet, meters, etc. Required for L3 rates. At most 12 alphanumeric characters long.
  */
 class PaymentIntentAmountDetailsLineItem extends ApiResource
 {

lib/QuotePreviewInvoice.php

@@ -55,7 +55,7 @@
  * @property bool $attempted Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the <code>invoice.created</code> webhook, for example, so you might not want to display that invoice as unpaid to your users.
  * @property (object{disabled_reason: null|string, enabled: bool, liability: null|(object{account?: Account|string, type: string}&StripeObject), provider: null|string, status: null|string}&StripeObject) $automatic_tax
  * @property null|int $automatically_finalizes_at The time when this invoice is currently scheduled to be automatically finalized. The field will be <code>null</code> if the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always be <code>null</code> - see <code>finalized_at</code> for the time when an already-finalized invoice was finalized.
- * @property null|string $billing_reason <p>Indicates the reason why the invoice was created.</p><p>* <code>manual</code>: Unrelated to a subscription, for example, created via the invoice editor. * <code>subscription</code>: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds. * <code>subscription_create</code>: A new subscription was created. * <code>subscription_cycle</code>: A subscription advanced into a new period. * <code>subscription_threshold</code>: A subscription reached a billing threshold. * <code>subscription_update</code>: A subscription was updated. * <code>upcoming</code>: Reserved for simulated invoices, per the upcoming invoice endpoint.</p>
+ * @property null|string $billing_reason <p>Indicates the reason why the invoice was created.</p><p>* <code>manual</code>: Unrelated to a subscription, for example, created via the invoice editor. * <code>subscription</code>: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds. * <code>subscription_create</code>: A new subscription was created. * <code>subscription_cycle</code>: A subscription advanced into a new period. * <code>subscription_threshold</code>: A subscription reached a billing threshold. * <code>subscription_update</code>: A subscription was updated. * <code>upcoming</code>: Reserved for upcoming invoices created through the Create Preview Invoice API or when an <code>invoice.upcoming</code> event is generated for an upcoming invoice on a subscription.</p>
  * @property string $collection_method Either <code>charge_automatically</code>, or <code>send_invoice</code>. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions.
  * @property null|(object{client_secret: string, type: string}&StripeObject) $confirmation_secret The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.

lib/Util/ApiVersion.php

@@ -6,5 +6,5 @@
 
 class ApiVersion
 {
-    const CURRENT = '2025-09-30.preview';
+    const CURRENT = '2025-10-29.preview';
 }