Benutzerdefiniertes Capital-Programm erstellenPrivate Vorschau

Alle Nutzer/innen, die Capital-Angebote erhalten, sehen Ihren öffentlichen Unternehmensnamen, Ihr Symbol, Ihr Logo und Ihre Branding-Farbe in den Angebots-E-Mails, auf der Antrags- und der Finanzierungsberichtsseite.

Navigieren Sie zu den Branding-Einstellungen für Connect und stellen Sie sicher, dass die Branding-Einstellungen Ihrer Plattform korrekt sind.

Wir empfehlen die Verwendung von Testmodus-Tools zum Erstellen Ihrer Integration. Rufen Sie das Capital-Dashboard im Test-Modus auf.

1. Klicken Sie auf Erstellen, um das Modal Finanzierungsangebot erstellen zu öffnen, in dem Sie Finanzierungsangebote im Testmodus erstellen können. Mit den Standardoptionen wird ein nicht zugestelltes Finanzierungsangebot mit einem Darlehensbetrag von 1.000 USD erstellt.
2. Behalten Sie die Standardoptionen bei und klicken Sie auf Finanzierungsangebot erstellen.
3. Klicken Sie im Dashboard auf die Zeile, die dem von Ihnen erstellten Angebot entspricht.

Im Abschnitt „Darlehen und Finanzierung“ der Detailseite des verbundenen Kontos werden Einzelheiten zum Finanzierungsangebot der Nutzerin/des Nutzers angezeigt.

Mit dem Endpoint Finanzierungsangebote auflisten können Sie Finanzierungsangebote für alle Nutzer/innen Ihrer Plattform abrufen.

curl https://api.stripe.com/v1/capital/financing_offers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

Bei erfolgreicher Angebotserstellung wird eine Antwort ähnlich der Folgenden zurückgegeben:

{
  "object": "list",
  "url": "/v1/capital/financing_offers",
  "has_more": false,
  "data": [
    {
      "id": "financingoffer_abc123",
      "object": "capital.financing_offer",
      ...,
    },
    {...}
  ]
}

Sie können über den Endpoint Finanzierungsangebot abrufen nach einem Finanzierungsangebot suchen. Rufen Sie das erste Finanzierungsangebot aus der vorstehenden Liste ab.

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123 \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

Stripe sendet den Webhook capital.financing_offer.created, nachdem ein Finanzierungsangebot erstellt wurde. Aktualisieren Sie Ihre Webhook-Integration, um den Webhook capital.financing_offer.created zu überwachen. Wenn Sie Ihre eigenen Angebots-E-Mails versenden, ist der Webhook eine wichtige Benachrichtigung, um Nutzer/innen über Angebote zu informieren.

Verlinken Sie Nutzer/innen in der E-Mail mit einem speziellen Capital-Abschnitt in Ihrem Plattform-Dashboard. Nutzer/innen greifen über Konto-Links auf die Capital-Finanzierungsanwendung zu. Konto-Links laufen kurz nach ihrer Erstellung ab. Bieten Sie Nutzerinnen und Nutzern daher die Möglichkeit, den Anwendungs-Link neu zu erstellen. Fügen Sie einen Link zum Finanzierungsantrag in Ihr Plattform-Dashboard ein, indem Sie einen Konto-Link vom Typ capital_financing_offer generieren.

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d account=acct_123 \
  # The URL the user will be redirected to if the account link is expired, has been previously-visited, or is otherwise invalid.
  -d refresh_url="https://example.com/reauth" \
  # The URL the user will be redirected to after completing the linked flow.
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_offer

Wenn ein Konto-Link erfolgreich erstellt wurde, erhalten Sie eine Antwort ähnlich der folgenden:

{
  "object": "account_link",
  "created": 1611264596,
  "expires_at": 1611264896,
  "url": "https://connect.stripe.com/capital/offer/SrjgLUfa0O7K"
}

