Rückerstattungsintegration: Teilrückzahlungen im Shop richtig abnehmen
Ein Mitarbeiter hat eine Erstattung für eine Position genehmigt und auf „Erstatten“ geklickt, erhält aber statt einer Bestätigung einen Verbindungsfehler. Darf er erneut klicken? Genau solche Fragen muss die Rückerstattungsintegration beantworten, die Sie für Ihren Onlineshop beauftragen. Für die Abnahme zählt nicht, ob es eine Schaltfläche gibt, sondern der Nachweis: Der genehmigte Betrag wurde erstattet, eine Wiederholung hat keine zusätzliche Rückerstattung ausgelöst, und eine Abweichung ist für das Finanzteam sichtbar.
Beginnen Sie mit dem Zahlungsvorgang nach der Genehmigung der Warenrückgabe. Halten Sie den Betrag, den Bezug zur ursprünglichen Zahlung, die Wiederholungsregeln und das Abgleichverfahren fest. So lässt sich eine funktionierende Integration von einer Vorführung unterscheiden, bei der alles lediglich beim ersten Versuch geklappt hat.
Wo die Verantwortung der Zahlungsintegration beginnt
Die Verantwortung beginnt, wenn das Unternehmen bereits festgelegt hat, wem es wofür welchen Betrag erstattet. Die Bearbeitung der Anfrage und die Ausführung des Geldvorgangs sollten miteinander verknüpfte, aber getrennte Prozesse sein. Eine genehmigte Anfrage beweist noch nicht, dass der Zahlungsanbieter die Rückerstattung ausgeführt hat.
Wenn Sie die Annahme zurückgesandter Waren erst organisieren, benötigen Sie zunächst ein Retourenportal mit RMA-Anfragen und -Entscheidungen. Hier geht es um den nächsten Schritt: eine genehmigte Entscheidung in eine kontrollierte finanzielle Handlung umzusetzen. Benennen Sie in der Leistungsbeschreibung die Quelle des genehmigten Betrags und die Bedingung, nach deren Erfüllung er an den Anbieter übermittelt werden darf.
Unterscheiden Sie statt eines einzigen Status „Erstattet“ zwischen Genehmigung, Befehlsübermittlung, ungeklärtem Ergebnis und bestätigter Ausführung. Dies ist ein empfohlenes internes Modell, nicht die Bezeichnung von API-Statuswerten. Legen Sie für jeden Zustand die zulässige nächste Handlung fest.
Welchen Betrag das System erstatten darf
Das System soll den genehmigten Betrag innerhalb des Restbetrags der konkreten Zahlung erstatten. Nur den ursprünglichen Bestellwert zu prüfen, reicht nicht aus: Ein Teil des Geldes könnte bereits erstattet oder für einen anderen, noch nicht abgeschlossenen Vorgang reserviert sein. Trennen Sie in den Anforderungen tatsächlich erstattete Beträge von Beträgen, deren Ergebnis noch geklärt wird.
Für den Shopbetreiber bedeutet die Kontrolle des verfügbaren Erstattungsbetrags eine einfache Regel: Zwei Mitarbeiter dürfen nicht gleichzeitig denselben Restbetrag verwenden. Lassen Sie sich vom Auftragnehmer zeigen, wie das System das Limit prüft und den benötigten Betrag in einem abgestimmten Schritt reserviert, statt zwei unabhängige Prüfungen durchzuführen. Auch die Freigabe dieser Reservierung nach einer Ablehnung durch den Anbieter muss geregelt sein.
Wie Teilmengen, Rabatte und Versand berechnet werden
Der Teilrückerstattungsbetrag sollte sich aus einer vereinbarten Berechnung ergeben, nicht aus dem aktuellen Katalogpreis des Produkts. Legen Sie vor der Entwicklung fest, wie Bestellrabatt, Stückzahl und Versand berücksichtigt werden. Der Auftragnehmer setzt diese Regeln um, darf aber nicht eigenständig die Finanzpolitik des Shops festlegen.
Bereiten Sie Beispiele mit Kopeken sowie mit dem Restbetrag nach mehreren Teilrückerstattungen vor. Vereinbaren Sie die Rechengenauigkeit und die Stelle, an der gerundet wird, und übermitteln Sie im Zahlungsbefehl einen bereits festgelegten Betrag. Wurde der Einkauf mit mehreren Zahlungen beglichen, ist eine eindeutige Aufteilung erforderlich; die Bestellnummer allein erklärt nicht, welche Zahlung reduziert werden soll.
Was Sie bei den Möglichkeiten Ihres Anbieters prüfen sollten
Prüfen Sie die Unterstützung von Teilrückerstattungen, die Finanzierungsquelle und die Ergebnisabfrage für Ihre konkrete Anbindung. Der Name des Zahlungsdienstes beschreibt noch nicht alle Bedingungen. Klären Sie diese Abhängigkeiten vor der Freigabe des Kostenvoranschlags, sonst wartet eine fertige Schaltfläche womöglich noch auf zusätzliche Einstellungen.
Beispielsweise beschreibt die offizielle LiqPay-Dokumentation zu Rückerstattungen vollständige und teilweise Rückerstattungen auf die Karte, mit der der Kunde bezahlt hat. Sie unterscheidet außerdem zwischen der Finanzierung aus künftigen Zahlungen und vom Firmenkonto bei der PrivatBank; die zweite Variante wird nach Vereinbarung beim Vertragsabschluss freigeschaltet. Eine erfolgreiche Befehlsübermittlung sollte daher nicht zu einem bedingungslosen Versprechen werden, dass das Geld sofort eingeht.
Bei LiqPay enthält die Anfrage die Aktion refund, den Betrag und die Kaufkennung order_id. Ob ein universeller Schlüssel zum Schutz vor Wiederholungen verfügbar ist, muss bestätigt werden und darf nicht in Analogie zu einer anderen API vorausgesetzt werden.
- Ist das benötigte Szenario für Ihren Shop und die Zahlungsart verfügbar?
- Welche Felder verknüpfen die Rückerstattung eindeutig mit der ursprünglichen Zahlung?
- Was bedeutet die Antwort auf die Anfrage, und wodurch wird das endgültige Ergebnis bestätigt?
- Wie lässt sich das Ergebnis prüfen, wenn die Antwort oder die Serverbenachrichtigung nicht eingegangen ist?
- Welche Finanzierungs- und Gebührenbedingungen müssen Sie gesondert mit dem Anbieter klären?
Wie aus einem erneuten Versuch keine zweite Rückerstattung wird
Jede genehmigte finanzielle Handlung muss eine stabile interne Kennung haben. Ein erneuter Klick, die erneute Zustellung einer Aufgabe und die Wiederaufnahme nach einem Ausfall müssen sich auf denselben Vorgang beziehen. Das ist die Grundlage der Idempotenz von Rückerstattungen: Eine wiederholte Verarbeitung erzeugt keine neue Geldwirkung für eine bereits ausgeführte Entscheidung.
Die Bestellnummer allein genügt nicht: Zu einem Einkauf können mehrere berechtigte Teilrückerstattungen gehören. Eine neue Zufallsnummer für jeden Versuch eignet sich aber ebenso wenig — dann verliert das System den Zusammenhang zwischen Wiederholung und ursprünglicher Handlung. Halten Sie in der Spezifikation die Verknüpfung zwischen Betragsentscheidung, internem Vorgang, ursprünglicher Zahlung, Übermittlungsversuchen und Anbieterbestätigungen fest.
Was nach einer Zeitüberschreitung zu tun ist
Klären Sie nach einer Zeitüberschreitung zunächst das Ergebnis, statt eine neue Rückerstattung anzulegen. Ein Timeout bedeutet, dass der Shop nicht rechtzeitig eine Antwort erhalten hat; er beweist keine Ablehnung durch das Zahlungssystem. Deshalb brauchen Sie einen sichtbaren Zustand „Ergebnis wird geklärt“ und ein Prüfverfahren durch einen zuständigen Mitarbeiter oder eine Hintergrundaufgabe.
Unterstützt der Anbieter einen Idempotenzschlüssel, wiederholen Sie die Anfrage nach seinen dokumentierten Regeln. Ein solcher Schlüssel schützt nicht automatisch vor einem zweiten Vorgang, den jemand separat im Anbieterportal angelegt hat. Eine wiederholte Anfrage ist keine neue Entscheidung — diese Regel muss sowohl in der Software als auch im Handeln des Teams gelten. Sehen Sie für ungeklärte Fälle das Stoppen automatischer Wiederholungen und die Übergabe zum Abgleich vor.
Fiktives Beispiel: zwei Genehmigungen zu einer Zahlung
Prüfen Sie in der Vorführung mehrere Teilbeträge, nicht nur eine vollständige Stornierung. Das folgende erfundene Testbeispiel ist keine GL.ua-Fallstudie: Es unterscheidet die Wiederholung einer Handlung von einer neuen Genehmigung.
Der Shop hat eine Zahlung über 3 780 UAH erhalten. Das Finanzteam hat bereits eine Rückerstattung von 640 UAH bestätigt und anschließend weitere 915 UAH für eine andere Position genehmigt. Die zweite Anfrage endete mit einer Zeitüberschreitung. Solange das Ergebnis ungeklärt ist, muss das System genau diesen Vorgang über 915 UAH beibehalten und verhindern, dass er durch einen neuen Eintrag mit derselben Grundlage umgangen wird.
Nach bestätigter Ausführung wurden insgesamt 1 555 UAH erstattet, der Restbetrag der Zahlung beträgt 2 225 UAH. Geht eine erneute Benachrichtigung über dieselben 915 UAH ein, darf der erfasste Betrag nicht steigen. Genehmigt das Unternehmen später gesonderte 500 UAH, ist dies ein neuer Vorgang mit eigener Grundlage und keine Wiederholung des vorherigen. So sieht die Finanzfachkraft den Verlauf und nicht nur den letzten Status.
| Situation in der Vorführung | Erwartete Reaktion | Nachweis für die Abnahme |
|---|---|---|
| Erneuter Klick für 915 UAH | Der bestehende Vorgang wird geöffnet | Keine zweite ausgeführte Rückerstattung auf derselben Grundlage |
| Antwort nach Übermittlung verloren | Das Ergebnis wird ohne neue Entscheidung geklärt | Betrag, Zahlung und Versuchsprotokoll sind gespeichert |
| Erneute Ausführungsbenachrichtigung | Der bekannte Eintrag wird aktualisiert | Die Summe bleibt bei 1 555 UAH |
| Neue Genehmigung über 500 UAH | Nach Prüfung des Restbetrags wird ein separater Vorgang angelegt | Neue Grundlage und Bezug zur selben Zahlung sind vorhanden |
| Manuelle Rückerstattung im Anbieterportal | Die Abweichung wird zum Abgleich weitergeleitet | Das Team sieht die externe Handlung, statt sie durch eine Wiederholung zu verdecken |
Wie das Finanzteam den Abschluss prüft
Der Abschluss wird durch den Abgleich des genehmigten Betrags mit den Anbieterdaten und dem Eintrag im Buchhaltungssystem bestätigt. Eine grüne Anzeige im Shop ersetzt diese Prüfung nicht. Der Abgleich der Rückerstattungen mit dem Anbieter ist sowohl für automatische Vorgänge als auch für außerhalb der Website ausgeführte Handlungen erforderlich.
Vereinbaren Sie ein Register mit interner Nummer, ursprünglicher Zahlung, genehmigtem und bestätigtem Betrag, Währung, Zeitpunkt der letzten Prüfung, Bestätigungsquelle und der für die Abweichung zuständigen Person. Ersetzen Sie den Erstattungsbetrag nicht durch die Nettoauszahlung an den Shop nach Gebühren. Das sind unterschiedliche Kennzahlen; das Finanzteam vereinbart die Erfassung der Gebühren anhand der Leistungsbedingungen.
Benachrichtigungen des Anbieters sind vor ihrer Verwendung zu prüfen. Die LiqPay-Callback-Dokumentation sieht eine Signaturprüfung und die Möglichkeit vor, den aktuellen Zahlungsstatus separat abzurufen. Verlangen Sie für die Abnahme außerdem die Prüfung, ob die Benachrichtigung zu Ihrem Shop und zur betreffenden Zahlung gehört. Eine echte Benachrichtigung über eine andere Zahlung darf die aktuelle Rückerstattung nicht abschließen.
Verlangen Sie eine Liste unbestätigter Vorgänge und Abweichungen: Dieselbe Tagessumme kann eine falsche Zuordnung zum Käufer verbergen. Vereinbaren Sie mit dem Finanzteam die Abgleichhäufigkeit und die Reaktionsfrist und zeigen Sie im System Fristüberschreitungen sowie die zuständige Person an.
Welche Abnahmeanforderungen in den Auftragnehmervertrag gehören
Nehmen Sie reproduzierbare Tests, ein zugängliches Register und ein Wiederherstellungsverfahren nach Ausfällen in die Abnahme auf. Die Vorführung muss mit der Prüfung der Daten im Shop und beim Anbieter enden. Die Abnahmekriterien der Integration sollten vor der Entwicklung vereinbart werden, damit die Beseitigung des Risikos doppelter Vorgänge nicht zu unerwartetem Zusatzumfang wird.
- Führen Sie eine gewöhnliche Teilrückerstattung aus und prüfen Sie Betrag, Zahlung und Endzustand.
- Wiederholen Sie die Handlung von zwei Arbeitsplätzen aus und prüfen Sie, dass keine zusätzliche finanzielle Wirkung entstanden ist.
- Simulieren Sie den Verlust der Antwort, eine wiederholte Serverbenachrichtigung und den Neustart der Aufgabenverarbeitung.
- Prüfen Sie Ablehnung, ungeklärtes Ergebnis und Wiederherstellung nach einem Ausfall des Buchhaltungssystems.
- Gleichen Sie den Verlauf der Teilrückerstattungen, den verfügbaren Restbetrag und einen externen manuellen Vorgang ab.
- Übergeben Sie der Finanzfachkraft eine Testabweichung: Sie muss deren Ursache finden und den nächsten Schritt ohne Hilfe eines Entwicklers verstehen.
Verwenden Sie für Tests die verfügbare Testumgebung des Anbieters. Was sie nicht nachbildet, prüfen Sie durch kontrollierte Fehlersimulation. Geben Sie eine simulierte Antwort nicht als tatsächliche Geldbewegung aus. Vereinbaren Sie gesondert die Prüfung der produktiven Anbindung, die zuständige Person und das zulässige Vorgehen.
Die Dauer hängt vom Zugang zum Zahlungsportal, der Abstimmung der Betragsregeln, der Bereitschaft der Buchhaltung und der Möglichkeit ab, Ausnahmefälle nachzubilden. Die Kosten setzen sich aus Analyse, Rückerstattungsverarbeitung, Wiederholungsschutz, Protokollierung, Abgleich, Tests und Support zusammen. Bei wenigen Vorgängen kann eine kontrollierte manuelle Ausführung mit Abgleich ein sinnvollerer Einstieg sein als die vollständige Automatisierung.
Einsatzbereitschaft bedeutet, dass ein ungeklärtes Ergebnis eine zuständige Person hat, und jeder bestätigte Betrag eine nachvollziehbare Grundlage. Besprechen Sie zur Einschätzung einer solchen Erweiterung mit GL.ua (Глянець) die Zahlungsszenarien im Rahmen der Entwicklung und Weiterentwicklung Ihres Onlineshops: Welche Rückerstattungen sollen automatisiert werden, was bleibt unter Kontrolle der Finanzfachkraft und welche Tests bestätigen das Ergebnis?
Häufig gestellte Fragen
Muss für Rückerstattungen die Shopplattform gewechselt werden?
Nicht unbedingt. Prüfen Sie zunächst die Möglichkeiten des bestehenden Zahlungsmoduls und der Speicherung des Vorgangsverlaufs. Eine Migration sollte erst bei einer nachgewiesenen konkreten Einschränkung erwogen werden, nicht allein wegen des Automatisierungsbedarfs.
Kann später ein weiterer Zahlungsanbieter hinzugefügt werden?
Diese Möglichkeit sollte gesondert im Leistungsumfang vorgesehen werden. Das gemeinsame Register kann bestehen bleiben, doch Befehle, Statuswerte und Bestätigungen jedes Anbieters benötigen eigene Zuordnungen und Tests.
Wie geht man mit einer Zahlung per Geschenkgutschein um?
Setzen Sie diese nicht automatisch mit einer Kartenzahlung gleich. Das Unternehmen muss ein eigenes Szenario für die Wiederherstellung des Guthabens oder eine andere Entschädigung festlegen. Der Auftragnehmer muss prüfen, wie es mit dem Geldanteil des Einkaufs zusammenspielt.
Ersetzt eine Zahlungsrückerstattung die Buchhaltungsbelege?
Ein erfolgreicher Zahlungsvorgang bestätigt für sich genommen nicht, dass alle Buchhaltungsverfahren abgeschlossen sind. Die erforderlichen Dokumente und Handlungen legt Ihr Finanzteam gemeinsam mit den zuständigen Fachleuten fest; ihre Automatisierung wird gesondert vereinbart.
Was sollte bei der Übergabe der Integration an den Support verlangt werden?
Fordern Sie eine Beschreibung der Zustände, Einstellungen, Benachrichtigungen und des Umgangs mit Abweichungen sowie Testszenarien und eine Liste der Verantwortlichen an. Übertragen Sie den Zugang zu produktiven Schlüsseln auf einem vereinbarten sicheren Weg, nicht in einer Anleitung oder einem Fehlerprotokoll.
Nur ein Schritt zu Ihrer perfekten Website



