Stornierung einer API-Bestellung, wenn der Kunde einen falschen Link gesendet hat

Prüfen Sie zuerst, ob die Bestellung an den Anbieter übergeben wurde

Ein falscher Link bedeutet nicht immer, dass die Promotion bereits gestartet ist. In Ihrer eigenen Datenbank kann die Bestellung angelegt, aber noch nicht per API gesendet worden sein. In diesem Fall hängt die Stornierung nur von Ihrer Verarbeitungslogik ab: Es genügt, die Bestellung als storniert zu markieren, die automatische Zahlung zu stoppen und die Übertragung nicht zu starten.

Prüfen Sie die Bestell-ID, den Erstellungszeitpunkt, den Link, die Dienstleistungsart und das Protokoll der API-Anfragen. Wenn die Anfrage an den Anbieter nicht abgeschickt wurde, legen Sie keine neue Bestellung über der alten an. Fixieren Sie zuerst die Stornierung der ursprünglichen Anfrage, sonst kann der Kunde zwei Starts für unterschiedliche Links erhalten.

Ermitteln Sie den Status der Bestellung beim Anbieter

Wenn die API-Anfrage bereits gesendet wurde, fragen Sie den aktuellen Status beim Anbieter ab. Die Statusbezeichnungen unterscheiden sich, aber meist lassen sie sich in mehrere Gruppen einteilen: Wartend, In Bearbeitung, Teilweise ausgeführt, Abgeschlossen und Storniert. Für die Entscheidung ist nicht der Status in Ihrem Panel wichtig, sondern die Antwort der Seite, die die Dienstleistung startet.

• Wartend: Die Bestellung lässt möglicherweise noch eine Stornierung zu.
• In Bearbeitung: Ein Stopp ist manchmal möglich, aber ein Teil des Volumens kann bereits gestartet sein.
• Teilweise ausgeführt: Storniert werden kann nur der Rest, wenn der Anbieter eine solche Operation unterstützt.
• Abgeschlossen: Der Link lässt sich durch Stornierung nicht mehr korrigieren.

Der Nachteil der Prüfung nur anhand des internen Status ist, dass er sich mit Verzögerung aktualisieren kann. Orientieren Sie sich an der letzten API-Antwort und dem Zeitpunkt ihres Eingangs.

Stornieren Sie die Bestellung vor dem Start der Dienstleistung

Für eine Bestellung in der Warteschlange verwenden Sie die Stornierungsmethode, sofern sie in der Dokumentation des Anbieters vorgesehen ist. Übergeben Sie die bei der Erstellung der Bestellung erhaltene ID und nicht Ihre interne Nummer, falls es sich um unterschiedliche Werte handelt. Speichern Sie die vollständige Antwort: Operationscode, Status, Fehlertext und Zeitpunkt der Anfrage.

Betrachten Sie die Bestellung erst als storniert, wenn die API die Stornierung bestätigt hat. Die Antwort über die Annahme der Anfrage und der tatsächliche Stopp der Dienstleistung können unterschiedliche Ereignisse sein. Bei manchen Integrationen kommt zuerst die Bestätigung der Annahme, und der endgültige Status ändert sich später.

Der Nachteil dieser Variante ist, dass der Anbieter es möglicherweise nicht mehr schafft, die Bestellung aus der Bearbeitung zu nehmen. Dann liefert die Stornierung eine Ablehnung oder greift nur für den nicht ausgeführten Teil.

Ändern Sie den Link in einer bereits erstellten Bestellung nicht ohne Bestätigung

Bei vielen APIs wird der Link im Moment der Bestellerstellung fixiert. Der Versuch, einen neuen Link mit derselben ID zu übergeben, kann ignoriert, als Fehler behandelt werden oder einen unvorhersehbaren Zustand erzeugen. Verlassen Sie sich nicht darauf, dass das erneute Senden der Anfrage die Adresse automatisch ersetzt.

Wenn die Dokumentation die Bearbeitung des Links ausdrücklich unterstützt, stellen Sie zuerst sicher, dass die Dienstleistung noch nicht mit der Ausführung begonnen hat. Speichern Sie dann den alten Wert, den neuen Wert und die API-Antwort. Das ist bei einem Streit mit dem Kunden oder dem Anbieter nützlich.

Der Nachteil der Bearbeitung ist, dass selbst bei einer verfügbaren Methode ein Teil der Aktionen vor der Aktualisierung auf die alte Seite gegangen sein kann. Ein korrigierter Link überträgt das bereits erzielte Ergebnis nicht.

Was tun bei teilweiser Ausführung

Wenn über den falschen Link bereits eine Promotion begonnen hat, beantragen Sie die Stornierung des Restes. Geben Sie in der Anfrage an den Anbieter die Bestell-ID, den falschen Link, den korrekten Link, den aktuellen Status und den Zeitpunkt der Fehlerentdeckung an. Ändern Sie die Angaben in der Anfrage nicht mehrmals: Das erschwert die Prüfung des Verlaufs.

Wenn die Stornierung des Restes bestätigt ist, halten Sie das bereits ausgeführte Volumen fest. Eine Rückerstattung, sofern sie in den Regeln des Anbieters vorgesehen ist, betrifft in der Regel nur den nicht ausgeführten Teil. Das ausgeführte Volumen lässt sich technisch nicht von einem Kanal, Video oder Profil auf ein anderes übertragen.

Der Nachteil der teilweisen Stornierung ist offensichtlich: Der Kunde kann bereits ein Ergebnis auf der falschen Seite erhalten, und das Budget für diesen Teil der Bestellung wird nicht immer zurückerstattet.

Wenn die Bestellung abgeschlossen ist, stellen Sie die Korrektur als separate Anfrage

