Komponente Capital-AntragPrivate Vorschau

Zeigen Sie einen End-to-End-Antragsablauf für die Capital-Finanzierung an.

Mit der Capital-Anmeldeformular-Komponente können Ihre berechtigten verbundenen Konten ein Anmeldeformular auf der Website oder dem Anmeldeformular Ihrer Plattform ausfüllen. Sie können ihren Angebotsbetrag und ihre Konditionen auswählen, Vertragsdetails einsehen und ihr Anmeldeformular einreichen.

Diese Komponente ähnelt der Komponente Capital Promotion, ruft jedoch das Anmeldeformular direkt auf und schließt pädagogische oder kommerzielle Inhalte aus. Verwenden Sie diese eingebettete Komponente, wenn Sie anpassen möchten, wie das Finanzierungsangebot und die Programminformationen für berechtigte verbundene Konten angezeigt werden sollen.

Bevor Sie beginnen

Eingebettete Komponenten können nur für verbundene Konten in den USA und im Vereinigten Königreich angezeigt werden.
Bevor Sie live gehen, müssen Sie automatische Angebote aktivieren und Ihre Integration zur Prüfung an Stripe übermitteln.
Wenn Sie die Komponente anzeigen, wird standardmäßig auf Inhalte von Stripe verwiesen. Sie können den Link zur Datenschutzerklärung und Funktionsweise von Capital für Plattformen durch Ihre entsprechende Dokumentation ersetzen.

Installieren eingebetteter Komponenten von Capital

Installieren Sie eine Beta-Version der Stripe SDKs, um Kontositzungen für Komponenten der privaten Vorschau zu erstellen:

Ruby >=15.5.0-beta.1
Python >=12.5.0b1
PHP >=17.6.0-beta.1
Node >=18.5.0-beta.1
.NET >=48.5.0-beta.1
Java >=29.5.0-beta.1
Go >=82.5.0-beta.1

Verwenden Sie die Beta-Version der clientseitigen Stripe-Bibliotheken, um Komponenten der privaten Vorschau zu rendern:

Installieren Sie die Bibliothek:

npm install --save @stripe/connect-js@preview

Wenn Sie React in Ihrer Anwendung verwenden:

npm install --save @stripe/react-connect-js@preview

Connect.js einrichten

Wenn Sie in Ihrem Anmeldeformular nicht bereits in Stripe eingebettete Komponenten verwenden, initialisieren Sie Connect.js, bevor Sie das Anmeldeformular integrieren.

Kontositzung erstellen

Geben Sie in Ihrer Anfrage zum Erstellen einer Kontositzung capital_financing_application im Parameter components an.

Anmeldeformular-Komponente anzeigen

Stellen Sie die Capital-Anmeldeformular-Komponente im Frontend dar:

Methode	Typ	Beschreibung	Standard
`setOnApplicationSubmitted`	`() => void`	Das verbundene Konto hat seinen Finanzierungsantrag erfolgreich eingereicht.
`setOnApplicationStepChange`	`({step: string}) => void`	Das verbundene Konto hat innerhalb des Anmeldeformulars einen Schritt durchlaufen.
`setPrivacyPolicyUrl`	`string`	Absolute URL einer Seite, die Ihre Datenschutzerklärung enthält.	`https://stripe.com/privacy`
`setHowCapitalWorksUrl`	`string`	Absolute URL einer Seite mit Informationen über das Capital-Programm.	`https://docs.stripe.com/capital/how-capital-for-platforms-works`

Anzeigestatus festlegen

Fügen Sie das Anmeldeformular auf einer Seite hinzu, die Ihre verbundenen Konten verwenden, um Informationen zu Zahlungen und Auszahlungen anzuzeigen, oder auf einer speziellen Seite Finanzierung in der Nutzeroberfläche Ihrer Plattform. Verwenden Sie (falls zutreffend) einen anderen Standort als die Connect-Werbekomponente.

Um festzustellen, ob ein verbundenes Konto für ein Angebot infrage kommt, rufen Sie den Endpoint Finanzierungsangebote auflisten und übergeben Sie die ID des verbundenen Kontos im Parameter connected_account.

