銀行とデビットカードの送金を管理する

Stripe では、Connect の Custom アカウントの送金をプラットフォームですべて管理できます。

注意

このページでは旧バージョンの Connect について説明しています。最新バージョンの Connect では、従来の transfers エンドポイントが非推奨になり、その代わりに payouts が使用されています。ダッシュボードのユーザインターフェイスにはこの変更が反映され、お使いの Stripe API バージョンにはかかわりなく、用語として「送金」ではなく「入金」が使用されています。Connect API の最新バージョンの詳細については、銀行およびデビットカードの入金のドキュメントをご覧ください。

デフォルトでは、連結アカウントの代理として行う請求は、連結アカウントの Stripe 残高に累積され、日次のローリング方式で入金されます。ただし、Stripe は、Custom アカウントに関してこの動作を詳細に管理する機能を用意しています。

以下の操作が可能です。

入金先の銀行口座とデビットカードを設定する
売上が自動的に入金される頻度を管理する
手動入金を実行する
売上を即座に送金する

銀行口座とデビットカードを管理する

Custom アカウントには、external_accounts プロパティがあります。これは、Stripe アカウントに関連付けられているすべての銀行口座とデビットカードの一覧です。任意の外部口座を売上の入金先にすることができます。

{
  "id": "{{CONNECTED_ACCOUNT_ID}}"
,
  "object": "account",
  "external_accounts": {
    "object": "list",
    "has_more": false,
    "url": "/v1/accounts/acct_14qyt6Alijdnw0EA/external_accounts",
    "data": [
      {
        "id": "{{BANK_ACCOUNT_ID}}"
,
        "object": "bank_account",
        "account": "acct_14qyt6Alijdnw0EA",
        "account_holder_name": "Jane Austen",
        "account_holder_type": "individual",
        "bank_name": "STRIPE TEST BANK",
        "country": "US",
        "currency": "usd",
        "default_for_currency": false,
        "fingerprint": "sSZ2yLp0EZTH17cF",
        "last4": "6789",
        "metadata": {
        },
        "routing_number": "110000000",
        "status": "new"
      },
      {...},
      {...},
    ],
  ...
}

入金先口座は、Stripe アカウントを作成または更新するときに、external_accounts パラメーターを使用して追加されます。この値は、Stripe.js から返された銀行口座またはデビットカードのトークンです。これ以外の方法として、銀行口座情報のハッシュを指定できますが、機密性の高いデータがサーバーを介することがないようにするため、Stripe.js の使用をお勧めします。

送金先としてデビットカードを使用する場合には、次の制限が適用されます。

プリペイド式ではないアメリカの Visa、Mastercard、またはディスカバーであること
Instant Payouts では各入金の上限を 9,999 USD とする
上記以外では一般に送金ごとに 3,000 USD を上限とする

複数の銀行口座およびデビット口座を管理する

デフォルトでは、Custom アカウントの更新時に external_accounts に新しい値を指定すると、既存の口座が新しい口座に「置換」されます。連結アカウントに他の銀行口座またはデビットカードを「追加」するには、Bank Account (銀行口座) と Card (カード) の作成 API エンドポイントを使用します。

複数の通貨を扱う際は、Stripe はその通貨を使用する関連付けられた銀行口座またはデビットカードに入金を自動送信して、換算手数料を回避します。特定の通貨に複数の口座がある場合には、Stripe は default_for_currency として設定されている口座を使用します。

Stripe ではお客様の参照用として、また、ユーザーがサポート対象のオプションから選択できるようにするため、利用可能な国と通貨の組み合わせのリストを提供しています。

入金情報

自動送金の使用時は、アカウントの transfer_schedule プロパティによって Stripe アカウントの残高が自動入金される頻度が示されます。

{
  ...
  "transfer_schedule": {
    "delay_days": 7,
    "interval": "daily"
  },
  ...
}

delay_days プロパティは、支払い (またはリンクされた送金) が入金可能になるまでの時間を示しています。このフィールドは、自動入金の管理に利用できます。たとえば、Custom アカウントが、売上を支払いの 2 週間後に受け取るようにするには、interval を daily に、delay_days を 14 に設定します。デフォルトは、アカウントの最小許容値であり、連結アカウントの国によって決まります。このフィールドを設定または更新するときは、文字列 minimum を渡して最小許容値を選択できます。

interval プロパティには、4 種類の設定を使用できます。

manual に設定すると自動入金は行われません。Transfers API を使用して、アカウントの残高を手動で入金する必要があります (連結アカウントとして処理)。また、Instant Payouts を使用する場合もアカウントを manual に設定します。
daily に設定すると、支払いの作成から delay_days で設定された日数後にその支払いが自動的に入金されます。delay_days の値をお客様独自の送金スケジュールやアカウントのデフォルトの送金スケジュールの値より小さくすることはできません。
weekly に設定すると、weekly_anchor パラメータ (monday などの小文字の曜日) に従って、残高が毎週 1 回自動的に入金されます。
monthly に設定すると、monthly_anchor パラメータ (1 から 31 の数字) に従って、残高が毎月 1 回自動的に入金されます。

手動入金を使用する

Accounts API を使用して、transfer_schedule[interval] を manual に設定した場合、Stripe は最大 90 日間、入金指示があるまで (または最大 90 日間が経過するまで) アカウント保有者の残高に売上を保持します。こうした売上の入金をトリガーするには、Transfers API を使用します。

Transfers API は、Stripe の連結アカウントの残高から外部口座に資金を移動するためにのみ使用されます。Stripe アカウント間で売上を移動するには、支払いと送金別方式の作成またはプラットフォームでのデスティネーション支払いの作成をご覧ください。

注

「エスクロー」には法律上の明確な定義があり、Stripe はエスクロー口座をサポートしていません。ただし、手動入金でエスクローに類似する機能を提供しています。これによりお客様に入金タイミングを管理でき、Custom アカウントへの入金を最長 90 日間遅延させることができます。

配送遅延のリスクが考えられる場合、または返金が必要になる可能性がある場合に、手動入金をエスクローの代替として使用することができます。

標準の送金

基本的な送金の例として、Custom アカウントの Stripe 残高から外部口座に 10 USD を送金します。

destination=default_for_currency を設定すると、Stripe は、アカウントの、指定された通貨のデフォルトの銀行口座またはデビットカードに送金します。

標準的な送金では、ユーザーの利用可能な残高を上限として入金できます。この金額を確認するには、ユーザーの代理として残高取得のコールを実行します。

Stripe は、残高内で複数の支払い元からの支払いの構成部分を分類して個別の残高で追跡します。残高取得のレスポンスでは、各残高の構成要素が支払い元のタイプ別に分類されます。たとえば、クレジットカード以外の残高の送金を作成するには、リクエストで source_type を指定します。

いずれのソースの残高の構成部分もマイナスになる可能性があり (返金またはチャージバックによって)、利用可能な残高の総計を超える送金は作成できないことに注意してください。

Instant Payouts を使用する

Instant Payouts を使用すると、Custom アカウントのデビットカードに売上を即時送金できます。売上は通常 30 分以内に関連付けられた銀行口座に反映され、支払いから入金までを非常に短時間で行うことができます。

Instant Payouts を使用するには、送金作成時に method プロパティに instant を指定します。

Instant Payouts は、いくつかの点で他の手動送金とは異なります。

アカウントの利用可能残高に加え、「保留」残高も送金できます
Instant Payouts は週末や祝日にもリクエストできます

初めに、プラットフォームはすべての連結アカウント全体で、1 日あたり最大 500 USD まで Instant Payouts を使用して送金できます。このしきい値を増やす必要がある場合は、お問い合わせください。

Instant Payouts はアメリカの主要銀行のすべてでサポートされていますが、ごく一部の銀行ではサポートされていません。その銀行では、標準の入金を使用する必要があります。

カードをアカウントに追加すると、Stripe はレスポンスで available_payout_methods プロパティを返します。これは、Stripe がそのカードでサポートする支払い方法のセッになります。送金を作成する際には、このセットに含まれる値のみを methodとして渡す必要があります。

{
  "id": "{{CARD_ID}}"
,
  "object": "card",
  ...
  "account": "acct_1032D82eZvKYlo2C",
  "available_payout_methods": ["standard", "instant"],
}

Custom アカウントのカードが Instant Payouts に対応していない場合は、入金を即座に受け取ることができないことをそのアカウントの保有者に明確に伝える必要があります。

送金で Webhook を使用する

連結アカウントの送金アクティビティはすべて、Webhook を使用して追跡できます (Connect を使用している場合には、常に Webhook を使用する必要があります)。送金に固有のイベントは、以下のとおりです。

transfer.created
transfer.updated
transfer.paid
transfer.failed

大半の送金では、これらのイベント通知は数日間にわたって送信されます。Instant Payouts は通常 transfer.paid を 30 分以内に送信します。

送金を完了できない場合には、transfer.failed イベントが発生します。このイベントの failure_reason プロパティでその理由が示されます。