Plattformtransaktionen melden

Importieren Sie Transaktionsdaten aus Datenquellen von Drittanbietern, um sie in das Underwriting von Stripe Capital einzubinden.

Vorsicht

Das Melden von Plattformtransaktionen für Capital befinden sich in der privaten Vorschau und unterliegt möglichen Änderungen. Bei Fragen oder Feedback wenden Sie sich bitte an capital-review@stripe.com

Verbessern Sie den Zugang zu Finanzierungsoptionen für Ihre Nutzer/innen, die Zahlungen außerhalb von Stripe akzeptieren. Dies umfasst das Zahlungsvolumen über andere Zahlungsabwickler und Offline-Transaktionen wie Bargeld und Schecks.

Stripe Capital integriert diese Transaktionen außerhalb von Stripe, um Ihren Nutzerinnen und Nutzern Angebote basierend auf ihrem gesamten Unternehmensprofil zu unterbreiten, nicht nur auf dem über Stripe abgewickelten Teil.

Ihre Daten erfassen und aufbereiten

Erfassen Sie Umsatzdaten wie alternatives Zahlungsverarbeitungsvolumen und Bargeldtransaktionen, um sie als CSV-Dateien in Stripe zu importieren. Fügen Sie außerdem Stripe-Transaktionen hinzu, die wir zur Validierung Ihrer Datenintegration verwenden. Sie können die Daten, die Sie importiert haben, über das Importsatz-Dashboard anzeigen. Stellen Sie sicher, dass Ihre Daten mit dem unten angegebenen CSV-Format kompatibel sind. Jedes Attribut ist erforderlich, sofern nicht anders angegeben.

Attribut	Typ	Beispiel	Beschreibung
`stripe_merchant_id`	ID des verbundenen Stripe Kontos	`acct_abcdef1234`	Die Kennung der ID des verbundenen Stripe Kontos.
`transaction_id`	Zeichenfolge	Ein beliebiger Wert wie `my_internal_id` oder `Check Number 1234`	Die Kennung der Transaktion: Diese Angabe muss für alle Transaktionen für alle Zeiten eindeutig sein. Dies ist eine willkürliche Kennung, mit der Sie eine einzelne Transaktion verfolgen können.
`capture_date`	Datum im Format `YYYY-MM-DD` in der Zeitzone UTC	`2022-01-27`	Das Datum, an dem die Zahlung erfolgreich erfasst wurde: Dies entspricht dem Datum der Zahlungserfassung, nicht dem Autorisierungsdatum.
`payer_id`	Zeichenfolge	Ein beliebiger Wert wie `my_internal_payer_id` oder `Customer Number 1234`	Die Kennung des/der Zahlungspflichtigen: Eindeutige, willkürliche Kennung für einen Kunden/eine Kundin des angegebenen Händlers/der angegebenen Händlerin.
`processor_id`	Zeichenfolge	`stripe` oder ein beliebiger Wert wie `checks` oder `App Store`	Die Kennung des Abwicklers für diese Transaktion: `stripe`, wenn Stripe diese Transaktion verarbeitet hat Andernfalls eine anonymisierte, willkürliche Kennung, mit deren Hilfe die Quelle einer Reihe von Transaktionen gruppiert werden kann.
`payment_method`	Zeichenfolge	`check`, `cash`, `credit_card`, `paypal`, `Zelle` und andere	Die für diese Transaktion verwendete Zahlungsmethode.
`transaction_amount`	Ganzzahl	`1234`, wenn ein/e Käufer/in 12,34 USD an den/die Händler/in zahlt oder wenn der/die Händler/in 12,34 USD an den/die Käufer/in zurückerstattet.	Der numerische Betrag der Transaktion ohne Währungssymbole: Wird in kleineren Einheiten angegeben (in Cent für USD). Immer nicht-negativ. Das Attribut `transaction_type` wird verwendet, um die Richtung der Saldoänderung anzugeben.
`transaction_currency`	Dreistelliger ISO-Währungscode (kleingeschrieben)	`usd`	Dies ist der dreistellige ISO-Code für die Währung der Transaktion: Währung, in der die Transaktion erfasst wurde, bevor die Fremdwährung umgetauscht wurde.
`transaction_type`	`credit` oder `debit`	`credit`, wenn ein/e Käufer/in an den Händler/in zahlt `debit`, wenn der/die Händler/in eine Rückerstattung an eine/n Käufer/in ausstellt	Der Transaktionstyp: `credit`, wenn die Transaktion das Händlerguthaben erhöht (Zahlung) `debit`, wenn die Transaktion das Händlerguthaben verringert (Rückerstattung oder Anfechtung)
`fee_amount`	Ganzzahl	`100`, wenn der Zahlungsabwickler oder die Plattform dem/der Händler/in eine Gebühr von 1 USD berechnet oder wenn der Abwickler oder die Plattform eine Gebühr von 1 USD an den/die Händler/in zurückgibt.	Der mit der Transaktion verknüpfte Gebührenbetrag: Wird in kleineren Einheiten angegeben (in Cent für USD). Immer nicht-negativ. Setzen Sie `fee_amount` auf `0`, wenn die Gebühr unbekannt oder null ist. Das Attribut `fee_type` wird verwendet, um die Richtung der Saldoänderung anzugeben.
`fee_type`	`credit` oder `debit`	`credit`, wenn der Abwickler die Gebühr an den/die Händler/in zurückgibt `debit`, wenn der Abwickler dem/der Händler/in die Gebühr berechnet	Der `fee_type`: `credit`, wenn die Gebühr das Händlerguthaben erhöht (der Abwickler gibt die Gebühr an den/die Händler/in zurück) `debit`, wenn die Gebühr das Händlerguthaben verringert (der Abwickler berechnet dem/der Händler/in eine Gebühr). Setzen Sie `fee_type` auf `debit`, wenn die Gebühr unbekannt oder Null ist.
`version`	Ganzzahl	`1742323922`	Unix-Zeitstempel, der angibt, wann die Datei generiert wurde: Dieser Wert muss für alle Zeilen in einer Datei gleich sein.
`additional_data` (Optional)	Schlüssel-Wert-Zeichenfolge	`"{'key1':'value1','key2':'value2'}"` `""` Leer lassen	Eine optionale Zeichenfolge mit Schlüssel-Wert-Paaren, die nützlich sind, um zusätzliche Informationen über die Transaktion in einem strukturierten Format zu speichern: Setzen Sie `additional_data` auf `""` oder leer, wenn keine zusätzlichen Informationen vorliegen.

