# Autorise des champs « description » et « email » vides pour plusieurs objets

## Nouveautés

Possibilité de définir sur null la propriété `description` des objets `Customer`, `Charge`, `InvoiceItem` et `Recipient`, ainsi que la propriété `email` des objets `Customer` et `Recipient`, en fournissant des valeurs de chaîne vides dans les requêtes POST.

## Impact

Permet de définir `description` et `email` comme null sur divers objets, ce qui apporte une plus grande souplesse dans la manière de gérer les données.

## Modifications

#### API REST

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → nullable(string)` |
| `Charge.description` | Changed | `string → nullable(string)` |
| `InvoiceItem.description` | Changed | `string → nullable(string)` |
| `Recipient.description` | Changed | `string → nullable(string)` |
| `Customer.email` | Changed | `string → nullable(string)` |
| `Recipient.email` | Changed | `string → nullable(string)` |

#### Ruby

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → nullable(string)` |
| `Charge.description` | Changed | `string → nullable(string)` |
| `InvoiceItem.description` | Changed | `string → nullable(string)` |
| `Recipient.description` | Changed | `string → nullable(string)` |
| `Customer.email` | Changed | `string → nullable(string)` |
| `Recipient.email` | Changed | `string → nullable(string)` |

#### Python

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → nullable(string)` |
| `Charge.description` | Changed | `string → nullable(string)` |
| `InvoiceItem.description` | Changed | `string → nullable(string)` |
| `Recipient.description` | Changed | `string → nullable(string)` |
| `Customer.email` | Changed | `string → nullable(string)` |
| `Recipient.email` | Changed | `string → nullable(string)` |

#### PHP

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → nullable(string)` |
| `Charge.description` | Changed | `string → nullable(string)` |
| `InvoiceItem.description` | Changed | `string → nullable(string)` |
| `Recipient.description` | Changed | `string → nullable(string)` |
| `Customer.email` | Changed | `string → nullable(string)` |
| `Recipient.email` | Changed | `string → nullable(string)` |

#### Java

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → nullable(string)` |
| `Charge.description` | Changed | `string → nullable(string)` |
| `InvoiceItem.description` | Changed | `string → nullable(string)` |
| `Recipient.description` | Changed | `string → nullable(string)` |
| `Customer.email` | Changed | `string → nullable(string)` |
| `Recipient.email` | Changed | `string → nullable(string)` |

#### Node.js

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.description` | Changed | `string → string | null` |
| `Charge.description` | Changed | `string → string | null` |
| `InvoiceItem.description` | Changed | `string → string | null` |
| `Recipient.description` | Changed | `string → string | null` |
| `Customer.email` | Changed | `string → string | null` |
| `Recipient.email` | Changed | `string → string | null` |

#### Go

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.Description` | Changed | `string → nullable(string)` |
| `Charge.Description` | Changed | `string → nullable(string)` |
| `InvoiceItem.Description` | Changed | `string → nullable(string)` |
| `Recipient.Description` | Changed | `string → nullable(string)` |
| `Customer.Email` | Changed | `string → nullable(string)` |
| `Recipient.Email` | Changed | `string → nullable(string)` |

#### .NET

| Fields | Change | From → to |
| --- | --- | --- |
| `Customer.Description` | Changed | `string → nullable(string)` |
| `Charge.Description` | Changed | `string → nullable(string)` |
| `InvoiceItem.Description` | Changed | `string → nullable(string)` |
| `Recipient.Description` | Changed | `string → nullable(string)` |
| `Customer.Email` | Changed | `string → nullable(string)` |
| `Recipient.Email` | Changed | `string → nullable(string)` |

## 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.
2. 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 : 2013-08-12`
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK Ruby vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK Python vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK PHP vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK Java vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK Node vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK Go vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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.
2. Mettez à niveau votre SDK .NET vers la dernière version.
3. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
4. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
5. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
6. [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).