レポートの提供と照合非公開プレビュー

次の取引残高タイプ は、マーチャントキャッシュアドバンスやローンを含む、連結アカウントの融資に関連しています。

• 入金：financing_payout
• 返済： financing_paydown
• 差戻し：financing_payout_reversalまたはfinancing_paydown_reversal

入金

各入金取引には、タイプfinancing_payoutの取引残高オブジェクトがあります。プラットフォームの UI にある取引残高またはそれに相当するモデルのリストに入金を表示できます。

返済

各入金取引には、タイプfinancing_paydownの取引残高オブジェクトがあります。プラットフォームの UI で源泉徴収取引を表示するには：

1. 取引残高を取得 を行い、取引タイプでフィルタリングします。
2. Stripe-Accountヘッダーに連結アカウントのアカウント ID を指定します。

以下に例を示します。

curl -G https://api.stripe.com/v1/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=financing_paydown

取引残高のリストの取得に成功すると、次のようなレスポンスを受け取ります。

{
 "object": "list",
 "data": [
 {
  "id": "txn_abcdef123456",
  "object": "balance_transaction",
  "amount": -1550,
  "available_on": 123456789,
  "created": 123456789,
  "currency": "usd",
  "description": "Withheld funds from py_abcdef123456 to pay down flex loan flxln_abcdef123456",
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": -1550,
  "reporting_category": "financing_paydown",
  "source": "cptxn_abcdef123456",
  "status": "available",
  "type": "financing_paydown"
 },
 ...
 ],
 "has_more": false,
 "url": "/v1/balance_transactions"
}

この返済が Stripe 決済での Capital 源泉徴収により発生した場合、レスポンスの descriptionフィールドはこの Stripe 決済を参照します。例えば、返済には「ローンflxln_123abcの返済のため、ch_123abcから資金を源泉徴収」という説明が含まれる場合があります。

取引残高のソースフィールドを展開することで、該当する資金調達取引オブジェクトを取得できます。

curl -G https://api.stripe.com/v1/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=financing_paydown \
  -d "expand[]"="data.source"

展開すると、source フィールドに融資取引の詳細が表示されます：

{
 "object": "list",
 "data": [
 {
  "id": "txn_abcdef123456",
  "object": "balance_transaction",
  "source": {
     "id": "cptxn_1NAyja2eZvKYlo2CGPcd8FIX",
     "object": "capital.financing_transaction",
     "account": "acct_1032D82eZvKYlo2C",
     "created_at": 1684861854,
     "details": {
       "advance_amount": 10000,
       "currency": "usd",
       "fee_amount": 1000,
       "linked_payment": "ch_1032Rp2eZvKYlo2Cv6jPGmkF",
       "reason": "automatic_withholding",
       "total_amount": 11000,
       "transaction": {
         "charge": "ch_1032Rp2eZvKYlo2Cv6jPGmkF"
       }
     },
     ...
   },
  "status": "available",
  "type": "financing_paydown"
 },
 ...
 ],
 "has_more": false,
 "url": "/v1/balance_transactions"
}

差戻し

各差戻し取引には、タイプが financing_payout_reversalまたはfinancing_paydown_reversalの 取引残高オブジェクトがあります。差戻しは、ACH 取引の失敗、融資のキャンセル、または手動差し戻しリクエストにより発生する可能性があります。差戻し取引の提供には 2 つの目的があります。

• これらはキャンセルされた融資を示すことがあります。元の資金供給をレポートに含めた場合は、すべての差戻しを含めてください。このようにして、連結アカウントは両方の取引が相殺されることを確認できます。
• これらは以前に保留された資金を連結アカウントの残高に返すことができます。

レポートから差戻しを除外すると、レポートが不正確な融資を反映する可能性があるため、連結アカウントの照合に問題が生じる可能性があります。

プラットフォームのUIにある取引残高のリストや同等のモデルに返済を表示できます。以下に例を示します。

既存のレポート：連結アカウントの個別取引（プラットフォーム手数料やインターチェンジフィーを含む）を示す既存のレポートについては、レポートに源泉徴収額を追加することを検討してください。新規レポート：新規レポートでは、特定の期間のすべての源泉徴収額を表示します。これにより、連結アカウントは、販売処理のうちどれだけが融資に充当されているかを確認できます。入金レポートでは、源泉徴収された合計金額を含めることをお勧めします。これにより、連結アカウントは、源泉徴収（および請求するプラットフォーム手数料）を差し引いた総入金販売処理を照合し、外部銀行口座で期待される入金額を算出できます。

詳細については、入金の消し込みを参照してください。

サンドボックス を使用して、連結アカウント向けの様々な状態の融資オファーを作成できます。

テストシナリオを作成するには：

1. テスト環境にsandboxを作成します。

2. Capital ダッシュボードを通じてテストオファーを生成します。

3. オファーを配信済みとして更新し、承認をシミュレートします。

4. 資金の承認と支払いにより自動入金をテストします。

5. 入金または返済をテストします。特定の状況下でのみStripeによって開始されるため、差戻しをテストすることはできません。

   • Payouts
     1. オファー承認後の自動入金の発生確認
     2. `capital.financing_transaction.created Webhook の監視
     3. 入金取引がレポートに表示されることを確認
   • 返済
     1. テスト決済の処理による自動源泉徴収のテスト
     2. Capital ダッシュボードを通じた手動返済のシミュレート
     3. 返済取引がレポート導入に表示されることを確認します

6. 取引詳細がレポートインターフェースに正しく表示されることを確認します。

7. 取引通知のWebhook処理を確認します。

8. 実装されている場合は、アカウントリンクまたは埋め込みコンポーネントをテストします。

9. 取引の消し込みプロセスを検証してください。

テスト後、すべての適格な連結アカウントに対して自動オファーを有効にする前に、手動で本番オファーを送信してレポートを確認します。詳細については、Testingを参照してください。