# Pflichtbeträge, Transaktionen und Anpassungen Zeigen Sie Details zu einer FundingObligation an und nehmen Sie Anpassungen vor. Im Laufe der Zeit wird ein verbundenes Konto mehrere ausgezahlte (oder `past_due`) `FundingObligation`-Instanzen und höchstens eine einzige aktuell ausstehende `FundingObligation` haben. Um die `FundingObligation` für den aktuellen Zeitraum abzurufen, führen Sie diesen Befehl aus: ```curl curl -G https://api.stripe.com/v1/issuing/funding_obligations \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d limit=1 ``` ## Beispiel für eine Antwort auf eine Einzahlungsverpflichtung ```json [ { "id": "ifo_123", "livemode": true, "created": 1654628149, "amount_total": 10000, "amount_outstanding": 10000, "amount_paid": 0, "currency": "usd", "status": "unpaid", "due_at": 1654714851, "owed_to": "acct_123", "credit_period_starts_at": 1654625149, "credit_period_ends_at":1654713851, "paid_at": null, "finalized_at": 1654713860 } ] ``` Um `FundingObligations` mit einem bestimmten Status abzurufen, übergeben Sie den spezifischen Statuswert, wenn Sie eine Liste von `FundingObligations` anfordern. Dieser API-Aufruf ruft `FundingObligations` mit dem `status` `past_due` ab: ```curl curl -G https://api.stripe.com/v1/issuing/funding_obligations \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=past_due ``` ## Anpassungen des Hauptbuchs an Kontoverpflichtungen Mit der Credit Ledger API können Sie Einblicke in Off-Card-Transaktionsaktivitäten, die im normalen Geschäftsverlauf auftreten, aufzeichnen und warten. Mit den Credit Ledger APIs können Sie: 1. [Konto für Off-Card-Transaktionsaktivitäten zur Anpassung des verfügbaren Guthabens und der Finanzierungsverpflichtungen](https://docs.stripe.com/issuing/credit/manage-account-obligations/obligations-transactions-adjustments.md#account-for-off-card-transaction-activity) 1. [Den verfügbaren Guthabenbetrag eines Kontos abrufen](https://docs.stripe.com/issuing/credit/manage-account-obligations/available-credit.md) 1. [Fassen Sie sowohl Anpassungen als auch Kartenausgabenaktivitäten in einer einzigen Abrechnung zusammen](https://docs.stripe.com/issuing/credit/manage-account-obligations/obligations-transactions-adjustments.md#get-fundingobligation-transactions) | Guthabenanpassungen | Lastschriftanpassungen | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Guthabenanpassungen *verringern* den Betrag, der Ihnen von einem verbundenen Konto geschuldet wird. Sie *erhöhen* das verfügbare Guthaben des verbundenen Kontos. Beispiele sind: - Rückerstattung - Prämien und Rabatte - FO-Rückzahlung - Rückzahlung von Aufwendungen außerhalb der Richtlinie | Lastschriftanpassungen *erhöhen* den Betrag, der Ihnen von einem verbundenen Konto geschuldet wird. Sie *verringern* das verfügbare Guthaben des verbundenen Kontos. Beispiele sind: - Stornierungen von Guthabenanpassungen - Übermäßige CA-Zahlungssanierung (einschließlich Guthabenrückerstattungen) | Um die Anwendung von Anpassungen auf das Hauptbuch eines verbundenen Kontos zu demonstrieren, nehmen wir an, dass Barbell (eines der verbundenen Konten von Gymbox) ein Kreditlimit von 1.000 USD hat und eine Schichtleiterin/ein Schichtleiter ihre/seine Barbell Charge Card verwendet hat, um zum Mittagessen zwei Proteinriegel für 10 USD zu kaufen. Die Ausgabenrichtlinie von Barbell verbietet jedoch diese Art von persönlichen Ausgaben, und der/die Karteninhaber/in muss Barbell den Betrag durch einen Gehaltsabzug aus eigener Tasche zurückzahlen. Die folgende Tabelle beschreibt die Abfolge von Ereignissen auf Stripe unter Verwendung der Credit Ledger API. Alle in dieser Tabelle gezeigten Beträge und Wertänderungen sind reine Buchübertragungen. Während dieses Vorgangs werden keine echten Gelder bewegt. | AKTION | ISSUING-GUTHABEN VON BARBELL (VERBUNDENES KONTO) | EINZAHLUNGSVERPFLICHTUNG VON BARBELL AN GYMBOX | VERFÜGBARES GUTHABEN VON BARBELL | ISSUING-GUTHABEN VON GYMBOX (PLATTFORM) | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ---------------------------------------------- | -------------------------------- | --------------------------------------- | | Barbell beginnt mit einem Guthaben von 0 USD und 100 USD vorherige Ausgaben. Gymbox startete mit einem Guthaben von 10000 USD, das für eine zuvor erfasste Transaktion verringert wurde. | 0 USD | 100 USD | 900 USD | 9.900 USD | | Der Karteninhaber tätigt eine weitere Transaktion in Höhe von 10 USD, die autorisiert ist, da das Issuing-Guthaben von Gymbox groß genug ist, um den Ausgabenbetrag zu decken. Das Issuing-Guthaben von Gymbox verringert sich aufgrund der Autorisierungssperre um 10 USD. | -10 USD | 100 USD | 900 USD | 9.890 USD | | Beim Autorisierungs-Clearing (in der Regel am nächsten Tag): 1. Löscht Stripe die Autorisierung, 2. Verringert sich das Guthaben von Gymbox um 10 USD und erhöht sich das Guthaben von Barbell um 10 und 3. Erhöht sich die FundingObligation von Barbell um 10 USD | 0 USD | 110 USD | 890 USD | 9.890 USD | | Barbell erhält die Zahlung von ihrem Schichtleiter/ihrer Schichtleiterin und überweist 10 USD zurück an Gymbox. Gymbox wendet eine entsprechende Guthabenanpassung in Höhe von 10 USD an. | 0 USD | 100 USD | 900 USD | 9.890 USD | | Am Ende des Kreditzeitraums beschließt Gymbox, seinem langjährigen Kunden Barbell eine Gutschrift in Höhe von 50 USD für seine Treue zu gewähren. Gymbox meldet eine Guthabenanpassung von 50 USD für Barbell. | 0 USD | 50 USD | 950 USD | 9.890 USD | | Unmittelbar nach dem Senden der Guthabenanpassung stellt Gymbox fest, dass die ausgestellte Gutschrift zu groß war. Um die Gutschrift auf der Abrechnung zu korrigieren, meldet Gymbox eine Lastschriftanpassung von 20 USD an die Verpflichtungen von Barbell. | 0 USD | 70 USD | 970 USD | 9.890 USD | ### Konto für Off-Card-Transaktionsaktivitäten Stripe erstellt automatisch ein Kreditbuch für alle Nutzer/innen, die das Oboarding für die Verwendung der Charge Card abgeschlossen haben. Im Laufe der Zeit hat ein verbundenes Konto Ausgaben durch Transaktionen angesammelt und seine `FundingObligations` und das verfügbare Guthaben werden anhand dieser Kartenausgabenaktivität angepasst. Um eine Anpassung vorzunehmen und einen entsprechenden Kreditbucheintrag zu erstellen (zum Beispiel für ein Kundenbindungsguthaben von 50 USD), führen Sie diesen Befehl aus: ```curl curl https://api.stripe.com/v1/issuing/credit_ledger_adjustments \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount_type=credit \ -d amount=5000 \ -d currency=usd \ -d reason=platform_issued_credit_memo \ -d "reason_description=Customer loyalty reward credited to account" \ -d "funding_obligation={{FUNDINGOBLIGATION_ID}}" ``` ### Beispielantwort ```json { "id": "cla_1IC5a2ILABoM8KJZ2EgdP4Tb", "object_type": "issuing_credit_ledger_adjustment", "reason": "platform_issued_credit_memo", "reason_description": "Customer loyalty reward credited to account", "amount": 5000, "currency": "usd", "funding_obligation": identifier("fundingObligation"), "livemode": false } ``` Dann können Sie Ihrem Kunden/Ihrer Kundin eine Liste der Lastschrift- und Guthabenanpassungen anzeigen, die im aktuellen Kreditzeitraum auf seinem/ihrem Konto vorgenommen wurden. Dazu können Sie den Endpunkt `credit_ledger_adjustments` aufrufen, wobei die Parameter `stripe_account` und `funding_obligation` ausgefüllt sind. ```curl curl -G https://api.stripe.com/v1/issuing/credit_ledger_adjustments \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "funding_obligation={{FUNDINGOBLIGATION_ID}}" ``` ### Beispielantwort ```json { "object": "list", "url": "/v1/issuing/credit_ledger_adjustments", "has_more": false, "data": [ { "id": "icla_1IC5a2ILABoM8KJZ2EgdP4Tb", "object_type": "issuing_credit_ledger_adjustment", "created": 1605236462, "amount": 50000, "currency": "usd", "reason": "platform_issued_credit_memo", "funding_obligation": identifier("fundingObligation"), "livemode": false }, // ... more objects ] } ``` Um zu bestätigen, dass der `amount_outstanding` für die entsprechende `FundingObligation` um den Anpassungsbetrag der Gutschrift reduziert wurde, rufen Sie die FundingObligation ab oder überwachen Sie den Webhook `issue_funding_obligation.updated`. ## Ausgabenaktivität für eine FundingObligation abrufen Um eine Ansicht der Ausgabenaktivität über kartenbasierte Transaktionsautorisierungen, ausgeglichene Transaktionen, Rückzahlungen und [Off-Card-Transaktionsanpassungen](https://docs.stripe.com/issuing/credit/manage-account-obligations/obligations-transactions-adjustments.md#ledger-adjustments) hinweg in einer einzigen Abrechnung zusammenzustellen, rufen Sie den Endpoint `credit_ledger_entries` auf. Geben Sie im Parameter funding_obligation request eine Verpflichtungs-ID an. ```curl curl -G https://api.stripe.com/v1/issuing/credit_ledger_entries \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "funding_obligation={{FUNDINGOBLIGATION_ID}}" \ -d limit=3 \ -d starting_after={ENTRY_ID} ``` ### Beispielantwort ```json { "object": "list", "url": "/v1/issuing/credit_ledger_entries", "has_more": false, "data": [ { "id": "cle_1IC6b2ILABoM8KZz3EgtT9ka", "object": "credit_ledger_entry", "created": 1615292400, "amount": -80000, "currency": "usd", "funding_obligation": identifier("fundingObligation"), "livemode": true, "source": { "issuing_transaction": "ipi_1Fq2s1ILABoM8KZjPhQNaz2s", "type": "issuing_transaction" } }, { "id": "cle_1IC6b2ILABoM8KZz3EgwX7yp", "object": "credit_ledger_entry", "created": 1615206000, "amount": 20000, "currency": "usd", "funding_obligation": "fo_23456", "livemode": true, "source": { "issuing_credit_ledger_adjustment": "icla_1Fq8f2ILABoM8KZwSpPJz20F", "type": "issuing_credit_ledger_adjustment" } }, // ... more objects if available ] } ``` Kartenbasierte Transaktionen werden mit dem Typ `issuing_transaction` gekennzeichnet, während Anpassungen mit dem Typ `issuing_credit_ledger_adjustment` gekennzeichnet werden. Wenn Sie keine Anpassungen am Kredithauptbuch vornehmen, können Sie die Liste der Transaktionen abrufen, die zu `FundingObligation` eines verbundenen Kontos beigetragen haben. Hierfür übergeben Sie den Parameter [funding_obligation_for_account](https://docs.stripe.com/api/issuing/transactions/list.md#list_issuing_transactions-funding_obligation_for_account) in der API-Anfrage `List all transactions`: ```curl curl -G https://api.stripe.com/v1/issuing/transactions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview; issuing_credit_beta=v1" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "funding_obligation_for_account={{FUNDINGOBLIGATION_ID}}" ``` ### Beispielantwort ```json { "object": "list", "url": "/v1/issuing/transactions", "has_more": false, "data": [ { "id": "ipi_123", "object": "issuing.transaction", // various other fields "funding_obligation_for_platform": "ifo_123","funding_obligation_for_account": identifier("fundingObligation"), // various other fields }, { "id": "ipi_123", "object": "issuing.transaction", // various other fields "funding_obligation_for_platform": "ifo_789","funding_obligation_for_account": identifier("fundingObligation"), // various other fields }, {...} ] } ``` ## Webhook-Übersicht Zur Erinnerung, Sie können diese drei Webhooks überwachen: - `issuing_funding_obligation.created`: Wird immer dann ausgelöst, wenn eine `FundingObligation` erstellt wird. Dies geschieht zu Beginn jedes neuen Kreditzeitraums für das verbundene Konto. - `issuing_funding_obligation.updated`: Wird immer dann ausgelöst, wenn eine `FundingObligation` aktualisiert wird. Dies geschieht immer dann, wenn die Finanzierungsverpflichtung den Status oder die Betragsfelder ändert oder aktualisiert wurde, um eine Rückzahlung anzuzeigen. - `issuing_credit_ledger_adjustment.created`: Wird ausgelöst, wenn eine neue Anpassung an eine `FundingObligation` erstellt wird.