# Ajout d’un hachage d’informations démographiques à l’API Persons

## Nouveautés

Introduction du hachage `us_cfpb_data` dans l’API Persons, qui contient deux sous-hachages, `ethnicity_details` et `race_details`, ainsi qu’un champ de texte libre pour l’auto-identification du genre de la personne. Chaque sous-hachage comprend des champs, ce qui permet d’ajouter plusieurs valeurs d’énumération et de saisir du texte libre pour décrire l’origine ethnique ou la race de la personne.

Ce changement est conforme à l’article 1071 de la loi Dodd-Frank, qui oblige les fournisseurs de financement des petites entreprises aux États-Unis à recueillir des informations démographiques sur les demandeurs. Les partenaires financiers de Stripe communiquent ces informations au CFPB, qui analyse les disparités potentielles en matière de financement des entreprises. Les informations partagées avec le CFPB sont anonymisées afin de protéger l’identité des demandeurs.

```bash
curl https://api.stripe.com/v1/accounts/acct_xxxxx/persons \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc:" \
  -d us_cfpb_data[self_identified_gender]=female \
  -d us_cfpb_data[ethnicity_details][ethnicity][]=not_hispanic_or_latino \
  -d us_cfpb_data[race_details][race][]=white
```

## Impact

Cet ajout assure la conformité au Règlement 1071 en exigeant des fournisseurs de financement aux petites entreprises qu’ils recueillent des informations démographiques sur les demandeurs de financement.

## Modifications

#### API REST

| Parameter      | Change | Resources or endpoints                                            |
| -------------- | ------ | ----------------------------------------------------------------- |
| `us_cfpb_data` | Added  | `Person#create`, `Person#update`, `Person`, `Token#create.person` |

#### Ruby

| Parameter      | Change | Resources or methods                                                                                         |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------ |
| `us_cfpb_data` | Added  | `AccountPerson::CreateParams`, `AccountPerson::UpdateParams`, `AccountPerson`, `Token::CreateParams::Person` |

#### Python

| Parameter      | Change | Resources or methods                                                                                    |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| `us_cfpb_data` | Added  | `AccountPerson.CreateParams`, `AccountPerson.UpdateParams`, `AccountPerson`, `Token.CreateParamsPerson` |

#### PHP

| Parameter      | Change | Resources or methods |
| -------------- | ------ | -------------------- |
| `us_cfpb_data` | Added  | `Person`             |

#### Java

| Parameter    | Change | Resources or methods                                                                                  |
| ------------ | ------ | ----------------------------------------------------------------------------------------------------- |
| `usCfpbData` | Added  | `AccountPersonCreateParams`, `AccountPersonUpdateParams`, `AccountPerson`, `TokenCreateParams.person` |

#### Node.js

| Parameter      | Change | Resources or methods                                                                                  |
| -------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| `us_cfpb_data` | Added  | `AccountPersonCreateParams`, `AccountPersonUpdateParams`, `AccountPerson`, `TokenCreateParams.person` |

#### Go

| Parameter    | Change | Resources or methods     |
| ------------ | ------ | ------------------------ |
| `USCfpbData` | Added  | `PersonParams`, `Person` |

#### .NET

| Parameter    | Change | Resources or methods                                                                              |
| ------------ | ------ | ------------------------------------------------------------------------------------------------- |
| `UsCfpbData` | Added  | `AccountPersonCreateOptions`, `AccountPersonUpdateOptions`, `AccountPerson`, `TokenPersonOptions` |

## 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-04-30.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.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.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).

#### 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.1.0](https://github.com/stripe/stripe-python/releases/tag/v12.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).

#### 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.2.0](https://github.com/stripe/stripe-php/releases/tag/v17.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).

#### 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.1.0](https://github.com/stripe/stripe-java/releases/tag/v29.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).

#### 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.1.0](https://github.com/stripe/stripe-node/releases/tag/v18.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 [v82.1.0](https://github.com/stripe/stripe-go/releases/tag/v82.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).

#### .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.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.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).

## Changements connexes

- [Ajout d’un champ de désignation d’entreprise appartenant à des personnes issues de minorités au hachage du profil de l’entreprise](https://docs.stripe.com/changelog/basil/2025-04-30/add-minority-owned-business-designation-to-business-profile.md)