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

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

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

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

考慮事項

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

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

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

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

受取人を作成する

フォームを使用して入金受取人情報を収集する場合は、Accounts v2 API を使用して受取人を作成します。アカウント ID を作成するには、次のパラメーターを指定する必要があります。

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

公開プレビュー

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

一部の方法では、有効にする前に受取人に関する情報を追加する必要があり、Accounts v2 API を使用して目的の入金手段を指定しなければなりません。capabilities パラメーターを使用して有効にする方法では、受取人のために収集する情報が決定されます。たとえば、アメリカの受取人の configuration.recipient.capabilities.bank_accounts.local は、アカウントとルーティング番号を送信する必要があります。

入金方法API パラメーター説明
地方銀行configuration.recipient.capabilities.bank_accounts.localアカウントが ACH や FPS などの現地の銀行ネットワークを介して OutboundPayment を受け取れるようにします。
銀行電信送金configuration.recipient.capabilities.bank_accounts.wireアカウントが Fedwire や SWIFT などの電信ネットワークを介して OutboundPayment を受信できるようにします。
カードconfiguration.recipient.capabilities.cardsアカウントが、Visa Direct や Mastercard Send などのデビットカードネットワークを介して OutboundPayment を受信できるようにします。

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

これらのフィールドとリクエストされた入金手段を追加した後、API レスポンスに必要な追加情報が Stripe で決定されます。この情報は、受取人が入金を受け取れるようにするために必要な情報で、お客様が送信する必要があります。これらの要件を受け取るには、include 配列に requirements、configuration.recipient、および identity を含めます。それ以外の場合、Stripe は実際の値に関係なく null レスポンスを返します。

アカウントを作成、取得、または更新すると、include パラメーターで指定した場合にのみ、レスポンスに特定のフィールドが入力されます。指定しなかったフィールドは、実際の値に関係なく、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: {{STRIPE_API_VERSION}}" \
  --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 v2 API からのレスポンスを使用して requirements.entries を調べ、Stripe に送信する必要があるフィールドを決定します。restricts_capabilities フィールドを持つ entries は、受取人が入金を受け付けるために必要です。

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

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

送信する必要がある追加のフィールドを決定したら、Accounts v2 API を使用して必要な情報を送信します。上記の応答の id を URI で使用します。

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: {{STRIPE_API_VERSION}}" \
  --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"
    ]
  }'

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

Accounts v2 API を使用してアカウントを取得し、リクエストした機能の 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: {{STRIPE_API_VERSION}}" \
  -d "include[0]"="configuration.recipient"

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

OutboundSetupIntents v2 API を使用して、入金方法の詳細を Stripe に送信し、受取人への入金を有効にします。

このリクエストの 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: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

電信送金するには、USBankAccount v2 API を使用して、送金方法に fedwire_routing_number を追加します。追加手数料が適用されます。詳細については、料金体系をご覧ください。

入金手段としてデビットカードを使用することも可能です。ただし、受取人はデビットカード情報を直接 Stripe に送信する必要があります。デビットカードによる入金を有効にする場合は、Account Links v2 API を使用して、ユーザーがデビットカードの認証情報を送信するための共有フォームを作成します。

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

受取人のために作成されたすべての入金手段を表示します。Payout Methods API v2 を呼び出して、受取人 ID を入力します。

このリクエストの Stripe-Context ヘッダーは受取人のアカウント 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: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

レスポンスには、受取人が保持している PayoutMethod オブジェクトのリストが含まれます。PayoutMethod ID を使用して、OutboundPayments API で入金を作成します。詳しくは、送金をご覧ください。