プラットフォーム取引の報告

サードパーティのデータソースから取引データをインポートして、Stripe Capital の引受に組み込みます。

注意

Capital でのプラットフォーム取引の報告は現在非公開ベータでのみ利用でき、今後変更される可能性があります。ご質問やフィードバックがありましたら、capital-review@stripe.com までお問い合わせください。

Stripe 以外で支払いを受け付けるユーザーの融資オプションへのアクセスを増やします。これには、他の決済代行業者による決済額や、現金や小切手などのオフライン取引が含まれます。

Stripe Capital は、これらの Stripe 外の取引を組み込み、Stripe で処理された部分だけでなく、ビジネスプロファイル全体に基づいてユーザーにオファーを拡張します。

データの収集と準備

代替決済処理額や現金取引などの収益データを収集し、CSV ファイルとして Stripe にインポートします。加えて、データ統合の検証に使用する Stripe 取引も含めます。インポートしたデータは、インポート設定ダッシュボードから確認できます。データが以下の CSV 形式に対応してることを確認してください。特に断りのない限り、すべての属性が必須です。

属性	タイプ	例	説明
`stripe_merchant_id`	Stripe 連結アカウント ID	`acct_abcdef1234`	Stripe 連結アカウント ID の識別子。
`transaction_id`	文字列	`my_internal_id` や `Check Number 1234` などの任意の値	取引の識別子: すべての取引で常に一意である必要があります。これは、1 つの取引を追跡するための任意の識別子です。
`capture_date`	UTC タイムゾーンの `YYYY-MM-DD` 形式の日付	`2022-01-27`	支払いが正常にキャプチャーされた日付: これは、オーソリ日ではなく、支払いのキャプチャー日に対応します。
`payer_id`	文字列	`my_internal_payer_id` や `Customer Number 1234` などの任意の値	支払人の識別子: 特定の加盟店の顧客につけられる一意かつ任意の識別子。
`processor_id`	文字列	`stripe`、または `checks` や `App Store` などの任意の値	この取引を処理する決済代行業者の識別子: `stripe` (Stripe が取引を処理した場合) それ以外の場合は、取引ソースをグループ化する匿名化された任意の識別子。
`payment_method`	文字列	`check`、`cash`、`credit_card`、`paypal`、`Zelle` など	この取引に使用された決済手段。
`transaction_amount`	整数	買い手が加盟店に 12.34 USD を支払った場合、または加盟店が買い手に 12.34 USD を返金した場合は `1234`。	通貨記号を含まない取引の金額: 補助単位 (USD の場合はセント) で指定されます。負の値は使用できません。 `transaction_type` 属性は、残高の増減を示すために使用されます。
`transaction_currency`	小文字 3 文字の ISO 通貨コード	`usd`	これは、取引通貨を表す 3 文字の ISO コードです。外貨為替の前に取引がキャプチャーされた通貨。
`transaction_type`	`credit` または `debit`	買い手が加盟店に支払う場合は `credit` 加盟店が買い手に返金する場合は `debit`	取引タイプ: 取引によって加盟店の残高が増える場合は `credit` (支払い) 取引によって加盟店の残高が減る場合は `debit` (返金または不審請求の申し立て)
`fee_amount`	整数	決済代行業者またはプラットフォームが加盟店に 1 USD の手数料を請求または返金する場合は `100`。	取引に関連する手数料の金額: 補助単位 (USD の場合はセント) で指定されます。負の値は使用できません。手数料が不明またはゼロの場合は、`fee_amount` を `0` に設定します。 `fee_type` 属性は、残高の増減を示すために使用されます。
`fee_type`	`credit` または `debit`	決済代行業者が加盟店に手数料を返金する場合は `credit` 決済代行業者が加盟店に手数料を請求する場合は `debit`	`fee_type`: 手数料によって加盟店の残高が増える場合は `credit` (決済代行業者が加盟店に手数料を返金します)。手数料によって加盟店の残高が減る場合は `debit` (決済代行業者が加盟店に手数料を請求します)。手数料が不明またはゼロの場合は、`fee_type` を `debit` に設定します。
`version`	整数	`1742323922`	ファイルの生成日時を表す Unix タイムスタンプ: この値は、ファイル内のすべての行で同じである必要があります。
`additional_data` (オプション)	キーと値の文字列	`"{'key1':'value1','key2':'value2'}"` `""` 空のままにする	取引に関する追加情報を構造化された形式で保存するのに役立つ、キーと値のペアの任意の文字列。 `additional_data` を `""` に設定するか、追加情報がない場合は空にします。

スキーマを検証する

インポート設定ダッシュボードでテスト環境トグルを選択して、最初にテストデータのインポートを実行します。

テスト中

本番データは、テスト環境にアップロードしないでください。下位レベルのアクセス権を持つユーザーはこのデータを表示できるため、セキュリティ上のリスクが生じる可能性があります。

ファイルをインポートをクリックし、スキーマを Capital 取引スキーマに指定します。
CSV ファイルをアップロードする前に、サンプルファイルをダウンロードをクリックして要求形式を確認します。
完成したテンプレートを選択してアップロードします。

