# レポートの提供と照合 連結アカウントに Capital レポートを提供し、既存のレポートで Capital 取引を照合する方法を学習します。 > Capital for platforms は [パブリックプレビュー](https://docs.stripe.com/release-phases.md)で利用できます。 このガイドの用途： - **Capital レポートの提供**:連結アカウントに Capital 取引レポートを提供します。これらのレポートを使用して、未払い残高、決済履歴、融資契約などのデータを表示できます。連結アカウントに複数の方法でレポートを提供できます。 - **Capital 取引を含む既存レポートの照合**：プラットフォームの UI で連結アカウントにレポートをすでに提供している場合は、Stripe API を使用してそれらの既存レポートで Capital 取引データを同期します。 融資オファーには、入金、返済、差戻しの三種類の取引があります。[Stripe APIを使用したレポート提供](https://docs.stripe.com/capital/reporting-and-reconciliation.md#before-you-begin) をご希望の場合、これらの取引について以下で詳しく説明します。 ## レポート提供のオプション 連結アカウントに Capital レポートを複数の方法で提供でき、複数のオプションを使用できます。 | | | | | **メール** | 連結アカウントは、オファーの受諾、入金の送金、週ごとの決済進捗の更新に関する通知をメールで受け取ります。これらのコーブランドメールには、連結アカウントを Stripe がホストする別の Capital ページにリダイレクトするリンクが含まれており、そこで Capital 取引や決済の進捗を確認できます。このページには、元の請求金額、プラットフォームおよび処理手数料、返金、不審請求の申し立てなどの標準的な決済処理の詳細は含まれていません。 アカウント登録中に [Stripeがあなたの代わりにメールを送信する](https://docs.stripe.com/capital/how-capital-for-platforms-works.md#capital-emails) ことを選択した場合、これを自動的に行います。 | | **埋め込みコンポーネント** | プラットフォームのUIにCapital 融資コンポーネントを埋め込みます。これにより、連結アカウントがプラットフォームの UI で直接アクセスできる取引レポートを表示できます。このコンポーネントには、標準的な決済処理情報（支払い、返金、または不審請求の申し立てなど）は含まれていません。 このコンポーネントを実装するには、[Capital 融資](https://docs.stripe.com/connect/supported-embedded-components/capital-financing.md)を参照してください。 | | **API** | Financing Transactions APIを使用して、詳細な決済データ (支払い、返金、または不審請求の申し立てなどの標準的な決済処理情報を含む) とともに Capital 取引を監視および表示します。独自のカスタムレポートインターフェースを構築することもできます。 これらのAPIを使用するには、このガイドを続けてお読みください。 | [アドホックレポートを提供することもできます](https://docs.stripe.com/capital/reporting-and-reconciliation.md#ad-hoc-reports)。 ## はじめに APIを使用してレポートを提供したい場合は、次のタイプの取引を確認してください： | | | | | **入金** | Stripe は (金融パートナーと共に)、融資契約の条件に従って、承認され受け入れられた融資オファーの入金資金を連結アカウントに自動的に配分します。Capital 資金供給は、連結アカウントの通常の入金とは独立しています。これらの入金を促進するために、プラットフォームからの追加のアクションは必要ありません。 | | **返済** | 融資金額の支払いに使用される決済。3 つのタイプの返済取引が利用可能です。 - **源泉徴収**:連結アカウントが総融資額を支払うまで、融資を支払うために自動的に差し引かれる固定割合の決済。連結アカウントが融資を申し込むと、Stripe が将来の決済または売上から固定割合を差し引くことに同意します。 - **ユーザー主導**:ユーザーは、Stripe ホストの Capital ページまたは Stripe 融資の埋め込みコンポーネント内で、融資に対して手動で決済を行うことができます。 - **回収の試み**：Stripeのサービスチームは、Capitalの回収ポリシーに従って返済を開始する場合があります。 Capital の源泉徴収は、決済処理と同時に発生し、Connect ボリューム手数料とプラットフォームアプリ手数料は、全額請求額に基づいて計算されます。連結アカウントに送金される最終的な金額は、元の決済金額からプラットフォームアプリ手数料と Capital の源泉徴収を差し引いたものです。たとえば、連結アカウントが 15% の源泉徴収率の融資オファーを受け入れます。1日に100 USDの決済を 5 回受け入れた場合、プラットフォームアプリ手数料と Capital の源泉徴収を差し引いた後の総入金額は405 USDです。 | | **差戻し** | Stripe は以下の状況で入金または返済取引を差戻しする場合があります。 - **失敗したACH取引**:連結アカウントが外部銀行口座からの手動返済に対して資金不足の場合、または顧客の ACH 決済が決済中または決済後に失敗した場合に発生します。 - **融資キャンセル**：連結アカウントが承認された融資オファーをキャンセルした場合、Stripe は初回入金を差戻しします。 - **手動差戻し**：請求の返金は自動的にCapitalの返済の差戻しをトリガーしませんが、連結アカウントは[capital-support@stripe.com](mailto:capital-support@stripe.com) に連絡して手動差戻しを要求できます。これらのリクエストはケースバイケースで評価され、元の請求に関する詳細、返金理由の説明、および関連するサポート情報が必要です。 | [資金提供取引](https://docs.stripe.com/api/capital/financing_transactions.md) API または [取引残高](https://docs.stripe.com/api/balance_transactions.md) APIを使用して取引を取得できます。 始めるには、API を選択してください。 # 資金調達の取引 > This is a 資金調達の取引 for when fetch-transactions-api is financing-transactions. View the full page at https://docs.stripe.com/capital/reporting-and-reconciliation?fetch-transactions-api=financing-transactions. Financing Transactions APIを使用して、Capitalに特有の詳細な取引情報を含めます。 ## Capital 取引の監視 次の取引タイプは、マーチャントキャッシュアドバンスやローンを含む、連結アカウントの融資に関連しています： - 入金： `payout` - 返済：`payment` - 差戻し：`reversal` ### 入金 各資金供給には、タイプが`payout`の[資金調達取引](https://docs.stripe.com/api/capital/financing_transaction_object.md) オブジェクトがあります。入金資金調達取引が作成されると、Stripe は [capital.financing_transaction.created](https://docs.stripe.com/api/events/types.md#event_types-capital.financing_transaction.created) Webhook を送信します。ACH資金が連結アカウントの銀行口座に到着するまでに数営業日かかることがあります。 Webhook イベントをリッスンし、受信時にカスタム入金レポートを更新して、連結アカウントの外部銀行口座に送信された融資金額を表示します。 ### 返済 UIに源泉徴収取引を表示するには： 1. [Retrieve Financing Transactions](https://docs.stripe.com/api/capital/financing_transactions/retrieve.md) を行い、取引タイプでフィルタリングします。 1. `Stripe-Account`ヘッダーに連結アカウントのアカウントIDを指定します。 ```curl curl -G https://api.stripe.com/v1/capital/financing_transactions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=paydown ``` 資金調達取引リストを正常に取得すると、次のようなレスポンスが返されます。 ```json { "object": "list", "url": "/v1/capital/financing_transactions?financing_offer=financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs&charge=ch_1HoZftJQ3aJgxqz50EbvL8zU", "has_more": false, "data": [ { "id": "cptxn_1NAdVWJQ3aJgxqz5FSScvJaF", "object": "capital.financing_transaction", "account": "acct_1HLGiXJQ3aJgxqz5", "created_at": 1684780258, "details": { "advance_amount": 10000, "currency": "usd", "fee_amount": 1000, "linked_payment": "ch_1HoZftJQ3aJgxqz50EbvL8zU", "reason": "automatic_withholding", "total_amount": 11000, "transaction": { "charge": "ch_1HoZftJQ3aJgxqz50EbvL8zU" } }, "financing_offer": "financingoffer_1NAdVWJQ3aJgxqz5nh90Zqrs", "livemode": true, "type": "payment", "user_facing_description": "Paydown of your loan" }, {...}, {...} ] } ``` レスポンスには、当該の返済の結果、未返済の融資金額がどのようになったかを示す情報が含まれています。`"details.reason": "automatic_withholding"` の理由で返済が行われた場合は、`details.transaction` フィールドに元の Stripe の支払いの参照も含まれます。 ### 差戻し 各差戻しには、タイプ `reversal` の [資金調達取引](https://docs.stripe.com/api/capital/financing_transaction_object.md) オブジェクトがあります。差戻しは、ACH 取引の失敗、融資のキャンセル、または手動差し戻しリクエストにより発生する可能性があります。差戻し取引の提供には 2 つの目的があります。 - これらはキャンセルされた融資を示すことがあります。元の資金供給をレポートに含めた場合は、すべての差戻しを含めてください。このようにして、連結アカウントは両方の取引が相殺されることを確認できます。 - これらは以前に保留された資金を連結アカウントの残高に返すことができます。レポートから差戻しを除外すると、レポートが不正確な融資を反映する可能性があるため、連結アカウントの照合に問題が生じる可能性があります。 ### デスティネーション支払い プラットフォームが [デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)を使用して決済処理し、プラットフォームで発生した元の請求と[ファイナンス取引](https://docs.stripe.com/api/capital/financing_transaction_object.md)の返済を照合したい場合は、[資金調達取引](https://docs.stripe.com/api/capital/financing_transaction_object.md) の`details.transaction` フィールドで請求 ID を抽出します。これは、連結アカウントへの自動 [送金](https://docs.stripe.com/api/transfers/object.md)の結果として発生した決済 ID に設定されます。 ```json { "id": "cptxn_1NBJQR2eZvKYlo2CBUy2GQ1S", "object": "capital.financing_transaction", "details": { "reason": "automatic_withholding", "transaction": { "charge": "py_1NBJI62c99H72o8MUEN0fIZx" }, ... }, "type": "payment", ... } ``` その後、[Retrieve Charge API](https://docs.stripe.com/api/charges/retrieve.md) を使用して請求オブジェクトを取得できます。 ```curl curl https://api.stripe.com/v1/charges/py_1NBJI62c99H72o8MUEN0fIZx \ -u "<>:" ``` ```json { "id": "py_1NBJI62c99H72o8MUEN0fIZx", "object": "charge", "source_transfer": "tr_3NBJGW2eZvKYlo2C1jQOxNwF", ... } ``` これはデスティネーション支払いであるため、`source_transfer`は[送金](https://docs.stripe.com/api/transfers/object.md) IDで入力されます。[Retrieve Transfer API](https://docs.stripe.com/api/transfers/retrieve.md)を使用して送金オブジェクトを取得します。 ```curl curl https://api.stripe.com/v1/transfers/tr_3NBJGW2eZvKYlo2C1jQOxNwF \ -u "<>:" ``` ```json { "id": "tr_3NBJGW2eZvKYlo2C1jQOxNwF", "object": "transfer", "source_transaction": "ch_3NBJGW2eZvKYlo2C17oDFajw", ... } ``` `source_transaction` フィールドは、プラットフォームで行われた [Charge (支払い)](https://docs.stripe.com/api/payment_provider/payment/object.md) の ID を含み、連結アカウントへの [Transfer (送金)](https://docs.stripe.com/api/transfers/object.md) をトリガーします。 ## レポートの提供 プラットフォームの UI にある融資取引またはそれに相当するモデルのリストに返済を表示できます。以下に例を示します。 - **既存のレポート**：連結アカウントの個別取引 (プラットフォーム手数料やインターチェンジフィーを含む)を表示する既存のレポートに、源泉徴収額を追加することを検討してください。 - **新規レポート**：新規レポートでは、特定の期間のすべての源泉徴収額を表示します。これにより、連結アカウントは、販売処理のうちどれだけが融資に充当されているかを確認できます。入金レポートでは、源泉徴収された合計金額を含めることをお勧めします。これにより、連結アカウントは、源泉徴収分 (および請求するプラットフォーム手数料) を差し引いた総売上処理額を照合し、外部銀行口座で確認される入金額に到達できます。 ### アドホックレポートの提供 アドホックレポートを提供するための 3 つのオプションを用意しています。 ### アカウントリンク オンデマンドレポートのニーズに応じて、[アカウントリンク](https://docs.stripe.com/api/account_links.md)を作成できます。このリンクは、連結アカウントを Stripe ホストの Capital ページ（メールで送信されたものと同じ）にリダイレクトし、そこで Capital トランザクションと決済の進捗を確認できます。このページには、標準の決済処理情報（支払い、返金、または不審請求の申し立てなど）は含まれていません。 [アカウントリンク](https://docs.stripe.com/api/account_links/create.md)を作成するには、タイプを`capital_financing_reporting`に設定します： ``` curl https://api.stripe.com/v1/account_links \ -u sk_test_26PHem9AhJZvU623DfE1x4sd: \ -d account=acct_123 \ -d refresh_url="https://example.com/reauth" \ -d return_url="https://example.com/thanks" \ -d type=capital_financing_reporting ``` ### Stripe Sigma Stripe Sigma を使用すると、クエリを作成し、スキーマを使用して連結アカウントに分析レポートを提供できます。Stripe ダッシュボードで Sigma レポートにアクセスするには、以下を参照してください: - [connected_account_financing_balances](https://dashboard.stripe.com/stripe-schema?tableName=financing_balances)：このテーブルを使用して、未払いの融資残高を報告します。 - [connected_account_financing_transactions](https://dashboard.stripe.com/stripe-schema?tableName=connected_account_financing_transactions)：このテーブルを使用して、入金、返済、および差戻しをレポートします。 Sigma を使用して、標準の決済処理情報（支払い、返金、不審請求の申し立てなど）を見つけることもできます。 ### CSV ファイル 適格な連結アカウントに自動融資オファーを送信した後、これらのオファーをダッシュボードで追跡できます。承認された融資オファーを選択すると、初回入金とその後の Capital 取引を含む取引履歴を確認できます。 このデータを CSV ファイルとしてエクスポートし、該当する連結アカウントと共有するには、[Offers](https://dashboard.stripe.com/connect/capital/financing_offers) タブの上部にある **エクスポート** をクリックします。このデータには、Capital 取引（入金、返済、差戻しなど）のみが含まれ、標準の決済処理情報（支払い、返金、または不審請求の申し立てなど）は含まれていません。 ## テスト [サンドボックス](https://docs.stripe.com/capital/testing.md) を使用して、連結アカウント向けの様々な状態の融資オファーを作成できます。 テストシナリオを作成するには： 1. テスト環境に[sandbox](https://docs.stripe.com/sandboxes.md)を作成します。 1. Capital ダッシュボードを通じてテストオファーを生成します。 1. オファーを配信済みとして更新し、承認をシミュレートします。 1. 資金の承認と支払いにより自動入金をテストします。 1. 入金または返済をテストします。特定の状況下でのみStripeによって開始されるため、差戻しをテストすることはできません。 - 入金： 1. オファー承認後に自動入金が発生することを確認します。 1. `capital.financing_transaction.created` Webhook を監視します。 1. 入金取引がレポートに表示されることを確認します。 - 返済: 1. テスト用決済の処理による自動源泉徴収をテストします。 1. Capital ダッシュボードを通じて手動返済をシミュレーションします。 1. 分割払い取引がレポート導入に表示されることを確認します。 1. 取引詳細がレポートインターフェースに正しく表示されることを確認します。 1. 取引通知のWebhook処理を確認します。 1. アカウントリンクまたは埋め込みコンポーネントをテストします (実装されている場合)。 1. 取引の消し込みプロセスを検証してください。 テスト後、すべての適格な連結アカウントに対して自動オファーを有効にする前に、手動で本番オファーを送信してレポートを確認します。詳細については、[Testing](https://docs.stripe.com/capital/testing.md)を参照してください。 # 取引残高 > This is a 取引残高 for when fetch-transactions-api is balance-transactions. View the full page at https://docs.stripe.com/capital/reporting-and-reconciliation?fetch-transactions-api=balance-transactions. 取引残高 APIを使用する既存の統合がある場合は、この導入オプションを使用してください。ほとんどの取引タイプを返しますが、連結アカウントの[融資オファー](https://docs.stripe.com/api/capital/connect_financing_object.md)などの追加情報は含まれません。 ## Capital 取引の監視 次の[取引残高タイプ](https://docs.stripe.com/reports/balance-transaction-types.md#financing_related) は、マーチャントキャッシュアドバンスやローンを含む、連結アカウントの融資に関連しています。 - 入金：`financing_payout` - 返済： `financing_paydown` - 差戻し：`financing_payout_reversal`または`financing_paydown_reversal` ### 入金 各入金取引には、タイプ`financing_payout`の[取引残高](https://docs.stripe.com/api/balance_transactions.md)オブジェクトがあります。プラットフォームの UI にある取引残高またはそれに相当するモデルのリストに入金を表示できます。 ### 返済 各入金取引には、タイプ`financing_paydown`の[取引残高](https://docs.stripe.com/api/balance_transactions.md)オブジェクトがあります。プラットフォームの UI で源泉徴収取引を表示するには： 1. [取引残高を取得](https://docs.stripe.com/api/balance_transactions/retrieve.md) を行い、取引タイプでフィルタリングします。 1. `Stripe-Account`ヘッダーに連結アカウントのアカウント ID を指定します。 以下に例を示します。 ```curl curl -G https://api.stripe.com/v1/balance_transactions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=financing_paydown ``` 取引残高の[リスト](https://docs.stripe.com/api/balance_transactions/list.md)の取得に成功すると、次のようなレスポンスを受け取ります。 ```json { "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`から資金を源泉徴収」という説明が含まれる場合があります。 取引残高の[ソース](https://docs.stripe.com/api/balance_transactions/object.md#balance_transaction_object-source)フィールドを展開することで、該当する[資金調達取引](https://docs.stripe.com/capital/reporting-and-reconciliation.md?fetch-transactions-api=financing-transactions)オブジェクトを取得できます。 ```curl curl -G https://api.stripe.com/v1/balance_transactions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=financing_paydown \ -d "expand[]=data.source" ``` 展開すると、`source` フィールドに融資取引の詳細が表示されます： ```json { "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`の [取引残高](https://docs.stripe.com/api/balance_transactions.md)オブジェクトがあります。差戻しは、ACH 取引の失敗、融資のキャンセル、または手動差し戻しリクエストにより発生する可能性があります。差戻し取引の提供には 2 つの目的があります。 - これらはキャンセルされた融資を示すことがあります。元の資金供給をレポートに含めた場合は、すべての差戻しを含めてください。このようにして、連結アカウントは両方の取引が相殺されることを確認できます。 - これらは以前に保留された資金を連結アカウントの残高に返すことができます。 レポートから差戻しを除外すると、レポートが不正確な融資を反映する可能性があるため、連結アカウントの照合に問題が生じる可能性があります。 ## レポートの提供 プラットフォームのUIにある取引残高のリストや同等のモデルに返済を表示できます。以下に例を示します。 - **既存のレポート**：連結アカウントの個別取引 (プラットフォーム手数料やインターチェンジフィーを含む)を表示する既存のレポートに、源泉徴収額を追加することを検討してください。 - **新規レポート**: 新規レポートでは、特定の期間におけるすべての源泉徴収金額を表示します。これにより、連結アカウントは、売上処理のうち融資に充当された金額を確認できます。入金レポートでは、源泉徴収された合計金額を含めることができます。これにより、連結アカウントは、入金された売上処理の合計から源泉徴収 (および課せられるプラットフォーム手数料) を差し引いた金額を照合し、外部の銀行口座に入金される予定金額を確認できます。 詳細については、[入金の消し込み](https://docs.stripe.com/payouts/reconciliation.md)を参照してください。 ## テスト [サンドボックス](https://docs.stripe.com/capital/testing.md) を使用して、連結アカウント向けの様々な状態の融資オファーを作成できます。 テストシナリオを作成するには： 1. テスト環境に[sandbox](https://docs.stripe.com/sandboxes.md)を作成します。 1. Capital ダッシュボードを通じてテストオファーを生成します。 1. オファーを配信済みとして更新し、承認をシミュレートします。 1. 資金の承認と支払いにより自動入金をテストします。 1. 入金または返済をテストします。特定の状況下でのみStripeによって開始されるため、差戻しをテストすることはできません。 - 入金： 1. オファー承認後に自動入金が発生することを確認します。 1. `capital.financing_transaction.created` Webhook を監視します。 1. 入金取引がレポートに表示されることを確認します。 - 返済: 1. テスト用決済の処理による自動源泉徴収をテストします。 1. Capital ダッシュボードを通じて手動返済をシミュレーションします。 1. 分割払い取引がレポート導入に表示されることを確認します。 1. 取引詳細がレポートインターフェースに正しく表示されることを確認します。 1. 取引通知のWebhook処理を確認します。 1. アカウントリンクまたは埋め込みコンポーネントをテストします (実装されている場合)。 1. 取引の消し込みプロセスを検証してください。 テスト後、すべての適格な連結アカウントに対して自動オファーを有効にする前に、手動で本番オファーを送信してレポートを確認します。詳細については、[Testing](https://docs.stripe.com/capital/testing.md)を参照してください。 ## See also - [プラットフォーム向け Capital の仕組み](https://docs.stripe.com/capital/how-capital-for-platforms-works.md) - [Capitalの設定](https://docs.stripe.com/capital/getting-started.md)