stripe · stripe-openapi · Sep 21, 2023 · Aug 30, 2023 · Aug 31, 2023 · Sep 15, 2023
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -40,7 +40,7 @@ jobs:
     strategy:
       matrix:
         php-version:
-          - "8.1"
+          - "8.2"
 
     steps:
       - uses: actions/checkout@v3
@@ -136,7 +136,7 @@ jobs:
 
       - name: Coveralls
         run: vendor/bin/php-coveralls -v --coverage_clover='clover.xml' --json_path='coveralls-upload.json'
-        if: env.COVERALLS_REPO_TOKEN && matrix.php-version == '8.1' && matrix.env == 'AUTOLOAD=1'
+        if: env.COVERALLS_REPO_TOKEN && matrix.php-version == '8.2' && matrix.env == 'AUTOLOAD=1'
         env:
           COVERALLS_RUN_LOCALLY: 1
           COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}

diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v532
+v540
diff --git a/composer.json b/composer.json
@@ -22,7 +22,6 @@
   },
   "require-dev": {
     "phpunit/phpunit": "^5.7 || ^9.0",
-    "squizlabs/php_codesniffer": "^3.3",
     "friendsofphp/php-cs-fixer": "3.5.0",
     "phpstan/phpstan": "^1.2",
     "php-coveralls/php-coveralls": "^2.5"

diff --git a/lib/Account.php b/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

diff --git a/lib/ConfirmationToken.php b/lib/ConfirmationToken.php
@@ -12,7 +12,6 @@
  * @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|string $customer ID of the Customer this ConfirmationToken belongs to.
  * @property null|int $expires_at Time at which this ConfirmationToken expires and can no longer be used to confirm a PaymentIntent or SetupIntent. This is set to null once this ConfirmationToken has been used.
  * @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 $mandate_data Data used for generating a Mandate.

diff --git a/lib/Event.php b/lib/Event.php
@@ -146,6 +146,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';

diff --git a/lib/File.php b/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
 {

diff --git a/lib/FileLink.php b/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.

diff --git a/lib/Invoice.php b/lib/Invoice.php
@@ -80,6 +80,7 @@
  * @property null|\Stripe\StripeObject $from_invoice Details of the invoice that was cloned. See the <a href="https://stripe.com/docs/invoicing/invoice-revisions">revision documentation</a> for more details.
  * @property null|string $hosted_invoice_url The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
  * @property null|string $invoice_pdf The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
+ * @property null|\Stripe\StripeObject $issuer The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
  * @property null|\Stripe\StripeObject $last_finalization_error The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
  * @property null|string|\Stripe\Invoice $latest_revision The ID of the most recent non-draft revision of this invoice
  * @property \Stripe\Collection<\Stripe\InvoiceLineItem> $lines The individual line items that make up the invoice. <code>lines</code> is sorted as follows: (1) pending invoice items (including prorations) in reverse chronological order, (2) subscription items in reverse chronological order, and (3) invoice items added after invoice creation in chronological order.

diff --git a/lib/Person.php b/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.

diff --git a/lib/QuotePreviewInvoice.php b/lib/QuotePreviewInvoice.php
@@ -76,6 +76,7 @@
  * @property null|int $ending_balance Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
  * @property null|string $footer Footer displayed on the invoice.
  * @property null|\Stripe\StripeObject $from_invoice Details of the invoice that was cloned. See the <a href="https://stripe.com/docs/invoicing/invoice-revisions">revision documentation</a> for more details.
+ * @property null|\Stripe\StripeObject $issuer The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
  * @property null|\Stripe\StripeObject $last_finalization_error The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
  * @property null|string|\Stripe\Invoice $latest_revision The ID of the most recent non-draft revision of this invoice
  * @property \Stripe\Collection<\Stripe\InvoiceLineItem> $lines The individual line items that make up the invoice. <code>lines</code> is sorted as follows: (1) pending invoice items (including prorations) in reverse chronological order, (2) subscription items in reverse chronological order, and (3) invoice items added after invoice creation in chronological order.

diff --git a/lib/Service/FileService.php b/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

diff --git a/lib/Service/Issuing/AuthorizationService.php b/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

diff --git a/lib/Service/PaymentIntentService.php b/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

diff --git a/lib/TaxId.php b/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.

diff --git a/lib/Util/ApiVersion.php b/lib/Util/ApiVersion.php
@@ -7,5 +7,5 @@
 class ApiVersion
 {
     const CURRENT = '2023-08-16';
-    const PREVIEW = '2023-08-11.preview-v2';
+    const PREVIEW = '2023-09-15.preview-v2';
 }
diff --git a/phpunit.no_autoload.xml b/phpunit.no_autoload.xml
@@ -1,4 +1,9 @@
-<phpunit bootstrap="tests/bootstrap.no_autoload.php" colors="true">
+<phpunit
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+    bootstrap="tests/bootstrap.no_autoload.php"
+    colors="true"
+>
     <php>
       <env name="IS_RUNNING_PHPUNIT" value="true"/>
     </php>

diff --git a/phpunit.xml b/phpunit.xml
@@ -1,4 +1,9 @@
-<phpunit bootstrap="tests/bootstrap.php" colors="true">
+<phpunit
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+    bootstrap="tests/bootstrap.php"
+    colors="true"
+>
     <php>
       <env name="IS_RUNNING_PHPUNIT" value="true"/>
     </php>