# Fügt der Persons API einen Hash für demografische Informationen hinzu

## Das ändert sich

Führt den Hash `us_cfpb_data` im Persons API ein, der zwei Unter-Hashes, `ethnicity_details` und `race_details`, sowie ein Freitextfeld für das selbst identifizierte Geschlecht der Person enthält. Jeder Sub-Hash enthält Felder, die mehrere Enum-Werte und Freitexteingaben ermöglichen, um die ethnische Zugehörigkeit oder Rasse der Person zu beschreiben.

Diese Änderung steht im Einklang mit Abschnitt 1071 des Dodd-Frank Act, der Anbieter/innen von Finanzierungen für kleine Unternehmen in den USA dazu verpflichtet, demografische Informationen über Antragsteller/innen zu erfassen. Die Finanzpartner von Stripe melden diese Informationen an das CFPB, das potenzielle Ungleichheiten bei der Unternehmensfinanzierung analysiert. Die an das CFPB weitergegebenen Informationen werden anonymisiert, um die Identität der Antragsteller zu schützen.

```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
```

## Ergebnis

Dieser Zusatz stellt die Einhaltung der Verordnung 1071 sicher, indem er Anbieter von Finanzierungsmöglichkeiten für kleine Unternehmen verpflichtet, demografische Informationen über Finanzierungsantragsteller zu sammeln.

## Änderungen

#### REST API

| 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` |

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-04-30.basil`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf [v15.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf [v12.1.0](https://github.com/stripe/stripe-python/releases/tag/v12.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf [v17.2.0](https://github.com/stripe/stripe-php/releases/tag/v17.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf [v29.1.0](https://github.com/stripe/stripe-java/releases/tag/v29.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf [v18.1.0](https://github.com/stripe/stripe-node/releases/tag/v18.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf [v82.1.0](https://github.com/stripe/stripe-go/releases/tag/v82.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf [v48.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.1.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

## Zugehörige Änderungen

- [Fügt dem Unternehmensprofil-Hash ein Feld für die Bezeichnung eines Unternehmens im Besitz einer Minderheit hinzu](https://docs.stripe.com/changelog/basil/2025-04-30/add-minority-owned-business-designation-to-business-profile.md)