スキーマ検証エラーを解決する

一般的なスキーマ検証エラーには、次のようなものがあります。

エラー	トラブルシューティング
無効な日付	日付のすべてが Epoch または Unix タイムスタンプの形式であることを確認してください。
データの未入力	すべてのレコードに必須フィールドが含まれていることを確認してください。
互換性のない属性タイプ	属性が指定されたタイプに準拠していることを確認します (たとえば、`transaction_type` は `credit` または `debit` である必要があります)。
データが大きすぎます	データを複数の CSV ファイルに分割します。Stripe API では各 50 MB まで、ダッシュボードのアップロードと S3 データコネクターでは各 1GB まででです。

アップロードしたファイルにエラーがある場合、インポートファイルに失敗の概要が表示されます。次の手順に従ってエラーを解決してください。

ダウンロードをクリックしてエラーを確認します。
エラーメッセージ列を確認して、エラーを確認します。
すべてのエラーを修正します。
修正した CSV を再アップロードします。
検証と処理の最新ステータスが表示されるのを待ちます。

Stripe Capital の事前分析を設定する

1 回限りのサードパーティーデータをアップロードして、このデータがユーザー向けオファーの生成にどのように貢献しているかを分析します。データを正確に評価し、引受を改善するために、過去 24 カ月の履歴データを提供することをお勧めします。

注

初期分析では、サイズが 10 MB までの個々のファイルのみがサポートされます。データがそれよりも大きい場合は、複数のファイルに分割します。

本番データ を収集し、次のデータスキーマに従って CSV ファイルにフォーマットします。
本番環境 で、Stripe API、Amazon S3 データコネクターを使用するか、インポート設定ダッシュボードでファイルを 1 つずつ手動でアップロードして、各 CSV ファイルを Stripe にインポートします。
a.ファイルが大きすぎる場合は複数の CSV ファイルに分割します。ファイル数が多くなる場合は、S3 データコネクターと連携することをお勧めします。
b.ファイル内のすべての行について、version が現在の Unix タイムスタンプに設定されていることを確認します。

本番環境のインポートで見つかったデータ品質の問題を修正するために、Stripe からお客様に連絡する場合があります。

毎日の自動データインポートを設定する

事前分析が完了したら、Stripe API または Amazon S3 データコネクターを使用して日次データインポートの実装を設定し、集計データの毎日の自動アップロードを有効にします。正確かつ最新の情報を維持するために、データは毎日アップロードするようにしてください。ユーザーの財務状況をリアルタイムで把握することで、より多くの情報に基づいた引受判断を下すことができます。データインポートの設定について他にご不明な点がありましたら、Stripe までお問い合わせください。

データをインポートするその他の方法:

インポート設定ダッシュボードを使用すると、コードを記述せずに外部データの 1 回限りの手動アップロードを行えます。テスト環境でテスト取引データを検証し終わったら、本番データを使用して日次インポートを自動化できます。その方法は次の 2 通りです。

Stripe の API を使用してインポートを完全に自動化します。
Amazon S3 などのデータコネクターを使用して、定期的なノーコードインポートを設定します。

どちらの方法でも、アップロードしたファイルはダッシュボードに表示されます。

データコネクターによる定期的な自動ファイルインポート

取引データファイルが S3 に保存されている場合は、Amazon S3 データコネクターを使用してこれらのファイルを Stripe にインポートできます。Stripe connector for Amazon S3 を使用してコネクターを設定します。データコネクターを介してインポートされる最大ファイルサイズは 1GB です。

Stripe API を使用した自動データアップロード

File Upload API を使用することで、ドキュメントを Stripe に安全に送信できます。ファイルをアップロードするには、マルチパートまたはフォームデータリクエストを https://files.stripe.com/v1/files に送信します。サブドメイン files.stripe.com は、Stripe の API エンドポイントの大半とは異なることに注意してください。リクエストには、data_management_manual_upload の目的と、テンプレート化されたサードパーティーデータの CSV ファイルを指定する必要があります。API を使用してアップロードできるファイルの最大サイズは 50 MB です。
次の例では、成功した場合にファイルオブジェクトが返され、ローカルファイルシステムの /path/to/a/file.jpg にあるファイルをアップロードします。
Command Line
```
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F file="@/path/to/a/file.csv" \
  -F purpose=data_management_manual_upload
```
Data Management API を使用して、ImportSet オブジェクトを作成します。ImportSet は、サードパーティーのデータファイルを Stripe のデータ管理ダッシュボードにインポートするリクエストを表します。Data Management API はベータ版であるため、リクエストにベータヘッダー Stripe-Version: 2024-12-18.acacia;udap_beta=v1 を指定します。
次の例では、前の手順で File Upload API を返した file_abcdef から ImportSet オブジェクトを作成しています。
Command Line
```
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2024-12-18.acacia;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file="file_abcdef" \
  --data-urlencode source_data_format="gsdf_61S7vBSIsrNXP3yYM5G6S"
```

テストのファイルのアップロードと ImportSet オブジェクトを作成するには、リクエストでテスト API キーを使用します。