Update generated code for v2291 and 1d5fb9dc5cd047376b47f4bbb9af90300932ea60

Author: stripe-openapi[bot]

CODEGEN_VERSION

@@ -1 +1 @@
-5fab6377244519650455ed4213e07c477c0bfece
+1d5fb9dc5cd047376b47f4bbb9af90300932ea60

OPENAPI_VERSION

@@ -1 +1 @@
-v2290
+v2291

init.php

@@ -1083,6 +1083,8 @@
 require __DIR__ . '/lib/FrMealVouchersOnboarding.php';
 require __DIR__ . '/lib/FundingInstructions.php';
 require __DIR__ . '/lib/FxQuote.php';
+require __DIR__ . '/lib/GiftCard.php';
+require __DIR__ . '/lib/GiftCardOperation.php';
 require __DIR__ . '/lib/Identity/BlocklistEntry.php';
 require __DIR__ . '/lib/Identity/VerificationReport.php';
 require __DIR__ . '/lib/Identity/VerificationSession.php';
@@ -1218,6 +1220,8 @@
 require __DIR__ . '/lib/Service/Forwarding/RequestService.php';
 require __DIR__ . '/lib/Service/FrMealVouchersOnboardingService.php';
 require __DIR__ . '/lib/Service/FxQuoteService.php';
+require __DIR__ . '/lib/Service/GiftCardOperationService.php';
+require __DIR__ . '/lib/Service/GiftCardService.php';
 require __DIR__ . '/lib/Service/Identity/BlocklistEntryService.php';
 require __DIR__ . '/lib/Service/Identity/IdentityServiceFactory.php';
 require __DIR__ . '/lib/Service/Identity/VerificationReportService.php';
@@ -1301,6 +1305,7 @@
 require __DIR__ . '/lib/Service/Tax/TaxServiceFactory.php';
 require __DIR__ . '/lib/Service/Tax/TransactionService.php';
 require __DIR__ . '/lib/Service/TaxCodeService.php';
+require __DIR__ . '/lib/Service/TaxFundService.php';
 require __DIR__ . '/lib/Service/TaxIdService.php';
 require __DIR__ . '/lib/Service/TaxRateService.php';
 require __DIR__ . '/lib/Service/Terminal/ConfigurationService.php';
@@ -1475,6 +1480,7 @@
 require __DIR__ . '/lib/Tax/TransactionLineItem.php';
 require __DIR__ . '/lib/TaxCode.php';
 require __DIR__ . '/lib/TaxDeductedAtSource.php';
+require __DIR__ . '/lib/TaxFund.php';
 require __DIR__ . '/lib/TaxId.php';
 require __DIR__ . '/lib/TaxRate.php';
 require __DIR__ . '/lib/Terminal/Configuration.php';

lib/Charge.php

@@ -42,7 +42,7 @@
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
  * @property null|string $currency Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency code</a>, in lowercase. Must be a <a href="https://stripe.com/docs/currencies">supported currency</a>.
  * @property null|(object{amount_subtotal: int, amount_total: int, fx_rate: string, source_currency: string}&\Stripe\StripeObject) $currency_conversion Currency conversion details for <a href="https://docs.stripe.com/payments/checkout/adaptive-pricing">Adaptive Pricing</a> sessions created before 2025-03-31.
