Guthaben für verbundene Konten einrichtenPrivate Vorschau

Erfahren Sie, wie Sie Kreditbedingungen für Ihre verbundenen Konten konfigurieren und ihre Ausgaben über Ihre Plattform finanzieren können.

Was sind verbundene Konten?

Verbundene Konten sind separate Stripe-Konten, die Ihren Nutzerinnen und Nutzern (Händler/innen, Unternehmen oder Privatpersonen) gehören, aber über Ihre Plattform verwaltet werden. Betrachten Sie sie als Unterkonten Ihres Hauptkontos bei Stripe.

Wichtige Konzepte:

Ihr Plattform-Konto: Ihr Hauptkonto bei Stripe, über das Sie alle Vorgänge verwalten.
Verbundene Konten: Individuelle Konten für Ihre Nutzer/innen (z. B. eine/n Fitnessstudiobetreiber/in, eine/n Restaurantbesitzer/in, eine/n Freiberufler/in).
Kreditgewährung: Sie können Ihren verbundenen Konten Kredit gewähren, sodass diese Geld ausgeben können, das sie noch nicht besitzen und es Ihnen später zurückzahlen.

Beispielszenario:

Sie betreiben eine Plattform, die Fitnessstudiobetreiberinnen und -betreibern Business-Tools zur Verfügung stellt.
Jede/r Fitnessstudiobetreiber/in erhält ein eigenes verbundenes Konto
Sie können ihnen einen Kredit in Höhe von 5.000 USD für den Kauf von Ausrüstung gewähren.
Sie verwenden die Kreditmittel und zahlen Ihnen den Kreditbetrag am Monatsende zurück.

So funktionieren Kredite bei verbundenen Konten

Mit der Credit API werden die Kreditbedingungen für Ihre verbundenen Konten verwaltet. Je nach Ihrer Kreditrichtlinie mit Ihrem Bankpartner können Sie die verbundenen Konten auswählen, die für den Erhalt einer Gutschrift infrage kommen, deren Kreditlimit und -laufzeit festlegen und ihnen ermöglichen, am Ende ihrer Kreditlaufzeit Ausgaben zu tätigen und diese zurückzuzahlen.

Voraussetzungen

Registrieren Sie Ihre Plattform.
Fügen Sie Unternehmensdetails hinzu, um Ihr Konto zu aktivieren.
Vervollständigen Sie Ihr Plattform-Profil.
Passen Sie die Markeneinstellungen an. Für Connect Onboarding müssen ein Unternehmensname, ein Symbol und eine Markenfarbe hinzugefügt werden.
Die Beta von Issuing Credits wurde für Ihr Konto aktiviert. Kontaktieren Sie Ihre/n Stripe-Kontovertreter/in, um weitere Informationen zu erhalten.

Informationen zur Einrichtung finden Sie im Leitfaden zur Erstellung eines Custom Connect-Kontos.

Fordern Sie die Funktion Charge Card für Ihre verbundenen Konten an.

Zusätzlich zu der für die Kartenausstellung erforderlichen transfers-Funktion müssen Sie die Funktion card_issuing_charge_card für jedes verbundene Konto aktivieren, dessen Ausgaben Sie mit den verfügbaren Mitteln Ihrer Plattform unterstützen möchten (dazu gehören auch die Ressourcen Ihrer Plattform, wenn Sie von einer Vorfinanzierung Gebrauch machen). Mit der card_issuing_charge_card-Funktion kann ein verbundenes Konto Karten in seinem Konto ausstellen und Zahlungen im Rahmen seines Kreditlimits tätigen, vorausgesetzt, dass Ihr Issuing-Plattformkonto über ausreichende Mittel zur Deckung der dieser Zahlungen verfügt. Wenn Sie auf Ihrer Plattform ein neues verbundenes Konto erstellen, können Sie die Funktion card_issuing_charge_card auf die dieselbe Weise hinzufügen, wie Sie andere Funktionen anfordern. Für bestehende verbundene Konten können Sie die Funktion card_issuing_charge_card über den API-Aufruf Konto aktualisieren anfordern.