Ihr Schema validieren

Wählen Sie im Importsatz-Dashboard den Schalter Test-Modus aus, um zuerst einen Import für Ihre Testdaten auszuführen.

Während des Testens

Laden Sie keine Produktionsdaten in eine Testumgebung hoch. Nutzer/innen mit geringen Berechtigungen können diese Daten anzeigen, was ein Sicherheitsrisiko darstellen kann.

Klicken Sie auf Datei importieren und geben Sie als Schema CAPITAL-Transaktionsschema an.
Klicken Sie auf Beispieldatei herunterladen, um ein Beispiel für das erforderliche Format zu sehen, bevor Sie Ihre CSV-Datei hochladen.
Wählen Sie Ihre fertige Vorlage zum Hochladen aus.

Beheben von Fehlern bei der Schemavalidierung

Einige häufige Fehler bei der Schemavalidierung:

Fehler	Fehlerbehebung
Ungültige Datumsangaben	Stellen Sie sicher, dass alle Datumsangaben im Epochen- oder Unix-Zeitstempelformat vorliegen.
Fehlende Daten	Stellen Sie sicher, dass jeder Datensatz die erforderlichen Felder enthält.
Inkompatible Attributtypen	Stellen Sie sicher, dass die Attribute den angegebenen Typen entsprechen (d. h. `transaction_type` muss `credit` oder `debit` sein).
Der Datenbestand ist zu groß	Teilen Sie Ihre Daten in mehrere CSV-Dateien auf, jeweils bis zu 50 MB mit der Stripe API oder jeweils 1 GB mit Dashboard-Upload und S3-Daten-Connector.

Wenn die hochgeladene Datei Fehler enthält, wird in der importierten Datei eine Fehlerübersicht angezeigt. So beheben Sie die Fehler:

Klicken Sie auf Herunterladen, um die Fehler zu überprüfen.
Überprüfen Sie die Fehlermeldungsspalte, um die Fehler anzuzeigen.
Korrigieren Sie alle Fehler.
Laden Sie die korrigierte CSV-Datei erneut hoch.
Warten Sie auf den neuesten Validierungs- und Verarbeitungsstatus.

Vorläufige Stripe Capital-Analyse erstellen

Laden Sie einmalige Drittanbieterdaten hoch, um zu analysieren, wie diese Daten zur Angebotserstellung für Ihre Nutzer/innen außerhalb von Stripe beitragen. Wir empfehlen, die historischen Daten der letzten 24 Monate zur Verfügung zu stellen, um Ihre Daten genau zu bewerten und unsere Risikoevaluation zu verbessern.

Notiz