- * @property null|(object{billing_details?: null|(object{address: (object{city: null|string, country: null|string, line1: null|string, line2: null|string, postal_code: null|string, state: null|string}&\Stripe\StripeObject), name: null|string}&\Stripe\StripeObject), email?: null|string, id: string, payment_method_details?: null|(object{allow_redisplay: string, au_becs_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), bacs_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), boleto?: (object{fingerprint: null|string}&\Stripe\StripeObject), card?: (object{brand: string, country: null|string, exp_month: int, exp_year: int, fingerprint: null|string, funding: string, iin?: null|string, last4: string, wallet: null|(object{type: string}&\Stripe\StripeObject)}&\Stripe\StripeObject), link?: (object{fingerprint?: null|string}&\Stripe\StripeObject), sepa_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), type: string, us_bank_account?: (object{fingerprint: null|string}&\Stripe\StripeObject)}&\Stripe\StripeObject), phone?: null|string, shipping_details: null|(object{address: (object{city: null|string, country: null|string, line1: null|string, line2: null|string, postal_code: null|string, state: null|string}&\Stripe\StripeObject), name: string}&\Stripe\StripeObject)}&\Stripe\StripeObject) $current_attempt The customer's pending attempt to pay that requires your approval. Contains information about the customer and their payment details.
+ * @property null|(object{billing_details?: null|(object{address: (object{city: null|string, country: null|string, line1: null|string, line2: null|string, postal_code: null|string, state: null|string}&\Stripe\StripeObject), name: null|string}&\Stripe\StripeObject), email?: null|string, id: string, payment_method_details?: null|(object{allow_redisplay: string, au_becs_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), bacs_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), boleto?: (object{fingerprint: null|string}&\Stripe\StripeObject), card?: (object{brand: string, country: null|string, exp_month: int, exp_year: int, fingerprint: null|string, funding: string, iin?: null|string, last4: string, wallet: null|(object{type: string}&\Stripe\StripeObject)}&\Stripe\StripeObject), link?: (object{fingerprint?: null|string}&\Stripe\StripeObject), pix?: (object{fingerprint: null|string}&\Stripe\StripeObject), sepa_debit?: (object{fingerprint: null|string}&\Stripe\StripeObject), type: string, us_bank_account?: (object{fingerprint: null|string}&\Stripe\StripeObject)}&\Stripe\StripeObject), phone?: null|string, shipping_details: null|(object{address: (object{city: null|string, country: null|string, line1: null|string, line2: null|string, postal_code: null|string, state: null|string}&\Stripe\StripeObject), name: string}&\Stripe\StripeObject)}&\Stripe\StripeObject) $current_attempt The customer's pending attempt to pay that requires your approval. Contains information about the customer and their payment details.
  * @property ((object{dropdown?: (object{default_value: null|string, options: (object{label: string, value: string}&\Stripe\StripeObject)[], value: null|string}&\Stripe\StripeObject), key: string, label: (object{custom: null|string, type: string}&\Stripe\StripeObject), numeric?: (object{default_value: null|string, maximum_length: null|int, minimum_length: null|int, value: null|string}&\Stripe\StripeObject), optional: bool, text?: (object{default_value: null|string, maximum_length: null|int, minimum_length: null|int, value: null|string}&\Stripe\StripeObject), type: string}&\Stripe\StripeObject))[] $custom_fields Collect additional information from your customer using custom fields. Up to 3 fields are supported. You can't set this parameter if <code>ui_mode</code> is <code>custom</code>.
  * @property null|string[] $custom_payment_method_types A list of the types of <a href="https://docs.stripe.com/payments/payment-methods/custom-payment-methods">custom payment methods</a> (e.g. cpmt_123) this Checkout Session is allowed to accept.
  * @property (object{after_submit: null|(object{message: string}&\Stripe\StripeObject), shipping_address: null|(object{message: string}&\Stripe\StripeObject), submit: null|(object{message: string}&\Stripe\StripeObject), terms_of_service_acceptance: null|(object{message: string}&\Stripe\StripeObject)}&\Stripe\StripeObject) $custom_text

lib/Checkout/Session.php

