API を使用して受取人を作成公開プレビュー

受取人が受取人と入金手段の詳細を収集するための情報収集フローを構築し、その情報を API を介して Stripe に渡します。ビジネスは、受取人とのすべてのやり取りと、受取人を確認するために必要なすべての情報を収集する責任を負うものとします。検証要件は、世界中の法律や規制の変更に合わせて更新されます。入金の失敗を回避するために、アカウント登録要件を定期的に確認して更新することを計画します。

入金を受け取る受取人を作成するには、以下を作成する必要があります。

• An active recipient with the Accounts v2 API
• An enabled payout method with the USBankAccount API v2

情報を収集するフォームを作成する

入金を行うには、受取人から情報を収集する必要があります。受取人が情報を送信できるようにメソッドまたはフォームを作成し、API を使用して Stripe に送信します。

確認要件は法的要件や規制要件によって異なるため、収集する必要がある情報は変更される可能性があります。将来、パラメーターが追加される可能性を考慮して、アプリケーションロジックを設計します。

受取人を作成する

Use the Accounts v2 API to create your recipient. You must provide the following parameters to create the Account ID:

You must specify your intended payout methods with the Accounts v2 API because some methods require additional information about your recipient before we can enable them. The methods you enable using the capabilities parameter determine information that you need to collect for your recipient. For example, configuration.recipient.capabilities.bank_accounts.local for a US recipient requires you to submit an account and routing number.

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

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

アカウントを作成、取得、または更新する場合、include パラメーターで指定した場合のみ、特定のフィールドが応答に入力されます。フィールドを指定しなかった場合は、実際の値に関係なく、レスポンスに null として表示されます。

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.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"
    ]
  }'

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

Use the response from the Accounts v2 API to inspect the requirements.entries to determine the specific fields you need to submit to Stripe. Any entries that have the restricts_capabilities field are required for the recipient to accept payouts.

{
 "id": "acct_1R9UxIQlxdq9VtNU",
 "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
       },
       "cards": null,

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

After you determine the additional fields you need to submit, use the Accounts v2 API to submit the required information.

curl -X POST https://api.stripe.com/v2/core/accounts/acct_1234 \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR",
                "id_numbers": [
                    {
                        "type": "us_ein",
                        "value": "000000000"
                    }
                ]
            }
        }
    },
    "include": [
        "identity"
    ]
  }'

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

Use the Accounts v2 API to retrieve an account and inspect the status of the capabilities you’ve requested. The status must be active for a recipient to receive payouts by your specified payout method.

curl -G https://api.stripe.com/v2/core/accounts/acct_1234 \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -d include=identity \
  -d include="configuration.recipient"

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

Use the USBankAccount v2 API to submit payout method details to Stripe to enable a payout to a recipient.

USBankAccounts は、ACH または電信送金で支払いを受け取ることができます。電信送金の場合は、fedwire_routing_number を含めます。追加料金が適用されます。詳細については、料金体系を参照してください。

curl -X POST https://api.stripe.com/v2/core/vault/us_bank_accounts \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "routing_number": "110000000",
    "account_number": "000123456789",
    "fedwire_routing_number": "110000000"
  }'

You can also use debit cards as a payout method. However, your recipients must submit their debit card information directly to Stripe. If you’re interested in enabling payouts by debit cards, use the Account Links v2 API to create a shareable form for your user to submit their debit card credentials.

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

View all of the created payout methods for a recipient. Call the Payout Methods API v2 and provide the recipient ID.

curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

The response contains a list of PayoutMethod objects that a recipient owns. Use the PayoutMethod IDs to make a payout using the OutboundPayments API. See Send money for more details.