Kreditbedingungen verwaltenPrivate Vorschau
Erfahren Sie, wie Sie die Kreditbedingungen für verbundene Konten verwalten.
Ändern Sie die Kreditbedingungen eines verbundenen Kontos, indem Sie den credit_limit_amount-CreditPolicy oder das credit_period_interval aktualisieren. Sie können auch die Option eines verbundenen Kontos deaktivieren, Gelder auszugeben, die vom Issuing-Konto Ihrer Plattform unterstützt werden, indem Sie den Status auf inactive setzen.
Aktualisieren Sie das Kreditlimit
Sie können das Kreditlimit eines verbundenen Kontos ändern, indem Sie die credit_-CreditPolicy aktualisieren, aber zuerst müssen Sie die Entscheidung über die Risikoevaluation über CreditUnderwritingRecord melden. Wenn Sie versuchen, credit_ zu aktualisieren, ohne zuvor denselben Betrag per CreditUnderwritingRecord zu melden, erhalten Sie eine Fehlermeldung.
Es gibt drei Szenarien für die Meldung von Entscheidungen über die Risikoevaluation zur Änderung eines Kreditlimits über die CreditUnderwritingRecord API:
Aktualisieren Sie in jedem Szenario nach Meldung der Entscheidung credit_ mit der CreditPolicy API auf den gleichen Betrag, den Sie genehmigt haben.
Diese Aktion löst das Webhook-Ereignis issuing_ aus und aktualisiert sofort das Feld credit_ in der CreditPolicy.
Beispielantwort
{ "livemode": true, "credit_limit_amount": 200000, // 2,000.00 USD "credit_limit_currency": "usd", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, "credit_limit_amount": 100000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active", }, "upcoming_attributes": null }
Aktualisieren Sie die Kreditlaufzeit
Der von Ihnen festgelegte Kreditzeitraum muss immer mit dem Kreditzeitraum übereinstimmen, der in Ihren von Ihrer Bank genehmigten Kreditrichtlinien festgelegt ist. Bevor Sie eine Kreditlaufzeit über die API ändern können, müssen Sie zunächst die Genehmigung von Stripe einholen, um die Kreditlaufzeit in Ihrem schriftlichen Kreditrichtliniendokument anpassen zu können. Möglicherweise müssen Sie den betroffenen Kontoinhaber/innen auch eine Änderung der Bedingungen mitteilen. Bitte wenden Sie sich an platform-compliance@stripe.com, um die erforderlichen Genehmigungen einzuholen, bevor Sie Maßnahmen ergreifen.
Sobald Sie die Genehmigung von Stripe erhalten haben, führen Sie die folgenden Schritte aus, um eine Kreditlaufzeit in der CreditPolicy API zu ändern. Sie müssen CreditUnderwritingRecord nicht verwenden, wenn Sie eine Kreditlaufzeit ändern.
Sie können die Kreditlaufzeit eines verbundenen Kontos ändern, indem Sie die Felder im Hash upcoming_attributes aktualisieren. Sie müssen einen effective_-Zeitstempel übergeben, wenn Sie die upcoming_ festlegen, um zu planen, wann die Änderungen wirksam werden sollen.
Nehmen wir anhand unseres vorherigen Beispiels an, dass die Plattform Gymbox beschließt, die Kreditlaufzeit ihres Kunden/ihrer Kundin von monatlich auf 15 Tage zu ändern, und die Plattform möchte, dass diese Änderung zu Beginn des nächsten Monats in Kraft tritt. Der Zeitstempel effective_ muss aus 10 Ziffern bestehen und auf 00 enden, da Stripe verlangt, dass alle durch upcoming_ vorgenommenen Änderungen um 00:00 UTC wirksam werden.
Die Plattform aktualisiert die CreditPolicy des verbundenen Kontos wie folgt mithilfe des Hashs upcoming_:
Beispielantwort
{ "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": 1681138965, // time of previous update to credit period "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active", }, "upcoming_attributes": { "effective_at": 1693526400, // 1st day of the next month, 00:00 UTC "credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, } }
Zum Zeitstempel effective_ wird die CreditPolicy automatisch auf das, was sich im Hash upcoming_ befindet, aktualisiert und der Hash last_ wird aktualisiert, um die Werte vor der Änderung widerzuspiegeln.
Beispielantwort
{ "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "active", "credit_period_interval": "day", "credit_period_interval_count": 15, "days_until_due": 0, "last_effective_attributes": { "effective_until": 1693526400, // 1st day of the next month, 00:00 UTC "credit_limit_amount": 200000, "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "status": "active" }, "upcoming_attributes": null }
Dies löst das Ereignis issuing_ aus. Zum effective_-Zeitstempel, wenn die Änderungen des Gutschriftszeitraums wirksam werden, wird die FundingObligation für den aktuellen Zeitraum finalisiert und eine neue FundingObligation wird erstellt, um den Beginn einer neuen Kreditlaufzeit unter den neuen Kreditbedingungen zu kennzeichnen.
Schließen Sie die Kreditlinie und geben Sie die Gründe an
Sie können die Kreditlinie des verbundenen Kontos schließen, indem Sie die folgenden zwei Schritte ausführen.
Verwenden Sie zunächst die CreditUnderwritingRecord API, um die Details der Entscheidung über den create_from_proactive_review-Endpoint zu übermitteln. Setzen Sie den Entscheidungstyp auf credit_ und geben Sie mindestens einen Grund an (bis zu vier sind möglich). Diese müssen die „wesentlichen“ Gründe für die Ablehnung des Antrags sein und mit den in Ihrer von der Bank genehmigten Kreditrichtlinie definierten Ablehnungsgründen übereinstimmen. Die Schließung einer Kreditlinie ist eine nachteilige Maßnahme, daher ist das Versenden einer Mitteilung mit den entsprechenden Schließungsgründen erforderlich. Eine vollständige Liste gültiger Entscheidungsgründe für credit_-Entscheidungen finden Sie hier.
Beispielantwort
{ "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": identifier("decisionTimestamp"), "decision": { "type": "credit_line_closed", "credit_line_closed": { "reasons": ["incomplete_application"] } }, "decision_deadline": null // no deadline for proactive review }
Setzen Sie als nächstes den CreditPolicy-Status des Kontos auf inactive.
Beispielantwort
{ "livemode": true, "credit_limit_amount": 200000, "credit_limit_currency": "usd", "status": "inactive", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, "last_effective_attributes": { "effective_until": "time_of_deactivation", "credit_limit_amount": 200000, "status": "active", "credit_period_interval": "month", "credit_period_interval_count": 1, "days_until_due": 1, }, "upcoming_attributes": null }
Diese Statusänderung löst das Ereignis issuing_ aus. Wenn Sie eine CreditPolicy deaktivieren, erhalten Sie für die nächsten 31 Tage weiterhin Aktualisierungen der FundingObligation, um alle gelöschten Transaktionen zu berücksichtigen, da Autorisierungen, die vor der Deaktivierung erfolgten bis zu 31 Tage später erfasst werden können.
Wenn das Issuing-Guthaben des verbundenen Kontos unter 0 liegt (was darauf hindeutet, dass das Konto Stripe Geld schuldet), erhalten Sie beim Versuch, CreditPolicy auf inactive zu setzen, eine Fehlermeldung, und Sie sollten das Guthaben aufstocken, um es auf Null zurückzusetzen und die CreditPolicy zu deaktivieren. Sobald der CreditPolicy-Status inactive ist, werden Autorisierungsversuche auf den Karten des Kontos durch das Issuing-Guthaben des Kontos finanziert und werden abgelehnt, wenn das Guthaben nicht ausreicht.
Sobald Sie die Kreditlinie geschlossen haben, indem Sie den Status auf inactive gesetzt haben, können Sie sie nicht wieder öffnen, indem Sie den Status zurück in active, es sei denn, der Kunde/die Kundin stellt einen neuen Antrag. Befolgen Sie in diesem Fall die Schritte, um einen neuen, genehmigten Kreditantrag zu melden.
Widerrufen Sie die Funktion card_issuing_charge_card capability.
Wenn Sie Ihr Issuing-Plattformkonto nicht mehr zur Unterstützung eines verbundenen Kontos nutzen, weil dieses nicht mehr die Underwriting-Kriterien Ihrer von der Bank genehmigten Kreditrichtlinie erfüllt oder gegen die allgemeinen Geschäftsbedingungen verstößt, lassen Sie dessen CreditPolicy inaktiv. Sie müssen außerdem die Funktion card_ widerrufen, indem Sie die Anfrage aufheben.
Sie können die Funktion card_ für dasselbe verbundene Konto erneut anfordern, wenn der/die Nutzer/in einen neuen Antrag einreicht. Befolgen Sie dazu die Schritte zur Einrichtung eines verbundenen Kontos mit Gutschrift.
Wenn für das verbundene Konto die card_-Funktion aktiviert ist, können Sie weiterhin Karten für das verbundene Konto ausstellen. Damit die Karten funktionieren, müssen Sie jedoch Geld zum Issuing-Guthaben des verbundenen Kontos hinzufügen.
Webhook-Übersicht
Zur Erinnerung, Sie können diese zwei Webhooks überwachen:
issuing_: Wird immer dann ausgelöst, wenn einecredit_ policy. created CreditPolicyerstellt wird. Dies geschieht, wenn die Funktion für das verbundene Konto angefordert wird.issuing_: Wird immer dann ausgelöst, wenn einecredit_ policy. updated CreditPolicyaktualisiert wird. Dies kann passieren, wenn die Plattform die Richtlinie des verbundenen Kontos aktualisiert.