コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

支払いと送金別方式の資金分離非公開プレビュー

連結アカウントへの送金対象として指定された資金を追跡します。

資金分離により、連結アカウントに送金する前に、支払いと送金別方式 からの資金をプラットフォームアカウントの保留状態に割り当てることができます。この状態の資金はプラットフォーム残高に表示されず、連結アカウントにのみ送金できます。

特定の決済からの割り当て残高を表示でき、これらの資金の完全な流れをトラックできます。

資金を割り当てると、以下のような他の目的での使用が防止されます。

  • プラットフォームレベルの自動入金
  • 関連のない返金とチャージバック
  • Stripe 手数料
  • プラットフォームでの決済残高からのその他の引き落とし

以下で利用可能です。

アメリカ
イギリス
オランダ
スイス
スウェーデン
スペイン
デンマーク
ドイツ
フランス
ベルギー

前提条件と制限事項

資金分離を実装する前に、これらの要件と制限をレビューします。

要件

  • プラットフォームは連結アカウントの負の残高に責任を持つ必要があります。
  • すべてのAPIリクエストにプレビューヘッダーallocated_funds_preview=v1を含める必要があります。

制限事項

  • Stripe ダッシュボードでは割り当てられた資金は識別されません。ダッシュボードに表示される残高と取引は、割り当てられた資金とその他の資金を組み合わせる場合があります。
  • 手数料 Billing はすべて非同期です。手数料は支払いに合わせて表示されない場合があります。手数料は、後でプラットフォームの Stripe 残高に請求されます。
  • 個別の Charge オブジェクトを展開することでのみ、割り当て資金の詳細を表示できます。
  • automatic_payment_methodsパラメーターは使用しないでください。割り当てられた資金は、Visa、Mastercard、Discover、American Express、Swish の支払い方法で行われた支払いからのみ行うことができます。
  • 資金分離は オーバーキャプチャー、マルチキャプチャー、増分オーソリでは使用できません。
  • アメリカでは資金分離で国境を越えた入金 使用できません。割り当て資金はアメリカの連結アカウントにのみ送金できます。

割り当て資金での決済作成

資金分離を使用するには、allocated_fundsをenabled: trueに設定してPaymentIntentを作成します。決済キャプチャー時に、Stripe が資金を割り当てます。

一意のtransfer_group 値を指定することで、割り当て資金の流れをトラックできます。

キャプチャーに成功すると、(決済手段の決済タイミングに従って) 全額が連結アカウントに送金できる割り当て資金として利用可能になります。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "allocated_funds[enabled]"=true \
  -d amount=10000 \
  -d currency=eur \
  -d payment_method=pm_xxxxxxxxx \
  -d transfer_group=ORDER100 \
  -d confirm=true \
  -d capture_method=automatic

特定の支払いに割り当てられた資金を表示する

特定の決済からの割り当て資金の残高を確認するには、支払いの allocated_funds.balanceプロパティを展開します。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "expand[]"="latest_charge.allocated_funds.balance"
Charge response
{
  "id": "{{PaymentIntent ID}}",
  "object": "payment_intent",
  "latest_charge": {
    "id": "{{Charge ID}}",
    "object": "charge",
    "allocated_funds": {
      "enabled": true,
      "balance": {
        "available": 0,
        "pending": 10000,
        "currency": "eur"
      }
    }
  }
}

割り当て資金の送金

割り当て資金を送金する際は、source_transaction パラメーターを関連する支払い ID に、destination パラメーターを関連する連結アカウントの ID に設定する必要があります。

プラットフォーム手数料の金額を指定した場合、その金額は割り当て資金から引き落とされ、プラットフォームでの決済残高に入金されます。送金作成レスポンスにはプラットフォーム手数料の詳細が含まれます。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d destination="{{Connected Account ID}}" \
  -d source_transaction="{{Charge ID}}" \
  -d amount=3800 \
  -d currency=eur \
  -d application_fee_amount=200

単一の送金または単一の連結アカウントで決済金額全体を送金する必要はありません。合計が元の決済金額を超えない限り、複数の送金にわたって割り当て資金を分割できます。

