Passa al contenuto
Crea account o Accedi
Il logo della documentazione Stripe
/
Chiedi all'IA
Crea un accountAccedi
Inizia
Pagamenti
Ricavi
Per piattaforme e marketplace
Gestione del denaro
Risorse per sviluppatori
API e SDKGuida
Panoramica
Controllo delle versioni
Log modifiche
    Panoramica
    Clover
    Basil
    Acacia
    Versioni precedenti
Aggiorna la tua versione API
Aggiornare la versione dell'SDK
Essentials
SDK
API
Test
CLI di Stripe
Progetti di esempio
Strumenti
Dashboard Stripe
Workbench
Dashboard per sviluppatori
Stripe per Visual Studio Code
Terraform
Funzionalità
Flussi di lavoro
Destinazioni degli eventi
Avvisi sullo stato di StripeCaricamenti file
Soluzioni di IA
Toolkit agente
Protocollo del contesto del modelloCreare flussi di lavoro di fatturazione SaaS con IA agentica
Sicurezza e privacy
Sicurezza
Crawler web di Stripebot
Estendi Stripe
Crea Stripe Apps
Usa le app di Stripe
Partner
Partner Ecosystem
Certificazione di partner
Stati Uniti
Italiano
Pagina inizialeRisorse per sviluppatoriChangelogBasil2025-07-30.preview

Renames the parameter for custom settlement timing on the Balance Settings APIModifiche che provocano errori

Novità

This change renames the top-level delay_days parameter of the Balance Settings API to delay_days_override to clearly distinguish between Stripe’s default settlement timing and whether your platform requests to override that computed delay.

Platforms can request a specific delay_days_override by creating or updating Balance Settings. Stripe uses the request to determine the final number of days to hold charge funds before they become available. If your platform doesn’t explicitly request a delay_days_override, we apply default settlement timing.

Why is this a breaking change?

We renamed the delay_days parameter to delay_days_override.

Impatto

If you participate in the Accounts v2 API public preview and want to use API version 2025-07-30.preview or later, you need to update your integration to use the new parameter name.

If your integration relies on the ability to specify your own settlement timing with delay_days, update your Balance Settings integration to use the delay_days_override parameter.

Modifiche

ParametersCambiaResources or endpoints
delay_days_overrideAggiunto
BalanceSettings#update.settlement_timing
delay_daysRimossi
BalanceSettings#update.settlement_timing

Upgrade

  1. View your current API version in Workbench.
  2. 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 to include Stripe-Version: 2025-07-30.preview
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Adds Account Links v2 API support for connected accounts created using the Accounts v2 API
  • Updates schedule customization for weekly and monthly payouts
  • Adds Connect embedded component for Instant Payouts promotion
Questa pagina è stata utile?
SìNo
  • Hai bisogno di aiuto? Contatta l'assistenza clienti.
  • Dai un'occhiata al nostro registro delle modifiche.
  • Domande? Contattaci.
  • LLM? Leggi llms.txt.
  • Realizzato da Markdoc