# Connect 向け Instant Payouts 即時入金を使用して、連結アカウントが売上を即時に利用できるようにします。 お客様が Stripe Dashboard ユーザーであり、Instant Payouts を有効にしたい場合は、[Stripe Dashboard ユーザー向け Instant Payouts](https://docs.stripe.com/payouts/instant-payouts.md) をご覧ください。 Instant Payouts を使用すると、連結するプラットフォームとマーケットプレイスは、決済が成功した直後に残高にアクセスできます。Instant Payouts は、週末や祝日を含む任意の曜日と時刻に利用でき、資金は通常、関連付けられている銀行口座で 30 分以内に売上として処理されます。 Instant Payouts は以下の目的で使用できます。 - 新しい連結アカウントの獲得と維持 - [手数料を請求](https://docs.stripe.com/connect/instant-payouts.md#monetization-and-fees)することで追加の収益を実現する カード支払いから得た売上は、支払いが完了するとすぐに Instant Payouts で利用可能になります。ACH または口座引き落としは、売上処理後にはじめて Instant Payouts で利用可能になります。 ## 適格な連結アカウント Instant Payouts は、プラットフォームとは異なる地域に所在する連結アカウントに対しても行えます。 Instant Payouts が連結アカウントでご利用いただけるのは以下の場合です。 - 連結アカウントの登録には[利用規約](https://docs.stripe.com/connect/service-agreement-types.md)全文が適用されます。 - 連結アカウントは入金の際に現地通貨を使用しています。 - プラットフォームと連結アカウントの双方がサポート対象国にあります。Instant Payouts は、以下の国のプラットフォームとその連結アカウントでご利用になれます。 ### 利用可否 - AE - AU - CA - DK - EU - GB - HK - MY - NO - NZ - SE - SG - US ### 外部口座の適格性 Instant Payouts を受け取るには、連結アカウントに適切な外部アカウントが必要です。Stripe Connect のコンテキストにおける外部アカウントとは、連結アカウントに関連付けられている銀行口座またはデビットカードを指し、利用資格は国によって異なります。 [マイナス残高を返金できない可能性がある連結アカウントについて責任を負っている](https://docs.stripe.com/connect/risk-management.md#identify-negative-balance-responsibility)場合は、Stripe がホストするアカウント登録フローとダッシュボードのインターフェイスを有効にして、デビットカード詳細を収集できます。これを有効にするには、[External Account settings](https://dashboard.stripe.com/settings/connect/payouts/external_accounts) に移動し、**Allow debit cards?** で **Yes** を選択します。 | 国 | 対象となる外部口座のタイプ | | ----------------------------- | ----------------------------------------------------------------------------------------------- | | US、GB、欧州連合 (ユーロ圏)、SE、DK、SG、AU | デビットカード、一部の銀行口座 ([サポート対象の銀行をご確認ください](https://docs.stripe.com/payouts/instant-payouts-banks.md)) | | CA,CZ,HU,NO,PL,RO,NZ,MY,AE | デビットカード ([サポート対象の銀行をご確認ください](https://docs.stripe.com/payouts/instant-payouts-banks.md)) | | HK | 一部の銀行口座 ([サポート対象銀行](https://docs.stripe.com/payouts/instant-payouts-banks.md)を確認) | 連結アカウントの Instant Payouts の利用資格を確認するには、連結アカウントの「アカウント」 ID を指定して [External Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/list.md) を呼び出すことで、外部口座を取得します。`available_payout_methods` 配列に `instant` が示されている外部口座は Instant Payouts を受け取る資格があります。レスポンスとして、アカウントの直近 10 件の有効な外部口座が返されます。デフォルトの 10 件より多くの表示をレビューする必要がある場合は、結果をページ分割して表示できます。 ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/external_accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` ```json { "object": "list", "data": [ { "object": "bank_account", "available_payout_methods": [ "standard", "instant" ], ... } ], } ``` ### 連結アカウントを招待して対象アカウントを追加する 連結アカウントに Instant Payouts の対象となる外部アカウントがない場合は、アカウントを指定して、[External Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/create.md) を使用して追加するように求めることができます。 ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "external_account={{BANKACCOUNTTOKEN_ID}}" ``` > Instant Payouts の対象となる連結アカウントの管理方法については、以下の[リスクと利用資格](https://docs.stripe.com/connect/instant-payouts.md#manage-risk-and-eligibility)の管理に関するセクションをご覧ください。 ## 収益化と手数料 一部のマーケットプレイスとプラットフォームは、Instant Payouts を収益化して利便性を有料で提供しています。Instant Payouts を収益化する場合、Stripe は、プラットフォーム手数料とアカウントからの引き落としの 2 種類の方法でユーザーからの手数料の徴収をサポートしています。 ### プラットフォーム手数料 [Application Fees (プラットフォーム手数料)](https://docs.stripe.com/api/application_fees.md) により、Stripe は、お客様が決定した手数料を回収して、Instant Payout を同期的に開始します。1 つのシームレスな取引であることから、Stripe ではプラットフォーム手数料を適用することをお勧めします。 - ユーザーは、利用可能な残高を超える金額を入金することはできません - API またはダッシュボードを使用して手数料を返金できます - 収益化のオプションには、定額、および最低金額と最高金額が設定された変動手数料があります - 手数料は、[Payout オブジェクト](https://docs.stripe.com/api/payouts/object.md)を使用して Instant Payouts の収益とペアとして組み合わせられるため、報告と照合に利用できます。徴収した手数料はダッシュボードの [Payments タブ](https://dashboard.stripe.com/connect/application_fees) で確認できます。 ダッシュボードの[プラットフォーム料金設定ツール](https://dashboard.stripe.com/test/settings/connect/platform_pricing/instant_payouts)を使用して、Instant Payouts のプラットフォーム手数料の料金を管理できます。 > Instant Payouts のプラットフォーム手数料は、`Balance` オブジェクトの [instant_available.net_available](https://docs.stripe.com/api/balance/balance_object.md#balance_object-instant_available-net_available) プロパティに基づいています。`instant_available.net_available` プロパティを使用せずに Instant Payouts を有効にすると、API の実装が正常に機能しなくなる可能性があります。 ### アカウントからの引き落とし 連結アカウントの Stripe 残高を[直接引き落とし](https://docs.stripe.com/connect/account-debits.md)、プラットフォームアカウントの Stripe 残高を入金して手数料を徴収することができます。Instant Payout を実行した後に、`source` パラメーターとして連結アカウント ID を指定して [Charge API](https://docs.stripe.com/api.md#create_charge) を呼び出します。アカウントの引き落としを使用して Instant Payout の手数料を徴収する場合は、以下の制約事項を考慮してください。 - プラットフォームと連結アカウントの両方が同じ地域に所在している必要があります。 - 連結アカウントから法的に拘束力のある同意を得る必要があります。 - 口座引き落としでは[追加費用](https://stripe.com/connect/pricing)が発生します。 - [予備金の留保が有効](https://docs.stripe.com/connect/account-balances.md#understanding-connected-reserve-balances) (2017 年 1 月 31 日以降に作成されたすべての新規プラットフォームではデフォルトで有効) で、引き落としと同じ通貨の銀行口座を保有している場合を除き、連結アカウントの残高がマイナスになる引き落としは実行できません。 - 連結アカウントが利用可能な残高をすでに全額入金している場合は、手数料の徴収が遅れることがあります。 - 消し込みを機能させるには、引き落としおよび関連する入金の内部データベースを管理する必要があります。 ## 連結アカウントが即時入金を開始できるようにする ユーザーの代わりに Instant Payouts を手動で開始するか、Stripe API または [Connect の埋め込みコンポーネント](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)を使用して、ユーザーが自分で Instant Payouts を開始できるユーザーインターフェイスを作成できます。ユーザーの代わりに Instant Payouts を開始する場合は、ユーザーから提供された指示と承認に必ず従ってください。 #### 埋め込みコンポーネント 連結アカウントがウェブサイトから直接 Instant Payouts を開始できるようにするには、[即時入金プロモーション](https://docs.stripe.com/connect/supported-embedded-components/instant-payouts-promotion.md)コンポーネント、[残高](https://docs.stripe.com/connect/supported-embedded-components/balances.md)コンポーネント、または [入金](https://docs.stripe.com/connect/supported-embedded-components/payouts.md)コンポーネントを使用してから、`instant_payouts` [アカウントセッション機能](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-balances-features-instant_payouts) を有効にします。Connect の埋め込みコンポーネントは、API を直接使用する代替手段を提供し、すべての適格性を評価し、関連する API コールを行って即時入金を開始します。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. [Connect の埋め込みコンポーネントの使用を開始する](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)方法を確認するか、[クイックスタート](https://docs.stripe.com/connect/connect-embedded-components/quickstart.md)を使用してシステムを作成します。 #### API 1. [retrieve balance](https://docs.stripe.com/api/balance/balance_retrieve.md) を呼び出し、[instant_available-net_available](https://docs.stripe.com/api/balance/balance_object.md#balance_object-instant_available-net_available) を展開します。 `instant_available.net_available` プロパティは、即時利用可能な送金先それぞれに対するプラットフォーム手数料を差し引いた、連結アカウントの即時残高です。[プラットフォーム手数料](https://docs.stripe.com/connect/instant-payouts.md#application-fees) で収益化する場合は、このフィールドを使用する必要があります。この金額は、ダッシュボードで設定されている、プラットフォームのプラットフォーム手数料の料金体系から計算されます。 プロパティ `instant_available.amount` は、連結アカウントの総残高です。プラットフォーム手数料は含まれません。 以下の例は、USD での Instant Payout に 2% の料金を設定するプラットフォームを示しています。 ```curl curl -G https://api.stripe.com/v1/balance \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "expand[]=instant_available.net_available" ``` ```json { "object": "balance", "available": [ { "amount": 500, "currency": "usd", "source_types": { "card": 500 } } ], "instant_available": [ { "amount": 500, "currency": "usd", "net_available": [ { "amount": 490, "destination": "ba_abc123", "source_types": { "card": 490 } } ], "source_types": { "card": 500 } } ], ... } ``` > カード支払いの売上は即時に利用可能になりますが、銀行口座引き落とし (ACH など) の売上は即時に利用可能になりません。 重要な考慮事項: - `net_available` は、[拡張パラメーター](https://docs.stripe.com/expand.md)として含まれる場合にのみ表示されます。 - `net_available` は連結アカウントにのみ表示されます。これをプラットフォームに対して展開すると、エラーが表示されます。 - `net_available` のハッシュは、すぐに利用可能な外部口座にのみ表示されます。有効な即時入金先ではない外部口座は表示されません。 - 外部口座には、外部口座のプロパティとプラットフォームで設定された料金体系ルールに基づいて、別の `net_available` 残高を設定できます。 1. `method=instant` を指定して [create payout](https://docs.stripe.com/api/payouts/create.md) を呼び出します。自社の収益化戦略に対応する金額フィールド `instant_available.amount` または `instant_available.net_available[0].amount` を使用します。残高エンドポイントの `destination` を使用して、目的の外部口座に入金します。 ```curl curl https://api.stripe.com/v1/payouts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=490 \ -d currency=usd \ -d method=instant \ -d "destination={{BANKACCOUNTTOKEN_ID}}" ``` > 利用対象外の外部口座への即時入金は失敗するため、連結アカウントにケイパビリティを表示する前に[利用資格を確認](https://docs.stripe.com/connect/instant-payouts.md#external-account-eligibility)してください。 1. 入金によって発生した[プラットフォーム手数料](https://docs.stripe.com/api/application_fee/retrieve.md)を表示します。 ```curl curl https://api.stripe.com/v1/application_fees/{{APPLICATIONFEE_ID}} \ -u "<>:" ``` #### ダッシュボード 連結アカウントの Instant Payouts は、ダッシュボードで手動で開始できます。連結アカウントがウェブサイトから独立してこの操作を行えるようにするには、Connect の埋め込みコンポーネントまたは API を使用します。 ダッシュボードで Instant Payouts を手動で開始するには、以下の手順に従います。 1. 特定の連結アカウントのページに移動します。 1. 連結アカウントに即時利用可能な残高がある場合は、**アカウント残高を入金**をクリックします。 1. モーダルで、金額を入力して、入金のタイプとして**即時**を選択します。 1. **入金**をクリックして、支払いを完了します。 ## 利用資格と 1 日あたりの上限金額 お使いのプラットフォームアカウントには、全連結アカウントへの即時入金が可能な 1 日あたりの最大額が設定されています。その日の上限に達した後にユーザーが Instant Payouts を開始することはできません。日次の上限はアメリカ中部時間 (CT) の 0 時にリセットされます。 ## リスクと利用資格を管理する プラットフォームとマーケットプレイスが損失の責任を負う場合、お客様は、返金や不審請求の申請に起因する、回収できないマイナス残高に対する責任を負います。 Stripe は、リスクパラメーターを設定して、プラットフォームを意図しない損失から保護することをお勧めします。以下のような信頼しきい値の設定など、[不正使用とリスクを管理するためのベストプラクティス](https://docs.stripe.com/connect/risk-management/best-practices.md#fraud)をいくつかご用意しています。 - 最小処理金額 - 有効な日数 - チャージバック率 ### Stripe ダッシュボードを使用したリスクの管理 ( プライベートプレビュー ) Stripe ダッシュボードの資格ツールを使用すると、これらのフィールドの目標値に基づいて、どのアカウントが Instant Payouts の対象であるかを簡単に判断できます。マイナス残高に対する責任を負う場合、基準を満たすユーザーは Express ダッシュボード、Standard ダッシュボード、または埋め込みコンポーネントで Instant Payouts にアクセスできます。 サインインして、プライベートプレビューで Instant Payouts のダッシュボード利用資格ツールへのアクセスをリクエストします。 Stripe アカウントがない場合は、[こちらから登録](https://dashboard.stripe.com/register)できます。 ## 料金体系 収益化に関する決定内容とは関係なく、Stripe は、Instant Payouts のご利用のすべてに対して 1% の手数料をマーケットプレイスとプラットフォームに請求します。Instant Payout 取引のそれぞれには、通貨に応じた最小金額と最大金額が設定されています。これらの手数料は、Connect の手数料全体の一部として評価されます。 | 国 | Instant Payout の下限額 | Instant Payout の上限額 | | ----------- | ------------------- | ------------------- | | US | 0.50 USD | 9,999 USD | | CA | 0.60 CAD | 9,999 CAD | | SG | 0.50 SGD | 9,999 SGD | | GB | 0.40 GBP | 9,999 GBP | | AU | 0.50 AUD | 9,999 AUD | | 欧州連合 (ユーロ圏) | 0.40 EUR | 9,999 EUR | | CZ | 10.00 チェココルナ | 99,999 CZK | | DK | 5.00 デンマーククローネ | 9,999 デンマーククローネ | | HU | 200.00 ハンガリーフォリント | 999,999 HUF | | NO | 5.00 ノルウェークローネ | 9,999 ノルウェークローネ | | PL | 2.00 ポーランドズウォティ | 9,999 ポーランドズウォティ | | RO | 2.00 ルーマニアレウ | 9,999 ルーマニアレウ | | SE | 5.00 スウェーデンクローナ | 9,999 スウェーデンクローナ | | NZ | 0.50 NZD | 9,999 NZD | | MY | 2.00 MYR | 9,999 MYR | | AE | 2.00 AED | 9,999 AED | | HK | 5.00 HKD | 9,999 HKD | ## マーケティング 連結アカウントに対する Instant Payouts のマーケティングでは、Instant Payouts に適用する予定の手数料をすべて明確に目立つように開示する必要があります。 「Instant Payouts を使用すれば、関連付けられた銀行口座に資金を即時送金できます。Instant Payouts は、週末や祝日を含む 24 時間 365 日使用でき、資金は通常 30 分以内にアカウントに反映されます」との旨、Stripe の製品のマーケティングとお客様のマーケティングが一貫していることを確認してください。Instant Payouts は通常 30 分以内に売上として処理されますが、銀行によっては入金されるまでの時間が長くなることがあります。