Support for APIs in the new API version 2025-03-31.basil

OPENAPI_VERSION

@@ -1 +1 @@
-v1505
+v1640

src/Stripe.net/Constants/ApiVersion.cs

@@ -3,6 +3,6 @@ namespace Stripe
 {
     internal class ApiVersion
     {
-        public const string Current = "2025-02-24.acacia";
+        public const string Current = "2025-03-31.basil";
     }
 }

src/Stripe.net/Constants/EventTypes.cs

@@ -81,6 +81,41 @@ public static class EventTypes
         /// </summary>
         public const string BillingAlertTriggered = "billing.alert.triggered";
 
+        /// <summary>
+        /// Occurs when a credit balance transaction is created.
+        /// </summary>
+        public const string BillingCreditBalanceTransactionCreated = "billing.credit_balance_transaction.created";
+
+        /// <summary>
+        /// Occurs when a credit grant is created.
+        /// </summary>
+        public const string BillingCreditGrantCreated = "billing.credit_grant.created";
+
+        /// <summary>
+        /// Occurs when a credit grant is updated.
+        /// </summary>
+        public const string BillingCreditGrantUpdated = "billing.credit_grant.updated";
+
+        /// <summary>
+        /// Occurs when a meter is created.
+        /// </summary>
+        public const string BillingMeterCreated = "billing.meter.created";
+
+        /// <summary>
+        /// Occurs when a meter is deactivated.
+        /// </summary>
+        public const string BillingMeterDeactivated = "billing.meter.deactivated";
+
+        /// <summary>
+        /// Occurs when a meter is reactivated.
+        /// </summary>
+        public const string BillingMeterReactivated = "billing.meter.reactivated";
+
+        /// <summary>
+        /// Occurs when a meter is updated.
+        /// </summary>
+        public const string BillingMeterUpdated = "billing.meter.updated";
+
         /// <summary>
         /// Occurs whenever a capability has new requirements or a new status.
         /// </summary>
@@ -490,6 +525,11 @@ public static class EventTypes
         /// </summary>
         public const string InvoiceOverdue = "invoice.overdue";
 
+        /// <summary>
+        /// Occurs when an invoice transitions to paid with a non-zero amount_overpaid.
+        /// </summary>
+        public const string InvoiceOverpaid = "invoice.overpaid";
+
         /// <summary>
         /// Occurs whenever an invoice payment attempt succeeds or an invoice is marked as paid
         /// out-of-band.
@@ -502,8 +542,8 @@ public static class EventTypes
         public const string InvoicePaymentActionRequired = "invoice.payment_action_required";
 
         /// <summary>
-        /// Occurs whenever an invoice payment attempt fails, due either to a declined payment or to
-        /// the lack of a stored payment method.
+        /// Occurs whenever an invoice payment attempt fails, due to either a declined payment,
+        /// including soft decline, or to the lack of a stored payment method.
         /// </summary>
         public const string InvoicePaymentFailed = "invoice.payment_failed";
 
@@ -918,7 +958,8 @@ public static class EventTypes
 
         /// <summary>
         /// Occurs whenever a review is closed. The review's <c>reason</c> field indicates why:
-        /// <c>approved</c>, <c>disputed</c>, <c>refunded</c>, or <c>refunded_as_fraud</c>.
+        /// <c>approved</c>, <c>disputed</c>, <c>refunded</c>, <c>refunded_as_fraud</c>, or
+        /// <c>canceled</c>.
         /// </summary>
         public const string ReviewClosed = "review.closed";
 

src/Stripe.net/Entities/Accounts/Account.cs

@@ -57,12 +57,7 @@ public class Account : StripeEntity<Account>, IHasId, IHasMetadata, IHasObject,
         public AccountBusinessProfile BusinessProfile { get; set; }
 
         /// <summary>
-        /// The business type. After you create an <a
-        /// href="https://stripe.com/api/account_links">Account Link</a> or <a
-        /// href="https://stripe.com/api/account_sessions">Account Session</a>, this property is
-        /// only returned for accounts where <a
-        /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
-        /// is <c>application</c>, which includes Custom accounts.
+        /// The business type.
         /// One of: <c>company</c>, <c>government_entity</c>, <c>individual</c>, or
         /// <c>non_profit</c>.
         /// </summary>
@@ -192,7 +187,7 @@ public class Account : StripeEntity<Account>, IHasId, IHasMetadata, IHasObject,
         /// <summary>
         /// This is an object representing a person associated with a Stripe account.
         ///
-        /// A platform cannot access a person for an account where <a
+        /// A platform can only access a subset of data in a person for an account where <a
         /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">account.controller.requirement_collection</a>
         /// is <c>stripe</c>, which includes Standard and Express accounts, after creating an
         /// Account Link or Account Session to start Connect onboarding.