Für die Erstanalyse unterstützen wir nur einzelne Dateien mit einer Größe von bis zu 10 MB. Wenn Ihre Daten größer sind, teilen Sie sie in mehrere Dateien auf.

Erfassen und formatieren Sie Ihre Produktionsdaten in einer CSV-Datei, die dem Datenschema folgt.
Importieren Sie im Live-Modus jede CSV-Datei in Stripe, indem Sie den Stripe API, den Amazon S3-Daten-Connector verwenden oder die Dateien einzeln manuell im Importsatz-Dashboard hochladen.
a. Wenn Ihre Datei zu groß ist, teilen Sie sie in mehrere CSV-Dateien auf. Wenn dies zu einer großen Anzahl von Dateien führt, empfehlen wir die Integration mit dem S3-Datenconnector.
b. Stellen Sie sicher, dass version für alle Zeilen in der Datei auf den aktuellen Unix-Zeitstempel gesetzt ist.

Stripe wird sich möglicherweise an Sie wenden, um in Ihren Produktionsimporten festgestellte Probleme mit der Datenqualität zu beheben.

Automatische tägliche Datenimporte einrichten

Konfigurieren Sie nach Abschluss der vorläufigen Analyse Ihre tägliche Datenimportintegration mit der Stripe API oder dem Amazon S3-Daten-Connector, um automatisierte tägliche aggregierte Daten-Uploads zu unterstützen. Laden Sie täglich Daten hoch, um genaue und aktuelle Informationen zu erhalten. Durch Echtzeit-Informationen des finanziellen Zustands Ihrer Nutzer/innen können wir fundiertere Entscheidungen über die Risikoevaluation treffen. Wenn Sie weitere Fragen zur Einrichtung Ihrer Datenimporte haben, kontaktieren Sie us.

Andere Möglichkeiten zum Importieren von Daten:

Über das Importsatz-Dashboard können Sie einmalige manuelle Uploads externer Daten vornehmen, ohne Code schreiben zu müssen. Nachdem Sie Ihre Testtransaktionsdaten in einer Testumgebung validiert haben, haben Sie zwei Möglichkeiten, die täglichen Importe mit Produktionsdaten zu automatisieren:

Verwenden Sie die APIs von Stripe, um Ihre Importe vollständig zu automatisieren.
Richten Sie wiederkehrende Importe ohne Code mit einem Daten-Connector wie Amazon S3 ein.

Dateien, die Sie mit einer der beiden Methoden hochladen, werden weiterhin im Dashboard angezeigt.

Automatisierte wiederkehrende Dateiimporte mit Datenkonnektoren

Wenn Ihre Transaktionsdatendateien in S3 gespeichert sind, können Sie den Amazon S3 Daten-Connector verwenden, um diese Dateien in Stripe zu importieren. Folgen Sie Stripe-Connector für Amazon S3, um Ihren Connector einzurichten. Die maximale Dateigröße, die über den Daten-Connector importiert wird, beträgt 1 GB.

Automatisiertes Hochladen von Daten mit der Stripe API

Verwenden Sie die File Upload API, um Dokumente sicher an Stripe zu senden. Um eine Datei hochzuladen, senden Sie eine mehrteilige Anfrage oder eine Formulardatenanfrage an https://files.stripe.com/v1/files. Beachten Sie, dass die Subdomain files.stripe.com sich von den meisten API-Endpoints von Stripe unterscheidet. In der Anfrage muss der data_management_manual_upload-Zweck sowie eine CSV-Datei mit Ihren in Vorlagen gespeicherten Daten von Drittanbietern angegeben werden. Die maximale Dateigröße, die Sie über die API hochladen können, beträgt 50 MB.
Im folgenden Beispiel, das bei Erfolg ein Datei-Objekt zurückgibt, wird eine Datei hochgeladen, die sich unter /path/to/a/file.jpg auf Ihrem lokalen Dateisystem befindet:
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
```
Verwenden Sie die Data Management API, um ein ImportSet-Objekt zu erstellen. Ein ImportSet stellt eine Anfrage zum Importieren einer Drittanbieter-Datendatei in das Datenverwaltungs-Dashboard von Stripe dar. Da sich die Data Management API in der Beta befindet, geben Sie den Beta-Header Stripe-Version: 2024-12-18.acacia;udap_beta=v1 in Ihrer Anfrage an.
Im folgenden Beispiel wird ein ImportSet-Objekt aus file_abcdef erstellt, das die File Upload API im vorherigen Schritt zurückgegeben hat:
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"
```

Verwenden Sie Ihren Test-API-Schlüssel in Ihrer Anfrage, um hochgeladene Dateien und ImportSet-Objekte im Test-Modus zu erstellen.