Eine abgeschlossene Bestellung lässt sich in der Regel nicht über die API stornieren. Löschen Sie in dieser Situation den Eintrag nicht und ändern Sie den Link nicht im Verlauf: Die Ausgangsdaten werden für den Abgleich benötigt. Prüfen Sie, ob die Dienstleistung tatsächlich über die fehlerhafte Adresse erbracht wurde und nicht nur mit Verzögerung angezeigt wird.

Danach gibt es zwei Wege: eine Entschädigung mit dem Anbieter nach seinen Regeln verhandeln oder nach Absprache mit dem Kunden eine neue Bestellung für den korrekten Link anlegen. Die neue Bestellung muss eine separate ID, einen eigenen Betrag und eine klare Kennzeichnung des Grundes der Erstellung haben.

Der Nachteil eines neuen Starts ist, dass er ein zusätzliches Budget erfordert und eine Entschädigung für die abgeschlossene Dienstleistung möglicherweise nicht verfügbar ist.

Informieren Sie den Kunden über die Situation vor einem erneuten Start

Starten Sie den Ersatz nicht nach eigenem Ermessen, wenn der Link dem Kunden gehört und der Fehler von seiner Seite kam. Senden Sie ihm den ursprünglichen Link, den Bestellstatus, die Möglichkeit der Stornierung und die Folgen jeder Variante. Das ist besonders wichtig, wenn ein Teil der Dienstleistung bereits ausgeführt wurde.

• Wenn die Bestellung nicht übergeben wurde, fordern Sie den richtigen Link an und bestätigen Sie die Stornierung der alten Anfrage.
• Wenn die Bestellung in der Warteschlange ist, teilen Sie mit, dass die Stornierung gesendet wurde, aber die Antwort des Anbieters noch aussteht.
• Wenn eine teilweise Ausführung vorliegt, geben Sie an, dass nur der Rest gestoppt werden kann.
• Wenn die Bestellung abgeschlossen ist, stimmen Sie einen neuen Start oder eine andere Lösung ab.

Der Nachteil einer langen Abstimmung ist, dass die Bestellung in der Warteschlange während dieser Zeit in Bearbeitung übergehen kann. Senden Sie daher zuerst die technische Stornierungsanfrage, wenn eine solche Möglichkeit besteht, und klären Sie danach die weiteren Schritte.

Speichern Sie Logs und Nachweise zur Operation

Für jede strittige Bestellung speichern Sie den ursprünglichen Link des Kunden, das Eingangsdatum, die interne Nummer, die ID beim Anbieter, die API-Anfragen und -Antworten. Wenn der Kunde den Link in einem Chat gesendet hat, ersetzen Sie die Nachricht nicht durch eine bearbeitete Variante in der Bestellkarte, ohne das Original zu speichern.

Halten Sie separat fest, wer wann den Fehler bemerkt hat. Das hilft, falsch übermittelte Daten von einem Fehler des Managers, des Bestellformulars oder einer automatischen Einsetzung zu unterscheiden. Verwenden Sie bei wiederholten Anfragen an den Anbieter eine einzige Datenkette, damit keine Widersprüche entstehen.

Der Nachteil der manuellen Protokollführung ist der Zeitaufwand. Aber ohne Verlauf ist es schwieriger, den Stornierungsstatus zu belegen und dem Kunden zu erklären, warum die Mittel nicht vollständig zurückerstattet werden können.

Prüfen Sie die Fehlerbehandlung in der Integration

Prüfen Sie nach einem solchen Fall, wie das System Links an die API übergibt. Der Fehler kann nicht nur beim Kunden liegen: Manchmal schneidet das Formular Parameter ab, setzt einen alten Wert aus dem Cache ein, akzeptiert einen Profillink statt eines Links zur Veröffentlichung oder lässt einen Link mit überflüssigen Zeichen durch.

Fügen Sie eine Formatprüfung vor der Bestellerstellung hinzu: Übereinstimmung mit der Plattform, der Dienstleistungsart und dem erwarteten Objekt. Bei Dienstleistungen für Videos muss das System einen Link zum Video von einem Link zum Kanal unterscheiden, und bei sozialen Netzwerken ein Profil von einer einzelnen Veröffentlichung. Die Prüfung garantiert nicht die Richtigkeit des Links, filtert aber einen Teil offensichtlicher Fehler heraus.

Die Übergabe der Bestellung sollte durch eine kurze Datenprüfung von ihrer Erstellung getrennt werden. Der Nachteil des zusätzlichen Schritts ist, dass die Bestellung nicht sofort in die Bearbeitung geht, dafür haben Sie Zeit, eine falsche Adresse zu bemerken.

Richten Sie ein klares Stornierungsszenario für das Team ein

Beschreiben Sie eine einheitliche Vorgehensweise: automatische Übermittlung stoppen, Status beim Anbieter prüfen, Stornierung senden, Antwort speichern, Kunden informieren und erst danach einen erneuten Start abstimmen. Ein solches Szenario ist keine Formsache, sondern verhindert, dass verschiedene Mitarbeiter sich gegenseitig ausschließende Aktionen ausführen.

Geben Sie keinen Zugriff auf die Stornierung ohne Rechtebeschränkung und Aktionsprotokoll. Wenn mehrere Manager gleichzeitig an einer Bestellung arbeiten, kann einer die Stornierung beantragen und ein anderer einen Ersatz anlegen, bevor die Antwort eintrifft. Das führt zu zusätzlichen Kosten und Verwirrung bei der Abrechnung.

Der Nachteil eines strengen Szenarios ist weniger Flexibilität in dringenden Fällen. Bei API-Bestellungen ist jedoch nicht die Geschwindigkeit einer einzelnen Aktion entscheidend, sondern die Kontrolle darüber, welcher Link tatsächlich in die Bearbeitung gegangen ist.