Nachdem Sie Ihre Webhook-Integration aktualisiert haben, erstellen Sie ein weiteres Angebot im Dashboard und verifizieren Sie den Erhalt des Webhooks capital.financing_offer.created.

Angebot als zugestellt kennzeichnen

Aktualisieren Sie Ihre Webhook-Integration, um das Finanzierungsangebot als zugestellt zu kennzeichnen, nachdem Sie die Angebots-E-Mail gesendet haben. Ein Angebot muss als zugestellt gekennzeichnet werden, um zu bestätigen, dass Sie das Angebot bei der Nutzerin/dem Nutzer beworben haben.

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123/mark_delivered \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

Verifizieren Sie mithilfe des Dashboards oder der Finanzierungsangebots-API, ob das Finanzierungsangebot übermittelt wurde.

Zusätzlich zum Webhook capital.financing_offer.created sendet Stripe zusätzliche Webhooks, wenn das Finanzierungsangebot verschiedene Zustände durchläuft. Im Folgenden finden Sie eine vollständige Liste der Webhooks, die Sie empfangen können:

Suchen Sie im Dashboard das zuvor zugestellte Angebot.

1. Klicken Sie auf das Überlaufmenü ().
2. Klicken Sie auf die Option Angebot ablaufen lassen, mit der Sie ein ablaufendes Angebot simulieren können.
3. Verifizieren Sie den Empfang des Webhooks capital.financing_offer.expired.

Mit Ausnahme von capital.financing_offer.canceled können Sie alle Webhooks mit Testmodus-Tools simulieren.

Sie können den Webhook capital.financing_offer.accepted simulieren, indem Sie ein Angebot beantragen.

1. Erstellen Sie im Dashboard ein zugestelltes Angebot mit einem maximalen Darlehensbetrag von 20.000 USD.
2. Generieren Sie einen Konto-Link vom Typ capital_financing_offer und navigieren Sie zu diesem Link. Hier sehen Sie in einer Vorschau, wie die Anwendung für Ihre Nutzer/innen aussieht.
3. Weiter bis zum Ende des Antrags und auf Absenden klicken.
4. Verifizieren Sie den Empfang des Webhooks capital.financing_offer.accepted.
5. Sehen Sie sich das Angebot im Dashboard an und prüfen Sie, ob es den Status „Angenommen“ hat.

Antrags-Tracker anzeigen

Ein Finanzierungsangebot mit dem Status „Angenommen“ wartet auf die Antragsprüfung durch das Stripe-Servicing-Team. Während dieser Überprüfung können Sie Nutzerin/den Nutzer zur Finanzierungsberichtsseite weiterleiten. Diese enthält einen Antrags-Tracker mit einem ungefähren Zeitplan für die Antragsprüfung.

Erstellen Sie einen Konto-Link vom Typ capital_financing_reporting.

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d account=acct_123 \
  # When the user refreshes the page, where should we redirect them
  -d refresh_url="https://example.com/reauth" \
  # When the user completes the application, where should they return
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_reporting

Navigieren Sie zum Link, um den Antrags-Tracker anzuzeigen.

Suchen Sie im Dashboard nach der Zeile, die dem angenommenen Angebot entspricht.

1. Klicken Sie auf das Überlaufmenü ().
2. Klicken Sie auf die Option Gelder genehmigen und auszahlen, mit der Sie eine Antragsgenehmigung und Auszahlung von Geldern simulieren können.
3. Verifizieren Sie den Empfang des Webhooks capital.financing_offer.paid_out, der Sie darüber informiert, dass die Finanzierung ausgezahlt wurde.
4. Erstellen Sie einen weiteren Konto-Link vom Typ capital_financing_reporting. Die Berichtsseite bietet jetzt Zugriff auf Auszahlungs- und Rückzahlungstransaktionsdetails für die laufende Finanzierung der Nutzer/innen.
5. Klicken Sie auf Zahlung ausführen und erstellen Sie eine Zahlungstransaktion.

