アカウントのケイパビリティ

ケイパビリティとは、カード支払いの受け付けやプラットフォームアカウントからの送金の受け取りなど、連結アカウントのためにリクエストできる機能を指します。

ほとんどの場合、Stripe が連結アカウントのビジネスについて特定の情報の確認を行ってから、そのアカウントに対してケイパビリティを有効にする必要があります。連結アカウント用にリクエストするケイパビリティによって、収集する必要のあるアカウント情報が決まります。アカウントに必要なケイパビリティのみをリクエストすることで、アカウント登録にかかる労力を軽減できます。より多くのケイパビリティをリクエストする場合は、アカウント登録フローで相応の情報を確認しなければなりません。

まず、プラットフォームプロフィールを完成させて、プラットフォームに適したケイパビリティを確認します。

アカウントの作成後、追加のケイパビリティをリクエストし、既存の非永続的なケイパビリティを削除することができます。他のプラットフォームが管理する連結アカウントの場合は、ケイパビリティのリクエストを解除できません。

サポートされているケイパビリティ

以下は、利用可能なケイパビリティの一覧です。項目をクリックすると表示を展開または圧縮できます。

複数のケイパビリティ

一般的に、1 つの連結アカウントに対して複数のケイパビリティがリクエストされますが、その際は以下の点を考慮する必要があります。

• ケイパビリティは互いに独立して動作します。
• 連結アカウントに card_payments と transfers の両方が設定され、そのいずれか一方の status が inactive であると、両方のケイパビリティが無効になります。
• You can request or unrequest most capabilities for a connected account at any time during the account’s lifecycle.

Capabilities also allow you to collect information for multiple purposes at the same time. For example, you can collect both required tax information and the information required for a requested capability.

Request capabilities for an Account

ケイパビリティは Account (アカウント) オブジェクトに設定されます。Account で使用可能なケイパビリティのリストを取得するには、list_capabilities エンドポイントを使用します。

アカウントの作成とケイパビリティのリクエストは、さまざまな設定の連結アカウントごとに異なります。

• Standard アカウントなど Stripe ダッシュボードの全機能にアクセスできる連結アカウントの場合、一部のケイパビリティが国に応じて自動的にリクエストされます。他のケイパビリティをリクエストすることもできます。
• Express ダッシュボードにアクセスできる連結アカウント (Express アカウントを含む) の場合、ケイパビリティをリクエストすることも、アカウント登録の設定を使用して、ケイパビリティのリクエストを自動化することもできます。
• For connected accounts without access to a Stripe-hosted Dashboard, including Custom accounts, you must request their capabilities.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

情報要件はケイパビリティによって異なりますが、多くの場合、本人確認や支払いタイプ固有のその他の情報に関連しています。

連結アカウントが正常に作成されたら、その要件の リストを取得 できます。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

レスポンスの requirements ハッシュには必要情報が記載されています。payouts_enabled と charges_enabled の値は、アカウントで入金と支払いが有効になっているかどうかを表します。

既存の連結アカウントのケイパビリティ

以降のセクションでは、ケイパビリティ API を使用して、既存の連結アカウントの情報要件をプレビューしたり、ケイパビリティを管理する方法を説明します。

情報要件をプレビューする

特定のケイパビリティをリクエストする前後に、連結アカウントでどのような情報が必要かをプレビューできます。

ケイパビリティをリクエストすると、account.updated Webhook が起動し、アカウントの要件が変更される可能性があります。要件を直ちに有効にしてアカウントを無効化しないようにするには、ケイパビリティをリクエストする前に要件をプレビューし、必要な情報を収集します。

以下は、特定のアカウントの card_payments ケイパビリティの要件を リスト化 した例です。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/card_payments \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

応答では、requirements ハッシュをチェックして、必要な情報を確認します。

{
  "id": "card_payments",
  "object": "capability",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "requested": false,
  "requested_at": null,
  "requirements": {
    "past_due": [],
    "currently_due": ["company.tax_id", ...],
    "eventually_due": [...],
    "disabled_reason": ...,
    "current_deadline": ...,
  },
  "status": "unrequested"
}

status の値は、ケイパビリティがリクエストされているかどうかを表します。値が リクエストされている 場合、アカウントの要件が有効になります。

リクエストする前にケイパビリティの要件をプレビューできるほか、同じエンドポイントを使用して、ケイパビリティの現在の要件を確認できます。これにより、要件が変更されたときに最新情報を得ることができます。

ケイパビリティのリクエストと解除

アカウントのケイパビリティをリクエストするには、アカウントを更新 して、ケイパビリティの値を requested から true に設定します。リクエストが成功すると、API はレスポンスで requested: true を返します。

アカウントのケイパビリティのリクエストを取り消すには、アカウントを更新 して、ケイパビリティの値を requested から false に設定します。ケイパビリティが削除できない場合は、この呼び出しでエラーが返されます。呼び出しが成功すると、API はレスポンスで requested: false を返します。

ダッシュボードからもアカウントのケイパビリティの追加や削除ができます。ケイパビリティを削除できない場合は、その削除 ボタンが無効化されています。

以下の例では、特定の連結アカウントの transfers ケイパビリティをリクエストしています。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d requested=true

次の例では、特定の 1 つの連結アカウントに対して複数のケイパビリティをリクエストしています。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[bancontact_payments][requested]"=true \
  -d "capabilities[eps_payments][requested]"=true \
  -d "capabilities[ideal_payments][requested]"=true \
  -d "capabilities[p24_payments][requested]"=true \
  -d "capabilities[sepa_debit_payments][requested]"=true

非推奨のケイパビリティ

次のセクションで説明するケイパビリティは非推奨のものです。可能であれば、新しいアカウントでリクエストしないでください。非推奨のケイパビリティを使用している既存のアカウントがある場合は、代わりに他のケイパビリティを使用するように更新することをお勧めします。

legacy_payments

legacy_payments ケイパビリティを使用すると、支払い、入金、送金が可能になります。新しいアカウントでは、より柔軟な設定に対応する card_payments と transfers のケイパビリティを使用することで、これらのアクションが有効になります。

次の手順を実行することをお勧めします。

1. 連結アカウントの登録プロセスを更新して、legacy_payments の代わりとなる card_payments と transfers の適切な組み合わせをリクエストします。

2. 既存の連結アカウントを更新して、card_payments と transfers の適切な組み合わせをリクエストします。

3. legacy_payments のステータスをチェックするコードを更新して、legacy_payments または関連する新しいケイパビリティのステータスを確認します。たとえば、legacy_payments または card_payments が有効なときに実行されるよう、カード支払いを行うアカウントの機能に関係するコードが更新されます。同様に、legacy_payments または transfers が有効なときに実行されるよう、送金を受け付けるアカウントの機能に関係するコードも更新されます。更新されたコードは、新しいケイパビリティがいつ有効化されるかに関係なく、移行プロセスの間は常に機能します。

4. すべての連結アカウントで新しいケイパビリティが有効になったら、コードから legacy_payments の参照情報を削除します。

If you do business in Canada, Stripe automatically requests card_payments and transfers for your accounts that use legacy_payments, to comply with updated requirements. During the process, you might see the following values in your connected accounts’ API responses.

capabilities: {
  legacy_payments: "active"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "inactive",
  legacy_payments: "active",
  transfers: "inactive"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "active",
  legacy_payments: "active",
  transfers: "active"
},
charges_enabled: true,
payouts_enabled: true