Dokumentation
Dokumentation
Gutschriften

1Einführung

Transaktionen, die sich im Zustand Completed oder Fulfill befinden, können erstattet werden, und das Geld kann an den Kunden zurückgezahlt werden. Weitere Informationen finden Sie im Transaktionsprozess.

Note
 Nicht jede Zahlart erlaubt es, Transaktionen verzögert zu autorisieren. Um einen einfacheren Prozess zu haben, empfehlen wir Ihnen, mit Rückerstattungen anstelle von Completions zu arbeiten.

2Integrationsdetails

Bevor Sie eine Transaktion vervollständigen können, sollten Sie die folgenden Anleitungen berücksichtigt haben:

Nachfolgend finden Sie weitere Informationen darüber, wie Sie eine Rückerstattung im Backoffice der Anwendung auslösen oder den Web Service verwenden können, um den Rückerstattungsprozess aus der Ferne in Ihre Anwendung zu integrieren.

2.1Online- vs. Offline-Rückerstattungen

Eine Rückerstattung kann auf zwei Arten ausgelöst werden:

  • Online: Wenn Sie eine Transaktion online erstatten, senden wir die Rückerstattungsanfrage direkt an den Prozessor.

  • Offline: Die Offline-Rückerstattung simuliert die Rückerstattung in unserer Plattform, sendet sie jedoch nicht an den Prozessor. Diese Funktion kann verwendet werden, wenn Sie die Zahlung bereits beim Prozessor erstattet haben und sie nicht mehr im Online-Modus senden können.

2.2Eine Rückerstattung im Backoffice erstellen

Rückerstattungen finden Sie im Backoffice unter Space > Zahlung > Transaktionen. Öffnen Sie die Transaktion. Falls die Transaktion vervollständigt wurde, sollten Sie den Transaktions-Tab Rückerstattungen finden. Das Backend bietet eine einfache und bequeme Möglichkeit, Online- oder Offline-Rückerstattungen auszulösen.

Note
 Es können inkonsistente Daten entstehen, wenn Sie die Positionen nur im Backoffice und nicht auch in Ihrer Anwendung ändern.

2.3Eine Rückerstattung über den Web Service erstellen

Sie können eine vervollständigte Transaktion über den Web Service erstatten, indem Sie den Refund Service verwenden.

Sie haben die Möglichkeit, eine Rückerstattung basierend auf einer Mengenreduktion oder dem Stückpreis auszulösen. Sie sollten diese nicht kombinieren, da dies zu unerwarteten Ergebnissen führen kann. Um die Position zu erhalten, die Sie erstatten können, müssen Sie zuerst die Transaktion mit read abrufen. Dies liefert die notwendigen Informationen, die für die Rückerstattung benötigt werden.

Wir unterscheiden zwischen verschiedenen Rückerstattungstypen:

  • CUSTOMER_INITIATED_AUTOMATIC / MANUAL: Eine Rückerstattung ist vom Kunden initiiert, wenn die Rückerstattung nicht mit Zustimmung des Händlers ausgelöst wurde. Dies kann durch eine Rückbelastung auf der Kreditkarten- oder Lastschrifttransaktion geschehen.

  • MERCHANT_INITIATED_ONLINE / OFFLINE: Eine vom Händler initiierte Rückerstattung wird mit Zustimmung des Händlers ausgelöst.

Transaktionsantwort

Nachfolgend finden Sie einen Auszug aus der Antwort auf das read der Transaktion, die wir erstatten möchten.

"lineItems": [{
    "aggregatedTaxRate": 0,
    "amountExcludingTax": 70,
    "amountIncludingTax": 70,
    "attributes": {
        "color": {
            "label": "Color",
            "value": "Black"
        },
        "size": {
            "label": "Size",
            "value": "S"
        }
    },
    "name": "Chelsea Tee",
    "quantity": 1,
    "shippingRequired": true,
    "sku": "mtk004",
    "taxAmount": 0,
    "taxAmountPerUnit": 0,
    "taxes": [],
    "type": "PRODUCT",
    "uniqueId": "2622",
    "unitPriceExcludingTax": 70,
    "unitPriceIncludingTax": 70
}

Anfrage

Basierend auf diesen Informationen können wir die Rückerstattungsanfrage mit der Methode Refund Create der API auslösen.

{
    "externalId": "1",
    "reductions": [
        {
            "lineItemUniqueId": "2622",
            "quantityReduction": "1",
            "unitPriceReduction": "70"
        }
    ],
    "transaction": 109575,
    "type": "MERCHANT_INITIATED_ONLINE"
}
Staging 2.218.3