Geld mit Treasury mithilfe von DebitReversal-Objekten bewegen

Erfahren Sie, wie und unter welchen Umständen Sie Gelder von einem Treasury Finanzkonto von einem/einer externen Kontoinhaber/in abrufen können.

Durch die Rückgabe von Geldern aus einer ReceivedDebit wird eine DebitReversal erzeugt. Sie können die Gelder von einer ReceivedDebit nur in wenigen Szenarien zurückerlangen (weitere Details in der folgenden Tabelle). Ob Sie die Gelder einer ReceivedDebit zurückgeben können hängt vom Netzwerk und dem quellseitigen Ablauf ab.

Der Sub-Hash reversal_details für die ReceivedDebit-Ressource kann folgende Wertekombinationen aufweisen. Diese bestimmen, ob Sie die ReceivedDebit-Gelder zurückgeben können.

GRUND FÜR EINSCHRÄNKUNG	FRIST (EPOCHENZEITSTEMPEL)	BEISPIELSZENARIO
`null`	7940828047	Eine `ReceivedDebit`, aus der Sie Gelder zurückgeben können, aber nur bis zum Zeitstempel am `deadline`. ACH-`ReceivedDebits` haben eine Frist, die festlegt, wie lange Sie sie zurückgeben können.
`deadline_passed`	1629480538	Eine `ReceivedDebit`, deren Gelder vor dem Zeitstempel in `deadline` zurückgegeben konnten, die aber nicht mehr über die API zurückgegeben werden können, da die `deadline` verstrichen ist. ACH-`ReceivedDebits` können für eine begrenzte Zeit über die API zurückgegeben werden, nachdem sie erstellt wurden.
`already_reversed`	null	Eine `ReceivedDebit`, die bereits zurückgegeben wurde. Ihr `deadline`-Wert kann ungleich null sein.
`source_flow_restricted`	null	Eine `ReceivedDebit`, die nicht zurückgegeben werden kann, da ihr `source_flow` nicht rückgängig gemacht werden kann.

Fristen für Rückgabe

Sie haben etwa einen Werktag Zeit, um ACH-Lastschriften nach Erhalt über die API zurückzugeben. Nach Ablauf dieser Frist können ACH-Lastschriften zwar immer noch zurückgegeben werden, die Rückgabe ist jedoch nicht garantiert. Wenden Sie sich an den Support, um die Rückgabe von Geldern anzufordern, wenn die Stornofrist vergangen ist.

Informationen zu Rückgaben von ReceivedDebit-Geldern aufgrund einer Aktivität auf Issuing-Karten finden Sie im Leitfaden Angefochtene Zahlungen in Issuing.

DebitReversal erstellen

Verwenden Sie POST /v1/treasury/debit_reversals, um ein DebitReversal zu erstellen. Geben Sie die ID der zu stornierenden ReceivedDebit mit dem Parameter received_debit im Text der Anfrage an.

Notiz

DebitReversals können nicht aktualisiert werden, alle optionalen Metadaten müssen daher bei der Erstellung festgelegt werden.

Mit der folgenden Anfrage wird ein DebitReversal basierend auf dem Wert der ReceivedDebit-ID des erforderlichen received_debit-Parameters erstellt. Die Anfrage legt auch einen optionalen Metadatenwert fest.

Bei Erfolg gibt die Antwort das neue DebitReversal-Objekt zurück.

{
  "id": "{{DEBIT_REVERSAL_ID}}",
  "object": "debit_reversal",
  "amount": 1000,
  "currency": "usd",
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  "hosted_regulatory_receipt_url": "https://payments.stripe.com/regulatory-receipt/{{URL_ID}}",
  "linked_flows": null,
  "livemode": false,
  "metadata": {},
  "network": "ach",
  "received_debit": "{{RECEIVED_DEBIT_ID}}",
  "resolution": null,
  "status": "processing",
  "status_transitions": {
    "completed_at": null
  },
  "transaction": "{{TRANSACTION_ID}}"
}

Ein DebitReversal abrufen

Verwenden Sie GET /v1/treasury/debit_reversals/{{DEBIT_REVERSAL_ID}}, um das DebitReversal mit der zugehörigen ID abzurufen.

Bei Erfolg gibt die Antwort das erkannte DebitReversal zurück.

JSON (mit Kommentar)
{
  "id": "{{DEBIT_REVERSAL_ID}}",
  "object": "debit_reversal",
  "livemode": true | false,
  "created": "{{Timestamp}}",
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  "amount": 1000,
  "currency": "usd",
  // the ReceivedDebit being returned
  "received_debit": "{{RECEIVED_DEBIT_ID}}",

DebitReversals auflisten

Verwenden Sie GET /v1/treasury/debit_reversals, um eine Liste von DebitReversals für das Finanzkonto mit der im erforderlichen Parameter financial_account angegebenen ID abzurufen. Sie können die Liste unter Verwendung des Parameters received_debit nach Standardlistenparametern, status oder nach ReceivedDebit-ID sortieren.

{
  // Standard list parameters
  "limit", "starting_after", "ending_before",
  // Filter by financial account (Required)
  "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
  // Filter by `status`
  "status": "processing" | "canceled" | "completed"
  // Filter by ReceivedDebit
  "received_debit": "{{RECEIVED_DEBIT_ID}}",
}

Die folgende Anfrage ruft die letzten drei DebitReversal-Objekte für das erkannte Finanzkonto ab.

DebitReversals testen

Um DebitReversals zu testen, müssen Sie zuerst eine ReceivedDebit im Test-Modus erstellen. Verwenden Sie anschließend POST /v1/treasury/debit_reversals und geben Sie die Test-Modus-ID ReceivedDebit im Parameter received_debit an, um ein DebitReversal im Test-Modus zu erstellen.

DebitReversal-Webhooks

Stripe gibt die folgenden DebitReversal-Ereignisse an Ihren Webhook-Endpoint aus:

treasury.debit_reversal.created bei Erstellung des DebitReversal.
treasury.debit_reversal.completed, wenn das DebitReversal abgeschlossen wird.