Update generated code (#1579)

* Update generated code for v533

* Update generated code for v535

* Update generated code for v536

* Update generated code for v539

* Update generated code for v540

* Update generated code for v540

---------

Co-authored-by: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com>
Co-authored-by: anniel-stripe <[email protected]>

OPENAPI_VERSION

@@ -1 +1 @@
-v532
+v540

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 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\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/handling-api-verification#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/Event.php

@@ -131,6 +131,7 @@ class Event extends ApiResource
     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';

lib/File.php

@@ -5,25 +5,25 @@
 namespace Stripe;
 
 /**
- * This is an object representing a file hosted on Stripe's servers. The
- * file may have been uploaded by yourself using the <a href="https://stripe.com/docs/api#create_file">create file</a>
- * request (for example, when uploading dispute evidence) or it may have
- * been created by Stripe (for example, the results of a <a href="#scheduled_queries">Sigma scheduled
+ * This object represents files hosted on Stripe's servers. You can upload
+ * files with the <a href="https://stripe.com/docs/api#create_file">create file</a> request
+ * (for example, when uploading dispute evidence). Stripe also
+ * creates files independetly (for example, the results of a <a href="#scheduled_queries">Sigma scheduled
  * query</a>).
  *
  * Related guide: <a href="https://stripe.com/docs/file-upload">File upload guide</a>
  *
  * @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|int $expires_at The time at which the file expires and is no longer available in epoch seconds.
- * @property null|string $filename A filename for the file, suitable for saving to a filesystem.
+ * @property null|int $expires_at The file expires and isn't available at this time in epoch seconds.
+ * @property null|string $filename The suitable name for saving the file to a filesystem.
  * @property null|\Stripe\Collection<\Stripe\FileLink> $links A list of <a href="https://stripe.com/docs/api#file_links">file links</a> that point at this file.
  * @property string $purpose The <a href="https://stripe.com/docs/file-upload#uploading-a-file">purpose</a> of the uploaded file.
- * @property int $size The size in bytes of the file object.
- * @property null|string $title A user friendly title for the document.
- * @property null|string $type The type of the file returned (e.g., <code>csv</code>, <code>pdf</code>, <code>jpg</code>, or <code>png</code>).
- * @property null|string $url The URL from which the file can be downloaded using your live secret API key.
+ * @property int $size The size of the file object in bytes.
+ * @property null|string $title A suitable title for the document.
+ * @property null|string $type The returned file type (for example, <code>csv</code>, <code>pdf</code>, <code>jpg</code>, or <code>png</code>).
+ * @property null|string $url Use your live secret API key to download the file from this URL.
  */
 class File extends ApiResource
 {

lib/FileLink.php

@@ -6,14 +6,14 @@
 
 /**
  * To share the contents of a <code>File</code> object with non-Stripe users, you can
- * create a <code>FileLink</code>. <code>FileLink</code>s contain a URL that can be used to
+ * create a <code>FileLink</code>. <code>FileLink</code>s contain a URL that you can use to
  * retrieve the contents of the file without authentication.
  *
  * @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 bool $expired Whether this link is already expired.
- * @property null|int $expires_at Time at which the link expires.
+ * @property bool $expired Returns if the link is already expired.
+ * @property null|int $expires_at Time that the link expires.
  * @property string|\Stripe\File $file The file object this link points to.
  * @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.

lib/Person.php

@@ -10,7 +10,7 @@
  * 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.
  *
- * Related guide: <a href="https://stripe.com/docs/connect/identity-verification-api#person-information">Handling identity verification with the API</a>
+ * Related guide: <a href="https://stripe.com/docs/connect/handling-api-verification#person-information">Handling identity verification with the API</a>
  *
  * @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.

lib/Service/FileService.php

@@ -7,9 +7,9 @@
 class FileService extends \Stripe\Service\AbstractService
 {
     /**
-     * Returns a list of the files that your account has access to. The files are
-     * returned sorted by creation date, with the most recently created files appearing
-     * first.
+     * Returns a list of the files that your account has access to. Stripe sorts and
+     * returns the files by their creation dates, placing the most recently created
+     * files at the top.
      *
      * @param null|array $params
      * @param null|array|\Stripe\Util\RequestOptions $opts
@@ -24,10 +24,9 @@ public function all($params = null, $opts = null)
     }
 
     /**
-     * Retrieves the details of an existing file object. Supply the unique file ID from
-     * a file, and Stripe will return the corresponding file object. To access file
-     * contents, see the <a href="/docs/file-upload#download-file-contents">File Upload
-     * Guide</a>.
+     * Retrieves the details of an existing file object. After you supply a unique file
+     * ID, Stripe returns the corresponding file object. Learn how to <a
+     * href="/docs/file-upload#download-file-contents">access file contents</a>.
      *
      * @param string $id
      * @param null|array $params

lib/Service/Issuing/AuthorizationService.php

@@ -24,12 +24,12 @@ public function all($params = null, $opts = null)
     }
 
     /**
-     * Approves a pending Issuing <code>Authorization</code> object. This request
-     * should be made within the timeout window of the <a
+     * [Deprecated] Approves a pending Issuing <code>Authorization</code> object. This
+     * request should be made within the timeout window of the <a
      * href="/docs/issuing/controls/real-time-authorizations">real-time
-     * authorization</a> flow.  You can also respond directly to the webhook request to
-     * approve an authorization (preferred). More details can be found <a
-     * href="/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
+     * authorization</a> flow.  This method is deprecated. Instead, <a
+     * href="/docs/issuing/controls/real-time-authorizations#authorization-handling">respond
+     * directly to the webhook request to approve an authorization</a>.
      *
      * @param string $id
      * @param null|array $params
@@ -45,12 +45,12 @@ public function approve($id, $params = null, $opts = null)
     }
 
     /**
-     * Declines a pending Issuing <code>Authorization</code> object. This request
-     * should be made within the timeout window of the <a
+     * [Deprecated] Declines a pending Issuing <code>Authorization</code> object. This
+     * request should be made within the timeout window of the <a
      * href="/docs/issuing/controls/real-time-authorizations">real time
-     * authorization</a> flow. You can also respond directly to the webhook request to
-     * decline an authorization (preferred). More details can be found <a
-     * href="/docs/issuing/controls/real-time-authorizations#authorization-handling">here</a>.
+     * authorization</a> flow. This method is deprecated. Instead, <a
+     * href="/docs/issuing/controls/real-time-authorizations#authorization-handling">respond
+     * directly to the webhook request to decline an authorization</a>.
      *
      * @param string $id
      * @param null|array $params

lib/Service/PaymentIntentService.php

@@ -239,10 +239,10 @@ public function search($params = null, $opts = null)
     /**
      * Updates properties on a PaymentIntent object without confirming.
      *
-     * Depending on which properties you update, you may need to confirm the
-     * PaymentIntent again. For example, updating the <code>payment_method</code> will
-     * always require you to confirm the PaymentIntent again. If you prefer to update
-     * and confirm at the same time, we recommend updating properties via the <a
+     * Depending on which properties you update, you might need to confirm the
+     * PaymentIntent again. For example, updating the <code>payment_method</code>
+     * always requires you to confirm the PaymentIntent again. If you prefer to update
+     * and confirm at the same time, we recommend updating properties through the <a
      * href="/docs/api/payment_intents/confirm">confirm API</a> instead.
      *
      * @param string $id

lib/TaxId.php

@@ -5,10 +5,10 @@
 namespace Stripe;
 
 /**
- * You can add one or multiple tax IDs to a <a href="https://stripe.com/docs/api/customers">customer</a>.
- * A customer's tax IDs are displayed on invoices and credit notes issued for the customer.
+ * You can add one or multiple tax IDs to a <a href="https://stripe.com/docs/api/customers">customer</a> or account.
+ * Customer and account tax IDs get displayed on related invoices and credit notes.
  *
- * Related guide: <a href="https://stripe.com/docs/billing/taxes/tax-ids">Customer tax identification numbers</a>
+ * Related guides: <a href="https://stripe.com/docs/billing/taxes/tax-ids">Customer tax identification numbers</a>, <a href="https://stripe.com/docs/invoicing/connect#account-tax-ids">Account tax IDs</a>
  *
  * @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.