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

機能とは、カード決済やプラットフォームアカウントからの送金の受け取りなど、連結アカウントにリクエストできる機能を表します。連結アカウントがケイパビリティに関連するアクションを実行するには、ケイパビリティがアクティブである必要があります。

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

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

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

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

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

送金

transfers ケイパビリティを持つ連結アカウントに売上を送金できます。オンデマンドプラットフォームでは、連結アカウントへの支払いにこのケイパビリティがよく使用されます。たとえば、配車プラットフォームではこのケイパビリティを使用して、ドライバーにお金を支払うことが可能です。次の図は、売上の流れと、顧客、プラットフォーム、連結アカウント間の関係を示しています。

顧客、プラットフォーム、連結アカウント間の関係。

transfers ケイパビリティを使用すると、連結アカウントではなく、お客様のプラットフォームが支払いを処理します。そのため、連結アカウントの顧客の銀行明細書には、連結アカウントの明細書表記ではなく、プラットフォームの明細書表記が表示されます。

transfers ケイパビリティを使用する Payments には、デスティネーション支払い と 支払いと送金別方式 があります。

注

2019 年 8 月 14 日より前の API バージョンでは、transfers ケイパビリティが platform_payments と呼ばれていました。2019 年 8 月 14 日より前の API バージョンを使用している場合は、platform_payments を使用します。

海外送金

国外への資金の移動には、追加の要件が発生します。また、この移動は以下のシナリオのみで使用できます。

• SEPA 諸国に資金を送金する欧州連合、英国、ジブラルタルのプラットフォーム。
• 受取人の利用規約を使用して海外の入金先に売上を送るアメリカのプラットフォーム。

その他のシナリオの場合、連結アカウントと同じ地域にプラットフォームアカウントを作成します。ビジネスの構造によっては、その地域での法人の設立と、連結アカウントを登録するための追加作業が必要になる場合があります。

カード支払い

連結アカウントに card_payments ケイパビリティが設定されている場合は、カード支払いと ACH 送金を直接処理するだけでなく、プラットフォームからの支払いを受け取ることもできます。たとえば、このケイパビリティが設定された E-コマース店舗では、自身の支払いを回収できます。次の図は、売上の流れと、顧客、プラットフォーム、連結アカウント間の関係を示しています。

顧客、連結アカウント、プラットフォーム間の関係。

アカウントに card_payments ケイパビリティを付与するには、card_payments と transfers の両方をリクエストする必要があります。

連結アカウントにこのケイパビリティがある場合、顧客の銀行明細書には、プラットフォームの明細書表記ではなく、連結アカウントの明細書表記が表示されます。

card_payments ケイパビリティは、すべての支払いタイプ に適用されます。

複数のケイパビリティ

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

• ケイパビリティは互いに独立して動作します。
• 連結アカウントに card_payments と transfers の両方が設定され、そのいずれか一方の status が inactive であると、両方のケイパビリティが無効になります。
• アカウントのライフサイクルのどの時点においても、連結アカウントのほぼすべてのケイパビリティをリクエストしたり、リクエストを解除したりできます。

また、ケイパビリティを使用すると、同時に複数の目的で情報を収集できます。たとえば、必須の納税情報と、リクエストされたケイパビリティに必要な情報の両方を収集できます。

アカウントのケイパビリティをリクエストする

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

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

• Standard アカウントなど Stripe ダッシュボードの全機能にアクセスできる連結アカウントの場合、一部のケイパビリティが国に応じて自動的にリクエストされます。他のケイパビリティをリクエストすることもできます。
• Express ダッシュボードにアクセスできる連結アカウント (Express アカウントを含む) の場合、ケイパビリティをリクエストすることも、アカウント登録の設定を使用して、ケイパビリティのリクエストを自動化することもできます。
• Stripe がホストするダッシュボードに連結アカウント (Custom アカウントを含む) がアクセスできない場合は、そのアカウントのケイパビリティをリクエストする必要があります。

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 の参照情報を削除します。

カナダでビジネスを運営している場合、Stripe は最新の要件に準拠するために、legacy_payments を使用するアカウントの card_payments と transfers を自動的にリクエストします。このプロセスの間、連結アカウントの API レスポンスに次のメッセージが表示される場合があります。

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