指定された場合、送金レスポンスにはプラットフォーム手数料の詳細が含まれます。

Transfer response
{
  "id": "{{Transfer ID}}",
  "object": "transfer",
  "amount": 3800,
  "currency": "eur",
  "destination": "{{Connected Account ID}}",
  "source_transaction": "{{Charge ID}}",
  "application_fee_amount": 200,
  "application_fee": {
    "id": "{{Application Fee ID}}",
    "object": "application_fee",
    "amount": 200,
    "currency": "eur",
    "fee_source": {
      "type": "transfer",
      "transfer": "{{Transfer ID}}"
    }
  }
}

送金でプラットフォーム手数料を徴収すると、資金は割り当てられた資金からプラットフォームアカウントの残高に直接移動します。プラットフォームの通貨と連結アカウントの通貨が異なる場合、プラットフォーム手数料がプラットフォームアカウントから移動しないため、不要な外国為替 (FX) 換算が回避されます。

返金および不審請求の申請の処理

割り当て資金を持つ決済の返金と不審請求の申し立ては、プラットフォームアカウント残高の資金を使用する前に、これらの割り当て資金から引き出されます。Stripe は、関連する決済の残りの割り当て資金が返金または不審請求の申し立てをカバーできない場合にのみ、プラットフォームアカウント残高から引き落とします。

たとえば、100 EUR の決済から 60 EUR を送金し、その後100 EUR の返金を処理した場合 :

  • 40 EUR は、残りの割り当て資金から来ています。
  • 60 EUR はプラットフォームのアカウント残高から得られます。

不審請求の申し立て手数料は常にプラットフォームアカウント残高から引き落とされ、割り当て資金に影響しません。

送金差戻し を使用して、返金を処理する前または不審請求の申し立ての結果を待っている間に、連結アカウントから割り当て資金残高に資金を返すことができます :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/transfers/
{{TRANSFER_ID}}
/reversals \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=6000 \
  -d refund_application_fee=true

決済が元々割り当てられていた場合、送金の差戻しによって資金は常に割り当て状態に戻されます。

refund_application_feeパラメーターを true に設定すると、Stripe はプラットフォームでの決済残高からプラットフォーム手数料も引き落とし、割り当て状態に戻します。

不審請求の申し立てに関与する割り当て資金の送金を差戻した場合、申し立ての結果に関係なく割り当てされた状態が維持されます。これらから不審請求の申し立て手数料を回収することはできません。

不審請求の申し立てにおいて主張が認められた場合、割り当て資金を連結アカウントに送金できます。申し立てが認められなかった場合は、Stripe に連絡して資金の割り当て解除とプラットフォームアカウント残高への追加をリクエストできます。

割り当てられた資金をプラットフォームアカウント残高に送金する

残高送金 を使用して、割り当てられた売上からプラットフォームアカウントの残高に売上を送金できます。これは、保留残高を解消する場合や、支払いまたは送金の直後以外のタイミングでプラットフォーム手数料を回収する場合に役立ちます。選択した通貨は、支払いが処理された通貨と一致している必要があります。

たとえば、顧客の不審請求の申し立てが最初にプラットフォームアカウントの残高から返金され、後で売り手からの送金を差し戻した場合に、割り当てられた資金の保留残高が発生することがあります。このシナリオでは、クローバックされた資金は割り当てられた資金に含まれますが、顧客はすでに返金されているため、これらの割り当てられた資金をプラットフォームアカウントの残高に移動することをお勧めします。

Command Line
cURL
No results
curl https://api.stripe.com/v1/balance_transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d amount=6000 \
  -d currency=eur \
  -d "destination_balance[type]"=payments \
  -d "source_balance[type]"=allocated_funds \
  -d "source_balance[allocated_funds][type]"=charge \
  -d "source_balance[allocated_funds][charge]"="{{Charge ID}}"

資金分離のテスト

割り当て資金はテスト環境ではなく サンドボックス 環境でのみテストできます。導入の決済をシミュレートするには、テストガイド を参照してください。