# 受取人を作成する

入金の受取人を作成する方法を説明します。

受取人とは、支払先の個人またはビジネスを指します。入金を送信するには、事前に受取人を作成する必要があります。受取人を作成した後は、今後の入金でその情報を再利用できます。

## 必要な情報を収集する

Stripe では、受取人の情報を収集する 2 つの方法を提供しています。

- **受取人情報の収集を Stripe に任せる**: 受取人が自身の入金詳細を入力できるように、Stripe ダッシュボードまたは API を使用して安全な事前構築済みのホスト型フォームを生成します。これにより、慎重な取り扱いが必要な銀行データや本人確認の処理を Stripe に委ねることができます。
- **受取人の処理手順を管理する**: 独自の UI 内で入金および本人確認のための情報を直接収集し、ダッシュボードまたは API を使用して Stripe にその詳細を提出します。

要件はそれぞれ異なります。対応している国、要件、事業形態、入金方法の完全なリストについては、[受取人の要件](https://docs.stripe.com/global-payouts/recipient-requirements.md)を参照してください。

|  | コーディング不要 | Stripe がオンラインで提供 | コーディングが必要 |
| --- | --- | --- | --- |
| **ブランディングとローカライズ** | 該当しない | ビジネス名、ロゴ、ブランドカラーを使用した共同ブランド仕様で、自動的にローカライズされます | UI を完全に制御できますが、自動的なローカライズは適用されません |
| **新しいコンプライアンス要件に合わせた自動更新** | 詳細情報の入力が必要 | 即時 | システムの変更が必要 |
| **変更なしで新しい国に対応** | ✓ サポート対象 | ✓ サポート対象 | ❌ |
| **処理手順のロジック** | 該当しない | 管理が限定的 | 全面的に管理 |

## 受取人を作成する

#### ダッシュボード

Stripe ダッシュボードからいくつかの方法で、コードを使用せずに受取人を作成できます。

1. **Treasury** > **入金** > [受取人](https://dashboard.stripe.com/global-payouts/recipients)に移動し、**受取人を追加**をクリックします。
2. 受取人のメールアドレスと国を入力します。名前を追加して、後で受取人にアクセスすることもできます。
3. 受取人の情報を収集する方法を選択します。Stripe から受取人に Stripe ホスト型フォームへのリンクをメールで送信する (**Pay via Email**) ほか、そのリンクをご自身で受取人に直接送信したり、情報を直接入力したりすることができます。収集が必要な情報については、[受取人の要件](https://docs.stripe.com/global-payouts/recipient-requirements.md)を参照してください。
4. (オプション) 受取人に対して有効にする入金手段を更新します。受取人の作成後に、**受取人の詳細** > **入金手段**から入金手段を更新することもできます。
5. **続行** または **メールを送信** (Stripe がメールを直接送信することを選択した場合) をクリックして、フローを完了します。

リンクは、2 回クリックされるか完了するまで、3 日間有効です。

コンプライアンス上の理由により、受取人のデビットカード情報を手動で入力することはできません。この受取人の作成方法でサポートされているのは、銀行口座と暗号資産ウォレットのみです。

> #### Pay via Email の注意事項
> 
> - Pay via Email は、海外入金をサポートしていません。送金者と受取人は同じ国にいる必要があります。
> - [Verification of Payee regulation](https://support.stripe.com/questions/verification-of-payee-support-for-financial-accounts) により、EU では Pay via Email を利用できません。

#### Stripe がオンラインで提供

[Account Links API](https://docs.stripe.com/api/v2/core/account-links.md) を使用して、Stripe ホスト型フォームで情報を収集するためのリンクをプログラムで生成できます。このフォームは、各受取人の機能、国、入金方法に基づいて動的にレンダリングされます。また、ビジネス名、ブランドカラー、アイコンを使用してカスタマイズすることも可能です。受取人はホスト型フォームに入力し、入金方法の詳細 (銀行口座番号や金融機関コードなど) を含む必要な詳細情報を Stripe に直接提出します。
![受取人がフォームに情報を入力します](https://b.stripecdn.com/docs-statics-srv/assets/stripe-hosted1.b2a794696c10dcecdced4869e1d94e56.png)

受取人は、Stripe ホスト型フォームに情報を入力します。
![受取人が入金の認証情報を Stripe に接続することに同意します](https://b.stripecdn.com/docs-statics-srv/assets/stripe-hosted2.ae2c0c01b188e67f8a3c5b720dc8e08c.png)

受取人は、自身の入金に関する認証情報を Stripe に紐付けることに同意します。
![入金を受け取れるようになったことを示す完了画面が受取人に表示されます。](https://b.stripecdn.com/docs-statics-srv/assets/stripe-hosted4.83fd75e3fbf54e8b81c8a7740a80732e.png)

入金を受け取れるようになったことを示す完了画面が受取人に表示されます。

### サポートされるブラウザー

Stripe がオンラインで提供する収集は、次のようなデスクトップおよびモバイルブラウザーをサポートしています。

- Chrome と Firefox の最新の 20 のメジャーバージョン
- Safari と Edge の最新の 2 つのメジャーバージョン
- iOS のモバイル Safari の最新の 2 つのメジャーバージョン
- iframe 環境ではないこと

### 収集フォームをカスタマイズする

Stripe がオンライン提供するフォームをカスタマイズするには、ダッシュボードの[ビジネスブランドの設定ページ](https://dashboard.stripe.com/settings/branding)に移動し、ビジネス名、色、アイコンを追加します。

### API を使用して受取人を作成する

受取人を作成するには、受取人の詳細を入力し、有効にする入金方法を指定します。

[Accounts v2 API](https://docs.stripe.com/api/v2/core/accounts/create.md) を使用して受取人を作成します。一部の入金方法では有効化の前に受取人の追加情報が必要になるため、利用を予定している入金方法を指定してください。`capabilities` パラメーターで有効にする入金方法によって、受取人から収集が必要な KYC 情報 (名前や生年月日など) が決まります。

```curl
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "requirements",
        "configuration.recipient",
        "identity"
    ]
  }'
```

機能をリクエストすると、それらを有効化するために必要な追加情報が API レスポンス内の [requirements.entries](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-response-requirements-entries) 配列に含まれます。

### 機能

#### OutboundPayments の機能

次の表は、銀行の送金網に対応する機能ハッシュを示しています。機能をリクエストするには、そのハッシュの `requested` パラメーターを `true` に設定します。

| 銀行の送金網 | 機能ハッシュ | 説明 |
| --- | --- | --- |
| 現地 | `configuration.recipient.capabilities.bank_accounts.local` | `アカウント`で、ACH や FPS といった現地の銀行ネットワークを介して `OutboundPayments` を受け取れます。 |
| 銀行の電信送金 | `configuration.recipient.capabilities.bank_accounts.wire` | `アカウント`で、Fedwire や SWIFT といったワイヤーネットワークを介して `OutboundPayments` を受け取れます。 |
| カード | `configuration.recipient.capabilities.cards` | `アカウント`で、Visa Direct や Mastercard Send といったデビットカードネットワークを介して `OutboundPayments` を受け取れます。 |

#### PayoutIntents の機能 (Private preview)

PayoutIntents を使用する場合は、代わりに以下の機能ハッシュを使用できます。

| 銀行の送金網 | 機能ハッシュ | 説明 |
| --- | --- | --- |
| ACH (米国内) | `configuration.recipient.capabilities.bank_accounts.ach` | `アカウント`で、ACH ネットワーク経由で入金を受け取れます。 |
| Fedwire (アメリカ国内電信送金) | `configuration.recipient.capabilities.bank_accounts.fedwire` | `アカウント`で、Fedwire ネットワーク経由で入金を受け取れます。 |
| FPS (イギリス国内) | `configuration.recipient.capabilities.bank_accounts.fps` | `アカウント`で、Faster Payments Service 経由で入金を受け取れます。 |
| SEPA (ユーロ圏) | `configuration.recipient.capabilities.bank_accounts.sepa` | `アカウント`で、SEPA クレジットトランスファーネットワーク経由で入金を受け取れます。 |
| SEPA Instant (ユーロ圏) | `configuration.recipient.capabilities.bank_accounts.sepa_instant` | `アカウント`で、SEPA インスタントクレジットトランスファーネットワーク経由で入金を受け取れます。 |
| 現地 (越境) | `configuration.recipient.capabilities.bank_accounts.local` | `アカウント`で、現地の銀行ネットワーク経由での越境入金を受け取れます。 |
| SWIFT (越境電信送金) | `configuration.recipient.capabilities.bank_accounts.swift` | `アカウント`で、SWIFT ネットワーク経由での越境入金を受け取れます。 |
| カード | `configuration.recipient.capabilities.cards` | `アカウント`で、Visa Direct、Mastercard Send などのデビットカードネットワーク経由で入金を受け取れます。 |

受取人は、異なる種類の入金方法を複数保有できます。利用できる入金方法は、受取人の国によって異なります。[利用できる入金方法の国別一覧](https://docs.stripe.com/global-payouts/recipient-requirements.md#requirements)を参照してください。

これらのフィールドとリクエストされた入金方法を追加すると、受取人が支払いを受け取れるようにするために提出する必要がある追加情報が API レスポンスで指定されます。

### 共有可能なリンクを作成する

[Account Link API](https://docs.stripe.com/api/v2/core/account-links/create.md) を使用して、共有可能なリンクを作成します。このリンクを受取人に送信します。受取人は収集フォームにアクセスして、必要な情報を Stripe に直接送信できます。各 `AccountLink` URL は生成から 10 分後に有効期限が切れ、1 回のみ使用できます。10 分を超えてから受取人が `AccountLink` をクリックすると、セキュリティ上の理由から、受取人は `refresh_url` にリダイレクトされます。受取人が情報を提供すると、`AccountLink` は `return_url` にリダイレクトされます。

> 受取人の本人確認をご希望ですか？受取人が Stripe ホスト型フォームで入金方法の詳細を共有した後、[Financial Connections API](https://docs.stripe.com/financial-connections/ownership.md) を使用して、リンクされたアカウントに関連付けられている所有者情報を表示および確認できます。利用をご希望の場合は、[メールアドレスを入力](https://docs.stripe.com/global-payouts/recipient-creation.md#financial_connections_payouts_preview)してください。

### 受取人の確認をご希望ですか？

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/global-payouts/recipient-creation" \
  -d '{"email": "EMAIL", "preview": "financial_connections_payouts_preview"}'
```

共有可能なリンクを作成するには、次のパラメーターを指定します。

- `account`: 受取人のアカウント ID。[Accounts v2 API](https://docs.stripe.com/api/v2/core/accounts.md) を使用して取得できます。
- `use_case.type`: 受取人の情報を初めて収集する場合は、`account_onboarding` を指定します。
- `use_case.account_onboarding.configurations`: `recipient` に設定します。
- `use_case.account_onboarding.return_url`: 受取人が情報収集フォームを完了した、または途中で離脱した場合に Stripe が受取人をリダイレクトするページです。
- `use_case.account_onboarding.refresh_url`: `AccountLink` がすでに使用済み、期限切れ、または無効な場合に Stripe が受取人をリダイレクトするページです。

次のリクエストにより、受取人の情報を初めて収集するための `AccountLink` が作成されます。

```curl
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_onboarding",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'
```

受取人をこの URL にリダイレクトする前に、アプリケーションで受取人を認証します。

> 追加の認証ツールをご希望ですか？Stripe ではワンタイムパスコード機能も提供しており、受取人のメールアドレスに認証コードを送信し、新しい `AccountLink` にリダイレクトすることで受取人を再認証できます。利用をご希望の場合は、[メールアドレスを入力](https://docs.stripe.com/global-payouts/recipient-creation.md#authentication_tools_payouts_preview)してください。

### その他の認証ツールにご興味がありますか？

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/global-payouts/recipient-creation" \
  -d '{"email": "EMAIL", "preview": "authentication_tools_payouts_preview"}'
```

### 受取人確認のチェック (イギリスのみ)

イギリスの受取人に送金する前に、[受取人確認](https://www.wearepay.uk/what-we-do/overlay-services/confirmation-of-payee/)のチェックを行う必要があります。この確認は、銀行口座の作成時に行うか、API コールで行います。

`/v2/payment_methods/gb_bank_accounts` へのリクエストには次のパラメーターを含めます。

| API パラメーター | 必須 | 説明 |
| --- | --- | --- |
| `account_number` | はい | 銀行口座の口座番号。 |
| `sort_code` | はい | 銀行口座のソートコード (数字のみ)。 |
| `confirmation_of_payee` | いいえ | 受取人の銀行口座を確認するかどうかを決定します。 |

これらのリクエストの Stripe-Context ヘッダーは、受取人の `Account` ID にしてください。

```curl
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -H "Stripe-Context: {{CONTEXT_ID}}" \
  --json '{
    "sort_code": "108800",
    "account_number": "00012345",
    "confirmation_of_payee": {
        "initiate": true
    }
  }'
```

以下はレスポンスの例です。

```json
{
  "id": "gbba_123",
  "object": "payment_methods.gb_bank_account",
  "bank_account_type": "checking",
  "bank_name": "Test Bank",
  "created": "2023-05-15T16:29:15.738Z",
  "deactivated": false,
  "last4": "2345",
  "sort_code": "108800",
  "confirmation_of_payee": {
    "result": {
      "created": "2024-10-18T19:19:31.000Z",
      "match_result": "mismatch",
      "matched": {
        "business_type": null,
        "name": ""
      },
      "message": "The provided information does not match the information the bank has on file for this account.",
      "provided": {
        "business_type": "business",
        "name": "John Smith"
      }
    },
    "status": "awaiting_acknowledgement"
  },
}
```

受取人の確認の結果が一致する場合、すぐにこの送金先に資金を送金できます。結果が部分的に一致する場合、結果が一致しない場合、またはサービスを利用できない場合は、最初に次の結果を確認する必要があります。

```curl
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts/gbba_1234/acknowledge_confirmation_of_payee \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -H "Stripe-Context: {{CONTEXT_ID}}"
```

確認の前に、これらの銀行口座を見直して正しい送金先であることを確認してください。送金先と一致していない銀行口座は、ダッシュボードで確認することもできます。

### 受取人が有効であることを確認する

受取人が入金を受け取れるようにするには、受取人に関する情報と、利用を予定している入金方法に関する情報を収集する必要があります。

受取人が共有可能なリンクから収集フォームにアクセスして必要な情報を提出すると、[v2.core.account_link.returned](https://docs.stripe.com/api/v2/core/events/event-types.md?api-version=2025-07-30.preview&rds=1#v2_event_types-v2.core.account_link.returned) Webhook がトリガーされます。この Webhook イベントを処理することで、受取人が情報の提出を完了したタイミングを把握できますが、リクエストされた機能の検証は非同期で行われる場合があります。受取人が入金を受け取れる状態になったと判断する前に、機能の `status` を確認してください。[Webhook とその処理方法](https://docs.stripe.com/webhooks.md)について詳細を参照してください。

または、ダッシュボードや [Accounts v2 API](https://docs.stripe.com/api/v2/core/accounts.md) を使用して、受取人が入金を受け取る準備ができているかどうかを判断することもできます。

#### ダッシュボード

1. [受取人](https://dashboard.stripe.com/global-payouts/recipients)に移動し、受取人を選択します。
2. 追加情報が不要であることを確認します。受取人からの追加情報が必要な場合は、ページにバナーが表示されます (「情報が必要です」「デフォルトの銀行口座が設定されていません」など)。表示されない場合、受取人の情報収集は完了しています。
3. 入金方法で 1 つ以上の入金方法が有効になっていることを確認します。有効になっていない場合は、別のリンクを共有するか、API を使用して入金方法を収集する必要があります。別の共有可能リンクを作成するには、[Account Links API](https://docs.stripe.com/api/v2/core/account-links.md) を再度使用します。

#### API

[Account を取得](https://docs.stripe.com/api/v2/core/accounts/retrieve.md)して、リクエストした[機能](https://docs.stripe.com/global-payouts/recipient-creation.md#capabilities)の `status` を確認します。受取人がその種類の入金方法で入金を受け取るには、機能の `status` が `active` になっている必要があります。また、資金を送金する前に、その種類の特定の入金方法 (銀行口座など) が `Account` に紐付けられていることを確認してください。

```curl
curl -G https://api.stripe.com/v2/core/accounts/acct_1234 \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -d "include[0]=identity" \
  -d "include[1]=configuration.recipient" \
  -d "include[2]=default"
```

### 既存の受取人を更新する

[Account Links API](https://docs.stripe.com/api/v2/core/account-links.md) を使用して別の共有可能なリンクを作成すると、Stripe がオンラインで提供するフォームで受取人が情報を更新できるようになります。

新しい共有可能なリンクを作成するには、以下を指定します。

- `account`: 受取人のアカウント ID。[Accounts v2 API](https://docs.stripe.com/api/v2/core/accounts.md) を使用して取得できます。
- `use_case.type`: `account_update` を指定します。
- `use_case.account_update.configurations`: `recipient` に設定します。
- `use_case.account_update.return_url`: 受取人が情報収集フォームを完了した、または途中で離脱した場合に Stripe が受取人をリダイレクトするページです。
- `use_case.account_update.refresh_url`: `AccountLink` がすでに使用済み、期限切れ、または無効な場合に Stripe が受取人をリダイレクトするページです。

```curl
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_update",
        "account_update": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'
```

受取人の作成に使用した `AccountLink` と同様に、URL は 10 分後に有効期限が切れ、1 回のみ使用できます。受取人が 10 分以上経過してから URL を開いた場合や、複数回開いた場合は、`refresh_url` にリダイレクトされます。

#### API

受取人用の情報収集フローを構築して受取人と入金方法の詳細を収集し、API を介してその情報を Stripe に渡します。

受取人とは、受取人の機能が設定された v2 [Account](https://docs.stripe.com/api/v2/core/accounts.md) のことです。API では、全体を通して受取人を `Account` オブジェクトとして参照します。

### Use API keys

You must use [restricted API keys](https://docs.stripe.com/keys/restricted-api-keys.md) to make live requests to the Global Payouts APIs. For a standard integration, [create a restricted key with the following permissions](https://dashboard.stripe.com/apikeys/create):

- **Recipient Configuration: Write**
- **Money Management Financial Accounts: Read**
- **Money Management Payout Methods: Write**
- **Money Management Outbound Payments: Write**

Grant additional permissions for these scenarios:

- For UK Confirmation of Payee or SEPA/Eurozone payments that require Recipient Verifications, grant **Money Management Recipient Verifications: Write**.
- If you use the gated Payout Intents API path, grant **Money Management Payout Intents: Write**.

### 受取人を作成する

フォームで入金先となる受取人の情報を収集する場合は、[Accounts API](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview) を使用して受取人を作成してください。`Account` を作成するには、次のパラメーターを指定する必要があります。

| 必要な情報 | パラメーター |
| --- | --- |
| 受取人の国 | `identity.country` |
| 受取人の事業形態 | `identity.entity_type` |
| 受取人のメールアドレス | `contact_email` |
| `アカウント`に表示する名前。これは Stripe ダッシュボードと、`アカウント`に送信するすべての請求書に表示されます。 | `display_name` |
| 有効にする機能 | `configuration.recipient.capabilities` |

[アカウントの作成](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview#v2_create_accounts-configuration-recipient-capabilities)時には、[対応する機能をリクエスト](https://docs.stripe.com/connect/account-capabilities.md?accounts-namespace=v2)することで希望する入金方法の種類を指定する必要があります。

| 入金方法 | API パラメーター | 説明 |
| --- | --- | --- |
| 現地 | `configuration.recipient.capabilities.bank_accounts.local` | `アカウント`で、ACH や FPS といった現地の銀行ネットワークを介して `OutboundPayments` を受け取れます。 |
| 銀行の電信送金 | `configuration.recipient.capabilities.bank_accounts.wire` | `アカウント`で、Fedwire や SWIFT といったワイヤーネットワークを介して `OutboundPayments` を受け取れます。 |
| カード | `configuration.recipient.capabilities.cards` | `アカウント`で、Visa Direct や Mastercard Send といったデビットカードネットワークを介して `OutboundPayments` を受け取れます。 |

### PayoutIntents の入金に関する概念 (Private preview)

PayoutIntents を使用する場合は、以下の概念に基づく、より詳細な機能を使用することになります。

- **入金手段**: 銀行口座、デビットカード、暗号資産ウォレットなど、入金の着金先の種類。
- **銀行の送金網**: 銀行口座の入金手段において、資金移動に使用される特定の決済ネットワーク (ACH、FPS、SEPA など)。1 つの銀行口座の入金手段で複数の送金網をサポートできます。
- **機能**: 特定の入金方法や送金網を有効にする、受取人アカウントの設定。機能 (たとえば、`bank_accounts.ach`) をリクエストすると、その方法のオンボーディングが開始されます。これを使用して入金を送信するには、機能が `active` になり、受取人が対応する入金方法を保有している必要があります。カードと暗号資産ウォレットにはそれぞれ 1 つの機能があり、銀行口座にはサポートされている送金網ごとに 1 つの機能があります。

#### 銀行口座

| 銀行の送金網 | 機能 | 説明 |
| --- | --- | --- |
| ACH (アメリカ) | `configuration.recipient.capabilities.bank_accounts.ach` | `アカウント`で、ACH ネットワーク経由で入金を受け取れます。 |
| Fedwire (アメリカ国内電信送金) | `configuration.recipient.capabilities.bank_accounts.fedwire` | `アカウント`で、Fedwire ネットワーク経由で入金を受け取れます。 |
| RTP (米国リアルタイム) | `configuration.recipient.capabilities.bank_accounts.rtp` | `アカウント`で、RTP ネットワーク経由で入金を受け取れます。 |
| FPS (イギリス) | `configuration.recipient.capabilities.bank_accounts.fps` | `アカウント`で、Faster Payments Service 経由で入金を受け取れます。 |
| SEPA (ユーロ圏) | `configuration.recipient.capabilities.bank_accounts.sepa` | `アカウント`で、SEPA クレジットトランスファーネットワーク経由で入金を受け取れます。 |
| SEPA Instant (ユーロ圏) | `configuration.recipient.capabilities.bank_accounts.sepa_instant` | `アカウント`で、SEPA インスタントクレジットトランスファーネットワーク経由で入金を受け取れます。 |
| 現地 (越境) | `configuration.recipient.capabilities.bank_accounts.local` | `アカウント`で、現地の銀行ネットワーク経由での越境入金を受け取れます。 |
| SWIFT (越境電信送金) | `configuration.recipient.capabilities.bank_accounts.swift` | `アカウント`で、SWIFT ネットワーク経由での越境入金を受け取れます。 |

#### その他の入金手段

| 入金方法 | 機能 | 説明 |
| --- | --- | --- |
| デビットカード | `configuration.recipient.capabilities.cards` | `アカウント`で、Visa Direct、Mastercard Send などのデビットカードネットワーク経由で入金を受け取れます。 |

受取人は、異なる種類の入金方法を複数保有できます。利用できる入金方法の種類は、受取人の国によって異なります。[利用できる入金方法の国別一覧](https://docs.stripe.com/global-payouts/recipient-requirements.md#requirements)を参照してください。

一部の機能を利用するには、受取人に関する追加の KYC 情報 (名前や生年月日など) が必要です。機能をリクエストすると、Stripe はそれらを有効化するために提出が必要な情報の要件を特定し、API レスポンス内で指定します。レスポンスでこれらの要件を受け取るには、`include` 配列に `requirements`、`configuration.recipient`、`identity` を含めてください。これらを含めない場合、Stripe は実際の値に関係なく、これらのプロパティに対して null を返します。

```curl
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'
```

PayoutIntents (プライベートプレビュー) を使用する場合は、代わりに `bank_accounts.ach` など、目的の送金網に応じたより詳細な機能をリクエストします。

```curl
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "ach": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'
```

### 受取人を有効にするための必須フィールドを判断する

提出が必要な具体的な要件を特定するには、Accounts API レスポンス内の [requirements.entries](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview#v2_create_accounts-response-requirements-entries) 配列を確認してください。受取人が入金を受け取れるようにするには、`restricts_capabilities` プロパティが含まれているすべての要件について情報を提出してください。

```json
{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {
     "capabilities": {
       "bank_accounts": {
         "local": {
           "requested": true,
           "status": "restricted",
           "status_details": [
             {
               "code": "requirements_past_due",
               "resolution": "provide_info"
             }
           ]
         },
         "wire": null,
         "instant": null
       },
       "cards": null,
       "stripe_balance": null
     },
     "default_outbound_destination": null
   }
 },
 "contact_email": "jenny.rosen@stripe.com",
 "created": "2025-04-02T17:20:00.000Z",
 "dashboard": null,
 "identity": {
   "attestations": {
     "directorship_declaration": null,
     "ownership_declaration": null,
     "persons_provided": {
       "directors": null,
       "executives": null,
       "owners": null,
       "ownership_exemption_reason": null
     },
     "terms_of_service": {
       "account": null
     }
   },
   "business_details": null,
   "country": "US",
   "entity_type": "individual",
   "individual": null
 },
 "defaults": null,
 "display_name": "Jenny Rosen",
 "metadata": {},
 "requirements": {
   "collector": "stripe",
   "entries": [
     {
       "awaiting_action_from": "user",
       "description": "identity.individual.given_name",
       "errors": [],
       "impact": {
         "restricts_capabilities": [
           {
             "capability": "bank_accounts.local",
             "configuration": "recipient",
             "deadline": {
               "status": "past_due"
             }
           }
         ],
         "restricts_payouts": null
       },
       "minimum_deadline": {
         "status": "past_due"
       },
       "reference": null,
       "requested_reasons": [
         {
           "code": "routine_onboarding"
         }
       ]
     },
     {
       "awaiting_action_from": "user",
       "description": "identity.individual.surname",
       "errors": [],
       "impact": {
         "restricts_capabilities": [
           {
             "capability": "bank_accounts.local",
             "configuration": "recipient",
             "deadline": {
               "status": "past_due"
             }
           }
         ],
         "restricts_payouts": null
       },
       "minimum_deadline": {
         "status": "past_due"
       },
       "reference": null,
       "requested_reasons": [
         {
           "code": "routine_onboarding"
         }
       ]
     }
   ],
   "summary": {
     "minimum_deadline": {
       "status": "past_due",
       "time": null
     }
   }
 }
}
```

### 受取人情報を Stripe に提出する

必要な情報を収集したら、[Accounts API](https://docs.stripe.com/api/v2/core/accounts/update.md?api-version=preview) を使用して提出します。

```curl
curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "given_name": "Jenny",
            "surname": "Rosen",
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR"
            }
        }
    },
    "include": [
        "identity"
    ]
  }'
```

### 受取人が有効であることを確認する

[Account を取得](https://docs.stripe.com/api/v2/core/accounts/retrieve.md?api-version=preview)して、リクエストした機能の `status` を確認します。受取人がその方法で入金を受け取るには、機能の `status` が `active` になっている必要があります。

```curl
curl -G https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -d "include[0]=configuration.recipient"
```

### 受取人の入金方法を作成する

機能が有効になったら、[Outbound Setup Intents API](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/create.md?api-version=preview) を使用して受取人の実際の `PayoutMethod` を作成します。

このリクエストの Stripe-Context ヘッダーは、受取人の `Account` ID にしてください。

```curl
curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -H "Stripe-Context: {{CONTEXT_ID}}" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'
```

> `OutboundSetupIntent` のレスポンスにはその [PayoutMethod](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/create.md?api-version=preview#v2_create_outbound_setup_intents-response-payout_method) が含まれています。`OutboundPayment` を作成する際には、`OutboundSetupIntent` ID (たとえば `osi_test_...`) ではなく、必ず `PayoutMethod` の ID (たとえば `frba_test_...`) を使用します。

電信送金で入金するには、[US Bank Accounts API](https://docs.stripe.com/api/v2/core/vault/us-bank-accounts/update.md?api-version=preview) を使用して `fedwire_routing_number` をその `PayoutMethod` に追加します。ただし追加の手数料が課されます。詳しくは[料金体系](https://docs.stripe.com/global-payouts/pricing.md)を参照してください。

デビットカードを入金方法として使用することもできます。ただし、受取人はデビットカードの情報を Stripe に直接提出する必要があります。デビットカードによる入金を有効にする場合は、[Account Links API](https://docs.stripe.com/api/v2/core/account-links.md) を使用して、ユーザーがデビットカード情報を提出するための共有可能なフォームを作成してください。この収集処理の詳細な手順については、[Stripe がオンラインで提供](https://docs.stripe.com/global-payouts/recipient-creation.md?create-recipient-method=stripe-hosted#create-recipients-with-no-code)している方法の説明を参照してください。

### 受取人の入金方法をすべて表示する

Payout Methods API を使用して、[受取人の PayoutMethods を取得](https://docs.stripe.com/api/v2/money-management/payout-methods/list.md?api-version=preview)してください。

このリクエストの Stripe-Context ヘッダーは、受取人の `Account` ID にしてください。

```curl
curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -H "Stripe-Context: {{CONTEXT_ID}}"
```

このレスポンスには、受取人に関連する `PayoutMethod` オブジェクトの一覧が含まれます。[Outbound Payments API](https://docs.stripe.com/api/v2/money-management/outbound-payments/create.md?api-version=preview) または [Payout Intents API](https://docs.stripe.com/api/v2/money-management/payout-intents/create.md?api-version=preview) (プライベートプレビュー) を使用して入金を行うには、`PayoutMethod` ID を使用します。詳細については、[送金](https://docs.stripe.com/global-payouts/send-money.md)に関する説明を参照してください。

### 受取人向けデフォルトの入金方法の設定

必要に応じて、1 つ以上の通貨について受取人のデフォルトの入金方法を設定できます。Stripe では、`PayoutMethod` を指定せずにその通貨で入金を作成した場合、その通貨のデフォルトの入金方法が使用されます。

受取人の `Account` を更新するには、その [defaults.payout_methods](https://docs.stripe.com/api/v2/core/accounts/update.md?api-version=preview#v2_update_accounts-defaults-payout_methods) に 1 つ以上の入金方法を追加します。このプロパティは小文字の ISO 通貨コードをキーとするマップであり、各値は受取人が所有する `PayoutMethod` ID です。

```curl
curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "defaults": {
        "payout_methods": {
            "usd": "usba_test_..."
        }
    },
    "include": [
        "defaults"
    ]
  }'
```

レスポンスでは、指定した各通貨にデフォルトの入金方法が設定された更新済みの `Account` が返されます。

```json
{
  "id": "{{CONNECTED_ACCOUNT_ID}}",
  "object": "v2.core.account",
  "defaults": {
    "payout_methods": {
      "usd": "usba_test_..."
    }
  }
  . . .
}
```

対応する受取人のデフォルトが設定されている通貨で入金を作成する場合、入金リクエストで `PayoutMethod` を指定する必要はありません。`PayoutMethod` を指定した場合、受取人のデフォルトは上書きされます。

## 考慮事項

受取人とのすべてのやり取りと、受取人の確認に必要なすべての情報を収集する責任はビジネスにあります。世界中の法律および規制の変更に応じて、Stripe は受取人の確認要件を更新します。

入金の失敗を防ぐため、アカウント登録要件の定期的な確認と更新を計画する。