# 最終的な会社代表権の証明書をドキュメントタイプとして追加する

## 新機能

[Accounts API](https://docs.stripe.com/api/accounts/object.md?api-version=2025-01-27.acacia) で `proof_of_ultimate_beneficial_ownership` ドキュメントタイプを使用して、ビジネスの [最終的な実質的支配者](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) (UBO) を識別するドキュメントをアップロードできるようになりました。これは、[顧客確認](https://support.stripe.com/questions/know-your-customer-obligations) (KYC) 要件を満たすのに役立ちます。

[最終的な会社代表者](https://support.stripe.com/questions/beneficial-owner-and-director-definitions)とは、直接または間接的に、会社の大部分の株式を所有し、会社に対して重要な支配権を行使する人物を指します。これらの人物は通常、Stripe アカウントにおいて [所有者](https://docs.stripe.com/api/persons/object.md?api-version=2025-01-27.acacia#person_object-relationship-owner)、[取締役](https://docs.stripe.com/api/persons/object.md?api-version=2025-01-27.acacia#person_object-relationship-director)、または [エグゼクティブ](https://docs.stripe.com/api/persons/object.md?api-version=2025-01-27.acacia#person_object-relationship-executive)で表されます。

UBO 要件を満たすために、Stripe は、会社の所有権または支配権を多く持つ代表者の情報を[特定、収集、検証](https://support.stripe.com/questions/company-beneficial-ownership-and-director-requirement)する必要があります (この所有権割合は、ほとんどの企業において 25% 以上と定義されています)。会社の所有権の多くが他の企業 (持株会社) によって保有されている場合、Stripe は該当する持株会社の情報を特定、収集、検証します。

最終的な会社代表権の証明書に使用されるドキュメントタイプは、すべての国で受け入れられるわけではありません。このドキュメントタイプを使用できるアカウントは、requirements フィールドで `proof_of_ultimate_beneficial_ownership` の要件を受け取ります。アカウントが最終的な会社代表者権の証明書の提供をサポートしている場合は、[各国の受入可能な確認書類](https://docs.stripe.com/acceptable-verification-documents.md)リストから書類を 1 つ選択して、関係を検証することができます。

ファイルを[アップロード](https://docs.stripe.com/file-upload.md)したら、アカウントに添付できます。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]=file_5dtoJkOhAxrMWb"
```

## 影響

会社の所有構造が複雑であったり、外国の持株会社が関与していたりする場合、既存の KYC フィールドは会社の UBO 宣言を十分に反映できていない可能性があります。`proof_of_ultimate_beneficial_ownership` ドキュメントは、KYC 要件に準拠するための代替方法を提供し、柔軟な対応を可能にします。

一部のアカウントでは、[今後の要件の更新](https://docs.stripe.com/connect/upcoming-requirements-updates.md)の一環として、最終的な会社代表権の新しい証明要件が表示される場合があります。

## 変更点

#### REST API

| Parameter                                | Change | Resources or endpoints                                                                                                                                                                                           |
| ---------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proof_of_ultimate_beneficial_ownership` | Added  | [Account#create.documents](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents), [Account#update.documents](/api/accounts/update?api-version=2025-01-27.acacia#update_account-documents) |

#### Ruby

この変更は、Ruby SDK には影響しません。

#### Python

| Parameter                                | Change | Resources or methods                                                                                                |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------- |
| `proof_of_ultimate_beneficial_ownership` | Added  | [stripe.Account.CreateParamsDocuments](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents) |

#### PHP

この変更は、PHP SDK には影響しません。

#### Java

| Parameter                                | Change | Resources or methods                                                                                                                                                                                                       |
| ---------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proof_of_ultimate_beneficial_ownership` | Added  | [AccountCreateParams.documents](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents), [AccountUpdateParams.documents](/api/accounts/update?api-version=2025-01-27.acacia#update_account-documents) |

#### Node.js

| Parameter                                | Change | Resources or methods                                                                                                                                                                                                       |
| ---------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proof_of_ultimate_beneficial_ownership` | Added  | [AccountCreateParams.documents](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents), [AccountUpdateParams.documents](/api/accounts/update?api-version=2025-01-27.acacia#update_account-documents) |

#### Go

| Parameter                            | Change | Resources or methods                                                                                  |
| ------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------- |
| `ProofOfUltimateBeneficialOwnership` | Added  | [AccountDocumentsParams](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents) |

#### .NET

| Parameter                            | Change | Resources or methods                                                                                   |
| ------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------ |
| `ProofOfUltimateBeneficialOwnership` | Added  | [AccountDocumentsOptions](/api/accounts/create?api-version=2025-01-27.acacia#create_account-documents) |

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2025-01-27.acacia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Ruby SDK を [v13.4.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.4.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Python SDK を [v11.5.0](https://github.com/stripe/stripe-python/releases/tag/v11.5.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. PHP SDK を [v16.5.0](https://github.com/stripe/stripe-php/releases/tag/v16.5.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Java SDK を [v28.3.0](https://github.com/stripe/stripe-java/releases/tag/v28.3.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Node SDK を [v17.6.0](https://github.com/stripe/stripe-node/releases/tag/v17.6.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Go SDK を [v81.3.0](https://github.com/stripe/stripe-go/releases/tag/v81.3.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. .NET SDK を [v47.3.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.3.0)にアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

## 関連する変更

- [Accounts API に所有権免除の理由のサポートを追加しました](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api.md)
- [Accounts API にディレクターシップ宣言を追加しました](https://docs.stripe.com/changelog/acacia/2025-01-27/directorship-declaration.md)
