Anleitung zum Hochladen von Dateien
Verwenden Sie die File Upload API, um Nachweise zu Zahlungsanfechtungen, Identitätsnachweise und mehr sicher an Stripe zu senden.
Wenn Sie eine Datei mit der API bei Stripe hochladen, werden ein Datei-Token und andere Informationen über die Datei zurückgegeben. Das Token kann anschließend in anderen API-Aufrufen verwendet werden. Diese Anleitung führt Sie Schritt für Schritt durch diesen Vorgang.
Datei hochladen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Um eine Datei hochzuladen, senden Sie eine multipart/form-data
-Anfrage 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 sollten ein purpose
und eine file
angegeben werden. Im folgenden Beispiel wird eine Datei hochgeladen, die sich unter /path/to/a/file.jpg auf Ihrem lokalen Dateisystem befindet und den Zweck dispute_
hat:
Im folgenden Beispiel wird eine Datei über unser Android SDK mit dem Zweck dispute_
hochgeladen:
Es gibt mehrere gültige Werte für Zwecke, die unterschiedliche Anforderungen an das Dateiformat und die Größe haben.
Purpose | Description | Supported mimetypes | Max size | Expiry | Downloadable |
---|---|---|---|---|---|
account_ | Additional documentation requirements that can be requested for an account. | PDF JPEG PNG | 16MB | NEVER | false |
business_ | A business icon. | JPEG PNG GIF | 512KB | NEVER | true |
business_ | A business logo. | JPEG PNG GIF | 512KB | NEVER | true |
customer_ | Customer signature image. | JPEG PNG SVG | 4MB | 7 days | true |
dispute_ | Evidence to submit with a dispute response. | PDF JPEG PNG | 5MB | 9 months | true |
identity_ | A document to verify the identity of an account owner during account provisioning. | PDF JPEG PNG | 16MB | NEVER | false |
issuing_ | Additional regulatory reporting requirements for Issuing. | JSON | 256KB | 2 years | true |
pci_ | A self-assessment PCI questionnaire. | PDF | 16MB | NEVER | true |
tax_ | A user-uploaded tax document. | PDF CSV JPEG PNG XLSX DOCX | 16MB | NEVER | true |
additional_ | Additional verification for custom accounts. | PDF JPEG PNG | 16MB | NEVER | false |
terminal_ | Splashscreen to be displayed on Terminal readers. | PNG JPEG GIF | 4.194304MB | 1 year | true |
Vorsicht
Die Größe der identity_
-Bilder darf 8.000 x 8.000 Pixel nicht überschreiten.
Der MIME-Typ der Datei, die Sie hochladen möchten, muss dem Dateiformat entsprechen.
File format | MIME type |
---|---|
APK | application/vnd.android.package-archive |
CSV | text/csv |
DOCX | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
GIF | image/gif |
HTML | text/html |
JPEG | image/jpeg |
JSON | application/json |
JSONL | application/jsonl |
MARKDOWN | text/markdown |
application/pdf | |
PEM | application/x-pem-file |
PNG | image/png |
SVG | image/svg+xml |
TIFF | image/tiff |
TSV | text/tab-separated-values |
TXT | text/plain |
WEBP | image/webp |
XLS | application/vnd.ms-excel |
XLSM | application/vnd.ms-excel.sheet.macroEnabled.12 |
XLSX | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
XML | application/xml |
ZIP | application/zip |
Vorsicht
Microsoft Office-Dokumente mit VBA-Makros werden aus Sicherheitsgründen abgelehnt.
Eine erfolgreiche Anfrage gibt ein File-Objekt zurück.
File API-Ressource abrufen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Um die API-Ressource für eine Datei abzurufen, stellen Sie eine GET-Anfrage an den Endpoint /v1/files der Subdomain files.stripe.com unter Angabe der ID für den Datei-Upload:
Dateiinhalte herunterladen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn der Dateizweck das Herunterladen des Dateiinhalts zulässt, dann enthält die Datei das Feld url
. Dieses ist nicht null und gibt die Zugriffsmöglichkeit auf den Inhalt an. Die URL erfordert eine Authentifizierung mit Ihren Stripe-API-Schlüsseln.
curl https://files.stripe.com/v1/files/
-u{{FILE_ID}}sk_test_4eC39HqLyjWDarjtT1zdp7dc
Wenn Sie nicht authentifizierten Zugriff auf eine Datei benötigen, deren Zweck das Herunterladen zulässt, dann können Sie durch Erstellen eines file_link anonyme Download-Links erzeugen.
Die file_link-Ressource verfügt über das Feld url
, das einen nicht authentifizierten Zugriff auf den Inhalt der Datei ermöglicht.
Datei verwenden![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem eine Datei hochgeladen wurde, kann die ID des Datei-Uploads in anderen API-Anfragen verwendet werden. So lässt sich beispielsweise eine hochgeladene Datei einer bestimmten Zahlungsanfechtung als Nachweis zuordnen.
Beachten Sie, dass Sie eine hochgeladene Datei nur in einer einzelnen API-Anfrage verwenden können.
Fehler beim Hochladen beheben![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie die File API zum Hochladen eines PDF-Dokuments verwenden, wird das Dokument einer Reihe von Prüfungen unterzogen, um die korrekte Formatierung und die Einhaltung der PDF-Spezifikationen sicherzustellen. Falls eine der Prüfungen für das Hochladen fehlschlägt, wird ein Fehler zurückgegeben.
Führen Sie folgende Schritte aus, um erkannte Fehler zu beheben:
- Entfernen Sie Kommentare oder sonstige dem Dokument hinzugefügte Medien.
- Wenn Sie Ihre Kommentare oder Medien nicht entfernen können oder wenn Sie mehrere PDF-Dateien zu einer zusammengefasst haben, können Sie mit der Funktion „Print to PDF” Ihres Computers ein neues Dokument erstellen.