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.
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
- Register your platform.
- 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 `card_issuing_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_ 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_-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_ auf die dieselbe Weise hinzufügen, wie Sie andere Funktionen anfordern. Für bestehende verbundene Konten können Sie die Funktion 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_) 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_ 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 Nutzungsbedingungen der Charge Card, um die Funktion `card_issuing_charge_card` zu aktivieren
Nachdem die Funktion card_ für ein verbundenes Konto beantragt wurde, aktivieren Sie die Funktion, indem Sie die 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_ active wird, erstellt Stripe eine leere, inaktive CreditPolicy für das verbundene Konto und löst das Webhook-Ereignis issuing_ aus.
Um den credit_ 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_ 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_ 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_-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
After you set up your connected account for credit by activating the CreditPolicy, you can generate virtual or physical cards for your connected account to use against their credit limit.