Update generated code (#1793)

* Update generated code for v1399

* Update generated code for v1409

* Update generated code for v1412

---------

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

Author: stripe-openapi[bot]

OPENAPI_VERSION

@@ -1 +1 @@
-v1347
+v1412

lib/BalanceTransaction.php

@@ -24,7 +24,7 @@
  * @property string $reporting_category Learn more about how <a href="https://stripe.com/docs/reports/reporting-categories">reporting categories</a> can help you understand balance transactions from an accounting perspective.
  * @property null|string|\Stripe\ApplicationFee|\Stripe\ApplicationFeeRefund|\Stripe\Charge|\Stripe\ConnectCollectionTransfer|\Stripe\CustomerCashBalanceTransaction|\Stripe\Dispute|\Stripe\Issuing\Authorization|\Stripe\Issuing\Dispute|\Stripe\Issuing\Transaction|\Stripe\Payout|\Stripe\Refund|\Stripe\ReserveTransaction|\Stripe\TaxDeductedAtSource|\Stripe\Topup|\Stripe\Transfer|\Stripe\TransferReversal $source This transaction relates to the Stripe object.
  * @property string $status The transaction's net funds status in the Stripe balance, which are either <code>available</code> or <code>pending</code>.
- * @property string $type Transaction type: <code>adjustment</code>, <code>advance</code>, <code>advance_funding</code>, <code>anticipation_repayment</code>, <code>application_fee</code>, <code>application_fee_refund</code>, <code>charge</code>, <code>climate_order_purchase</code>, <code>climate_order_refund</code>, <code>connect_collection_transfer</code>, <code>contribution</code>, <code>issuing_authorization_hold</code>, <code>issuing_authorization_release</code>, <code>issuing_dispute</code>, <code>issuing_transaction</code>, <code>obligation_outbound</code>, <code>obligation_reversal_inbound</code>, <code>payment</code>, <code>payment_failure_refund</code>, <code>payment_network_reserve_hold</code>, <code>payment_network_reserve_release</code>, <code>payment_refund</code>, <code>payment_reversal</code>, <code>payment_unreconciled</code>, <code>payout</code>, <code>payout_cancel</code>, <code>payout_failure</code>, <code>refund</code>, <code>refund_failure</code>, <code>reserve_transaction</code>, <code>reserved_funds</code>, <code>stripe_fee</code>, <code>stripe_fx_fee</code>, <code>tax_fee</code>, <code>topup</code>, <code>topup_reversal</code>, <code>transfer</code>, <code>transfer_cancel</code>, <code>transfer_failure</code>, or <code>transfer_refund</code>. Learn more about <a href="https://stripe.com/docs/reports/balance-transaction-types">balance transaction types and what they represent</a>. To classify transactions for accounting purposes, consider <code>reporting_category</code> instead.
+ * @property string $type Transaction type: <code>adjustment</code>, <code>advance</code>, <code>advance_funding</code>, <code>anticipation_repayment</code>, <code>application_fee</code>, <code>application_fee_refund</code>, <code>charge</code>, <code>climate_order_purchase</code>, <code>climate_order_refund</code>, <code>connect_collection_transfer</code>, <code>contribution</code>, <code>issuing_authorization_hold</code>, <code>issuing_authorization_release</code>, <code>issuing_dispute</code>, <code>issuing_transaction</code>, <code>obligation_outbound</code>, <code>obligation_reversal_inbound</code>, <code>payment</code>, <code>payment_failure_refund</code>, <code>payment_network_reserve_hold</code>, <code>payment_network_reserve_release</code>, <code>payment_refund</code>, <code>payment_reversal</code>, <code>payment_unreconciled</code>, <code>payout</code>, <code>payout_cancel</code>, <code>payout_failure</code>, <code>payout_minimum_balance_hold</code>, <code>payout_minimum_balance_release</code>, <code>refund</code>, <code>refund_failure</code>, <code>reserve_transaction</code>, <code>reserved_funds</code>, <code>stripe_fee</code>, <code>stripe_fx_fee</code>, <code>tax_fee</code>, <code>topup</code>, <code>topup_reversal</code>, <code>transfer</code>, <code>transfer_cancel</code>, <code>transfer_failure</code>, or <code>transfer_refund</code>. Learn more about <a href="https://stripe.com/docs/reports/balance-transaction-types">balance transaction types and what they represent</a>. To classify transactions for accounting purposes, consider <code>reporting_category</code> instead.
  */
 class BalanceTransaction extends ApiResource
 {
@@ -57,6 +57,8 @@ class BalanceTransaction extends ApiResource
     const TYPE_PAYOUT = 'payout';
     const TYPE_PAYOUT_CANCEL = 'payout_cancel';
     const TYPE_PAYOUT_FAILURE = 'payout_failure';
+    const TYPE_PAYOUT_MINIMUM_BALANCE_HOLD = 'payout_minimum_balance_hold';
+    const TYPE_PAYOUT_MINIMUM_BALANCE_RELEASE = 'payout_minimum_balance_release';
     const TYPE_REFUND = 'refund';
     const TYPE_REFUND_FAILURE = 'refund_failure';
     const TYPE_RESERVED_FUNDS = 'reserved_funds';

lib/Billing/CreditGrant.php

@@ -16,7 +16,7 @@
  * @property string $category The category of this credit grant. This is for tracking purposes and isn't displayed to the customer.
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
  * @property string|\Stripe\Customer $customer ID of the customer receiving the billing credits.
- * @property null|int $effective_at The time when the billing credits become effective—when they're eligible for use.
+ * @property null|int $effective_at The time when the billing credits become effective-when they're eligible for use.
  * @property null|int $expires_at The time when the billing credits expire. If not present, the billing credits don't expire.
  * @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/Billing/Meter.php

@@ -5,7 +5,7 @@
 namespace Stripe\Billing;
 
 /**
- * A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then attach the billing meter to a price and attach the price to a subscription to charge the user for the number of API calls they make.
+ * Meters specify how to aggregate meter events over a billing period. Meter events represent the actions that customers take in your system. Meters attach to prices and form the basis of the bill.
  *
  * Related guide: <a href="https://docs.stripe.com/billing/subscriptions/usage-based">Usage based billing</a>
  *

lib/Billing/MeterEvent.php

@@ -5,8 +5,7 @@
 namespace Stripe\Billing;
 
 /**
- * A billing meter event represents a customer's usage of a product. Meter events are used to bill a customer based on their usage.
- * Meter events are associated with billing meters, which define the shape of the event's payload and how those events are aggregated for billing.
+ * Meter events represent actions that customers take in your system. You can use meter events to bill a customer based on their usage. Meter events are associated with billing meters, which define both the contents of the event’s payload and how to aggregate those events.
  *
  * @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.

lib/Card.php

@@ -22,6 +22,7 @@
  * @property null|string $address_state State/County/Province/Region.
  * @property null|string $address_zip ZIP or postal code.
  * @property null|string $address_zip_check If <code>address_zip</code> was provided, results of the check: <code>pass</code>, <code>fail</code>, <code>unavailable</code>, or <code>unchecked</code>.
+ * @property null|string $allow_redisplay This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
  * @property null|string[] $available_payout_methods A set of available payout methods for this card. Only values from this set should be passed as the <code>method</code> when creating a payout.
  * @property string $brand Card brand. Can be <code>American Express</code>, <code>Diners Club</code>, <code>Discover</code>, <code>Eftpos Australia</code>, <code>Girocard</code>, <code>JCB</code>, <code>MasterCard</code>, <code>UnionPay</code>, <code>Visa</code>, or <code>Unknown</code>.
  * @property null|string $country Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
@@ -38,13 +39,21 @@
  * @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.
  * @property null|\Stripe\StripeObject $networks
+ * @property null|string $regulated_status Status of a card based on the card issuer.
  * @property null|string $status For external accounts that are cards, possible values are <code>new</code> and <code>errored</code>. If a payout fails, the status is set to <code>errored</code> and <a href="https://stripe.com/docs/payouts#payout-schedule">scheduled payouts</a> are stopped until account details are updated.
  * @property null|string $tokenization_method If the card number is tokenized, this is the method that was used. Can be <code>android_pay</code> (includes Google Pay), <code>apple_pay</code>, <code>masterpass</code>, <code>visa_checkout</code>, or null.
  */
 class Card extends ApiResource
 {
     const OBJECT_NAME = 'card';
 
+    const ALLOW_REDISPLAY_ALWAYS = 'always';
+    const ALLOW_REDISPLAY_LIMITED = 'limited';
+    const ALLOW_REDISPLAY_UNSPECIFIED = 'unspecified';
+
+    const REGULATED_STATUS_REGULATED = 'regulated';
+    const REGULATED_STATUS_UNREGULATED = 'unregulated';
+
     /**
      * Delete a specified external account for a given account.
      *

lib/Service/Billing/MeterService.php

@@ -57,7 +57,8 @@ public function create($params = null, $opts = null)
     }
 
     /**
-     * Deactivates a billing meter.
+     * When a meter is deactivated, no more meter events will be accepted for this
+     * meter. You can’t attach a deactivated meter to a price.
      *
      * @param string $id
      * @param null|array $params
@@ -73,7 +74,8 @@ public function deactivate($id, $params = null, $opts = null)
     }
 
     /**
-     * Reactivates a billing meter.
+     * When a meter is reactivated, events for this meter can be accepted and you can
+     * attach the meter to a price.
      *
      * @param string $id
      * @param null|array $params

lib/Source.php

@@ -22,6 +22,7 @@
  * @property null|\Stripe\StripeObject $ach_debit
  * @property null|\Stripe\StripeObject $acss_debit
  * @property null|\Stripe\StripeObject $alipay
+ * @property null|string $allow_redisplay This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
  * @property null|int $amount A positive integer in the smallest currency unit (that is, 100 cents for $1.00, or 1 for ¥1, Japanese Yen being a zero-decimal currency) representing the total amount associated with the source. This is the amount for which the source will be chargeable once ready. Required for <code>single_use</code> sources.
  * @property null|\Stripe\StripeObject $au_becs_debit
  * @property null|\Stripe\StripeObject $bancontact
@@ -61,6 +62,10 @@ class Source extends ApiResource
 
     use ApiOperations\Update;
 
+    const ALLOW_REDISPLAY_ALWAYS = 'always';
+    const ALLOW_REDISPLAY_LIMITED = 'limited';
+    const ALLOW_REDISPLAY_UNSPECIFIED = 'unspecified';
+
     const FLOW_CODE_VERIFICATION = 'code_verification';
     const FLOW_NONE = 'none';
     const FLOW_RECEIVER = 'receiver';

lib/TaxId.php

@@ -17,7 +17,7 @@
  * @property null|string|\Stripe\Customer $customer ID of the customer.
  * @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 $owner The account or customer the tax ID belongs to.
- * @property string $type Type of the tax ID, one of <code>ad_nrt</code>, <code>ae_trn</code>, <code>ar_cuit</code>, <code>au_abn</code>, <code>au_arn</code>, <code>bg_uic</code>, <code>bh_vat</code>, <code>bo_tin</code>, <code>br_cnpj</code>, <code>br_cpf</code>, <code>by_tin</code>, <code>ca_bn</code>, <code>ca_gst_hst</code>, <code>ca_pst_bc</code>, <code>ca_pst_mb</code>, <code>ca_pst_sk</code>, <code>ca_qst</code>, <code>ch_uid</code>, <code>ch_vat</code>, <code>cl_tin</code>, <code>cn_tin</code>, <code>co_nit</code>, <code>cr_tin</code>, <code>de_stn</code>, <code>do_rcn</code>, <code>ec_ruc</code>, <code>eg_tin</code>, <code>es_cif</code>, <code>eu_oss_vat</code>, <code>eu_vat</code>, <code>gb_vat</code>, <code>ge_vat</code>, <code>hk_br</code>, <code>hr_oib</code>, <code>hu_tin</code>, <code>id_npwp</code>, <code>il_vat</code>, <code>in_gst</code>, <code>is_vat</code>, <code>jp_cn</code>, <code>jp_rn</code>, <code>jp_trn</code>, <code>ke_pin</code>, <code>kr_brn</code>, <code>kz_bin</code>, <code>li_uid</code>, <code>li_vat</code>, <code>ma_vat</code>, <code>md_vat</code>, <code>mx_rfc</code>, <code>my_frp</code>, <code>my_itn</code>, <code>my_sst</code>, <code>ng_tin</code>, <code>no_vat</code>, <code>no_voec</code>, <code>nz_gst</code>, <code>om_vat</code>, <code>pe_ruc</code>, <code>ph_tin</code>, <code>ro_tin</code>, <code>rs_pib</code>, <code>ru_inn</code>, <code>ru_kpp</code>, <code>sa_vat</code>, <code>sg_gst</code>, <code>sg_uen</code>, <code>si_tin</code>, <code>sv_nit</code>, <code>th_vat</code>, <code>tr_tin</code>, <code>tw_vat</code>, <code>tz_vat</code>, <code>ua_vat</code>, <code>us_ein</code>, <code>uy_ruc</code>, <code>uz_tin</code>, <code>uz_vat</code>, <code>ve_rif</code>, <code>vn_tin</code>, or <code>za_vat</code>. Note that some legacy tax IDs have type <code>unknown</code>
+ * @property string $type Type of the tax ID, one of <code>ad_nrt</code>, <code>ae_trn</code>, <code>al_tin</code>, <code>am_tin</code>, <code>ao_tin</code>, <code>ar_cuit</code>, <code>au_abn</code>, <code>au_arn</code>, <code>ba_tin</code>, <code>bb_tin</code>, <code>bg_uic</code>, <code>bh_vat</code>, <code>bo_tin</code>, <code>br_cnpj</code>, <code>br_cpf</code>, <code>bs_tin</code>, <code>by_tin</code>, <code>ca_bn</code>, <code>ca_gst_hst</code>, <code>ca_pst_bc</code>, <code>ca_pst_mb</code>, <code>ca_pst_sk</code>, <code>ca_qst</code>, <code>cd_nif</code>, <code>ch_uid</code>, <code>ch_vat</code>, <code>cl_tin</code>, <code>cn_tin</code>, <code>co_nit</code>, <code>cr_tin</code>, <code>de_stn</code>, <code>do_rcn</code>, <code>ec_ruc</code>, <code>eg_tin</code>, <code>es_cif</code>, <code>eu_oss_vat</code>, <code>eu_vat</code>, <code>gb_vat</code>, <code>ge_vat</code>, <code>gn_nif</code>, <code>hk_br</code>, <code>hr_oib</code>, <code>hu_tin</code>, <code>id_npwp</code>, <code>il_vat</code>, <code>in_gst</code>, <code>is_vat</code>, <code>jp_cn</code>, <code>jp_rn</code>, <code>jp_trn</code>, <code>ke_pin</code>, <code>kh_tin</code>, <code>kr_brn</code>, <code>kz_bin</code>, <code>li_uid</code>, <code>li_vat</code>, <code>ma_vat</code>, <code>md_vat</code>, <code>me_pib</code>, <code>mk_vat</code>, <code>mr_nif</code>, <code>mx_rfc</code>, <code>my_frp</code>, <code>my_itn</code>, <code>my_sst</code>, <code>ng_tin</code>, <code>no_vat</code>, <code>no_voec</code>, <code>np_pan</code>, <code>nz_gst</code>, <code>om_vat</code>, <code>pe_ruc</code>, <code>ph_tin</code>, <code>ro_tin</code>, <code>rs_pib</code>, <code>ru_inn</code>, <code>ru_kpp</code>, <code>sa_vat</code>, <code>sg_gst</code>, <code>sg_uen</code>, <code>si_tin</code>, <code>sn_ninea</code>, <code>sr_fin</code>, <code>sv_nit</code>, <code>th_vat</code>, <code>tj_tin</code>, <code>tr_tin</code>, <code>tw_vat</code>, <code>tz_vat</code>, <code>ua_vat</code>, <code>ug_tin</code>, <code>us_ein</code>, <code>uy_ruc</code>, <code>uz_tin</code>, <code>uz_vat</code>, <code>ve_rif</code>, <code>vn_tin</code>, <code>za_vat</code>, <code>zm_tin</code>, or <code>zw_tin</code>. Note that some legacy tax IDs have type <code>unknown</code>
  * @property string $value Value of the tax ID.
  * @property null|\Stripe\StripeObject $verification Tax ID verification information.
  */
@@ -27,21 +27,28 @@ class TaxId extends ApiResource
 
     const TYPE_AD_NRT = 'ad_nrt';
     const TYPE_AE_TRN = 'ae_trn';
+    const TYPE_AL_TIN = 'al_tin';
+    const TYPE_AM_TIN = 'am_tin';
+    const TYPE_AO_TIN = 'ao_tin';
     const TYPE_AR_CUIT = 'ar_cuit';
     const TYPE_AU_ABN = 'au_abn';
     const TYPE_AU_ARN = 'au_arn';
+    const TYPE_BA_TIN = 'ba_tin';
+    const TYPE_BB_TIN = 'bb_tin';
     const TYPE_BG_UIC = 'bg_uic';
     const TYPE_BH_VAT = 'bh_vat';
     const TYPE_BO_TIN = 'bo_tin';
     const TYPE_BR_CNPJ = 'br_cnpj';
     const TYPE_BR_CPF = 'br_cpf';
+    const TYPE_BS_TIN = 'bs_tin';
     const TYPE_BY_TIN = 'by_tin';
     const TYPE_CA_BN = 'ca_bn';
     const TYPE_CA_GST_HST = 'ca_gst_hst';
     const TYPE_CA_PST_BC = 'ca_pst_bc';
     const TYPE_CA_PST_MB = 'ca_pst_mb';
     const TYPE_CA_PST_SK = 'ca_pst_sk';
     const TYPE_CA_QST = 'ca_qst';
+    const TYPE_CD_NIF = 'cd_nif';
     const TYPE_CH_UID = 'ch_uid';
     const TYPE_CH_VAT = 'ch_vat';
     const TYPE_CL_TIN = 'cl_tin';
@@ -57,6 +64,7 @@ class TaxId extends ApiResource
     const TYPE_EU_VAT = 'eu_vat';
     const TYPE_GB_VAT = 'gb_vat';
     const TYPE_GE_VAT = 'ge_vat';
+    const TYPE_GN_NIF = 'gn_nif';
     const TYPE_HK_BR = 'hk_br';
     const TYPE_HR_OIB = 'hr_oib';
     const TYPE_HU_TIN = 'hu_tin';
@@ -68,19 +76,24 @@ class TaxId extends ApiResource
     const TYPE_JP_RN = 'jp_rn';
     const TYPE_JP_TRN = 'jp_trn';
     const TYPE_KE_PIN = 'ke_pin';
+    const TYPE_KH_TIN = 'kh_tin';
     const TYPE_KR_BRN = 'kr_brn';
     const TYPE_KZ_BIN = 'kz_bin';
     const TYPE_LI_UID = 'li_uid';
     const TYPE_LI_VAT = 'li_vat';
     const TYPE_MA_VAT = 'ma_vat';
     const TYPE_MD_VAT = 'md_vat';
+    const TYPE_ME_PIB = 'me_pib';
+    const TYPE_MK_VAT = 'mk_vat';
+    const TYPE_MR_NIF = 'mr_nif';
     const TYPE_MX_RFC = 'mx_rfc';
     const TYPE_MY_FRP = 'my_frp';
     const TYPE_MY_ITN = 'my_itn';
     const TYPE_MY_SST = 'my_sst';
     const TYPE_NG_TIN = 'ng_tin';
     const TYPE_NO_VAT = 'no_vat';
     const TYPE_NO_VOEC = 'no_voec';
+    const TYPE_NP_PAN = 'np_pan';
     const TYPE_NZ_GST = 'nz_gst';
     const TYPE_OM_VAT = 'om_vat';
     const TYPE_PE_RUC = 'pe_ruc';
@@ -93,12 +106,16 @@ class TaxId extends ApiResource
     const TYPE_SG_GST = 'sg_gst';
     const TYPE_SG_UEN = 'sg_uen';
     const TYPE_SI_TIN = 'si_tin';
+    const TYPE_SN_NINEA = 'sn_ninea';
+    const TYPE_SR_FIN = 'sr_fin';
     const TYPE_SV_NIT = 'sv_nit';
     const TYPE_TH_VAT = 'th_vat';
+    const TYPE_TJ_TIN = 'tj_tin';
     const TYPE_TR_TIN = 'tr_tin';
     const TYPE_TW_VAT = 'tw_vat';
     const TYPE_TZ_VAT = 'tz_vat';
     const TYPE_UA_VAT = 'ua_vat';
+    const TYPE_UG_TIN = 'ug_tin';
     const TYPE_UNKNOWN = 'unknown';
     const TYPE_US_EIN = 'us_ein';
     const TYPE_UY_RUC = 'uy_ruc';
@@ -107,6 +124,8 @@ class TaxId extends ApiResource
     const TYPE_VE_RIF = 've_rif';
     const TYPE_VN_TIN = 'vn_tin';
     const TYPE_ZA_VAT = 'za_vat';
+    const TYPE_ZM_TIN = 'zm_tin';
+    const TYPE_ZW_TIN = 'zw_tin';
 
     /**
      * Creates a new account or customer <code>tax_id</code> object.

lib/Util/ApiVersion.php

@@ -6,5 +6,5 @@
 
 class ApiVersion
 {
-    const CURRENT = '2024-11-20.acacia';
+    const CURRENT = '2024-12-18.acacia';
 }