# Payouts are now a capability ## What’s new We’ve made payouts a capability in both the `merchant` and `recipient` configurations. These are automatically requested when Stripe creates a Stripe balance for the account. A Stripe balance is created when you apply the Merchant configuration or request the `stripe_balance.stripe_transfers` capability on the Recipient configuration. You can use this capability to check that funds in the connected account’s Stripe balance can be paid out to their external account. Learn more about the [Accounts v2 public preview for Stripe Connect and Billing](https://docs.stripe.com/connect/accounts-v2/saas-platform-payments-billing.md). ## Why is this a breaking change? We’ve removed `requirements.entries.impact.restricts_payouts`. Payout restrictions are now listed in [requirements.entries.impact.restricts_capabilities.capability](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-04-30.preview#v2_account_object-requirements-entries-impact-restricts_capabilities-capability). ## Impact Requirements that impact payouts no longer have the `impact.restricts_payouts` field. Instead, the [impact.restricts_capabilities](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-04-30.preview#v2_account_object-requirements-entries-impact-restricts_capabilities) field includes the payouts capability on the Merchant or Recipient configurations. ## Changes #### REST API | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Endpoints | Change | Resources | | ------------------------------------------------ | ------ | -------------------------------------------------------------------------------------------- | | `close`, `create`, `list`, `retrieve`, `update` | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `create`, `del`, `list`, `retrieve`, `update` | Added | [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or endpoints | | -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer_account` | Added | [Billing.CreditBalanceSummary#retrieve](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [Billing.CreditBalanceTransaction#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant#create](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrant#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortal.Session#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortal.Session](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [Checkout.Session#create](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.Session#list](/api/checkout/sessions/list?api-version=2025-04-30.preview), [Checkout.Session](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNote#list](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnections.Account#list.account_holder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnections.Account.account_holder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnections.Session#create.account_holder](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnections.Session.account_holder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [Invoice#create_preview](/api/invoices/create_preview?api-version=2025-04-30.preview), [Invoice#create](/api/invoices/create?api-version=2025-04-30.preview), [Invoice#list](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceItem#create](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItem#list](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntent#create](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent#list](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntent#update](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethod#attach](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCode#create](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode#list](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [Quote#create](/api/quotes/create?api-version=2025-04-30.preview), [Quote#list](/api/quotes/list?api-version=2025-04-30.preview), [Quote#update](/api/quotes/update?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntent#create](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent#list](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntent#update](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [Subscription#create](/api/subscriptions/create?api-version=2025-04-30.preview), [Subscription#list](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule#list](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxId.owner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `related_customer_account` | Added | [Identity.VerificationSession#create](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [Identity.VerificationSession#list](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [Identity.VerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [balance_settings.updated](/api/events/types?api-version=2025-04-30.preview#event_types-balance_settings.updated) | #### Ruby | | Change | Resources | | | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2::Core::Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [V2::Core::Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `close`, `create`, `list`, `retrieve`, `update` | Added | [V2::Core::Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [V2::Core::Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer_account` | Added | [Billing.CreditBalanceSummary#retrieve](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [Billing.CreditBalanceTransaction#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant#create](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrant#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortal.Session#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortal.Session](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [Checkout.Session#create](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.Session#list](/api/checkout/sessions/list?api-version=2025-04-30.preview), [Checkout.Session](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNote#list](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnections.Account#list.account_holder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnections.Account.account_holder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnections.Session#create.account_holder](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnections.Session.account_holder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [Invoice#create_preview](/api/invoices/create_preview?api-version=2025-04-30.preview), [Invoice#create](/api/invoices/create?api-version=2025-04-30.preview), [Invoice#list](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceItem#create](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItem#list](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntent#create](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent#list](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntent#update](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethod#attach](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCode#create](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode#list](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [Quote#create](/api/quotes/create?api-version=2025-04-30.preview), [Quote#list](/api/quotes/list?api-version=2025-04-30.preview), [Quote#update](/api/quotes/update?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntent#create](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent#list](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntent#update](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [Subscription#create](/api/subscriptions/create?api-version=2025-04-30.preview), [Subscription#list](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule#list](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxId.owner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `related_customer_account` | Added | [Identity.VerificationSession#create](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [Identity.VerificationSession#list](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [Identity.VerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview) | #### Python | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [v2.core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [v2.core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ------------------------------------------------ | ------ | -------------------------------------------------------------------------------------------- | | `close`, `create`, `list`, `modify`, `retrieve` | Added | [v2.core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `modify`, `retrieve` | Added | [v2.core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | -------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `customer_account` | Added | [BillingCreditBalanceSummary#retrieve](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [BillingCreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [BillingCreditBalanceTransaction#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [BillingCreditGrant#create](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [BillingCreditGrant#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [BillingCreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortalSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortalSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [CheckoutSession#create](/api/checkout/sessions/create?api-version=2025-04-30.preview), [CheckoutSession#list](/api/checkout/sessions/list?api-version=2025-04-30.preview), [CheckoutSession](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNote#list](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnectionsAccount#list.account_holder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnectionsAccountAccountHolder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnectionsSession#create.account_holder](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnectionsSessionAccountHolder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [Invoice#create_preview](/api/invoices/create_preview?api-version=2025-04-30.preview), [Invoice#create](/api/invoices/create?api-version=2025-04-30.preview), [Invoice#list](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceItem#create](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItem#list](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntent#create](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent#list](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntent#update](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethod#attach](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCode#create](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode#list](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [Quote#create](/api/quotes/create?api-version=2025-04-30.preview), [Quote#list](/api/quotes/list?api-version=2025-04-30.preview), [Quote#update](/api/quotes/update?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntent#create](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent#list](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntent#update](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [Subscription#create](/api/subscriptions/create?api-version=2025-04-30.preview), [Subscription#list](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule#list](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxId#owner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `related_customer_account` | Added | [IdentityVerificationSession#create](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [identityVerificationSession#list](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [identityVerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview) | #### PHP | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ----------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `all`, `close`, `create`, `retrieve`, `update` | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `all`, `create`, `delete`, `retrieve`, `update` | Added | [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer_account` | Added | [Billing.CreditBalanceSummary#retrieve](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [Billing.CreditBalanceTransaction#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant#create](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrant#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortal.Session#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortal.Session](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [Checkout.Session#create](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.Session#list](/api/checkout/sessions/list?api-version=2025-04-30.preview), [Checkout.Session](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNote#list](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnections.Account#list.account_holder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnections.Account.account_holder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnections.Session#create.account_holder](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnections.Session.account_holder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [Invoice#create_preview](/api/invoices/create_preview?api-version=2025-04-30.preview), [Invoice#create](/api/invoices/create?api-version=2025-04-30.preview), [Invoice#list](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceItem#create](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItem#list](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntent#create](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent#list](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntent#update](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethod#attach](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCode#create](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode#list](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [Quote#create](/api/quotes/create?api-version=2025-04-30.preview), [Quote#list](/api/quotes/list?api-version=2025-04-30.preview), [Quote#update](/api/quotes/update?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntent#create](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent#list](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntent#update](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [Subscription#create](/api/subscriptions/create?api-version=2025-04-30.preview), [Subscription#list](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule#list](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxId.owner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `related_customer_account` | Added | [Identity.VerificationSession#create](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [Identity.VerificationSession#list](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [Identity.VerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview) | #### Java | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [v2.core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [v2.core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ------------------------------------------------ | ------ | -------------------------------------------------------------------------------------------- | | `close`, `create`, `list`, `retrieve`, `update` | Added | [v2.core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [v2.core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer_account` | Added | [Billing.CreditBalanceSummary#retrieve](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [Billing.CreditBalanceTransaction#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant#create](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrant#list](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortal.Session#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortal.Session](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [Checkout.Session#create](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.Session#list](/api/checkout/sessions/list?api-version=2025-04-30.preview), [Checkout.Session](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNote#list](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSession#create](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnections.Account#list.account_holder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnections.Account.account_holder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnections.Session#create.account_holder](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnections.Session.account_holder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [Invoice#create_preview](/api/invoices/create_preview?api-version=2025-04-30.preview), [Invoice#create](/api/invoices/create?api-version=2025-04-30.preview), [Invoice#list](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceItem#create](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItem#list](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntent#create](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent#list](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntent#update](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethod#attach](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCode#create](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode#list](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [Quote#create](/api/quotes/create?api-version=2025-04-30.preview), [Quote#list](/api/quotes/list?api-version=2025-04-30.preview), [Quote#update](/api/quotes/update?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntent#create](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent#list](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntent#update](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [Subscription#create](/api/subscriptions/create?api-version=2025-04-30.preview), [Subscription#list](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule#list](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxId.owner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `related_customer_account` | Added | [Identity.VerificationSession#create](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [Identity.VerificationSession#list](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [Identity.VerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview) | #### Node.js | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ------------------------------------------------ | ------ | -------------------------------------------------------------------------------------------- | | `close`, `create`, `list`, `retrieve`, `update` | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `create`, `del`, `list`, `retrieve`, `update` | Added | [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview) | | `retrieve`, `update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | `create`, `delete`, `list`, `retrieve`, `update` | Added | [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer_account` | Added | [Billing.CreditBalanceSummaryRetrieveParams](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [Billing.CreditBalanceTransactionListParams](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrantCreateParams](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrantListParams](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortalSessionCreateParams](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortalSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Checkout.SessionCreateParams](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.SessionListParams](/api/checkout/sessions/list?api-version=2025-04-30.preview), [CheckoutSession](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNoteListParams](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerSessionCreateParams](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnectionsAccountAccountHolder](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnectionsAccountListAccountHolderParams](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnectionsSessionAccountHolderParams](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnectionsSessionAccountHolder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [InvoiceCreatePreviewParams](/api/invoices/create_preview?api-version=2025-04-30.preview), [InvoiceItemListParams](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItemParams](/api/invoiceitems?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [InvoiceListParams](/api/invoices/list?api-version=2025-04-30.preview), [InvoiceParams](/api/invoices/create?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntentListParams](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntentParams](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethodAttachParams](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCodeListParams](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCodeParams](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [QuoteListParams](/api/quotes/list?api-version=2025-04-30.preview), [QuoteParams](/api/quotes/create?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntentListParams](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntentParams](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [SubscriptionListParams](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionParams](/api/subscriptions/create?api-version=2025-04-30.preview), [SubscriptionScheduleListParams](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionScheduleParams](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxIdOwnerOptions](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxIdOwner](/api/tax_ids/object?api-version=2025-04-30.preview), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `RelatedCustomerAccount` | Added | [IdentityVerificationSessionListParams](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [IdentityVerificationSessionParams](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [IdentityVerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | | | Change | Event types | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [V2CoreAccountClosedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationCustomerUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationMerchantUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingConfigurationRecipientUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingDefaultsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingIdentityUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountIncludingRequirementsUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonCreatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonDeletedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview), [V2CoreAccountPersonUpdatedEvent](/api/v2/core/accounts/event-types?api-version=2025-04-30.preview) | #### Go This change does not affect the Go SDK. #### .NET | | Change | Resources | | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview), [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | Methods | Change | Resources | | ------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Close`, `Create`, `Get`, `List`, `Update` | Added | [V2.Core.Account](/api/v2/core/accounts/object?api-version=2025-04-30.preview) | | `Create`, `Delete`, `Get`, `List`, `Update` | Added | [V2.Core.Person](/api/v2/core/persons/object?api-version=2025-04-30.preview), [ExternalAccount](/api/external_account_bank_accounts/object?api-version=2025-04-30.preview) | | `Get`, `Update` | Added | [BalanceSettings](/api/balance-settings/object?api-version=2025-04-30.preview) | | Parameters | Change | Resources or methods | | ------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CustomerAccount` | Added | [Billing.CreditBalanceSummaryRetrieveOptions](/api/billing/credit-balance-summary/retrieve?api-version=2025-04-30.preview), [Billing.CreditBalanceTransactionListOptions](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [Billing.CreditGrantCreateOptions](/api/billing/credit-grant/create?api-version=2025-04-30.preview), [Billing.CreditGrantListOptions](/api/billing/credit-balance-transaction/list?api-version=2025-04-30.preview), [BillingCreditBalanceSummary](/api/billing/credit-balance-summary/object?api-version=2025-04-30.preview), [BillingCreditGrant](/api/billing/credit-grant?api-version=2025-04-30.preview), [BillingPortalSessionCreateOptions](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [BillingPortalSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [Checkout.SessionCreateOptions](/api/checkout/sessions/create?api-version=2025-04-30.preview), [Checkout.SessionListOptions](/api/checkout/sessions/list?api-version=2025-04-30.preview), [CheckoutSession](/api/checkout/sessions/object?api-version=2025-04-30.preview), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-04-30.preview#confirmation_token_object-payment_method_preview), [CreditNoteListOptions](/api/credit_notes/list?api-version=2025-04-30.preview), [CreditNote](/api/credit_notes/object?api-version=2025-04-30.preview), [CustomerBalanceTransaction](/api/customer_portal/configurations/object?api-version=2025-04-30.preview), [CustomerCashBalanceTransaction](/api/customer_balance_transactions/object?api-version=2025-04-30.preview), [CustomerCashBalance](/api/cash_balance/object?api-version=2025-04-30.preview), [CustomerPaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [CustomerSessionCreateOptions](/api/customer_portal/sessions/create?api-version=2025-04-30.preview), [CustomerSession](/api/customer_portal/sessions/object?api-version=2025-04-30.preview), [CustomerTaxIdOwner](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [CustomerTaxId](/api/tax_ids/object?api-version=2025-04-30.preview), [Customer](/api/customers/object?api-version=2025-04-30.preview), [Discount](/api/discounts/object?api-version=2025-04-30.preview), [FinancialConnectionsAccountAccountHolderOptions](/api/financial_connections/accounts/list?api-version=2025-04-30.preview#financial_connections_list_accounts-account_holder), [FinancialConnectionsAccountAccountHolder](/api/financial_connections/accounts/object?api-version=2025-04-30.preview#financial_connections_account_object-account_holder), [FinancialConnectionsSessionAccountHolderOptions](/api/financial_connections/sessions/create?api-version=2025-04-30.preview#financial_connections_create_session-account_holder), [FinancialConnectionsSessionAccountHolder](/api/financial_connections/sessions/object?api-version=2025-04-30.preview#financial_connections_session_object-account_holder), [InvoiceCreateOptions](/api/invoices/create?api-version=2025-04-30.preview), [InvoiceCreatePreviewOptions](/api/invoices/create_preview?api-version=2025-04-30.preview), [InvoiceItemCreateOptions](/api/invoiceitems/create?api-version=2025-04-30.preview), [InvoiceItemListOptions](/api/invoiceitems/list?api-version=2025-04-30.preview), [InvoiceItem](/api/invoiceitems/object?api-version=2025-04-30.preview), [Invoice](/api/invoices/object?api-version=2025-04-30.preview), [PaymentIntentCreateOptions](/api/payment_intents/create?api-version=2025-04-30.preview), [PaymentIntentListOptions](/api/payment_intents/list?api-version=2025-04-30.preview), [PaymentIntentUpdateOptions](/api/payment_intents/update?api-version=2025-04-30.preview), [PaymentIntent](/api/payment_intents/object?api-version=2025-04-30.preview), [PaymentMethodAttachOptions](/api/payment_methods/attach?api-version=2025-04-30.preview), [PaymentMethod](/api/payment_methods/object?api-version=2025-04-30.preview), [PromotionCodeCreateOptions](/api/promotion_codes/create?api-version=2025-04-30.preview), [PromotionCodeListOptions](/api/promotion_codes/list?api-version=2025-04-30.preview), [PromotionCode](/api/promotion_codes/object?api-version=2025-04-30.preview), [QuoteCreateOptions](/api/quotes/create?api-version=2025-04-30.preview), [QuoteListOptions](/api/quotes/list?api-version=2025-04-30.preview), [QuotePreviewInvoice](/api/quotes/preview_invoices?api-version=2025-04-30.preview), [QuotePreviewSubscriptionSchedule](/api/quotes/preview_subscription_schedules/list?api-version=2025-04-30.preview), [Quote](/api/quotes/object?api-version=2025-04-30.preview), [SetupAttempt](/api/setup_attempts/object?api-version=2025-04-30.preview), [SetupIntentCreateOptions](/api/setup_intents/create?api-version=2025-04-30.preview), [SetupIntentListOptions](/api/setup_intents/list?api-version=2025-04-30.preview), [SetupIntentUpdateOptions](/api/setup_intents/update?api-version=2025-04-30.preview), [SetupIntent](/api/setup_intents/object?api-version=2025-04-30.preview), [SubscriptionCreateOptions](/api/subscriptions/create?api-version=2025-04-30.preview), [SubscriptionListOptions](/api/subscriptions/list?api-version=2025-04-30.preview), [SubscriptionScheduleCreateOptions](/api/subscription_schedules/create?api-version=2025-04-30.preview), [SubscriptionScheduleListOptions](/api/subscription_schedules/list?api-version=2025-04-30.preview), [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2025-04-30.preview), [Subscription](/api/subscriptions/object?api-version=2025-04-30.preview), [TaxIdOwnerOptions](/api/tax_ids/object?api-version=2025-04-30.preview#tax_id_object-owner), [TaxIdOwner](/api/tax_ids/object?api-version=2025-04-30.preview), [TaxId](/api/tax_ids/object?api-version=2025-04-30.preview) | | `RelatedCustomerAccount` | Added | [IdentityVerificationSessionListParams](/api/identity/verification_sessions/list?api-version=2025-04-30.preview), [IdentityVerificationSessionParams](/api/identity/verification_sessions/create?api-version=2025-04-30.preview), [IdentityVerificationSession](/api/identity/verification_sessions/object?api-version=2025-04-30.preview) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. If you use an SDK, upgrade to the corresponding SDK version for this API version. - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2025-04-30.preview` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to [v15.2.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v15.2.0-beta.1) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to [v12.2.0b1](https://github.com/stripe/stripe-python/releases/tag/v12.2.0b1) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to [v17.3.0-beta.1](https://github.com/stripe/stripe-php/releases/tag/v17.3.0-beta.1) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to [v29.2.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v29.2.0-beta.1) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to [v18.2.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v18.2.0-beta.1) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to [v82.2.0-beta.2](https://github.com/stripe/stripe-go/releases/tag/v82.2.0-beta.2) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to [v48.2.0-beta.2](https://github.com/stripe/stripe-dotnet/releases/tag/v48.2.0-beta.2) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds support for third-party tax providers in Accounts v2](https://docs.stripe.com/changelog/basil/2025-04-30/accounts-v2-3p-api-ref.md) - [Adds new event types for Accounts v2](https://docs.stripe.com/changelog/basil/2025-04-30/new-accounts-v2-events.md) - [Updated address validations for Tax](https://docs.stripe.com/changelog/basil/2025-04-30/updated-address-validations-for-tax.md)