src/Stripe.net/Entities/Accounts/AccountCapabilities.cs

@@ -107,6 +107,17 @@ public class AccountCapabilities : StripeEntity<AccountCapabilities>
 #endif
         public string BankTransferPayments { get; set; }
 
+        /// <summary>
+        /// The status of the Billie capability of the account, or whether the account can directly
+        /// process Billie payments.
+        /// One of: <c>active</c>, <c>inactive</c>, or <c>pending</c>.
+        /// </summary>
+        [JsonProperty("billie_payments")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("billie_payments")]
+#endif
+        public string BilliePayments { get; set; }
+
         /// <summary>
         /// The status of the blik payments capability of the account, or whether the account can
         /// directly process blik charges.
@@ -381,6 +392,17 @@ public class AccountCapabilities : StripeEntity<AccountCapabilities>
 #endif
         public string NaverPayPayments { get; set; }
 
+        /// <summary>
+        /// The status of the New Zealand BECS Direct Debit payments capability of the account, or
+        /// whether the account can directly process New Zealand BECS Direct Debit charges.
+        /// One of: <c>active</c>, <c>inactive</c>, or <c>pending</c>.
+        /// </summary>
+        [JsonProperty("nz_bank_account_becs_debit_payments")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("nz_bank_account_becs_debit_payments")]
+#endif
+        public string NzBankAccountBecsDebitPayments { get; set; }
+
         /// <summary>
         /// The status of the OXXO payments capability of the account, or whether the account can
         /// directly process OXXO charges.
@@ -469,6 +491,17 @@ public class AccountCapabilities : StripeEntity<AccountCapabilities>
 #endif
         public string SamsungPayPayments { get; set; }
 
+        /// <summary>
+        /// The status of the Satispay capability of the account, or whether the account can
+        /// directly process Satispay payments.
+        /// One of: <c>active</c>, <c>inactive</c>, or <c>pending</c>.
+        /// </summary>
+        [JsonProperty("satispay_payments")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("satispay_payments")]
+#endif
+        public string SatispayPayments { get; set; }
+
         /// <summary>
         /// The status of the SEPA customer_balance payments (EUR currency) capability of the
         /// account, or whether the account can directly process SEPA customer_balance charges.

src/Stripe.net/Entities/Accounts/AccountCompany.cs

@@ -87,7 +87,9 @@ public class AccountCompany : StripeEntity<AccountCompany>
         public string ExportPurposeCode { get; set; }
 
         /// <summary>
-        /// The company's legal name.
+        /// The company's legal name. Also available for accounts where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
+        /// is <c>stripe</c>.
         /// </summary>
         [JsonProperty("name")]
 #if NET6_0_OR_GREATER
@@ -96,7 +98,10 @@ public class AccountCompany : StripeEntity<AccountCompany>
         public string Name { get; set; }
 
         /// <summary>
-        /// The Kana variation of the company's legal name (Japan only).
+        /// The Kana variation of the company's legal name (Japan only). Also available for accounts
+        /// where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
+        /// is <c>stripe</c>.
         /// </summary>
         [JsonProperty("name_kana")]
 #if NET6_0_OR_GREATER
@@ -105,7 +110,10 @@ public class AccountCompany : StripeEntity<AccountCompany>
         public string NameKana { get; set; }
 
         /// <summary>
-        /// The Kanji variation of the company's legal name (Japan only).
+        /// The Kanji variation of the company's legal name (Japan only). Also available for
+        /// accounts where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
+        /// is <c>stripe</c>.
         /// </summary>
         [JsonProperty("name_kanji")]
 #if NET6_0_OR_GREATER
@@ -139,6 +147,12 @@ public class AccountCompany : StripeEntity<AccountCompany>
         public AccountCompanyOwnershipDeclaration OwnershipDeclaration { get; set; }
 
         /// <summary>
+        /// This value is used to determine if a business is exempt from providing ultimate
+        /// beneficial owners. See <a
+        /// href="https://support.stripe.com/questions/exemption-from-providing-ownership-details">this
+        /// support article</a> and <a
+        /// href="https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api">changelog</a>
+        /// for more details.
         /// One of: <c>qualified_entity_exceeds_ownership_threshold</c>, or
         /// <c>qualifies_as_financial_institution</c>.
         /// </summary>
@@ -158,7 +172,10 @@ public class AccountCompany : StripeEntity<AccountCompany>
         public string Phone { get; set; }
 
         /// <summary>
-        /// The category identifying the legal structure of the company or legal entity. See <a
+        /// The category identifying the legal structure of the company or legal entity. Also
+        /// available for accounts where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
+        /// is <c>stripe</c>. See <a
         /// href="https://stripe.com/docs/connect/identity-verification#business-structure">Business
         /// structure</a> for more details.
         /// One of: <c>free_zone_establishment</c>, <c>free_zone_llc</c>,

