# Kreditbedingungen verwalten Erfahren Sie, wie Sie die Kreditbedingungen für verbundene Konten verwalten. Ändern Sie die Kreditbedingungen eines verbundenen Kontos, indem Sie den [credit_limit_amount](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-credit_limit_amount)-CreditPolicy oder das [credit_period_interval](https://docs.stripe.com/api/issuing/credit_policy/object.md#issuing_credit_policy_object-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_limit_amount`-CreditPolicy aktualisieren, aber zuerst müssen Sie die Entscheidung über die Risikoevaluation über CreditUnderwritingRecord melden. Wenn Sie versuchen, `credit_limit_amount` 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: #### Erhöhung des Kreditlimits genehmigen ## Genehmigen Sie die Anfrage eines Kontos auf Erhöhung des Kreditlimits Wenn ein verbundenes Konto ein höheres Kreditlimit anfordert, melden Sie die Anfrage zuerst als Antrag und melden Sie dann die Entscheidung zur Genehmigung oder Ablehnung. Melden Sie die Anfrage des Kontos über den Endpoint [create_from_application](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md) der CreditUnderwritingRecord-API. Setzen Sie den [Zweck](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_application.md#create_from_application-application-purpose) des Antrags auf `credit_limit_increase` und verwenden Sie `submitted_at`, um das Datum und die Uhrzeit anzugeben, zu der der Kunde/die Kundin seine/ihre Anfrage eingereicht hat. Auch wenn es sich um eine/n bestehende/n Nutzer/in handelt, müssen Sie `name` und `email` im Hash `credit_user` angeben. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_application \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "application[purpose]=credit_limit_increase" \ -d "application[submitted_at]=1681138952" ``` ### Beispielantwort ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "application", "application": { "purpose": "credit_limit_increase", "submitted_at": 1681138952, "application_method": "online" }, "decision_deadline": 1683601352 // 30 days after submission } ``` Der zweite Schritt besteht darin, den Antrag mithilfe des Endpoints [report_decision](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md) zu genehmigen oder abzulehnen. Melden Sie die Entscheidung vor der [decision_deadline](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision_deadline), 30 Tage nachdem der Kunde/die Kundin seinen/ihren Antrag eingereicht hat. Setzen Sie den [decision type](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-type) auf `credit_limit_approved`, um den Antrag zu genehmigen und geben Sie den genehmigten Betrag an. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/{{CREDITUNDERWRITINGRECORD_ID}}/report_decision \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=200000" \ -d "decision[credit_limit_approved][currency]=usd" ``` Um stattdessen einen Antrag abzulehnen, führen Sie die gleichen Schritte wie oben beschrieben aus, legen Sie jedoch den Entscheidungstyp auf `application_rejected` fest und geben Sie die Gründe für die Ablehnung in [application_rejected.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-application_rejected-reasons) an. Weitere Informationen zu diesem Szenario finden Sie unter [Einen Antrag auf Erhöhung des Kreditlimits unter Angabe von Grnden ablehnen](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#reject-application). #### Erhöhen Sie das Kreditlimit proaktiv ## Erhöhen Sie ein Kreditlimit proaktiv ohne Antrag des Kunden/der Kundin Um das Kreditlimit eines verbundenen Kontos zu erhöhen, ohne dass der Kunde/die Kundin dies beantragt, melden Sie die Entscheidung in einem Schritt über den CreditUnderwritingRecord [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md)-Endpoint (erfahren Sie mehr unter [Melden von proaktiven Risikoevaluationsentscheidungen](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions). Setzen Sie den [Entscheidungstyp](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type) auf `credit_limit_approved` und geben Sie den neuen Betrag in [credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount) an. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_approved" \ -d "decision[credit_limit_approved][amount]=2000000" \ -d "decision[credit_limit_approved][currency]=usd" ``` ### Beispielantwort ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_approved", "credit_limit_approved": { "amount": 2000000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` #### Senken Sie das Kreditlimit proaktiv ## Senken Sie ein Kreditlimit und geben Sie die Gründe an Um das Kreditlimit eines verbundenen Kontos zu senken, melden Sie die Entscheidung Ihrer Plattform in einem Schritt über den CreditUnderwritingRecord [create_from_proactive_review](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md)-Endpoint (erfahren Sie mehr unter [Melden von proaktiven Risikoevaluationsentscheidungen](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#make-proactive-decisions). Legen Sie den [Entscheidungstyp](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-type) auf `credit_limit_decreased` fest und geben Sie den neuen Betrag in [credit_limit_approved.amount](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/report_decision.md#report_decision-decision-credit_limit_approved-amount) an. Da es sich bei der Reduzierung eines Kreditlimits um eine nachteilige Maßnahme handelt, müssen Sie aus der Liste der Gründe in [credit_limit_decreased.reasons](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md#create_from_proactive_review-decision-credit_limit_decreased-reasons) auch mindestens einen (und bis zu vier) `reasons` für die Reduzierung angeben. Dies müssen die „Hauptgründe“ für die Ablehnung des Antrags sein und sie müssen mit den Ablehnungsgründen übereinstimmen, die in Ihrer von der Bank genehmigten Kreditrichtlinie definiert sind. Ablehnungsmitteilungen müssen alle von Ihnen angegebenen Gründe enthalten (siehe [Versenden von E-Mails über nachteilige Maßnahmen](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#sending-adverse-action-notice-emails)). ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_limit_decreased" \ -d "decision[credit_limit_decreased][reasons][]=debt_to_cash_balance_ratio_too_high" \ -d "decision[credit_limit_decreased][reasons][]=runway_too_short" \ -d "decision[credit_limit_decreased][amount]=500000" \ -d "decision[credit_limit_decreased][currency]=usd" ``` ### Beispielantwort ```json { "object": "issuing.credit_underwriting_record", "id": "cur_1NiHAD2eZvKYlo2CmWGpt5OX", "credit_user": { "name": "Barbell Gym", "email": "barbell-gym@gmail.com" }, "created_from": "proactive_review", "decided_at": 1681138965, "decision": { "type": "credit_limit_decreased", "credit_limit_decreased": { "reasons": ["debt_to_cash_balance_ratio_too_high", "runway_too_short"], "amount": 500000, "currency": "usd" } }, "decision_deadline": null // no deadline for proactive review } ``` > Seien Sie vorsichtig, wenn Sie den `credit_limit_amount` für ein Konto verringern, da dies zu einer sofortigen Ablehnung der Autorisierung führen kann, wenn das Konto bereits mehr als den neuen `credit_limit_amount` ausgegeben hat. Aktualisieren Sie in jedem Szenario nach Meldung der Entscheidung `credit_limit_amount` mit der CreditPolicy API auf den gleichen Betrag, den Sie genehmigt haben. ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d credit_limit_amount=200000 ``` Diese Aktion löst das Webhook-Ereignis `issuing_credit_policy.updated` aus und aktualisiert sofort das Feld `credit_limit_amount` in der `CreditPolicy`. ### Beispielantwort ```json { "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](mailto: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](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-upcoming_attributes) aktualisieren. Sie müssen einen `effective_at`-Zeitstempel übergeben, wenn Sie die `upcoming_attributes` 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_at` muss aus 10 Ziffern bestehen und auf 00 enden, da Stripe verlangt, dass alle durch `upcoming_attributes` vorgenommenen Änderungen um 00:00 UTC wirksam werden. Die Plattform aktualisiert die `CreditPolicy` des verbundenen Kontos wie folgt mithilfe des Hashs `upcoming_attributes`: ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "upcoming_attributes[credit_period_interval]=day" \ -d "upcoming_attributes[credit_period_interval_count]=15" \ -d "upcoming_attributes[effective_at]={{EFFECTIVEATTIMESTAMP_ID}}" \ -d "upcoming_attributes[days_until_due]=0" ``` ### Beispielantwort ```json { "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_at` wird die `CreditPolicy` automatisch auf das, was sich im Hash `upcoming_attributes` befindet, aktualisiert und der Hash `last_effective_attributes` wird aktualisiert, um die Werte vor der Änderung widerzuspiegeln. ### Beispielantwort ```json { "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_credit_policy.updated` aus. Zum `effective_at`-Zeitstempel, wenn die Änderungen des Gutschriftszeitraums wirksam werden, wird die [FundingObligation](https://docs.stripe.com/api/issuing/funding_obligations.md) 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](https://docs.stripe.com/api/issuing/credit_underwriting_record_api/create_from_proactive_review.md)-Endpoint zu übermitteln. Setzen Sie den Entscheidungstyp auf `credit_line_closed` 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](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans.md#credit-line-closed), daher ist das Versenden einer Mitteilung mit den entsprechenden Schließungsgründen erforderlich. Eine [vollständige Liste gültiger Entscheidungsgründe](https://docs.stripe.com/api/issuing/credit_underwriting_record/object.md#credit_underwriting_record_object-decision-credit_line_closed-reasons) für `credit_line_closed`-Entscheidungen finden Sie hier. ```curl curl https://api.stripe.com/v1/issuing/credit_underwriting_records/create_from_proactive_review \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "credit_user[name]=Barbell Gym" \ --data-urlencode "credit_user[email]=barbell-gym@gmail.com" \ -d "decided_at={{DECISIONTIMESTAMP_ID}}" \ -d "decision[type]=credit_line_closed" \ -d "decision[credit_line_closed][reasons][]=incomplete_application" ``` ### Beispielantwort ```json { "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](https://docs.stripe.com/api/issuing/credit_policy/update.md#update_issuing_credit_policy-status) des Kontos auf `inactive`. ```curl curl https://api.stripe.com/v1/issuing/credit_policy \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; issuing_credit_beta=v1; issuing_underwritten_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=inactive ``` ### Beispielantwort ```json { "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_credit_policy.updated` aus. Wenn Sie eine `CreditPolicy` deaktivieren, erhalten Sie für die nächsten 31 Tage weiterhin Aktualisierungen der `FundingObligation`, um alle gelöschten [Transaktionen](https://docs.stripe.com/api/issuing/transactions/object.md) zu berücksichtigen, da Autorisierungen, die vor der Deaktivierung erfolgten bis zu 31 Tage später erfasst werden können. Wenn das [Issuing-Guthaben](https://docs.stripe.com/issuing/connect/funding.md) 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](https://docs.stripe.com/issuing/connect/funding.md) 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](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#record-application-details) 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_issuing_charge_card` widerrufen, indem Sie die Anfrage aufheben. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "capabilities[card_issuing_charge_card][requested]=false" ``` Sie können die Funktion `card_issuing_charge_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](https://docs.stripe.com/issuing/credit/connect-credit-setup.md#activate-funding-credit). Wenn für das verbundene Konto die `card_issuing`-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](https://docs.stripe.com/issuing/connect/funding.md) des verbundenen Kontos hinzufügen. ## Webhook-Übersicht Zur Erinnerung, Sie können diese zwei Webhooks überwachen: - `issuing_credit_policy.created`: Wird immer dann ausgelöst, wenn eine `CreditPolicy` erstellt wird. Dies geschieht, wenn die Funktion für das verbundene Konto angefordert wird. - `issuing_credit_policy.updated`: Wird immer dann ausgelöst, wenn eine `CreditPolicy` aktualisiert wird. Dies kann passieren, wenn die Plattform die Richtlinie des verbundenen Kontos aktualisiert.