@@ -0,0 +1,152 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe;
+
+/**
+ * Represents third-party gift cards that can be used as a payment method through Stripe.
+ *
+ * @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 $brand The brand of the gift card.
+ * @property null|int $exp_month The expiration month of the gift card.
+ * @property null|int $exp_year The expiration year of the gift card.
+ * @property null|GiftCardOperation|string $last_operation The last operation performed on this gift card.
+ * @property null|string $last4 The last four digits of the gift card number.
+ * @property bool $livemode If the object exists in live mode, the value is <code>true</code>. If the object exists in test mode, the value is <code>false</code>.
+ */
+class GiftCard extends ApiResource
+{
+    const OBJECT_NAME = 'gift_card';
+
+    const BRAND_FISERV_VALUELINK = 'fiserv_valuelink';
+    const BRAND_GIVEX = 'givex';
+    const BRAND_SVS = 'svs';
+
+    /**
+     * Creates a gift card object.
+     *
+     * @param null|array{brand: string, exp_month?: int, exp_year?: int, expand?: string[], number?: string, pin?: string} $params
+     * @param null|array|string $options
+     *
+     * @return GiftCard the created resource
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public static function create($params = null, $options = null)
+    {
+        self::_validateParams($params);
+        $url = static::classUrl();
+
+        list($response, $opts) = static::_staticRequest('post', $url, $params, $options);
+        $obj = Util\Util::convertToStripeObject($response->json, $opts);
+        $obj->setLastResponse($response);
+
+        return $obj;
+    }
+
+    /**
+     * Retrieves a third-party gift card object.
+     *
+     * @param array|string $id the ID of the API resource to retrieve, or an options array containing an `id` key
+     * @param null|array|string $opts
+     *
+     * @return GiftCard
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public static function retrieve($id, $opts = null)
+    {
+        $opts = Util\RequestOptions::parse($opts);
+        $instance = new static($id, $opts);
+        $instance->refresh();
+
+        return $instance;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation the activated gift card operation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public function activate($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/activate';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation the cashouted gift card operation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public function cashout($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/cashout';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation the checked gift card operation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public function checkBalance($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/check_balance';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation the reloaded gift card operation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public function reload($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/reload';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation the voided gift card operation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public function voidOperation($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/void_operation';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+}

lib/ConfirmationToken.php

@@ -0,0 +1,86 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe;
+
+/**
+ * A GiftCardOperation represents an operation performed on a third-party gift card,
+ * such as activation, deactivation, reload, cashout, balance check, or void.
+ *
+ * @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|(object{balance: (object{amount: int, currency: string}&StripeObject)}&StripeObject) $activation Details about a gift card activation operation.
+ * @property null|(object{voided_operation: string}&StripeObject) $activation_void Details about a gift card activation void operation.
+ * @property null|(object{balance: (object{amount: int, currency: string}&StripeObject)}&StripeObject) $balance_check Details about a gift card balance check operation.
+ * @property null|(object{balance: (object{amount: int, currency: string}&StripeObject), previous_balance: null|(object{amount: int, currency: string}&StripeObject)}&StripeObject) $cashout Details about a gift card cashout operation.
+ * @property null|(object{balance: (object{amount: int, currency: string}&StripeObject), voided_operation: string}&StripeObject) $cashout_void Details about a gift card cashout void operation.
+ * @property int $completed_at The timestamp of when this operation was completed.
+ * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
+ * @property null|(object{}&StripeObject) $deactivation Details about a gift card deactivation operation.
+ * @property null|string $failure_code The failure code of the operation. Only present if the status is failed.
+ * @property GiftCard|string $gift_card The gift card this operation was performed on.
+ * @property bool $livemode If the object exists in live mode, the value is <code>true</code>. If the object exists in test mode, the value is <code>false</code>.
+ * @property null|string $on_behalf_of The connected account whose credentials were used to perform this operation.
+ * @property null|(object{balance: (object{amount: int, currency: string}&StripeObject), previous_balance: null|(object{amount: int, currency: string}&StripeObject)}&StripeObject) $reload Details about a gift card reload operation.
+ * @property null|(object{balance: (object{amount: int, currency: string}&StripeObject), voided_operation: string}&StripeObject) $reload_void Details about a gift card reload void operation.
+ * @property string $status The status of the operation.
+ * @property string $type The type of operation performed.
+ */
+class GiftCardOperation extends ApiResource
+{
+    const OBJECT_NAME = 'gift_card_operation';
+
+    const FAILURE_CODE_ACTION_NOT_SUPPORTED = 'action_not_supported';
+    const FAILURE_CODE_CARD_ALREADY_ACTIVATED = 'card_already_activated';
+    const FAILURE_CODE_CARD_EXPIRED = 'card_expired';
+    const FAILURE_CODE_CARD_NOT_ACTIVATED = 'card_not_activated';
+    const FAILURE_CODE_DO_NOT_HONOR = 'do_not_honor';
+    const FAILURE_CODE_GENERIC_FAILURE = 'generic_failure';
+    const FAILURE_CODE_INSUFFICIENT_BALANCE = 'insufficient_balance';
+    const FAILURE_CODE_INVALID_AMOUNT = 'invalid_amount';
+    const FAILURE_CODE_INVALID_CURRENCY = 'invalid_currency';
+    const FAILURE_CODE_INVALID_NUMBER = 'invalid_number';
+    const FAILURE_CODE_INVALID_PIN = 'invalid_pin';
+    const FAILURE_CODE_INVALID_TRACK_DATA = 'invalid_track_data';
+    const FAILURE_CODE_LOST_CARD = 'lost_card';
+    const FAILURE_CODE_LOST_OR_STOLEN_CARD = 'lost_or_stolen_card';
+    const FAILURE_CODE_PIN_REQUIRED = 'pin_required';
+    const FAILURE_CODE_PIN_TRIES_EXCEEDED = 'pin_tries_exceeded';
+    const FAILURE_CODE_PROCESSING_ERROR = 'processing_error';
+    const FAILURE_CODE_PROVIDER_UNAVAILABLE = 'provider_unavailable';
+    const FAILURE_CODE_STOLEN_CARD = 'stolen_card';
+    const FAILURE_CODE_SUSPECTED_FRAUD = 'suspected_fraud';
+    const FAILURE_CODE_TIMEOUT = 'timeout';
+
+    const STATUS_FAILED = 'failed';
+    const STATUS_SUCCEEDED = 'succeeded';
+
+    const TYPE_ACTIVATION = 'activation';
+    const TYPE_ACTIVATION_VOID = 'activation_void';
+    const TYPE_BALANCE_CHECK = 'balance_check';
+    const TYPE_CASHOUT = 'cashout';
+    const TYPE_CASHOUT_VOID = 'cashout_void';
+    const TYPE_DEACTIVATION = 'deactivation';
+    const TYPE_RELOAD = 'reload';
+    const TYPE_RELOAD_VOID = 'reload_void';
+
+    /**
+     * Retrieves a third-party gift card operation object.
+     *
+     * @param array|string $id the ID of the API resource to retrieve, or an options array containing an `id` key
+     * @param null|array|string $opts
+     *
+     * @return GiftCardOperation
+     *
+     * @throws Exception\ApiErrorException if the request fails
+     */
+    public static function retrieve($id, $opts = null)
+    {
+        $opts = Util\RequestOptions::parse($opts);
+        $instance = new static($id, $opts);
+        $instance->refresh();
+
+        return $instance;
+    }
+}

lib/GiftCard.php

@@ -21,6 +21,7 @@
  * @property null|string $loss_reason The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
  * @property \Stripe\StripeObject $metadata Set of <a href="https://docs.stripe.com/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|(object{dispute_response: null|(object{error: null|string, merchant_evidence_files: null|string[]}&\Stripe\StripeObject), pre_arbitration_response: null|(object{error: null|string, merchant_evidence_files: null|string[]}&\Stripe\StripeObject), pre_arbitration_submission: null|(object{error: null|string, merchant_evidence_files: null|string[]}&\Stripe\StripeObject)}&\Stripe\StripeObject) $network_lifecycle Incoming information from the card network for this dispute. Includes the acquiring merchant's initial response, pre-arbitration submission, and pre-arbitration response to the dispute.
+ * @property null|(object{grant_deadline: null|int, granted_at: null|int, revocable_after: null|int, revoked_at: null|int, status: string}&\Stripe\StripeObject) $provisional_credit Provisional credit details for this dispute.
  * @property string $status Current status of the dispute.
  * @property string|Transaction $transaction The transaction being disputed.
  * @property null|(object{debit_reversal: null|string, received_debit: string}&\Stripe\StripeObject) $treasury <a href="https://docs.stripe.com/api/treasury">Treasury</a> details related to this dispute if it was created on a <a href="https://docs.stripe.com/api/treasury/financial_accounts">FinancialAccount</a>