コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

Stripe がホストする受取人の作成公開プレビュー

Stripe がホストするフォームを使用して受取人を登録する方法をご紹介します。

Stripe がホストするウェブフォームを使用して受取人情報を収集します。受取人の情報は、各受取人の機能、国、支払い方法に基づいて動的に表示されます。

Account Links API を使用して、Stripe がオンラインで提供するフォームで情報を収集するプログラムでリンクを生成でき、このフォームは、受取人それぞれのケイパビリティ、国、決済手段に基づいて動的にレンダリングされ、ビジネス名、ブランドカラー、アイコンを使用してカスタマイズできます。受取人はオンラインで提供するフォームに記入し、入金認証情報 (銀行口座や金融番号など) を含む必要な詳細を Stripe に直接送信します。

受取人がフォームに情報を入力する
受取人が入金証明書を Stripe に接続することに同意する
成功画面には、受取人に入金を受け取る準備が整ったことが表示されます

サポートされているブラウザー

Stripe のホスティング収集は、デスクトップとモバイルのブラウザーに対応しています。

  • Chrome と Firefox の最新の 20 個のメジャーバージョン
  • Safari と Edge の最新の 2 つのメジャーバージョン
  • iOS 上のモバイル Safari の最新の 2 つのメジャーバージョン
  • iframe 環境ではありません

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

Stripe のオンラインフォームをカスタマイズするには、ダッシュボードのビジネスブランドの設定ページに移動して、ビジネス名、カラー、アイコンを追加します。

受取人を作成する

公開プレビュー

米国の送金者向けの海外入金は、パブリックプレビューで提供されています。

Accounts v2 API を使用して、受取人を作成します。一部の入金方法では有効化する前に受取人に関する追加情報が必要になるため、意図する入金方法を指定する必要があります。capabilities パラメーターを使用して有効にする方法により、受取人のために収集する必要がある情報が決まります。たとえば、米国の受取人の場合、configuration.recipient.capabilities.bank_accounts.local ではアカウント番号とルーティングナンバーを送信する必要があります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.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 レスポンスに必要な追加情報が Stripe で決定されます。この情報は、受取人が入金を受け取れるようにするために必要な情報で、お客様が送信する必要があります。

入金方法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 を受信できるようにします。

受取人は、複数の入金手段を有効にできます。受取人は、すべての国ですべての入金手段を利用できるわけではありません。国別の利用可能な入金手段の一覧をご覧ください。

これらのフィールドとリクエストされた入金手段を追加した後、API レスポンスに必要な追加情報が Stripe で決定されます。この情報は、受取人が入金を受け取れるようにするために必要な情報で、お客様が送信する必要があります。

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

Account Link API を使用して、共有可能なリンクを作成します。このリンクを受取人に送信します。受取人は回収フォームにアクセスして、必要な情報を Stripe に直接送信できます。各 AccountLink URL は生成から 10 分後に有効期限が切れ、1 回のみ使用できます。受取人が 10 分後に有効期限が切れると、セキュリティ上の理由から、受取人は refresh.url にリダイレクトされます。受取人が情報を提供すると、AccountLink は return.url にリダイレクトされます。

プライベートプレビュー

受取人の確認を希望する場合受取人が Stripe のオンラインフォームで入金手段の詳細を共有した後、Financial Connections API を使用して、関連付けられた口座の所有権情報を表示および確定します。アクセスをご希望の場合は、メールアドレスを入力してください。

新しい共有可能なリンクを作成するには、以下のパラメーターを含めます。

  • account: 受取人のアカウント ID。Accounts v2 API を使用して取得できます。
  • use_case.type:受取人の情報を初めて収集する場合は、account_onboarding を指定します。
  • use_case.account_onboarding.configurations: recipient に設定します。
  • use_case.account_onboarding.return_url:AccountLink がすでにアクセスされたか、有効期限が切れているか、無効であるときに、Stripe はこのページに受取人をリダイレクトします。
  • use_case.account_onboarding.refresh_url:受取人が情報収集フォームを完了または終了したときに、Stripe がリダイレクトするページ。

次のリクエストで、受取人の情報を初めて収集する目的で AccountLink を作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.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 は、受取人のメールアドレスに認証コードを送信し、新しい Account Link にリダイレクトすることで受取人を再認証する、ワンタイムパスコード機能も提供しています。アクセスをご希望の場合は、メールアドレスを入力してください。

受取人小切手の確認 UK only

イギリスの受取人に送金する前に受取人確認にを行う必要があります。この確認は、銀行口座の作成時に行うか、API コールで行います。

/v2/payment_methods/gb_bank_accounts へのリクエストで次のパラメーターを指定します。

API パラメーター必要説明
account_numberあり銀行口座の口座番号。
sort_codeあり銀行口座のソートコード (数値のみ)。
confirmation_of_payeeなし受取人の銀行口座を確認するかどうかを決定します。

このリクエストの Stripe-Context ヘッダーは、受取人のアカウント ID である必要があります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "sort_code": "108800",
    "account_number": "00012345",
    "confirmation_of_payee": {
        "initiate": true
    }
  }'

次に、レスポンスの例を示します。

{
  "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"
  },
}

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts/gbba_1234/acknowledge_confirmation_of_payee \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

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

受取人が有効になっていることを確認する

受取人が入金を受け付けるには、その受取人に関する情報と、予定されている入金方法を収集する必要があります。

受取人が共有リンクから回収フォームにアクセスし、必要な情報を送信すると、v2.core.account_link.returned Webhook がトリガーされます。この Webhook イベントをリッスンすることで、AccountLink が正常に処理され、受取人が入金を受け付ける準備が整ったことを把握することができます。詳細は Webhook とその処理方法 をご確認ください。

または、ダッシュボードまたは Accounts v2 API を使用して、受取人が入金を受け付ける準備ができているかどうかを確認することもできます。

  1. 受取人に移動し、その受取人を選択します。
  2. 追加情報が必要ないことを確認します。受取人からの追加情報が必要な場合は、ページにバナーが表示されます (例: 「情報が必要です」、「デフォルトの銀行口座が設定されていません」)。表示がない場合、受取人情報の収集は完了しています。
  3. 入金方法で少なくとも 1 の入金方法が有効になっていることを確認します。有効になっていない場合は、別のリンクを共有するか、API を使用して入金方法を収集する必要があります。別の共有可能リンクを作成するには、Account Links API を再度使用します。

既存の受取人を更新する

Account Links API を使用して別の共有可能なリンクを作成すると、受取人は Stripe がホストするフォームで自分の情報を更新できるようなります。

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

  • account: 受取人のアカウント ID。Accounts v2 API を使用して取得できます。
  • use_case.type: account_update を指定します。
  • use_case.account_update.configurations: recipient に設定します。
  • use_case.account_update.return_url: AccountLink がすでに使用済み、期限切れ、または無効な場合に Stripe が受取人をリダイレクトするページです。
  • use_case.account_update.refresh_url: 受取人が情報収集フォームを完了した、または途中で離脱した場合に Stripe が受取人をリダイレクトするページです。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.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 にリダイレクトされます。

このページの内容