src/Stripe.net/Entities/Accounts/AccountFutureRequirementsError.cs

@@ -10,13 +10,13 @@ public class AccountFutureRequirementsError : StripeEntity<AccountFutureRequirem
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
         /// <c>invalid_dob_age_under_18</c>, <c>invalid_dob_age_under_minimum</c>,
         /// <c>invalid_product_description_length</c>, <c>invalid_product_description_url_match</c>,
-        /// <c>invalid_representative_country</c>,
+        /// <c>invalid_representative_country</c>, <c>invalid_signator</c>,
         /// <c>invalid_statement_descriptor_business_mismatch</c>,
         /// <c>invalid_statement_descriptor_denylisted</c>,
         /// <c>invalid_statement_descriptor_length</c>,
@@ -59,6 +59,7 @@ public class AccountFutureRequirementsError : StripeEntity<AccountFutureRequirem
         /// <c>verification_document_not_uploaded</c>, <c>verification_document_photo_mismatch</c>,
         /// <c>verification_document_too_large</c>, <c>verification_document_type_not_supported</c>,
         /// <c>verification_extraneous_directors</c>, <c>verification_failed_address_match</c>,
+        /// <c>verification_failed_authorizer_authority</c>,
         /// <c>verification_failed_business_iec_number</c>,
         /// <c>verification_failed_document_match</c>, <c>verification_failed_id_number_match</c>,
         /// <c>verification_failed_keyed_identity</c>, <c>verification_failed_keyed_match</c>,
@@ -67,6 +68,7 @@ public class AccountFutureRequirementsError : StripeEntity<AccountFutureRequirem
         /// <c>verification_failed_residential_address</c>, <c>verification_failed_tax_id_match</c>,
         /// <c>verification_failed_tax_id_not_issued</c>, <c>verification_missing_directors</c>,
         /// <c>verification_missing_executives</c>, <c>verification_missing_owners</c>,
+        /// <c>verification_rejected_ownership_exemption_reason</c>,
         /// <c>verification_requires_additional_memorandum_of_associations</c>,
         /// <c>verification_requires_additional_proof_of_registration</c>, or
         /// <c>verification_supportability</c>.

src/Stripe.net/Entities/Accounts/AccountRequirementsError.cs

@@ -10,13 +10,13 @@ public class AccountRequirementsError : StripeEntity<AccountRequirementsError>
     {
         /// <summary>
         /// The code for the type of error.
-        /// One of: <c>invalid_address_city_state_postal_code</c>,
+        /// One of: <c>information_missing</c>, <c>invalid_address_city_state_postal_code</c>,
         /// <c>invalid_address_highway_contract_box</c>, <c>invalid_address_private_mailbox</c>,
         /// <c>invalid_business_profile_name</c>, <c>invalid_business_profile_name_denylisted</c>,
         /// <c>invalid_company_name_denylisted</c>, <c>invalid_dob_age_over_maximum</c>,
         /// <c>invalid_dob_age_under_18</c>, <c>invalid_dob_age_under_minimum</c>,
         /// <c>invalid_product_description_length</c>, <c>invalid_product_description_url_match</c>,
-        /// <c>invalid_representative_country</c>,
+        /// <c>invalid_representative_country</c>, <c>invalid_signator</c>,
         /// <c>invalid_statement_descriptor_business_mismatch</c>,
         /// <c>invalid_statement_descriptor_denylisted</c>,
         /// <c>invalid_statement_descriptor_length</c>,
@@ -59,6 +59,7 @@ public class AccountRequirementsError : StripeEntity<AccountRequirementsError>
         /// <c>verification_document_not_uploaded</c>, <c>verification_document_photo_mismatch</c>,
         /// <c>verification_document_too_large</c>, <c>verification_document_type_not_supported</c>,
         /// <c>verification_extraneous_directors</c>, <c>verification_failed_address_match</c>,
+        /// <c>verification_failed_authorizer_authority</c>,
         /// <c>verification_failed_business_iec_number</c>,
         /// <c>verification_failed_document_match</c>, <c>verification_failed_id_number_match</c>,
         /// <c>verification_failed_keyed_identity</c>, <c>verification_failed_keyed_match</c>,
@@ -67,6 +68,7 @@ public class AccountRequirementsError : StripeEntity<AccountRequirementsError>
         /// <c>verification_failed_residential_address</c>, <c>verification_failed_tax_id_match</c>,
         /// <c>verification_failed_tax_id_not_issued</c>, <c>verification_missing_directors</c>,
         /// <c>verification_missing_executives</c>, <c>verification_missing_owners</c>,
+        /// <c>verification_rejected_ownership_exemption_reason</c>,
         /// <c>verification_requires_additional_memorandum_of_associations</c>,
         /// <c>verification_requires_additional_proof_of_registration</c>, or
         /// <c>verification_supportability</c>.

src/Stripe.net/Entities/Accounts/AccountSettingsInvoices.cs

@@ -54,5 +54,16 @@ public List<TaxId> DefaultAccountTaxIds
 #endif
         internal List<ExpandableField<TaxId>> InternalDefaultAccountTaxIds { get; set; }
         #endregion
+
+        /// <summary>
+        /// Whether payment methods should be saved when a payment is completed for a one-time
+        /// invoices on a hosted invoice page.
+        /// One of: <c>always</c>, <c>never</c>, or <c>offer</c>.
+        /// </summary>
+        [JsonProperty("hosted_payment_method_save")]
+#if NET6_0_OR_GREATER
+        [STJS.JsonPropertyName("hosted_payment_method_save")]
+#endif
+        public string HostedPaymentMethodSave { get; set; }
     }
 }

