Update generated code for beta

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 12.5.0 - 2023-09-28
+* [#1582](https://github.com/stripe/stripe-php/pull/1582) Generate Discount, SourceTransaction and use sections in more places
+* [#1584](https://github.com/stripe/stripe-php/pull/1584) Update generated code
+  * Add support for `rendering` on `Invoice`
+
 ## 12.5.0-beta.1 - 2023-09-21
 * [#1578](https://github.com/stripe/stripe-php/pull/1578) Update generated code for beta
   * Remove support for `customer` on `ConfirmationToken`

OPENAPI_VERSION

@@ -1 +1 @@
-v540
+v569

init.php

@@ -134,10 +134,10 @@
 require __DIR__ . '/lib/InvoiceLineItem.php';
 require __DIR__ . '/lib/Issuing/Authorization.php';
 require __DIR__ . '/lib/Issuing/Card.php';
-require __DIR__ . '/lib/Issuing/CardBundle.php';
-require __DIR__ . '/lib/Issuing/CardDesign.php';
 require __DIR__ . '/lib/Issuing/Cardholder.php';
 require __DIR__ . '/lib/Issuing/Dispute.php';
+require __DIR__ . '/lib/Issuing/PersonalizationDesign.php';
+require __DIR__ . '/lib/Issuing/PhysicalBundle.php';
 require __DIR__ . '/lib/Issuing/Transaction.php';
 require __DIR__ . '/lib/LineItem.php';
 require __DIR__ . '/lib/LoginLink.php';
@@ -211,12 +211,12 @@
 require __DIR__ . '/lib/Service/InvoiceItemService.php';
 require __DIR__ . '/lib/Service/InvoiceService.php';
 require __DIR__ . '/lib/Service/Issuing/AuthorizationService.php';
-require __DIR__ . '/lib/Service/Issuing/CardBundleService.php';
-require __DIR__ . '/lib/Service/Issuing/CardDesignService.php';
 require __DIR__ . '/lib/Service/Issuing/CardService.php';
 require __DIR__ . '/lib/Service/Issuing/CardholderService.php';
 require __DIR__ . '/lib/Service/Issuing/DisputeService.php';
 require __DIR__ . '/lib/Service/Issuing/IssuingServiceFactory.php';
+require __DIR__ . '/lib/Service/Issuing/PersonalizationDesignService.php';
+require __DIR__ . '/lib/Service/Issuing/PhysicalBundleService.php';
 require __DIR__ . '/lib/Service/Issuing/TransactionService.php';
 require __DIR__ . '/lib/Service/MandateService.php';
 require __DIR__ . '/lib/Service/OrderService.php';
@@ -265,9 +265,9 @@
 require __DIR__ . '/lib/Service/Terminal/TerminalServiceFactory.php';
 require __DIR__ . '/lib/Service/TestHelpers/CustomerService.php';
 require __DIR__ . '/lib/Service/TestHelpers/Issuing/AuthorizationService.php';
-require __DIR__ . '/lib/Service/TestHelpers/Issuing/CardDesignService.php';
 require __DIR__ . '/lib/Service/TestHelpers/Issuing/CardService.php';
 require __DIR__ . '/lib/Service/TestHelpers/Issuing/IssuingServiceFactory.php';
+require __DIR__ . '/lib/Service/TestHelpers/Issuing/PersonalizationDesignService.php';
 require __DIR__ . '/lib/Service/TestHelpers/Issuing/TransactionService.php';
 require __DIR__ . '/lib/Service/TestHelpers/RefundService.php';
 require __DIR__ . '/lib/Service/TestHelpers/Terminal/ReaderService.php';

lib/Event.php

@@ -47,6 +47,7 @@
  * @property \Stripe\StripeObject $data
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
  * @property int $pending_webhooks Number of webhooks that haven't been successfully delivered (for example, to return a 20x response) to the URLs you specify.
+ * @property null|\Stripe\StripeObject $reason Information about the action that causes the event. Only present when the event is triggered by an API request or an <a href="https://stripe.com/docs/billing/revenue-recovery/automations">Automation</a> action.
  * @property null|\Stripe\StripeObject $request Information on the API request that triggers the event.
  * @property string $type Description of the event (for example, <code>invoice.created</code> or <code>charge.refunded</code>).
  */
@@ -117,6 +118,7 @@ class Event extends ApiResource
     const CUSTOMER_SUBSCRIPTION_COLLECTION_PAUSED = 'customer.subscription.collection_paused';
     const CUSTOMER_SUBSCRIPTION_COLLECTION_RESUMED = 'customer.subscription.collection_resumed';
     const CUSTOMER_SUBSCRIPTION_CREATED = 'customer.subscription.created';
+    const CUSTOMER_SUBSCRIPTION_CUSTOM_EVENT = 'customer.subscription.custom_event';
     const CUSTOMER_SUBSCRIPTION_DELETED = 'customer.subscription.deleted';
     const CUSTOMER_SUBSCRIPTION_PAUSED = 'customer.subscription.paused';
     const CUSTOMER_SUBSCRIPTION_PENDING_UPDATE_APPLIED = 'customer.subscription.pending_update_applied';
@@ -166,16 +168,16 @@ class Event extends ApiResource
     const ISSUING_CARDHOLDER_CREATED = 'issuing_cardholder.created';
     const ISSUING_CARDHOLDER_UPDATED = 'issuing_cardholder.updated';
     const ISSUING_CARD_CREATED = 'issuing_card.created';
-    const ISSUING_CARD_DESIGN_ACTIVATED = 'issuing_card_design.activated';
-    const ISSUING_CARD_DESIGN_DEACTIVATED = 'issuing_card_design.deactivated';
-    const ISSUING_CARD_DESIGN_REJECTED = 'issuing_card_design.rejected';
-    const ISSUING_CARD_DESIGN_UPDATED = 'issuing_card_design.updated';
     const ISSUING_CARD_UPDATED = 'issuing_card.updated';
     const ISSUING_DISPUTE_CLOSED = 'issuing_dispute.closed';
     const ISSUING_DISPUTE_CREATED = 'issuing_dispute.created';
     const ISSUING_DISPUTE_FUNDS_REINSTATED = 'issuing_dispute.funds_reinstated';
     const ISSUING_DISPUTE_SUBMITTED = 'issuing_dispute.submitted';
     const ISSUING_DISPUTE_UPDATED = 'issuing_dispute.updated';
+    const ISSUING_PERSONALIZATION_DESIGN_ACTIVATED = 'issuing_personalization_design.activated';
+    const ISSUING_PERSONALIZATION_DESIGN_DEACTIVATED = 'issuing_personalization_design.deactivated';
+    const ISSUING_PERSONALIZATION_DESIGN_REJECTED = 'issuing_personalization_design.rejected';
+    const ISSUING_PERSONALIZATION_DESIGN_UPDATED = 'issuing_personalization_design.updated';
     const ISSUING_TRANSACTION_CREATED = 'issuing_transaction.created';
     const ISSUING_TRANSACTION_UPDATED = 'issuing_transaction.updated';
     const MANDATE_UPDATED = 'mandate.updated';
@@ -367,6 +369,7 @@ class Event extends ApiResource
     const TYPE_CUSTOMER_SUBSCRIPTION_COLLECTION_PAUSED = 'customer.subscription.collection_paused';
     const TYPE_CUSTOMER_SUBSCRIPTION_COLLECTION_RESUMED = 'customer.subscription.collection_resumed';
     const TYPE_CUSTOMER_SUBSCRIPTION_CREATED = 'customer.subscription.created';
+    const TYPE_CUSTOMER_SUBSCRIPTION_CUSTOM_EVENT = 'customer.subscription.custom_event';
     const TYPE_CUSTOMER_SUBSCRIPTION_DELETED = 'customer.subscription.deleted';
     const TYPE_CUSTOMER_SUBSCRIPTION_PAUSED = 'customer.subscription.paused';
     const TYPE_CUSTOMER_SUBSCRIPTION_PENDING_UPDATE_APPLIED = 'customer.subscription.pending_update_applied';
@@ -416,16 +419,16 @@ class Event extends ApiResource
     const TYPE_ISSUING_CARDHOLDER_CREATED = 'issuing_cardholder.created';
     const TYPE_ISSUING_CARDHOLDER_UPDATED = 'issuing_cardholder.updated';
     const TYPE_ISSUING_CARD_CREATED = 'issuing_card.created';
-    const TYPE_ISSUING_CARD_DESIGN_ACTIVATED = 'issuing_card_design.activated';
-    const TYPE_ISSUING_CARD_DESIGN_DEACTIVATED = 'issuing_card_design.deactivated';
-    const TYPE_ISSUING_CARD_DESIGN_REJECTED = 'issuing_card_design.rejected';
-    const TYPE_ISSUING_CARD_DESIGN_UPDATED = 'issuing_card_design.updated';
     const TYPE_ISSUING_CARD_UPDATED = 'issuing_card.updated';
     const TYPE_ISSUING_DISPUTE_CLOSED = 'issuing_dispute.closed';
     const TYPE_ISSUING_DISPUTE_CREATED = 'issuing_dispute.created';
     const TYPE_ISSUING_DISPUTE_FUNDS_REINSTATED = 'issuing_dispute.funds_reinstated';
     const TYPE_ISSUING_DISPUTE_SUBMITTED = 'issuing_dispute.submitted';
     const TYPE_ISSUING_DISPUTE_UPDATED = 'issuing_dispute.updated';
+    const TYPE_ISSUING_PERSONALIZATION_DESIGN_ACTIVATED = 'issuing_personalization_design.activated';
+    const TYPE_ISSUING_PERSONALIZATION_DESIGN_DEACTIVATED = 'issuing_personalization_design.deactivated';
+    const TYPE_ISSUING_PERSONALIZATION_DESIGN_REJECTED = 'issuing_personalization_design.rejected';
+    const TYPE_ISSUING_PERSONALIZATION_DESIGN_UPDATED = 'issuing_personalization_design.updated';
     const TYPE_ISSUING_TRANSACTION_CREATED = 'issuing_transaction.created';
     const TYPE_ISSUING_TRANSACTION_UPDATED = 'issuing_transaction.updated';
     const TYPE_MANDATE_UPDATED = 'mandate.updated';

lib/Invoice.php

@@ -99,7 +99,8 @@
  * @property int $pre_payment_credit_notes_amount Total amount of all pre-payment credit notes issued for this invoice.
  * @property null|string|\Stripe\Quote $quote The quote this invoice was generated from.
  * @property null|string $receipt_number This is the transaction number that appears on email receipts sent for this invoice.
- * @property null|\Stripe\StripeObject $rendering_options Options for invoice PDF rendering.
+ * @property null|\Stripe\StripeObject $rendering The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
+ * @property null|\Stripe\StripeObject $rendering_options This is a legacy field that will be removed soon. For details about <code>rendering_options</code>, refer to <code>rendering</code> instead. Options for invoice PDF rendering.
  * @property null|\Stripe\StripeObject $shipping_cost The details of the cost of shipping, including the ShippingRate applied on the invoice.
  * @property null|\Stripe\StripeObject $shipping_details Shipping details for the invoice. The Invoice PDF will use the <code>shipping_details</code> value if it is set, otherwise the PDF will render the shipping address from the customer.
  * @property int $starting_balance Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.

lib/Issuing/Card.php

@@ -11,7 +11,6 @@
  * @property string $object String representing the object's type. Objects of the same type share the same value.
  * @property string $brand The brand of the card.
  * @property null|string $cancellation_reason The reason why the card was canceled.
- * @property null|string|\Stripe\Issuing\CardDesign $card_design The card design object belonging to this card.
  * @property \Stripe\Issuing\Cardholder $cardholder <p>An Issuing <code>Cardholder</code> object represents an individual or business entity who is <a href="https://stripe.com/docs/issuing">issued</a> cards.</p><p>Related guide: <a href="https://stripe.com/docs/issuing/cards#create-cardholder">How to create a cardholder</a></p>
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
  * @property string $currency Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency code</a>, in lowercase. Supported currencies are <code>usd</code> in the US, <code>eur</code> in the EU, and <code>gbp</code> in the UK.
@@ -23,6 +22,7 @@
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
  * @property \Stripe\StripeObject $metadata Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  * @property null|string $number The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with <a href="https://stripe.com/docs/api/expanding_objects">the <code>expand</code> parameter</a>. Additionally, it's only available via the <a href="https://stripe.com/docs/api/issuing/cards/retrieve">&quot;Retrieve a card&quot; endpoint</a>, not via &quot;List all cards&quot; or any other endpoint.
+ * @property null|string|\Stripe\Issuing\PersonalizationDesign $personalization_design The personalization design object belonging to this card.
  * @property null|string|\Stripe\Issuing\Card $replaced_by The latest card that replaces this card, if any.
  * @property null|string|\Stripe\Issuing\Card $replacement_for The card this card replaces, if any.
  * @property null|string $replacement_reason The reason why the previous card needed to be replaced.

lib/Issuing/CardDesign.php → lib/Issuing/PersonalizationDesign.php

@@ -5,23 +5,23 @@
 namespace Stripe\Issuing;
 
 /**
- * A Card Design is a logical grouping of a Card Bundle, card logo, and carrier text that represents a product line.
+ * A Personalization Design is a logical grouping of a Physical Bundle, card logo, and carrier text that represents a product line.
  *
  * @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 string|\Stripe\Issuing\CardBundle $card_bundle The card bundle object belonging to this card design.
- * @property null|string|\Stripe\File $card_logo The file for the card logo, for use with card bundles that support card logos.
- * @property null|\Stripe\StripeObject $carrier_text Hash containing carrier text, for use with card bundles that support carrier text.
- * @property null|string $lookup_key A lookup key used to retrieve card designs dynamically from a static string. This may be up to 200 characters.
+ * @property null|string|\Stripe\File $card_logo The file for the card logo, for use with physical bundles that support card logos.
+ * @property null|\Stripe\StripeObject $carrier_text Hash containing carrier text, for use with physical bundles that support carrier text.
+ * @property null|string $lookup_key A lookup key used to retrieve personalization designs dynamically from a static string. This may be up to 200 characters.
  * @property \Stripe\StripeObject $metadata Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  * @property null|string $name Friendly display name.
+ * @property string|\Stripe\Issuing\PhysicalBundle $physical_bundle The physical bundle object belonging to this personalization design.
  * @property \Stripe\StripeObject $preferences
  * @property \Stripe\StripeObject $rejection_reasons
- * @property string $status Whether this card design can be used to create cards.
+ * @property string $status Whether this personalization design can be used to create cards.
  */
-class CardDesign extends \Stripe\ApiResource
+class PersonalizationDesign extends \Stripe\ApiResource
 {
-    const OBJECT_NAME = 'issuing.card_design';
+    const OBJECT_NAME = 'issuing.personalization_design';
 
     use \Stripe\ApiOperations\All;
     use \Stripe\ApiOperations\Create;

lib/Issuing/CardBundle.php → lib/Issuing/PhysicalBundle.php

@@ -5,19 +5,19 @@
 namespace Stripe\Issuing;
 
 /**
- * A Card Bundle represents the bundle of physical items - card stock, carrier letter, and envelope - that is shipped to a cardholder when you create a physical card.
+ * A Physical Bundle represents the bundle of physical items - card stock, carrier letter, and envelope - that is shipped to a cardholder when you create a physical card.
  *
  * @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|\Stripe\StripeObject $features
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
  * @property string $name Friendly display name.
- * @property string $status Whether this card bundle can be used to create cards.
- * @property string $type Whether this card bundle is a standard Stripe offering or custom-made for you.
+ * @property string $status Whether this physical bundle can be used to create cards.
+ * @property string $type Whether this physical bundle is a standard Stripe offering or custom-made for you.
  */
-class CardBundle extends \Stripe\ApiResource
+class PhysicalBundle extends \Stripe\ApiResource
 {
-    const OBJECT_NAME = 'issuing.card_bundle';
+    const OBJECT_NAME = 'issuing.physical_bundle';
 
     use \Stripe\ApiOperations\All;
     use \Stripe\ApiOperations\Retrieve;

lib/Mandate.php

@@ -5,18 +5,18 @@
 namespace Stripe;
 
 /**
- * A Mandate is a record of the permission a customer has given you to debit their payment method.
+ * A Mandate is a record of the permission that your customer gives you to debit their payment method.
  *
  * @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 \Stripe\StripeObject $customer_acceptance
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
  * @property null|\Stripe\StripeObject $multi_use
- * @property null|string $on_behalf_of The account (if any) for which the mandate is intended.
+ * @property null|string $on_behalf_of The account (if any) that the mandate is intended for.
  * @property string|\Stripe\PaymentMethod $payment_method ID of the payment method associated with this mandate.
  * @property \Stripe\StripeObject $payment_method_details
  * @property null|\Stripe\StripeObject $single_use
- * @property string $status The status of the mandate, which indicates whether it can be used to initiate a payment.
+ * @property string $status The mandate status indicates whether or not you can use it to initiate a payment.
  * @property string $type The type of the mandate.
  */
 class Mandate extends ApiResource