PflichtzahlungenPrivate Vorschau

Zahlungen an Ihre FundingObligation leisten.

Die FundingObligation eines Kontos auszahlen

Die FundingObligation zeigt an, was ein verbundenes Konto am Ende des Kreditzeitraums schuldet. Sie sind jedoch weiterhin für die Rückzahlung von dem verbundenen Konto verantwortlich. Verwenden Sie die Payment Intents API von Stripe, um das externe Bankkonto des verbundenen Kontos zu belasten (oder eine Kartenzahlung über Stripe Checkout oder Stripe Invoicing zu akzeptieren).

Stellen Sie sicher, dass Sie alle Zahlungen, die Sie von dem verbundenen Konto erhalten haben, in der FundingObligation des Kontos erfassen, um das verfügbare Guthaben genau widerzuspiegeln. Stripe bestimmt, ob eine Autorisierung auf der Grundlage des verfügbaren Guthabens eines Kontos genehmigt werden soll. Stripe kann überfällige und ausgebuchte FundingObligations an Bankpartner melden.

Rückzahlung einziehen

Sie können den besten Mechanismus wählen, um Rückzahlungen von Ihren verbundenen Konten einzuziehen. Wir empfehlen jedoch die Verwendung der Payments APIs von Stripe, um alle Aufzeichnungen in Stripe zu speichern und einen besseren Abgleich der Kartenausgaben und Rückzahlungen der einzelnen Nutzer/innen zu ermöglichen. Bitte aktualisieren Sie die FundingObligation entsprechend, nachdem Sie die Zahlung erfolgreich eingezogen haben. Dieser Schritt erfolgt nicht automatisch, wenn Sie die Payments APIs von Stripe verwenden. Stripe ermittelt past_due anhand des Parameters days_until_due, der in der CreditPolicy festgelegt ist. Stripe ermittelt charged_off auf der Grundlage Ihrer schriftlichen Kredit- oder Inkassorichtlinie, die die Anzahl der Tage definiert, nach der eine past_due-Verpflichtung charged_off ist.

Erfassen Sie Rückzahlungen in der FundingObligation

Nachdem Sie eine Zahlung von einem verbundenen Konto eingezogen haben, aktualisieren Sie dessen FundingObligation, um die Rückzahlung anzuzeigen. FundingObligations mit dem Status unpaid, past_due oder charged_off wirken sich auf das verfügbare Guthaben aus, das das verbundene Konto ausgeben kann. Nehmen wir zum Beispiel an, Barbell hat ein Kreditlimit von 1.000 USD und das Unternehmen kauft ein Laufband für 900 USD. Für die FundingObligation von Barbell werden 900 USD als geschuldeter amount_total ausgegeben. Dem Unternehmen stehen dann noch 100 USD zur Verfügung, die es ausgeben kann, bis die Tilgung der Schulden beginnt.

Nehmen wir an, Barbell zahlt am Ende der Kreditlaufzeit 500 USD an Gymbox zurück. Gymbox muss die FundingObligation von Barbell aktualisieren, um die Rückzahlung widerzuspiegeln. Durch diese Aktualisierung wird der amount_outstanding der FundingObligation auf 400 USD reduziert und das verfügbare Guthaben von Barbell steigt von USD 100 auf 600 USD.

Let’s say Barbell’s credit terms specify a 90-day period post due_at for the amount_outstanding on the FundingObligation to be charged off. On past_due over 90 days, Barbell’s amount_outstanding of 400 USD is charged off. 30 days after charging off the amount_outstanding on the FundingObligation, Gymbox receives a 100 USD payment from Barbell. Gymbox needs to record this repayment with the /pay endpoint to reduce the charged off amount_outstanding on the FundingObligation. This increases the available credit from 600 to 700 USD. If Gymbox closes Barbell’s credit line and reports the reason prior to collecting in full, the charged off amount_outstanding persists and subsequently recovered amounts can no longer be applied to reduce the amount_outstanding.

Beispielantwort

{
  "id": "ifo_123",
  "status": "unpaid",
  "amount_total": 90000,
  "amount_outstanding": 40000,
  "amount_paid": 50000,
  "owed_to": "acct_123",
  // other fields
}

Dieser API-Aufruf erhöht den amount_paid und verringert den amount_outstanding für die FundingObligation. Wenn amount_paid=amount_total für eine FundingObligation gilt, ändert Stripe den Status der Verpflichtung in paid, unabhängig davon, ob der vorherige Status unpaid, past_due oder charged_off war. Diese Aktualisierungen lösen das Ereignis issuing_funding_obligation.updated aus.

Wir empfehlen, sowohl den Einzug der Rückzahlung als auch die Aktualisierung der FundingObligation zu automatisieren und in aufeinander folgenden Aufrufen zusammenzufassen. Auf diese Weise aktualisieren Sie unmittelbar nach erfolgreichem Einzug der Rückzahlung die FundingObligation des verbundenen Kontos, um Stripe darüber zu informieren, das verfügbare Guthaben zu erhöhen.

Aktualisieren Sie den gezahlten Betrag in der FundingObligation

Wenn Sie eine fehlerhafte Rückzahlung vornehmen oder den amount_paid des verbundenen Kontos aus einem anderen Grund aktualisieren möchten, können Sie dies mit dem Endpoint /pay über das Feld amount_paid tun.

Beispielantwort

{
  "id": "ifo_789",
  "status": "unpaid",
  "amount_total": 90000,
  "amount_outstanding": 45000,
  "amount_paid": 45000,
  "owed_to": "acct_123",
  // other fields
}

Dadurch wird das Ereignis issuing_funding_obligation.updated gesendet.

Metadaten zu FundingObligations aktualisieren

Sie können die Metadaten zu einer FundingObligation aktualisieren, um zusätzliche Daten mit einer FundingObligation zu verknüpfen. Es empfiehlt sich beispielsweise, die OutboundPayment-ID aufzuzeichnen, die einer Rückzahlung entspricht.

Beispielantwort

{
  "id": "ifo_789",
  "status": "unpaid",
  "amount_total": 90000,
  "metadata": {
    "repayment_id": "obp_1NUy3y2eZvKYlo2C15gktUET"
  },
  "owed_to": "acct_123",
  // other fields
}

Dadurch wird das Ereignis issuing_funding_obligation.updated gesendet.