src/Stripe.net/Entities/ApplicationFees/ApplicationFeeFeeSource.cs

@@ -27,7 +27,7 @@ public class ApplicationFeeFeeSource : StripeEntity<ApplicationFeeFeeSource>
         public string Payout { get; set; }
 
         /// <summary>
-        /// Type of object that created the application fee, either <c>charge</c> or <c>payout</c>.
+        /// Type of object that created the application fee.
         /// One of: <c>charge</c>, or <c>payout</c>.
         /// </summary>
         [JsonProperty("type")]

src/Stripe.net/Entities/BalanceTransactions/BalanceTransaction.cs

@@ -214,7 +214,8 @@ public IBalanceTransactionSource Source
         /// <c>payout</c>, <c>payout_cancel</c>, <c>payout_failure</c>,
         /// <c>payout_minimum_balance_hold</c>, <c>payout_minimum_balance_release</c>,
         /// <c>refund</c>, <c>refund_failure</c>, <c>reserve_transaction</c>, <c>reserved_funds</c>,
-        /// <c>stripe_fee</c>, <c>stripe_fx_fee</c>, <c>tax_fee</c>, <c>topup</c>,
+        /// <c>stripe_fee</c>, <c>stripe_fx_fee</c>, <c>stripe_balance_payment_debit</c>,
+        /// <c>stripe_balance_payment_debit_reversal</c>, <c>tax_fee</c>, <c>topup</c>,
         /// <c>topup_reversal</c>, <c>transfer</c>, <c>transfer_cancel</c>, <c>transfer_failure</c>,
         /// or <c>transfer_refund</c>. Learn more about <a
         /// href="https://stripe.com/docs/reports/balance-transaction-types">balance transaction
@@ -232,6 +233,7 @@ public IBalanceTransactionSource Source
         /// <c>payout</c>, <c>payout_cancel</c>, <c>payout_failure</c>,
         /// <c>payout_minimum_balance_hold</c>, <c>payout_minimum_balance_release</c>,
         /// <c>refund</c>, <c>refund_failure</c>, <c>reserve_transaction</c>, <c>reserved_funds</c>,
+        /// <c>stripe_balance_payment_debit</c>, <c>stripe_balance_payment_debit_reversal</c>,
         /// <c>stripe_fee</c>, <c>stripe_fx_fee</c>, <c>tax_fee</c>, <c>topup</c>,
         /// <c>topup_reversal</c>, <c>transfer</c>, <c>transfer_cancel</c>, <c>transfer_failure</c>,
         /// or <c>transfer_refund</c>.

src/Stripe.net/Entities/BankAccounts/BankAccount.cs

@@ -45,7 +45,12 @@ public class BankAccount : StripeEntity<BankAccount>, IHasId, IHasMetadata, IHas
 
         /// <summary>
         /// (ID of the Account)
-        /// The ID of the account that the bank account is associated with.
+        /// The account this bank account belongs to. Only applicable on Accounts (not customers or
+        /// recipients) This property is only available when returned as an <a
+        /// href="https://stripe.com/api/external_account_bank_accounts/object">External Account</a>
+        /// where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-is_controller">controller.is_controller</a>
+        /// is <c>true</c>.
         /// </summary>
         [JsonIgnore]
 #if NET6_0_OR_GREATER
@@ -59,7 +64,12 @@ public string AccountId
 
         /// <summary>
         /// (Expanded)
-        /// The ID of the account that the bank account is associated with.
+        /// The account this bank account belongs to. Only applicable on Accounts (not customers or
+        /// recipients) This property is only available when returned as an <a
+        /// href="https://stripe.com/api/external_account_bank_accounts/object">External Account</a>
+        /// where <a
+        /// href="https://stripe.com/api/accounts/object#account_object-controller-is_controller">controller.is_controller</a>
+        /// is <c>true</c>.
         ///
         /// For more information, see the <a href="https://stripe.com/docs/expand">expand documentation</a>.
         /// </summary>