Das Anmeldeformular zeigt Inhalte dynamisch basierend auf dem Finanzierungsstatus des verbundenen Kontos an:

Keine aktive Finanzierung: Wenn für ein Konto kein förderfähiges Finanzierungsangebot vorliegt, wird das Anmeldeformular nicht angezeigt (gibt null zurück).
Mit aktivem Angebot: Wenn das verbundene Konto für ein Angebot berechtigt ist, zeigt die Komponente vollständige Angebotsdetails mit der Schaltfläche Anmeldeformular starten an.
Angebot wird geprüft: Nachdem ein berechtigtes verbundenes Konto ein Finanzierungsangebot angenommen und beantragt hat, verwenden Sie diesen Status, um den Status eines Anmeldeformulars anzuzeigen. Überwachen Sie das Ereignis onApplicationStepChange, um den Fortschritt des Angebots zu verfolgen. Dieses Ereignis wird ausgegeben, wenn das verbundene Konto zum nächsten Schritt übergeht oder zu einem vorherigen Schritt oder einer vorherigen Seite im Capital-Anmeldeformular zurücknavigiert. Der Name des nächsten Schritts wird dem Handler zur Verfügung gestellt, den Sie im Schrittfeld angeben. Diese Schritte können in beliebiger Reihenfolge angezeigt und wiederholt werden. Sie können die Schrittnamen jederzeit ändern, hinzufügen und entfernen.
Verwenden Sie das onApplicationStepChange-Objekt nur für Analysezwecke, z. B. zur Verfolgung der durchschnittlichen Seitenabschlusszeit oder der Seiten mit dem größten Abfall. Verwenden Sie das onApplicationStepChange-Objekt nicht, um Betriebs- oder Support-Workflows auszulösen, z. B. das Senden von E-Mails an verbundene Konten, die das Anmeldeformular auf einer bestimmten Seite gestoppt haben.
Angebot eingereicht: Wenn ein verbundenes Konto seinen Finanzierungsantrag bereits eingereicht hat, wird in der Capital-Finanzierungsantrag-Komponente ein leerer Bildschirm dargestellt. Überwachen Sie das `onApplicationSubmitted``-Ereignis, um stattdessen einen Bestätigungsbildschirm anzuzeigen.
Aktive Finanzierung läuft: Die Komponente wird nicht angezeigt (gibt null zurück).

Der onApplicationStepChange-Typ

Der Typ onApplicationStepChange ist in connect.js definiert. Jedes Mal, wenn das verbundene Konto im Rahmen des Capital-Antragsprozesses von einem Schritt zum nächsten navigiert, erhält der Schrittwechsel-Handler ein onApplicationStepChange-Objekt mit der folgenden Eigenschaft:

Name	Typ	Beispielwert
`step`	`string` (muss ein gültiger Schrittname sein)	`business_type`
Der eindeutige Verweis auf einen Onboarding-Schritt.

Schrittnamen

Jede Seite in einem Onboarding-Ablauf hat einen der folgenden Schrittnamen.

Schrittname	Beschreibung
`stripe_user_authentication`	Verarbeitet die Authentifizierung der Nutzerin/des Nutzers über ein von Stripe gehostetes Fenster, um die Identität zu überprüfen und den Finanzierungsablauf abzusichern.
`offer_selector`	Führt verbundene Konten in den Finanzierungsantrag ein und bietet einen Überblick über das Angebot und die Finanzierung.
`offer_summary`	Zeigt eine detaillierte Zusammenfassung des Finanzierungsangebots, einschließlich der wichtigsten Konditionen.
`business_details`	Erfasst detaillierte Informationen zum Unternehmen des verbundenen Kontos, wie Geschäftsadresse, Branche und betriebliche Besonderheiten.
`business_verification`	Sammelt Dokumente und Informationen, die die Existenz und Rechtmäßigkeit der Geschäftseinheit des verbundenen Kontos bestätigen.
`business_summary`	Bietet eine Übersicht über alle während des Onboardings übermittelten geschäftsbezogenen Informationen, damit das verbundene Konto die Angaben bestätigen oder aktualisieren kann.
`owners`	Erfasst Informationen über die wirtschaftlichen Eigentümer/innen des Unternehmens, das eine Finanzierung beantragt.
`directors`	Erfasst, falls zutreffend, Angaben zu den Geschäftsführerinnen und Geschäftsführern des Unternehmens.
`executives`	Erfasst Informationen über wichtige Führungskräfte, die mit dem Unternehmen verbunden sind.
`representative_details`	Erfasst Informationen über die Einzelperson, die das Unternehmen im Finanzierungsantrag vertritt.
`representative_additional_document`	Ermöglicht es dem verbundenen Konto, zusätzliche Dokumente hochzuladen, die die Identität oder Befugnis der Vertreterin/des Vertreters bestätigen.
`representative_document`	Erfasst einen amtlichen Ausweis oder ein gleichwertiges Dokument, das die Identität der Unternehmensvertreterin/des Unternehmensvertreters bestätigt.
`person_summary`	Bietet eine Übersicht über alle personenbezogenen Informationen (Eigentümerinnen/Eigentümer, Vertreterinnen/Vertreter, Führungskräfte), die übermittelt wurden und ermöglicht Aktualisierungen oder Korrekturen.
`offer_annual_revenue`	Erfasst Informationen zum Jahresumsatz des verbundenen Kontos, um die Finanzierungsberechtigung und -bedingungen zu bewerten.
`offer_financial_data`	Fordert zusätzliche Finanzdokumente und Daten an, die für die Risikoevaluation und Genehmigung des Finanzierungsangebots erforderlich sind.
`offer_missing_contact_info`	Fordert das verbundene Konto auf, fehlende Kontaktinformationen, die für den Finanzierungsantrag relevant sind, anzugeben oder zu aktualisieren.
`offer_payout_details`	Erfasst Details zu Zahlungen und Auszahlungen, um die Auszahlung von Finanzierungsgeldern auf das Bankkonto des verbundenen Kontos zu erleichtern.
`lending_network_offer_review_agreements`	Bietet verbundenen Konten spezielle Vereinbarungen über Finanzierungsangebote, die über das Kreditnetzwerk von Stripe zur Überprüfung und Annahme bereitgestellt werden.
`offer_review_agreements`	Zeigt die rechtlichen Vereinbarungen und Bedingungen des ausgewählten Finanzierungsangebots zur Prüfung und Zustimmung durch das verbundene Konto an.
`offer_complete`	Bestätigt, dass das Finanzierungsangebot eingereicht wurde und der Antragsprozess abgeschlossen ist.

Einschränkungen für einzelne Schritte

Das StepChange-Objekt dient ausschließlich der Analyse.
Schritte können in beliebiger Reihenfolge angezeigt und wiederholt werden.
Die Liste der gültigen Schrittbezeichnungen kann jederzeit und ohne Vorankündigung geändert werden.

Komponente zur Prüfung einreichen

Um eine der Capital-Komponenten im Live-Modus verwenden zu können, müssen Stripe und unsere Finanzpartner alle für Kund/innen sichtbaren Inhalte prüfen und genehmigen, die sich auf Stripe Capital beziehen:

Erstellen Sie ein Testangebot in einer Sandbox und legen Sie den Status des Angebots auf delivered fest. Verwenden Sie dieses Testangebot zur Vorschau des Anmeldeformulars auf der Website oder im Dashboard Ihrer Plattform.
Erfassung einer Vorschau des Sandbox-Angebots und der Anzeige der eingebetteten Komponente auf der Nutzeroberfläche Ihrer Plattform (z. B. Screenshots oder ein aufgezeichnetes Video).
Übermitteln Sie die Vorschau an Stripe. Nach der Genehmigung können Sie die Komponente mit Stripe im Live-Modus verwenden.

OptionalZusätzliche eingebettete Komponenten

Die Anmeldeformular-Komponente ist eine von mehreren eingebetteten Komponenten, die für Capital für Plattformen verfügbar sind. Sie können beispielsweise die Capital Finance- Komponente einbetten, mit der Ihre verbundenen Konten ihre Zahlungen verwalten und Transaktionen anzeigen können.

Siehe auch

Eingebettete Capital-Komponenten einrichten