Dokumentation
Dokumentation
Verbuchungen

1Einführung

Transaktionen befinden sich, nachdem sie autorisiert wurden, im Status Authorized. Weitere Informationen finden Sie im Transaktionsprozess. Die Funktion, die wir complete nennen, ist auch als capture oder activate bekannt. Diese Bezeichnung kann je nach Kontext unterschiedlich sein, die Funktion bezieht sich jedoch auf die Aktion, die tatsächlich den Geldtransfer vom Konto des Kunden auf das Konto des Händlers auslöst.

Einige Zahlarten können so konfiguriert werden, dass sie die Zahlung verzögert abschliessen und die Zahlung auf der Seite des Prozessors nur autorisieren. In diesem Fall kann der Bestellbetrag gesenkt werden und die Artikel im Warenkorb können geändert werden, bis Sie die Transaktion abschliessen.

Note
 Nicht jede Zahlart unterstützt Completions. Wenn Sie einen einheitlichen Prozess für alle Zahlarten erreichen möchten, empfehlen wir, die Zahlung sofort abzuschliessen. Informationen zu den Zahlarten und dazu, ob sie den verzögerten Abschluss unterstützen, finden Sie in der Payment-Connector-Liste.

2Integrationsdetails

Bevor Sie eine Transaktion abschliessen können, sollten Sie die folgenden Anleitungen berücksichtigt haben

  • Erstellen Sie eine Transaktion über die Payment Page

  • Erstellen Sie eine Transaktion über das iframe

Falls Sie eine nicht abgeschlossene Transaktion stornieren möchten, müssen Sie einen Void durchführen. In der Dokumentation zum Transaktions-Void erfahren Sie, wie Transaktionen annulliert werden.

2.1Die Positionen im Back Office bearbeiten

Sie können die Positionen im Back Office bearbeiten. Dazu müssen Sie die Transaktion unter Space > Zahlung > Transaktionen öffnen. Klicken Sie auf den Tab Positionen und dann auf Positionen bearbeiten. Sie können Ihre Änderungen speichern, indem Sie auf Positionen aktualisieren klicken.

Beim Ändern der Positionen über den Webservice oder im Back Office wird eine neue Version erstellt. Sie können die Versionen im Tab Version innerhalb der Transaktion sehen.

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

2.2Eine Transaktion im Back Office abschliessen

Transaktionen können auch im Back Office abgeschlossen werden. Eine Transaktion bleibt im Status Authorized, bis sie abgeschlossen wurde. Transaktionen können auf zwei Arten abgeschlossen werden:

  1. Online abschliessen: Wenn Sie eine Transaktion online abschliessen, senden wir die Complete-Anfrage an den Prozessor.

  2. Offline abschliessen: Der Offline-Abschluss simuliert den Abschluss, die Anfrage wird jedoch nicht an den Prozessor weitergeleitet. Diese Funktion kann verwendet werden, wenn Sie die Zahlung bereits beim Prozessor abgeschlossen haben und sie nicht mehr im Online-Modus senden können.

Erfolgreiche Abschlüsse können im Tab Completion in der Transaktion eingesehen werden.

2.3Positionen über den Webservice bearbeiten

Solange die Transaktion nicht Completed ist, können Sie die Positionen beliebig ändern und bearbeiten. Verwenden Sie die Operation create line item version, um bestehende Positionen über die API zu aktualisieren.

Anfrage

In der untenstehenden Beispielanfrage aktualisieren wir eine bestehende Position und setzen den neuen Preis auf 70 CHF statt der ursprünglichen 75 CHF, die in der ursprünglichen Transaktion gesetzt wurden.

{
    "externalId": "my-external-id",
    "lineItems": [
        {
            "amountIncludingTax": "70",
            "name": "Chelsea Tee",
            "quantity": "1",
            "shippingRequired": true,
            "sku": "mtk004",
            "type": "PRODUCT",
            "uniqueId": "2622"
        }
    ],
    "transaction": 109575
}

2.4Die Complete-Anfrage senden

Sobald Sie wissen, dass Sie die Transaktion nicht mehr ändern möchten und sie verarbeiten wollen, können Sie die Transaktion abschliessen, indem Sie die Complete-Anfrage über den Webservice mit dem Transaction Completion Service senden. Sie haben die Möglichkeit, die Transaktion online oder offline abzuschliessen, je nachdem, ob Sie sie an den Prozessor senden möchten.

2.5Wie geht es weiter?

Nachdem eine Transaktion abgeschlossen wurde, wechselt sie in den Status Completed und je nach Zahlart direkt in den Status Fulfill (siehe den Transaktionsprozess für weitere Informationen zu den Statusänderungen). Die Dokumentation zu Rückerstattungen erklärt, wie abgeschlossene Transaktionen dem Kunden zurückerstattet werden können.

Staging 2.218.3