Merge pull request #1888 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

API_VERSION

@@ -1 +1 @@
-2025-07-30.preview
+2025-08-27.preview

CHANGELOG.md

@@ -19,6 +19,14 @@ This release changes the pinned API version to `2025-07-30.preview`.
   * Remove support for thin event `V2CoreAccountLinkCompletedEvent`
   * Remove support for thin event `V2OffSessionPaymentRequiresCaptureEvent` with related object `V2.Payments.OffSessionPayment`
 
+## 17.5.0 - 2025-07-30
+This release changes the pinned API version to `2025-07-30.basil`.
+
+* [#1887](https://github.com/stripe/stripe-php/pull/1887) Update generated code
+  * Add support for `origin_context` on `Checkout.Session`
+* [#1881](https://github.com/stripe/stripe-php/pull/1881) Ensure compatibility with POST on older versions of libcurl
+  * Fixes an issue with older versions of php/libcurl where certain SDK calls that have empty POST bodies will result in a 400 Bad Request returned from the server.
+
 ## 17.5.0-beta.2 - 2025-07-09
 * [#1886](https://github.com/stripe/stripe-php/pull/1886) Pull in V2 FinancialAccount changes for June release
   * Add support for `close` and `create` methods on resource `V2.MoneyManagement.FinancialAccount`
@@ -46,6 +54,8 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Change type of `V2.MoneyManagement.ReceivedCredit.balance_transfer.payout_v1` from `string` to `nullable(string)`
 
 ## 17.4.0 - 2025-07-01
+This release changes the pinned API version to `2025-06-30.basil`.
+
 * [#1880](https://github.com/stripe/stripe-php/pull/1880) Update generated code
   * Add support for `migrate` method on resource `Subscription`
   * Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `Terminal.Reader`

OPENAPI_VERSION

@@ -1 +1 @@
-v1868
+v1932

lib/AccountSession.php

@@ -270,8 +270,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                 return Exception\IdempotencyException::factory($msg, $rcode, $rbody, $resp, $rheaders, $code);
 
                 // The beginning of the section generated from our OpenAPI spec
-            case 'temporary_session_expired':
-                return Exception\TemporarySessionExpiredException::factory(
+            case 'already_canceled':
+                return Exception\AlreadyCanceledException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -280,8 +280,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'non_zero_balance':
-                return Exception\NonZeroBalanceException::factory(
+            case 'already_exists':
+                return Exception\AlreadyExistsException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -290,8 +290,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'already_exists':
-                return Exception\AlreadyExistsException::factory(
+            case 'blocked_by_stripe':
+                return Exception\BlockedByStripeException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -300,8 +300,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'feature_not_enabled':
-                return Exception\FeatureNotEnabledException::factory(
+            case 'controlled_by_dashboard':
+                return Exception\ControlledByDashboardException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -310,8 +310,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'financial_account_not_open':
-                return Exception\FinancialAccountNotOpenException::factory(
+            case 'feature_not_enabled':
+                return Exception\FeatureNotEnabledException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -320,8 +320,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'blocked_by_stripe':
-                return Exception\BlockedByStripeException::factory(
+            case 'financial_account_not_open':
+                return Exception\FinancialAccountNotOpenException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -330,8 +330,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'already_canceled':
-                return Exception\AlreadyCanceledException::factory(
+            case 'insufficient_funds':
+                return Exception\InsufficientFundsException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -340,18 +340,21 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'not_cancelable':
-                return Exception\NotCancelableException::factory(
+            case 'invalid_payment_method':
+                $invalidParam = isset($errorData['invalid_param']) ? $errorData['invalid_param'] : null;
+
+                return Exception\InvalidPaymentMethodException::factory(
                     $msg,
                     $rcode,
                     $rbody,
                     $resp,
                     $rheaders,
-                    $code
+                    $code,
+                    $invalidParam
                 );
 
-            case 'insufficient_funds':
-                return Exception\InsufficientFundsException::factory(
+            case 'invalid_payout_method':
+                return Exception\InvalidPayoutMethodException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -360,8 +363,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'quota_exceeded':
-                return Exception\QuotaExceededException::factory(
+            case 'non_zero_balance':
+                return Exception\NonZeroBalanceException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -370,8 +373,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'recipient_not_notifiable':
-                return Exception\RecipientNotNotifiableException::factory(
+            case 'not_cancelable':
+                return Exception\NotCancelableException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -380,8 +383,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'invalid_payout_method':
-                return Exception\InvalidPayoutMethodException::factory(
+            case 'quota_exceeded':
+                return Exception\QuotaExceededException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -390,8 +393,8 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'controlled_by_dashboard':
-                return Exception\ControlledByDashboardException::factory(
+            case 'recipient_not_notifiable':
+                return Exception\RecipientNotNotifiableException::factory(
                     $msg,
                     $rcode,
                     $rbody,
@@ -400,17 +403,14 @@ private static function _specificV2APIError($rbody, $rcode, $rheaders, $resp, $e
                     $code
                 );
 
-            case 'invalid_payment_method':
-                $invalidParam = isset($errorData['invalid_param']) ? $errorData['invalid_param'] : null;
-
-                return Exception\InvalidPaymentMethodException::factory(
+            case 'temporary_session_expired':
+                return Exception\TemporarySessionExpiredException::factory(
                     $msg,
                     $rcode,
                     $rbody,
                     $resp,
                     $rheaders,
-                    $code,
-                    $invalidParam
+                    $code
                 );
 
                 // The end of the section generated from our OpenAPI spec

lib/ApiRequestor.php

@@ -8,14 +8,9 @@
  * This is an object representing your Stripe balance. You can retrieve it to see
  * the balance currently on your Stripe account.
  *
- * You can also retrieve the balance history, which contains a list of
- * <a href="https://stripe.com/docs/reporting/balance-transaction-types">transactions</a> that contributed to the balance
- * (charges, payouts, and so forth).
+ * The top-level <code>available</code> and <code>pending</code> comprise your &quot;payments balance.&quot;
  *
- * The available and pending amounts for each currency are broken down further by
- * payment source types.
- *
- * Related guide: <a href="https://stripe.com/docs/connect/account-balances">Understanding Connect account balances</a>
+ * Related guide: <a href="https://stripe.com/docs/payments/balances">Balances and settlement time</a>, <a href="https://stripe.com/docs/connect/account-balances">Understanding Connect account balances</a>
  *
  * @property string $object String representing the object's type. Objects of the same type share the same value.
  * @property (object{amount: int, currency: string, source_types?: (object{bank_account?: int, card?: int, fpx?: int}&StripeObject)}&StripeObject)[] $available Available funds that you can transfer or pay out automatically by Stripe or explicitly through the <a href="https://stripe.com/docs/api#transfers">Transfers API</a> or <a href="https://stripe.com/docs/api#payouts">Payouts API</a>. You can find the available balance for each currency and payment type in the <code>source_types</code> property.

lib/Balance.php

@@ -12,9 +12,7 @@
  * to manage your connected accounts’ balance settings instead.
  *
  * @property string $object String representing the object's type. Objects of the same type share the same value.
- * @property null|bool $debit_negative_balances A Boolean indicating if Stripe should try to reclaim negative balances from an attached bank account. See <a href="/connect/account-balances">Understanding Connect account balances</a> for details. The default value is <code>false</code> when <a href="/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a> is <code>application</code>, which includes Custom accounts, otherwise <code>true</code>.
- * @property null|(object{schedule: null|(object{interval: null|string, monthly_payout_days?: int[], weekly_payout_days?: string[]}&StripeObject), statement_descriptor: null|string, status: string}&StripeObject) $payouts Settings specific to the account's payouts.
- * @property (object{delay_days: int}&StripeObject) $settlement_timing
+ * @property (object{debit_negative_balances: null|bool, payouts: null|(object{schedule: null|(object{interval: null|string, monthly_payout_days?: int[], weekly_payout_days?: string[]}&StripeObject), statement_descriptor: null|string, status: string}&StripeObject), settlement_timing: (object{delay_days: int}&StripeObject)}&StripeObject) $payments
  */
 class BalanceSettings extends SingletonApiResource
 {
@@ -46,7 +44,7 @@ public static function retrieve($opts = null)
      * href="/connect/authentication">Making API calls for connected accounts</a>.
      *
      * @param string $id the ID of the resource to update
-     * @param null|array{debit_negative_balances?: bool, expand?: string[], payouts?: array{schedule?: array{interval?: string, monthly_payout_days?: int[], weekly_payout_days?: string[]}, statement_descriptor?: string}, settlement_timing?: array{delay_days_override?: int}} $params
+     * @param null|array{expand?: string[], payments: array{debit_negative_balances?: bool, payouts?: array{schedule?: array{interval?: string, monthly_payout_days?: int[], weekly_payout_days?: string[]}, statement_descriptor?: string}, settlement_timing?: array{delay_days_override?: int}}} $params
      * @param null|array|string $opts
      *
      * @return BalanceSettings the updated resource

lib/BalanceSettings.php

@@ -121,6 +121,16 @@ public function getClientId()
         return $this->config['client_id'];
     }
 
+    /**
+     * Gets the Stripe account ID used by the client to send requests.
+     *
+     * @return null|string the Stripe account ID used by the client to send requests
+     */
+    public function getStripeAccount()
+    {
+        return $this->config['stripe_account'];
+    }
+
     /**
      * Gets the base URL for Stripe's API.
      *

lib/BaseStripeClient.php

@@ -10,7 +10,7 @@
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
  * @property string $customer ID of customer for which the alert triggered
  * @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 $value The value triggering the alert
+ * @property string $value The value triggering the alert
  */
 class AlertTriggered extends \Stripe\ApiResource
 {

lib/Billing/AlertTriggered.php

@@ -16,7 +16,7 @@
  * @property (object{formula: string}&\Stripe\StripeObject) $default_aggregation
  * @property string $display_name The meter's name.
  * @property string $event_name The name of the meter event to record usage for. Corresponds with the <code>event_name</code> field on meter events.
- * @property null|string $event_time_window The time window to pre-aggregate meter events for, if any.
+ * @property null|string $event_time_window The time window which meter events have been pre-aggregated for, if any.
  * @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 $status The meter's status.
  * @property (object{deactivated_at: null|int}&\Stripe\StripeObject) $status_transitions