Pflichtbeträge, Transaktionen und AnpassungenPrivate Vorschau

Zeigen Sie Details zu einer FundingObligation an und nehmen Sie Anpassungen vor.

FundingObligations abrufen

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:

Beispiel für eine Antwort auf eine Einzahlungsverpflichtung

[
  {
    "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": nil,
    "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:

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:

Konto für Off-Card-Transaktionsaktivitäten zur Anpassung des verfügbaren Guthabens und der Finanzierungsverpflichtungen
Den verfügbaren Guthabenbetrag eines Kontos abrufen
Fassen Sie sowohl Anpassungen als auch Kartenausgabenaktivitäten in einer einzigen Abrechnung zusammen

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 das Guthaben von Gymbox um 10 USD und erhöht das Guthaben von Barbell um 10 und 3. Erhöht 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:

Beispielantwort

{
  "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": "fo_12345",
  "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.

Beispielantwort

{
  "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": "fo_12345",
      "livemode": false
    },
    // ... more objects
  ]
}

Um zu bestätigen, dass der amount_outstanding auf der entsprechenden FundingObligation um den Betrag der Guthabenanpassung reduziert wurde, rufen Sie die FundingObligation ab oder überwachen Sie den Webhook issuing_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 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.

Beispielantwort

{
  "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": "fo_12345",
      "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 in der API-Anfrage List all transactions:

Beispielantwort

{
  "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": "ifo_456",
      // various other fields
    },
    {
      "id": "ipi_123",
      "object": "issuing.transaction",
      // various other fields
      "funding_obligation_for_platform": "ifo_789",
      "funding_obligation_for_account": "ifo_456",
      // 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.