# Ajout des types de solde à l’API Balance Transactions

## Nouveautés

Ajout du champ `balance_type` à l’objet [opération sur solde](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2025-05-28.basil)

## Impact

Vous pouvez désormais voir le type de solde affecté par une transaction, avec les types `issuing`, `payments` et `refund_and_dispute_prefunding`. Cette meilleure catégorisation vous permet de rapprocher plus rapidement les variations de solde.

## Modifications

#### API REST

| Parameter      | Change | Resources or endpoints                                                                                                      |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balance_type` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### Ruby

| Parameter      | Change | Resources or methods                                                                                                        |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balance_type` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### Python

| Parameter      | Change | Resources or methods                                                                                                        |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balance_type` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### PHP

| Parameter      | Change | Resources or methods                                                                                                        |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balance_type` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### Java

| Parameter     | Change | Resources or methods                                                                                                        |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balanceType` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### Node.js

| Parameter      | Change | Resources or methods                                                                                                        |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `balance_type` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### Go

| Parameter     | Change | Resources or methods                                                                                                        |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `BalanceType` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

#### .NET

| Parameter     | Change | Resources or methods                                                                                                        |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `BalanceType` | Added  | [BalanceTransaction](/api/balance_transactions/object?api-version=2025-05-28.basil#balance_transaction_object-balance_type) |

## 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-05-28.basil`
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 [v15.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.2.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 [v12.2.0](https://github.com/stripe/stripe-python/releases/tag/v12.2.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).

#### 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 [v17.3.0](https://github.com/stripe/stripe-php/releases/tag/v17.3.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 [v29.2.0](https://github.com/stripe/stripe-java/releases/tag/v29.2.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 [v18.2.0](https://github.com/stripe/stripe-node/releases/tag/v18.2.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 [v82.2.0](https://github.com/stripe/stripe-go/releases/tag/v82.2.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 [v48.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.2.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).

## Changements connexes

- [Ajout de soldes de préfinancement des remboursements et des litiges à l’API Balance](https://docs.stripe.com/changelog/basil/2025-05-28/add-refund-and-dispute-prefunding-to-balances.md)