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

API を使用し海外送金の受取人を作成する公開プレビュー

Stripe API を使用して Global Payouts の受取人をユーザー登録する方法をご紹介します。

受取人から情報を収集するフローを構築し、受取人情報および支払い方法の詳細を取得した後、その情報を Stripe API を通じて Stripe に送信します。

考慮事項

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

入金の統合を構築する際は、以下の点を考慮してください。

  • 法務および規制要件の変更を定期的に確認します。
  • これらの変更に対応してアプリケーションロジックを更新する。

入金失敗を回避するために、アカウント登録要件を定期的に確認し、更新する計画を立ててください。

受取人を作成する

フォームを使用して入金受取人情報を回収する場合には、Accounts API v2 を使って受取人を作成します。Account ID を作成するには、以下のパラメーターを指定する必要があります。

必要な情報パラメータ
受取人の国identity.country
受取人の業種identity.entity_type
受取人のメールアドレスcontact_email
Account に表示する名前。これは Stripe ダッシュボードと、貴社から Account に送付されるすべての請求書に表示されます。display_name
有効にする入金手段configuration.recipient.capabilities

公開プレビュー

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

Account の作成時には、対応する機能をリクエストすることで希望する入金方法の種類を指定する必要があります。

入金方法API パラメーター説明
地方銀行configuration.recipient.capabilities.bank_accounts.localそれにより、Account が ACH や FPS といった現地の銀行ネットワークを介して OutboundPayments を行えるようになります。
銀行電信送金configuration.recipient.capabilities.bank_accounts.wireそれにより、Account が Fedwire や SWIFT といったワイヤーネットワークを介して OutboundPayments を行えるようになります。
カードconfiguration.recipient.capabilities.cardsそれにより、Account が Visa Direct や Mastercard Send といったデビットカードネットワークを介して OutboundPayments を行えるようになります。

受取人は複数の入金方法の種類を有効化できます。ただしすべての国の受取人があらゆる種類の入金方法を利用できるわけではありません。利用できる入金方法の国別一覧にご利用いただける入金方法の種類を記載しておりますのでご覧ください。

一部の機能を利用するには、受取人に関する追加情報が必要になります。たとえば、アメリカの受取人に対して configuration.recipient.capabilities.bank_accounts.local を使用する場合、口座番号とルーティング番号を提出する必要があります。入金方法の機能をリクエストすると、Stripe ではそれらの有効化に必要な追加情報を判断します。その内容は API レスポンスで確認できます。レスポンスにこれらの要件を含めるには、include 配列に requirements、configuration.recipient、および identity を指定してください。これらを含めなかった場合、実際の値の有無に関係なく、Stripe はこれらのプロパティに対して null を返します。

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-01-28.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"
    ]
  }'

受取人をアクティブ化するために必要なフィールドを決定する

提出が必要な具体的な要件を特定するには、Accounts API レスポンスの requirements.entries 配列を確認してください。受取人が入金を受けられるようにするには、restricts_capabilities プロパティが含まれているすべての要件を満たし、情報提供する必要があります。

{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {

受取人情報を Stripe に送信する

必要な情報を回収したら、Accounts API を使用して提出します。

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.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 を取得して、リクエストした機能の status を確認して下さい。受取人がその方法で入金を受け取るには、入金方法の機能の status が active である必要があります。

Command Line
cURL
No results
curl -G https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -d "include[0]"="configuration.recipient"

受取人の入金手段を作成する

入金方法のケイパビリティが有効になったら、Outbound Setup Intents API を使用して受取人の実際の PayoutMethod を作成します。

このリクエストの 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/money_management/outbound_setup_intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

メモ

OutboundSetupIntent のレスポンスにはその PayoutMethod が含まれています。OutboundPayment を作成する際には、OutboundSetupIntent ID (たとえば osi_test_...) ではなく、必ず PayoutMethod の ID (たとえば frba_test_...)を使用します。

電信送金で入金するには、US Bank Accounts API を使用して fedwire_routing_number をその PayoutMethod に追加します。ただし追加の手数料が課されます。詳しくは料金体系をご覧ください。

デビットカードを入金方法として利用することもできます。ただしその場合には、受取人がデビットカードの情報を Stripe に直接提供する必要があります。デビットカードによる入金を有効にするには、Account Links API を使用してユーザーがカード情報を登録するための共有用フォームを作成してください。

受取人のすべての入金手段を表示します。

Payout Methods API を使用して、受取人の PayoutMethods を取得してください。

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

このレスポンスには、受取人に関連する PayoutMethod オブジェクトの一覧が含まれます。PayoutMethod ID を使用して、Outbound Payments API を使用した入金を作成してください。詳しくは送金をご覧ください。