Geld mit Treasury mithilfe von CreditReversal-Objekten bewegen
Durch die Stornierung einer ReceivedCredit
wird ein CreditReversal
erstellt. ReceivedCredits
können nur in bestimmten Szenarien storniert werden (in der folgenden Tabelle aufgeführt). Ob Sie eine ReceivedCredit
stornieren können, hängt vom Netzwerk und Quell-Flow ab.
Der Sub-Hash reversal_details
für das ReceivedCredit
-Objekt kann folgende Wertekombinationen aufweisen. Diese bestimmen, ob Sie die ReceivedCredit
stornieren können oder nicht.
GRUND FÜR EINSCHRÄNKUNG | FRIST (EPOCHENZEITSTEMPEL) | BEISPIELSZENARIO |
---|---|---|
source_flow_restricted | null | Eine ReceivedCredit eines Stripe-Netzwerks als Resultat eines anderen Ablaufs als des OutboundPayment . Stripe lässt nicht zu, dass Nutzer/innen solche ReceivedCredits stornieren. |
network_restricted | null | Aufgrund von Netzwerkeinschränkungen kann Stripe die Stornierung einiger ReceivedCredits (z. B. einer ReceivedCredit aus einer Überweisung) nicht zulassen. |
null | {{TIMESTAMP}} | Eine ReceivedCredit , die stornierbar ist, aber nur bis zum Zeitstempel am deadline . ACH-ReceivedCredits haben eine Frist, die festlegt, wie lange sie storniert werden können. |
deadline_passed | {{TIMESTAMP}} | Eine ReceivedCredit , die bis zum Zeitstempel am deadline stornierbar war, es aber jetzt nicht mehr ist, da die deadline abgelaufen ist. ACH-ReceivedCredits sind nach ihrer Erstellung nur für einige Zeit stornierbar. |
already_reversed | null | Eine ReceivedCredit , die bereits storniert wurde, hat diesen restricted_reason . Ihr deadline -Wert kann ungleich null sein. |
null | null | Sie können ReceivedCredits jederzeit stornieren, wenn sowohl für restricted_reason als auch für deadline null festgelegt ist. |
CreditReversal erstellen
Verwenden Sie POST /v1/treasury/credit_reversals
, um ein CreditReversal
zu erstellen. Legen Sie den Parameter received_credit
im Text der Anfrage auf den Wert der zu stornierenden ReceivedCredit
-ID fest.
Notiz
CreditReversals
können nicht aktualisiert werden, also müssen Sie bei Erstellung alle optionalen Metadaten festlegen.
Die folgende Anfrage erstellt ein CreditReversal
basierend auf dem Wert der ReceivedCredit
-ID des erforderlichen received_credit
-Parameters. Die Anfrage legt auch einen optionalen Metadatenwert fest.
Bei Erfolg gibt die Antwort das neue CreditReversal
-Objekt zurück.
{ "id": "{{CREDIT_REVERSAL_ID}}", "object": "credit_reversal", "amount": 1000, "currency": "usd", "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", "hosted_regulatory_receipt_url": "https://payments.stripe.com/regulatory-receipt/{{URL_ID}}", "livemode": false, "metadata": { "csr_id": "CSR-12"
CreditReversal abrufen
Verwenden Sie GET /v1/treasury/credit_reversals/{{CREDIT_REVERSAL_ID}}
, um das CreditReversal
mit der zugehörigen ID abzurufen.
Die Antwort gibt das spezielle CreditReversal
-Objekt zurück.
CreditReversals auflisten
Verwenden Sie GET /v1/treasury/credit_reversals
, um eine Liste von CreditReversals
für das Finanzkonto mit der im erforderlichen Parameter financial_account
angegebenen ID abzurufen. Sie können die Liste unter Verwendung des Parameters received_credit
nach Standardlistenparametern, status
oder nach ReceivedCredit
-ID sortieren.
{ // Standard list parameters "limit", "starting_after", "ending_before", // Filter by status "status": "processing" | "posted", // Filter by FinancialAccount (Required) "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", // Filter by ReceivedCredit "received_credit": "{{RECEIVED_CREDIT_ID}}" }
Die folgende Anfrage gibt die letzten drei Stornos mit dem Status posted
für das angegebene Finanzkonto zurück.
Bei Erfolg gibt die Antwort die relevante Liste von CreditReversal
-Objekten zurück.
CreditReversals testen
Um CreditReversals zu testen, müssen Sie zunächst ReceivedCredits im Testmodus erstellen. Verwenden Sie dann POST /v1/treasury/credit_reversals
und geben Sie die ReceivedCredit
-ID im Testmodus im Parameter received_credit
an, um einenCreditReversal
im Testmodus zu erstellen.
CreditReversal-Webhooks
Stripe gibt die folgenden CreditReversal
-Ereignisse an Ihren Webhook-Endpoint aus:
treasury.credit_reversal.created
bei Erstellung desCreditReversal
.treasury.credit_reversal.posted
, wenn dasCreditReversal
veröffentlicht wird