Nachdem die Transaktion verarbeitet wurde, sehen Sie sich die Zahlung in der Transaktionstabelle an. Mit der Finanzierungsübersichts-API können Sie den von der Nutzerin/dem Nutzer abgezahlten Finanzierungsbetrag für laufende Finanzierungen programmgesteuert anzeigen.

curl https://api.stripe.com/v1/capital/financing_summary \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \

Wenn die Finanzierungsübersicht erfolgreich abgerufen wurde, erhalten Sie eine Antwort ähnlich der folgenden:

{
  "object": "capital.financing_summary",
  "details": {
    "currency": "usd",
    "advance_amount": 1000000,
    "fee_amount": 100000,
    "withhold_rate": 0.2,
    "remaining_amount": 999950,
    "paid_amount": 50,
    "current_repayment_interval": {
      "due_at": 123456789,
      "remaining_amount": 50,
      "paid_amount": 50
    },
    "repayments_begin_at": 123456789,
    "advance_paid_out_at": 123456789
  }
}

Suchen Sie im Dashboard nach der Zeile, die der ausgezahlten Finanzierung entspricht.

1. Klicken Sie auf das Überlaufmenü ().
2. Klicken Sie auf die Option Angebot zurückzahlen, mit der Sie die Rückzahlung eines Angebots simulieren können.
3. Verifizieren Sie den Empfang des Webhooks capital.financing_offer.fully_repaid, der Sie darüber informiert, dass die Finanzierung vollständig zurückgezahlt wurde.
4. Erstellen Sie einen weiteren Konto-Link vom Typ capital_financing_reporting.

Nachdem Nutzer/innen ihre Finanzierung zurückgezahlt haben, können sie jederzeit auf der Berichtsseite auf vergangene Finanzierungsdetails zugreifen.

Jetzt sollte auf Ihre Integration Folgendes zutreffen:

• Antwortet auf den Webhook capital.financing_offer.created, indem eine Angebots-E-Mail gesendet und das Angebot als zugestellt gekennzeichnet wird
• Zeigt den Link zu Finanzierungsanträgen in Ihrem Plattform-Dashboard an
• Zeigt den Link zur Finanzierungsberichterstattung in Ihrem Plattform-Dashboard an

Der Abschnitt „Capital“ Ihres Plattform-Dashboards kann je nachdem, in welcher Phase der Finanzierung sich die Nutzer/innen befinden, unterschiedlich angezeigt werden. Sehen Sie sich das Statusdiagramm unten an, um eine Liste möglicher Statuswerte für Finanzierungsangebote zu erhalten.

Wenn automatische Angebote im Live-Modus aktiviert sind, erstellt Stripe täglich automatisch Finanzierungsangebote für Ihre Nutzer/innen. Bevor Sie automatische Angebote aktivieren, müssen Sie Folgendes sicherstellen:

1. Bestätigen und aktualisieren Sie die E-Mail-Adressen Ihrer Nutzer/innen über das Comms Center. Um Anspruch auf eine Capital-Finanzierung zu haben, müssen Nutzer/innen eine E-Mail-Adresse bei Stripe hinterlegt haben. So können sie Transaktions-E-Mails wie Aktualisierungen zum Zahlungsfortschritt erhalten.
2. Kontaktieren Sie uns, um den Live-Zugriff auf die API für Finanzierungsangebote zu ermöglichen.

Zusätzliche Funktionen aktivieren

Einige Ihrer Nutzer/innen haben mit der Zeit möglicherweise Anspruch auf Refills. Bei Refills handelt es sich um zusätzliche Finanzierungsangebote, die an Nutzer/innen gesendet werden, die erhebliche Fortschritte bei der Rückzahlung ihrer laufenden Kredite gemacht haben. Befolgen Sie den Integrationsleitfaden für Refills, um Ihre Integration zu aktualisieren, damit Sie Refill-Finanzierungsangebote unterstützen können.

Wenn Sie Capital-Transaktionen in Ihr Plattform-Dashboard aufnehmen möchten, lesen Sie den Leitfaden für Reporting und Abgleich.