Melden Sie die Antragsdetails und das genehmigte Kreditlimit des Nutzers/der Nutzerin

Jedes Mal, wenn ein/e Nutzer/in einen Kreditantrag auf Ihrer Plattform ausfüllt und einreicht, erfassen Sie seine/ihre Antragsdetails sowie die Entscheidung über Genehmigung oder Ablehnung mit der Credit Underwriting Record API.

Verwenden Sie zunächst den Endpoint create_from_application, um den Zeitpunkt der Einreichung des Antrags sowie den Zweck (für neue Nutzer/innen credit_line_opening) und name und email des Antragstellers/der Antragstellerin im Hash credit_user aufzuzeichnen. Mit application_method können Sie angeben, wie Sie die Bewerbung erhalten haben. Wenn Sie jedoch keinen Wert angeben, wird standardmäßig online verwendet.

Beispielantwort

{
  "object": "issuing.credit_underwriting_record",
  "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX",
  "credit_user": {
    "name": "Barbell Gym",
    "email": "barbell-gym@gmail.com"
  },
  "created_from": "application",
  "application": {
    "purpose": "credit_line_opening",
    "submitted_at": 1681138952,
    "application_method": "online"
  },
  "decision_deadline": 1683601352 // 30 days after submission
}

Um den Antrag zu genehmigen, verwenden Sie den Endpoint report_decision-Endpoint mit der ID aus der Antwort und legen Sie den Entscheidungstyp auf credit_limit_approved fest und geben Sie den genehmigten Betrag an.

Alle eingegangenen Anträge müssen aufgezeichnet werden. Weitere Informationen dazu, wie Sie Anträge melden, die abgelehnt, unvollständig oder vom Antragsteller zurückgezogen wurden, finden Sie unter Melden von anderen Kreditentscheidungen.

Akzeptieren Sie die Konditionen der Charge Card, um die Funktion zu aktivieren

Nachdem die Funktion card_issuing_charge_card für ein verbundenes Konto beantragt wurde, aktivieren Sie die Funktion, indem Sie die card_issuing_charge_card-Anforderungen erfüllen und die Vereinbarungen für verbundene Konten akzeptieren, einschließlich (aber nicht beschränkt auf) die Allgemeinen Geschäftsbedingungen für die Zahlungskarte der Cross River Bank.

Diese Nutzungsbedingungen legen das Kreditverhältnis zwischen dem Bankpartner, der den Kredit gewährt, und dem verbundenen Konto fest. Sie müssen diese Bedingungen in Ihren Onboarding-Ablauf aufnehmen und die ausdrückliche Zustimmung Ihrer Nutzer/innen einholen.

Fügen Sie auch zusätzliche Nutzungsbedingungen der Zahlungskarte zwischen Ihnen und dem verbundenen Konto ein. Nehmen Sie die wichtigen Bedingungen auf, die in Ihrer Kreditrichtlinie mit dem Bankpartner festgelegt sind, wie Gebühren, Rückzahlungszeiträume, Prämien und Regeln für die Festlegung des Kreditlimits eines verbundenen Kontos. Erfassen Sie die Zustimmung in der API erst, nachdem das Konto den Bedingungen in Ihrem Onboarding-Verfahren zugestimmt hat.

Bestimmen Sie die Kreditlaufzeit und aktivieren Sie die Kreditlinie

Bitte lesen Sie vor dem Ausführen der in diesem Abschnitt beschriebenen Maßnahmen die Kreditrichtlinien Ihres Bankpartners.

Die CreditPolicy speichert das Kreditlimit und den Kreditzeitraum für Ihr verbundenes Konto.

Wenn die Funktion card_issuing_charge_card active wird, erstellt Stripe eine leere, inaktive CreditPolicy für das verbundene Konto und löst das Webhook-Ereignis issuing_credit_policy.created aus.

