# Ajoute des paramètres de solde de compte et de virement via l’API Balance Settings.

## Nouveautés

Vous pouvez désormais personnaliser la façon dont le solde et le virement d’un compte connecté sont gérés par votre plateforme grâce à l’[API Balance Settings](https://docs.stripe.com/api/balance-settings.md?api-version=2025-09-30.clover). Ces options sont incluses :

- [payments.debit_negative_balances](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover#balance_settings_object-payments-debit_negative_balances) : détermine si Stripe doit tenter de récupérer les soldes négatifs d’un compte bancaire associé.
- [payments.payouts.minimum_balance_by_currency](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover#balance_settings_object-payments-payouts-minimum_balance_by_currency) : définit le solde minimum à conserver par devise après les virements automatiques — seuls les fonds dépassant ce seuil sont versés.
- [payments.payouts.schedule](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover#balance_settings_object-payments-payouts-schedule) : définit la planification, y compris la fréquence des virements et les jours du mois ou de la semaine.
- [payments.payouts.statement_descriptor](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover#balance_settings_object-payments-payouts-statement_descriptor) : spécifie le texte qui apparaît sur l’extrait de compte bancaire pour les virements.
- [payments.règlement_timing](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover&rds=1&lang=curl#balance_settings_object-payments-settlement_timing) : définit le délai de règlement pour que les fonds en attente soient disponibles.

Si vous utilisiez [l’API Balance Settings sur des versions bêta antérieures à `2025-09-30.clover`](https://docs.stripe.com/api/balance-settings.md?api-version=2025-08-27.preview), vous remarquerez les changements suivants :

- Ajoute la possibilité de définir les paramètres du solde [delay_days](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing-delay_days) par défaut en affichant une valeur vide `delay_days_override`. La valeur par défaut est la plus basse disponible pour votre compte.

- Le champ [delay_days_override](https://docs.stripe.com/api/balance-settings/object.md?api-version=2025-09-30.clover#balance_settings_object-payments-settlement_timing-delay_days_override) ajouté à l’[objet Balance Settings](https://docs.stripe.com/api/balance-settings.md?api-version=2025-09-30.clover), que vous pouvez définir lorsque vous [mettez à jour les paramètres de solde](https://docs.stripe.com/api/balance-settings/update.md?api-version=2025-09-30.clover).

#### API REST

| Field                                                                   | Change  | From → to                              |
| ----------------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettings#update.payments.settlement_timing.delay_days_override` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter             | Change | Resources or endpoints                                                                                                                                       |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `delay_days_override` | Added  | [BalanceSettings.payments.settlement_timing](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### Ruby

| Field                                                                          | Change  | From → to                              |
| ------------------------------------------------------------------------------ | ------- | -------------------------------------- |
| `BalanceSettings::UpdateParams::Payment::SettlementTiming.delay_days_override` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter             | Change | Resources or methods                                                                                                                                         |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `delay_days_override` | Added  | [BalanceSettings::Payment::SettlementTiming](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### Python

| Field                                                                     | Change  | From → to                              |
| ------------------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettings.ModifyParamsPaymentSettlementTiming.delay_days_override` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter             | Change | Resources or methods                                                                                                                                       |
| --------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `delay_days_override` | Added  | [BalanceSettings.Payment.SettlementTiming](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### PHP

| Field                                                                            | Change  | From → to                              |
| -------------------------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettings.update().$params.payment.settlement_timing.delay_days_override` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter             | Change | Resources or methods                                                                                                                                         |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `delay_days_override` | Added  | [BalanceSettings.payments.settlement_timing](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### Java

| Field                                                                      | Change  | From → to                              |
| -------------------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettingsUpdateParams.payments.settlement_timing.delayDaysOverride` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter           | Change | Resources or methods                                                                                                                                         |
| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `delayDaysOverride` | Added  | [BalanceSettings.payments.settlement_timing](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### Node.js

| Field                                                                       | Change  | From → to                              |
| --------------------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettingUpdateParams.payments.settlement_timing.delay_days_override` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter             | Change | Resources or methods                                                                                                                                         |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `delay_days_override` | Added  | [BalanceSettings.payments.settlement_timing](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### Go

| Field                                                             | Change  | From → to                              |
| ----------------------------------------------------------------- | ------- | -------------------------------------- |
| `BalanceSettingsPaymentsSettlementTimingParams.DelayDaysOverride` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter           | Change | Resources or methods                                                                                                                                      |
| ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DelayDaysOverride` | Added  | [BalanceSettingsPaymentsSettlementTiming](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

#### .NET

| Field                                                              | Change  | From → to                              |
| ------------------------------------------------------------------ | ------- | -------------------------------------- |
| `BalanceSettingsPaymentsSettlementTimingOptions.DelayDaysOverride` | Changed | `longInteger → emptyable(longInteger)` |

| Parameter           | Change | Resources or methods                                                                                                                                        |
| ------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DelayDaysOverride` | Added  | [BalanceSettings.Payments.SettlementTiming](/api/balance-settings/object?api-version=2025-09-30.preview#balance_settings_object-payments-settlement_timing) |

## Impact

Toutes les plateformes Stripe peuvent désormais utiliser l’[API Balance Settings](https://docs.stripe.com/api/balance-settings.md?api-version=2025-09-30.clover) pour personnaliser les soldes des comptes, configurer [les soldes minimums pour les virements automatiques](https://docs.stripe.com/payouts/minimum-balances-for-automatic-payouts.md), et [gérer les paramètres de virement](https://docs.stripe.com/connect/manage-payout-schedule.md).

Nous recommandons d’utiliser l’[API Balance Settings](https://docs.stripe.com/api/balance-settings.md?api-version=2025-09-30.clover) pour Accounts v1 et Accounts v2 plutôt que l’ancien hachage [settings.payouts](https://docs.stripe.com/api/accounts/object.md?api-version=2025-09-30.clover#account_object-settings-payouts) dans l’[API Accounts v1.](https://docs.stripe.com/api/accounts.md?api-version=2025-09-30.clover) Toutefois, si vous êtes une plateforme sur Accounts v1 et que vous utilisez actuellement `settings.payouts`, vous n’avez pas besoin de migrer. Si vous êtes une plateforme sur [Accounts v2](https://docs.stripe.com/connect/accounts-v2.md), consultez la rubrique [Créer une plateforme SaaS](https://docs.stripe.com/connect/saas.md), pour en savoir plus.

## Modifications

#### API REST

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Endpoints            | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `retrieve`, `update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### Ruby

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods              | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `retrieve`, `update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### Python

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods              | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `modify`, `retrieve` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### PHP

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods              | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `retrieve`, `update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### Java

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods              | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `retrieve`, `update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### Node.js

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods              | Change | Resource                                                                      |
| -------------------- | ------ | ----------------------------------------------------------------------------- |
| `retrieve`, `update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### Go

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods         | Change | Resource                                                                      |
| --------------- | ------ | ----------------------------------------------------------------------------- |
| `Get`, `Update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

#### .NET

|  | Change | Resource                                                                      |
|  | ------ | ----------------------------------------------------------------------------- |
|  | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

| Methods         | Change | Resource                                                                      |
| --------------- | ------ | ----------------------------------------------------------------------------- |
| `Get`, `Update` | Added  | [BalanceSettings](/api/balance-settings/object?api-version=2025-09-30.clover) |

## Mise à niveau

#### API REST

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
   - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-09-30.clover`
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Ruby vers [v16.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v16.0.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Python

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Python vers [v13.0.1](https://github.com/stripe/stripe-python/releases/tag/v13.0.1)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK PHP vers [v18.0.0](https://github.com/stripe/stripe-php/releases/tag/v18.0.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Java

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Java vers [v30.0.0](https://github.com/stripe/stripe-java/releases/tag/v30.0.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Node vers [v19.1.0](https://github.com/stripe/stripe-node/releases/tag/v19.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Go

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Go vers [v83.0.0](https://github.com/stripe/stripe-go/releases/tag/v83.0.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK .NET vers [v49.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.0.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

## Modifications connexes

- [Ajoute des descriptions spécifiques pour les exigences en matière de risques lors des vérifications juridiques, PEP et sanctions](https://docs.stripe.com/changelog/clover/2025-09-30/expanded-risk-requirement-descriptions.md)
- [Ajoute un nouveau code d’erreur pour les validations de type d’entreprise](https://docs.stripe.com/changelog/clover/2025-09-30/business-type-error-code.md)