Update generated code (#1534)

* Update generated code for v426

* Update generated code for v426

* Update generated code for v428

* Update generated code for v431

* Update generated code for v432

---------

Co-authored-by: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com>
Co-authored-by: Richard Marmorstein <52928443+richardm-stripe@users.noreply.github.com>

OPENAPI_VERSION

@@ -1 +1 @@
-v425
+v432

lib/Account.php

@@ -29,7 +29,7 @@
  * @property null|string $email An email address associated with the account. It's not used for authentication and Stripe doesn't market to this field without explicit approval from the platform.
  * @property null|\Stripe\Collection<\Stripe\BankAccount|\Stripe\Card> $external_accounts External accounts (bank accounts and debit cards) currently attached to this account
  * @property null|\Stripe\StripeObject $future_requirements
- * @property null|\Stripe\Person $individual <p>This is an object representing a person associated with a Stripe account.</p><p>A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. See the <a href="https://stripe.com/docs/connect/standard-accounts">Standard onboarding</a> or <a href="https://stripe.com/docs/connect/express-accounts">Express onboarding documentation</a> for information about platform pre-filling and account onboarding steps.</p><p>Related guide: <a href="https://stripe.com/docs/connect/identity-verification-api#person-information">Handling identity verification with the API</a></p>
+ * @property null|\Stripe\Person $individual <p>This is an object representing a person associated with a Stripe account.</p><p>A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. See the <a href="https://stripe.com/docs/connect/standard-accounts">Standard onboarding</a> or <a href="https://stripe.com/docs/connect/express-accounts">Express onboarding documentation</a> for information about platform prefilling and account onboarding steps.</p><p>Related guide: <a href="https://stripe.com/docs/connect/identity-verification-api#person-information">Handling identity verification with the API</a></p>
  * @property null|\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|bool $payouts_enabled Whether Stripe can send payouts to this account.
  * @property null|\Stripe\StripeObject $requirements

lib/ApplicationFee.php

@@ -18,7 +18,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 null|string|\Stripe\Charge $originating_transaction ID of the corresponding charge on the platform account, if this fee was the result of a charge using the <code>destination</code> parameter.
  * @property bool $refunded Whether the fee has been fully refunded. If the fee is only partially refunded, this attribute will still be false.
- * @property \Stripe\Collection<\Stripe\StripeObject> $refunds A list of refunds that have been applied to the fee.
+ * @property \Stripe\Collection<\Stripe\ApplicationFeeRefund> $refunds A list of refunds that have been applied to the fee.
  */
 class ApplicationFee extends ApiResource
 {

lib/Apps/Secret.php

@@ -18,6 +18,7 @@
  * @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 int $created Time at which the object was created. Measured in seconds since the Unix epoch.
+ * @property null|bool $deleted If true, indicates that this secret has been deleted
  * @property null|int $expires_at The Unix timestamp for the expiry time of the secret, after which the secret deletes.
  * @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 A name for the secret that's unique within the scope.

lib/BalanceTransaction.php

@@ -54,8 +54,8 @@ class BalanceTransaction extends ApiResource
     const TYPE_PAYOUT_FAILURE = 'payout_failure';
     const TYPE_REFUND = 'refund';
     const TYPE_REFUND_FAILURE = 'refund_failure';
-    const TYPE_RESERVE_TRANSACTION = 'reserve_transaction';
     const TYPE_RESERVED_FUNDS = 'reserved_funds';
+    const TYPE_RESERVE_TRANSACTION = 'reserve_transaction';
     const TYPE_STRIPE_FEE = 'stripe_fee';
     const TYPE_STRIPE_FX_FEE = 'stripe_fx_fee';
     const TYPE_TAX_FEE = 'tax_fee';

lib/Card.php

@@ -29,11 +29,14 @@
  * @property null|string|\Stripe\Customer $customer The customer that this card belongs to. This attribute will not be in the card object if the card belongs to an account or recipient instead.
  * @property null|string $cvc_check If a CVC was provided, results of the check: <code>pass</code>, <code>fail</code>, <code>unavailable</code>, or <code>unchecked</code>. A result of unchecked indicates that CVC was provided but hasn't been checked yet. Checks are typically performed when attaching a card to a Customer object, or when creating a charge. For more details, see <a href="https://support.stripe.com/questions/check-if-a-card-is-valid-without-a-charge">Check if a card is valid without a charge</a>.
  * @property null|bool $default_for_currency Whether this card is the default external account for its currency.
+ * @property null|string $description A high-level description of the type of cards issued in this range. (For internal use only and not typically available in standard API requests.)
  * @property null|string $dynamic_last4 (For tokenized numbers only.) The last four digits of the device account number.
  * @property int $exp_month Two-digit number representing the card's expiration month.
  * @property int $exp_year Four-digit number representing the card's expiration year.
  * @property null|string $fingerprint <p>Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.</p><p><em>Starting May 1, 2021, card fingerprint in India for Connect will change to allow two fingerprints for the same card --- one for India and one for the rest of the world.</em></p>
  * @property string $funding Card funding type. Can be <code>credit</code>, <code>debit</code>, <code>prepaid</code>, or <code>unknown</code>.
+ * @property null|string $iin Issuer identification number of the card. (For internal use only and not typically available in standard API requests.)
+ * @property null|string $issuer The name of the card's issuing bank. (For internal use only and not typically available in standard API requests.)
  * @property string $last4 The last four digits of the card.
  * @property null|\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 Cardholder name.

lib/Charge.php

@@ -152,7 +152,7 @@ public function capture($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\SearchResult<Charge> the charge search results
+     * @return \Stripe\SearchResult<\Stripe\Charge> the charge search results
      */
     public static function search($params = null, $opts = null)
     {

lib/Checkout/Session.php

@@ -128,7 +128,7 @@ public function expire($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\LineItem> list of LineItems
+     * @return \Stripe\Collection<\Stripe\LineItem> list of line items
      */
     public static function allLineItems($id, $params = null, $opts = null)
     {

lib/CreditNote.php

@@ -85,7 +85,7 @@ public static function preview($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\CreditNoteLineItem> list of CreditNoteLineItems
+     * @return \Stripe\Collection<\Stripe\CreditNoteLineItem> list of credit note line items
      */
     public static function previewLines($params = null, $opts = null)
     {

lib/Customer.php

@@ -88,7 +88,7 @@ public function deleteDiscount($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\PaymentMethod> list of PaymentMethods
+     * @return \Stripe\Collection<\Stripe\PaymentMethod> list of payment methods
      */
     public static function allPaymentMethods($id, $params = null, $opts = null)
     {
@@ -107,7 +107,7 @@ public static function allPaymentMethods($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Customer the retrieved customer
+     * @return \Stripe\PaymentMethod the retrieved payment method
      */
     public function retrievePaymentMethod($payment_method, $params = null, $opts = null)
     {
@@ -125,7 +125,7 @@ public function retrievePaymentMethod($payment_method, $params = null, $opts = n
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\SearchResult<Customer> the customer search results
+     * @return \Stripe\SearchResult<\Stripe\Customer> the customer search results
      */
     public static function search($params = null, $opts = null)
     {

lib/Event.php

@@ -63,8 +63,8 @@ class Event extends ApiResource
     const ACCOUNT_EXTERNAL_ACCOUNT_UPDATED = 'account.external_account.updated';
     const ACCOUNT_UPDATED = 'account.updated';
     const APPLICATION_FEE_CREATED = 'application_fee.created';
-    const APPLICATION_FEE_REFUND_UPDATED = 'application_fee.refund.updated';
     const APPLICATION_FEE_REFUNDED = 'application_fee.refunded';
+    const APPLICATION_FEE_REFUND_UPDATED = 'application_fee.refund.updated';
     const BALANCE_AVAILABLE = 'balance.available';
     const BILLING_PORTAL_CONFIGURATION_CREATED = 'billing_portal.configuration.created';
     const BILLING_PORTAL_CONFIGURATION_UPDATED = 'billing_portal.configuration.updated';
@@ -80,8 +80,8 @@ class Event extends ApiResource
     const CHARGE_EXPIRED = 'charge.expired';
     const CHARGE_FAILED = 'charge.failed';
     const CHARGE_PENDING = 'charge.pending';
-    const CHARGE_REFUND_UPDATED = 'charge.refund.updated';
     const CHARGE_REFUNDED = 'charge.refunded';
+    const CHARGE_REFUND_UPDATED = 'charge.refund.updated';
     const CHARGE_SUCCEEDED = 'charge.succeeded';
     const CHARGE_UPDATED = 'charge.updated';
     const CHECKOUT_SESSION_ASYNC_PAYMENT_FAILED = 'checkout.session.async_payment_failed';
@@ -94,6 +94,7 @@ class Event extends ApiResource
     const CREDIT_NOTE_CREATED = 'credit_note.created';
     const CREDIT_NOTE_UPDATED = 'credit_note.updated';
     const CREDIT_NOTE_VOIDED = 'credit_note.voided';
+    const CUSTOMER_CASH_BALANCE_TRANSACTION_CREATED = 'customer_cash_balance_transaction.created';
     const CUSTOMER_CREATED = 'customer.created';
     const CUSTOMER_DELETED = 'customer.deleted';
     const CUSTOMER_DISCOUNT_CREATED = 'customer.discount.created';
@@ -115,7 +116,6 @@ class Event extends ApiResource
     const CUSTOMER_TAX_ID_DELETED = 'customer.tax_id.deleted';
     const CUSTOMER_TAX_ID_UPDATED = 'customer.tax_id.updated';
     const CUSTOMER_UPDATED = 'customer.updated';
-    const CUSTOMER_CASH_BALANCE_TRANSACTION_CREATED = 'customer_cash_balance_transaction.created';
     const FILE_CREATED = 'file.created';
     const FINANCIAL_CONNECTIONS_ACCOUNT_CREATED = 'financial_connections.account.created';
     const FINANCIAL_CONNECTIONS_ACCOUNT_DEACTIVATED = 'financial_connections.account.deactivated';
@@ -128,6 +128,9 @@ class Event extends ApiResource
     const IDENTITY_VERIFICATION_SESSION_REDACTED = 'identity.verification_session.redacted';
     const IDENTITY_VERIFICATION_SESSION_REQUIRES_INPUT = 'identity.verification_session.requires_input';
     const IDENTITY_VERIFICATION_SESSION_VERIFIED = 'identity.verification_session.verified';
+    const INVOICEITEM_CREATED = 'invoiceitem.created';
+    const INVOICEITEM_DELETED = 'invoiceitem.deleted';
+    const INVOICEITEM_UPDATED = 'invoiceitem.updated';
     const INVOICE_CREATED = 'invoice.created';
     const INVOICE_DELETED = 'invoice.deleted';
     const INVOICE_FINALIZATION_FAILED = 'invoice.finalization_failed';
@@ -141,16 +144,13 @@ class Event extends ApiResource
     const INVOICE_UPCOMING = 'invoice.upcoming';
     const INVOICE_UPDATED = 'invoice.updated';
     const INVOICE_VOIDED = 'invoice.voided';
-    const INVOICEITEM_CREATED = 'invoiceitem.created';
-    const INVOICEITEM_DELETED = 'invoiceitem.deleted';
-    const INVOICEITEM_UPDATED = 'invoiceitem.updated';
     const ISSUING_AUTHORIZATION_CREATED = 'issuing_authorization.created';
     const ISSUING_AUTHORIZATION_REQUEST = 'issuing_authorization.request';
     const ISSUING_AUTHORIZATION_UPDATED = 'issuing_authorization.updated';
-    const ISSUING_CARD_CREATED = 'issuing_card.created';
-    const ISSUING_CARD_UPDATED = 'issuing_card.updated';
     const ISSUING_CARDHOLDER_CREATED = 'issuing_cardholder.created';
     const ISSUING_CARDHOLDER_UPDATED = 'issuing_cardholder.updated';
+    const ISSUING_CARD_CREATED = 'issuing_card.created';
+    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';
@@ -233,9 +233,9 @@ class Event extends ApiResource
     const SUBSCRIPTION_SCHEDULE_EXPIRING = 'subscription_schedule.expiring';
     const SUBSCRIPTION_SCHEDULE_RELEASED = 'subscription_schedule.released';
     const SUBSCRIPTION_SCHEDULE_UPDATED = 'subscription_schedule.updated';
-    const TAX_SETTINGS_UPDATED = 'tax.settings.updated';
     const TAX_RATE_CREATED = 'tax_rate.created';
     const TAX_RATE_UPDATED = 'tax_rate.updated';
+    const TAX_SETTINGS_UPDATED = 'tax.settings.updated';
     const TERMINAL_READER_ACTION_FAILED = 'terminal.reader.action_failed';
     const TERMINAL_READER_ACTION_SUCCEEDED = 'terminal.reader.action_succeeded';
     const TEST_HELPERS_TEST_CLOCK_ADVANCING = 'test_helpers.test_clock.advancing';

lib/FinancialConnections/Account.php

@@ -72,7 +72,7 @@ public function disconnect($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\FinancialConnections\AccountOwner> list of BankConnectionsResourceOwners
+     * @return \Stripe\Collection<\Stripe\FinancialConnections\AccountOwner> list of account owners
      */
     public static function allOwners($id, $params = null, $opts = null)
     {

lib/Invoice.php

@@ -131,9 +131,6 @@ class Invoice extends ApiResource
     use ApiOperations\Search;
     use ApiOperations\Update;
 
-    const BILLING_CHARGE_AUTOMATICALLY = 'charge_automatically';
-    const BILLING_SEND_INVOICE = 'send_invoice';
-
     const BILLING_REASON_AUTOMATIC_PENDING_INVOICE_ITEM_INVOICE = 'automatic_pending_invoice_item_invoice';
     const BILLING_REASON_MANUAL = 'manual';
     const BILLING_REASON_QUOTE_ACCEPT = 'quote_accept';
@@ -151,14 +148,18 @@ class Invoice extends ApiResource
     const CUSTOMER_TAX_EXEMPT_NONE = 'none';
     const CUSTOMER_TAX_EXEMPT_REVERSE = 'reverse';
 
-    /** @deprecated */
-    const STATUS_DELETED = 'deleted';
     const STATUS_DRAFT = 'draft';
     const STATUS_OPEN = 'open';
     const STATUS_PAID = 'paid';
     const STATUS_UNCOLLECTIBLE = 'uncollectible';
     const STATUS_VOID = 'void';
 
+    const BILLING_CHARGE_AUTOMATICALLY = 'charge_automatically';
+    const BILLING_SEND_INVOICE = 'send_invoice';
+
+    /** @deprecated */
+    const STATUS_DELETED = 'deleted';
+
     /**
      * @param null|array $params
      * @param null|array|string $opts
@@ -251,7 +252,7 @@ public static function upcoming($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\InvoiceLineItem> list of InvoiceLineItems
+     * @return \Stripe\Collection<\Stripe\InvoiceLineItem> list of invoice line items
      */
     public static function upcomingLines($params = null, $opts = null)
     {
@@ -286,7 +287,7 @@ public function voidInvoice($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\SearchResult<Invoice> the invoice search results
+     * @return \Stripe\SearchResult<\Stripe\Invoice> the invoice search results
      */
     public static function search($params = null, $opts = null)
     {

lib/PaymentIntent.php

@@ -201,7 +201,7 @@ public function verifyMicrodeposits($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\SearchResult<PaymentIntent> the payment intent search results
+     * @return \Stripe\SearchResult<\Stripe\PaymentIntent> the payment intent search results
      */
     public static function search($params = null, $opts = null)
     {

lib/PaymentLink.php

@@ -72,7 +72,7 @@ class PaymentLink extends ApiResource
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return \Stripe\Collection<\Stripe\LineItem> list of LineItems
+     * @return \Stripe\Collection<\Stripe\LineItem> list of line items
      */
     public static function allLineItems($id, $params = null, $opts = null)
     {

lib/Payout.php

@@ -47,22 +47,6 @@ class Payout extends ApiResource
     use ApiOperations\Retrieve;
     use ApiOperations\Update;
 
-    const FAILURE_ACCOUNT_CLOSED = 'account_closed';
-    const FAILURE_ACCOUNT_FROZEN = 'account_frozen';
-    const FAILURE_BANK_ACCOUNT_RESTRICTED = 'bank_account_restricted';
-    const FAILURE_BANK_OWNERSHIP_CHANGED = 'bank_ownership_changed';
-    const FAILURE_COULD_NOT_PROCESS = 'could_not_process';
-    const FAILURE_DEBIT_NOT_AUTHORIZED = 'debit_not_authorized';
-    const FAILURE_DECLINED = 'declined';
-    const FAILURE_INCORRECT_ACCOUNT_HOLDER_ADDRESS = 'incorrect_account_holder_address';
-    const FAILURE_INCORRECT_ACCOUNT_HOLDER_NAME = 'incorrect_account_holder_name';
-    const FAILURE_INCORRECT_ACCOUNT_HOLDER_TAX_ID = 'incorrect_account_holder_tax_id';
-    const FAILURE_INSUFFICIENT_FUNDS = 'insufficient_funds';
-    const FAILURE_INVALID_ACCOUNT_NUMBER = 'invalid_account_number';
-    const FAILURE_INVALID_CURRENCY = 'invalid_currency';
-    const FAILURE_NO_ACCOUNT = 'no_account';
-    const FAILURE_UNSUPPORTED_CARD = 'unsupported_card';
-
     const METHOD_INSTANT = 'instant';
     const METHOD_STANDARD = 'standard';
 
@@ -79,6 +63,22 @@ class Payout extends ApiResource
     const TYPE_BANK_ACCOUNT = 'bank_account';
     const TYPE_CARD = 'card';
 
+    const FAILURE_ACCOUNT_CLOSED = 'account_closed';
+    const FAILURE_ACCOUNT_FROZEN = 'account_frozen';
+    const FAILURE_BANK_ACCOUNT_RESTRICTED = 'bank_account_restricted';
+    const FAILURE_BANK_OWNERSHIP_CHANGED = 'bank_ownership_changed';
+    const FAILURE_COULD_NOT_PROCESS = 'could_not_process';
+    const FAILURE_DEBIT_NOT_AUTHORIZED = 'debit_not_authorized';
+    const FAILURE_DECLINED = 'declined';
+    const FAILURE_INCORRECT_ACCOUNT_HOLDER_ADDRESS = 'incorrect_account_holder_address';
+    const FAILURE_INCORRECT_ACCOUNT_HOLDER_NAME = 'incorrect_account_holder_name';
+    const FAILURE_INCORRECT_ACCOUNT_HOLDER_TAX_ID = 'incorrect_account_holder_tax_id';
+    const FAILURE_INSUFFICIENT_FUNDS = 'insufficient_funds';
+    const FAILURE_INVALID_ACCOUNT_NUMBER = 'invalid_account_number';
+    const FAILURE_INVALID_CURRENCY = 'invalid_currency';
+    const FAILURE_NO_ACCOUNT = 'no_account';
+    const FAILURE_UNSUPPORTED_CARD = 'unsupported_card';
+
     /**
      * @param null|array $params
      * @param null|array|string $opts