Um den credit_limit_amount festzulegen, müssen Sie denselben Betrag verwenden, den Sie in der Antragsentscheidung genehmigt haben. Andernfalls gibt CreditPolicy einen Fehler zurück.

Nehmen wir in unserem Beispiel von Gymbox an, dass Gymbox bei Barbell (einem Fitnessstudio) ein Kreditlimit von 1.000 USD verlängern möchte, das am 15. eines jeden Monats zurückgezahlt wird. Gymbox führt den folgenden Aufruf durch, um das verbundene Konto von Barbell zu konfigurieren:

Sie können die Eigenschaft credit_period_ends_on_days so einstellen, dass der Monat auf einen beliebigen Tag (1 bis 28) endet, oder Sie können 31 verwenden, um den letzten Tag des Monats festzulegen, unabhängig davon, wie viele Tage der Monat hat.

Beispielantwort

{
  "livemode": true,
  "credit_limit_amount": 100000,
  "credit_limit_currency": "usd",
  "status": "active",
  "credit_period_interval": "month",
  "credit_period_interval_count": 1,
  "credit_period_ends_on_days": [15],
  "days_until_due": 0,
  "last_effective_attributes": {
    "effective_until": "time_of_update",
    "credit_limit_amount": null,
    "credit_period_interval": null,
    "credit_period_interval_count": null,
    "credit_period_ends_on_days": null,
    "days_until_due": null,
    "status": "inactive",
  },
  "upcoming_attributes": null
}

Sie können die CreditPolicy gleichzeitig aktualisieren und aktivieren, wie oben abgebildet. Die Richtlinie können Sie auch separat aktivieren, nachdem Sie die Felder festgelegt haben.

Beispielantwort

{
  "livemode": true,
  "credit_limit_amount": 100000,
  "credit_limit_currency": "usd",
  "status": "active",
  "credit_period_interval": "month",
  "credit_period_interval_count": 1,
  "days_until_due": 1,
  "last_effective_attributes": {
    "effective_until": "time_of_update_to_active",
    "credit_limit_amount": 100000,
    "credit_period_interval": "month",
    "credit_period_interval_count": 1,
    "days_until_due": 1,
    "status": "inactive",
  },
  "upcoming_attributes": null
}

Jede dieser Aktionen löst separate Instanzen des Webhook-Ereignisses issuing_credit_policy.updated aus.

Nachdem Sie die CreditPolicy aktiviert haben, werden die verfügbaren Ausgaben Ihrer Plattform mit den Ausgaben aller Karten des verbundenen Kontos verrechnet, bis zu dem Kreditlimit, das Sie für das verbundene Konto festgelegt haben. Diese Karten greifen nur dann auf die verfügbaren Ausgaben Ihrer Plattform zurück, wenn auf dem Guthaben in Issuing des verbundenen Kontos nicht ausreichend Guthaben vorhanden ist.

Wenn auf dem Issuing-Guthaben des verbundenen Kontos kein Guthaben mehr vorhanden ist und das verbundene Konto sein Kreditlimit erreicht hat, lehnt Stripe Autorisierungen automatisch ab. Stripe erstellt eine FundingObligation, um Sie bei der Verwaltung und Überwachung des vom Konto geschuldeten Betrags während der gesamten Kreditlaufzeit zu unterstützen.

Mit dem Hash upcoming_attributes und dem effective_at-Zeitstempel können Sie das zukünftige Datum festlegen, an dem die Kreditlaufzeit einer Kreditrichtlinie, einschließlich des Startdatums ihrer Aktivierung, in Kraft treten.

Unter Verwalten von Kontoverpflichtungen finden Sie Informationen zur Verwendung der FundingObligation, um die Ausgaben und das ausstehende Guthaben Ihrer verbundenen Konten zu verfolgen.

Karten und Karteninhaber/innen erstellen

Nachdem Sie Ihr verbundenes Konto durch Aktivieren der CreditPolicy für Guthaben eingerichtet haben, können Sie virtuelle oder physische Karten für Ihr verbundenes Konto erstellen, um sie auf das jeweilige Kreditlimit anzuwenden.