forumNeues Thema

Ist eine Abnahme ohne API-Integrationstests normal, hätten wir das vertraglich festlegen müssen?

AAleyna E***TeilnehmerCommunity-Mitglied
Beigetreten
Aug. 2024
Nachricht
80
#1

Wir betreiben ein Boutique-Hotel und geführte Städtetouren in Paris. Um unsere Website und die Direktbuchungs-Infrastruktur zu erneuern, haben wir mit einer lokalen Webagentur einen Vertrag über 14.000 EUR und einen 3-monatigen Zeitplan geschlossen. Die Entwicklung ist abgeschlossen, und das Projekt wurde uns zur Freigabe vorgelegt mit der Aussage, Zahlungsgateway und Buchungsmaschine seien angebunden.

Als wir jedoch nachfragten, ob die Zahlungs-API, die Kalendersynchronisation und die automatischen Bestätigungs-Mails End-to-End getestet wurden, bekamen wir eine überraschende Antwort: „Wir haben die nötigen Endpunkte angebunden, das System liefert Status 200 zurück. Die restlichen Szenarien können Sie live oder mit Ihren eigenen Testkarten durchspielen.“ Es wurden also weder Simulationen, fehlgeschlagene Transaktionen noch Lasttests durchgeführt.

Da wir so einen technischen Prozess noch nie gesteuert haben, sind wir ratlos. Ist es üblich, dass eine Agentur ein Projekt ohne API-Integrationstests übergibt? Wie sollten wir diese Tests rechtlich und technisch fordern, bevor wir die letzte Rate von 4.000 EUR freigeben?

KKemal G***Teilnehmer
Funktion
Verkäufer im Einzelhandel
Branche
IT-Dienstleistungen
Organisationsform
mittelständisches Unternehmen
Beigetreten
Apr. 2023
Nachricht
7

Doki · Incident-Response-Support · 2024

Nützlichste Antwort#2

Kurze Antwort: Das ist absolut nicht normal und ohne Integrationstests sollte niemals eine Zahlungs- oder Buchungssoftware abgenommen werden. Ein positiver Statuscode am API-Endpunkt zeigt nur, dass die Server miteinander sprechen; er beweist nicht, dass das Geld korrekt abgebucht wird, die Buchung fehlerfrei in der Datenbank landet oder wie das System reagiert, wenn ein Vorgang abbricht.

Integrationstests verifizieren Szenarien beim Datenaustausch zweier unterschiedlicher Systeme. Bei Zahlungen und Buchungen testet man nicht nur den Erfolgsfall. Randfälle wie unzureichende Deckung, ungültige Karten, Timeouts Schutz vor Doppelabbuchungen und die fehlerfreie Verarbeitung von Webhooks müssen simuliert werden. Wenn die Agentur sagt „testen Sie das live“, wälzt sie das Risiko direkt auf Sie ab, dass bei Ausfällen Kunden belastet werden, aber keine Buchung zustande kommt.

Halten Sie die restlichen 4.000 EUR unbedingt zurück und gehen Sie formal wie folgt vor: 1) Teilen Sie der Agentur schriftlich mit, dass die User Acceptance Tests (UAT) ohne Testberichte nicht als abgeschlossen gelten können. 2) Verlangen Sie als Abnahmekriterium eine Szenarienmatrix mindestens aus der Sandbox, die erfolgreiche/fehlgeschlagene Zahlungen Erstattungen, Timeouts und Webhook-Trigger umfasst. 3) Fordern Sie Logs und Protokolle der manuellen oder automatisierten Testläufe als verbindlichen Anhang zum Abnahmeprotokoll.

Selbst wenn im Vertrag keine detaillierte Leistungsbeschreibung steht: Nach Schuldrecht und Handelsbrauch schuldet der Auftragnehmer ein vertragsgemäßes, mangelfreies Werk. Ein System mit unvollständiger Integration stellt eine mangelhafte Leistung dar.

MMehmet I***TeilnehmerCommunity-Mitglied
Beigetreten
Mai 2024
Nachricht
3
#3

Ich mache solche Projekte seit Jahren – die Agentur versucht einfach, den aufwendigsten Teil, nämlich die Szenario-Tests, auf euch abzuwälzen. Ein 200er-Status sagt gar nichts. Die Bank gibt die Freigabe, aber was passiert, wenn euer System genau da in ein Timeout läuft? Eine ungetestete Zahlungsinfrastruktur geht niemals live.

SSelinTeilnehmer
Funktion
Frontend-Entwickler
Organisationsform
Firma mit 20 Mitarbeitern
Beigetreten
Feb. 2024
Nachricht
164
#4

Das A und O bei Zahlungssystemen sind die Webhooks. Schließt der Nutzer den Browser oder bricht die Verbindung ab – kann das System den asynchronen Callback im Hintergrund verarbeiten? Was macht die API bei Stornierungen oder Teilerstattungen? Diese Tests müssen sie mit Mock-Requests in der Sandbox fahren und euch die Logs vorlegen.

VVeli Y***TeilnehmerCommunity-Mitglied
Beigetreten
Feb. 2024
Nachricht
8
#5

Schlusszahlung sofort stoppen. Schreibt der Agentur per Mail: „Gemäß unseren Abnahmekriterien wird das Abnahmeprotokoll erst unterzeichnet wenn fünf Basisszenarien (erfolgreiche Abbuchung, Kartenlimit 3D-Secure-Abbruch Timeout und automatische Erstattung) in der Testumgebung des Zahlungsanbieters dokumentiert nachgewiesen wurden.“ Ihr werdet sehen wie schnell die einlenken.

VVolkan U***TeilnehmerCommunity-Mitglied
Beigetreten
Feb. 2024
Nachricht
56
#6

Den gleichen Fehler haben wir vor zwei Jahren bei unserem Tour-Projekt für 18.000 EUR gemacht. Wir haben der Agentur vertraut und sind live gegangen; in der ersten Woche wurde bei 22 Buchungen abgebucht, aber der Termin landete nie im Kalender. Wir mussten 3.100 EUR erstatten und das System 10 Tage offline nehmen. Drei Tage gesparte Tests haben uns zwei Wochen Chaos beschert.

EEbru O***Teilnehmer
Funktion
Qualitätsprüfer
Branche
IT-Dienstleistungen
Organisationsform
Team mit 8 Personen
Beigetreten
Jan. 2022
Nachricht
139
#7

Gibt es im Vertrag eine Klausel zur Abnahme oder Inbetriebnahme? Falls da die typische Formulierung drinsteht wie „gilt als abgenommen, wenn nicht innerhalb von 14 Tagen widersprochen wird“, solltet ihr schnellstmöglich schriftlich die Mängel rügen bevor die Frist abläuft.

YYiğit Ç***TeilnehmerCommunity-Mitglied
Beigetreten
März 2025
Nachricht
107
#8

Wenn du mich fragst, hat die Agentur gar keine Entwickler, die Integrationstests sauber schreiben können. Meistens klatschen die ein vorgefertigtes Plugin rein, tragen zwei API-Keys ein und denken, das Ding ist durch. Deswegen weichen die jetzt aus. Wahrscheinlich kriegen die selbst auf Druck keine anständige Testmatrix hin.

PPerihan K***TeilnehmerCommunity-Mitglied
Beigetreten
Jan. 2023
Nachricht
152
#9

Folgende drei Dokumente solltet ihr vor der Abnahme fordern: 1) Testergebnisse der Szenarien aus der Sandbox-Umgebung, 2) Screenshots der Fehlermeldungen, die der Kunde bei fehlschlagenden Vorgängen sieht, 3) Abgleich-Report zwischen dem Dashboard des Zahlungsanbieters und eurer Datenbank bei Testtransaktionen. Liegt das nicht vor, gilt das System als nicht geliefert.

ÖÖzgür Y***Teilnehmer
Funktion
IT-Leiter
Branche
chemie
Organisationsform
Boutique-Agentur
Beigetreten
Nov. 2023
Nachricht
5

Doki · Mobile App · 2025

#10

lasst euch nicht verunsichern, aber bleibt hart. devs hassen Testing, weil Bugs zu beheben den Release verzögert. behaltet euer Geld ein – ohne Testbericht verlassen die 4.000 EUR nicht euer Konto.

LLale K***TeilnehmerCommunity-Mitglied
Beigetreten
Okt. 2025
Nachricht
323
#11

Beim Lesen dieser Antwort war ich erleichtert, es liegt also nicht nur an mir. also wenn keine Abnahmekriterien definiert sind ist der Abschlusszeitpunkt des Projekts diskussionswürdig.

Wenn du das nicht von Anfang an schriftlich festhältst, gibt es später Streit.

TTülay K***ExperteCommunity-Mitglied
Beigetreten
Juli 2022
Nachricht
276
#12

Ich fasse kurz zusammen, was bisher gesagt wurde. Nach der Übergabe lebt das System weiter; Wartung ist ein separater Posten.

Der Zahlungsplan sollte an die Projektphasen gekoppelt sein, nicht an den Kalender. Aus Erfahrung weiß ich das.

MMustafa M***Teilnehmer
Funktion
Qualitätsprüfer
Branche
Lebensmittelgroßhandel
Organisationsform
Regionalhändler
Beigetreten
Feb. 2024
Nachricht
106
#13

Du hast recht, ich bin denselben Weg gegangen. Nach der Übergabe lebt das System weiter; Wartung ist ein separater Posten.

Ein Change-Request-Prozess verlangsamt die Arbeit nicht, sondern beschleunigt sie. Das war's, entschuldige, wenn ich zu lang war.

IIrmak B***TeilnehmerCommunity-Mitglied
Beigetreten
Jan. 2025
Nachricht
304
#14

Genau so, und das ist zudem kaum bekannt. Nach der Übergabe lebt das System weiter; Wartung ist ein separater Posten.

Wenn es jemand anders macht, würde mich das auch interessieren.

MMeryem S***Teilnehmer
Funktion
Systemadministrator
Branche
Elektro- und Elektronikindustrie
Organisationsform
Betrieb mit zwei Filialen
Beigetreten
März 2026
Nachricht
398
#15

Das wusste ich nicht. Schaut zuerst, welche Daten ihr bei der Entscheidungsfindung zur Hand habt.

Wenn deine Situation anders ist, ändert sich das natürlich.

OOkan I***Teilnehmer
Funktion
Finanzbuchhaltung
Branche
kosmetik
Organisationsform
Ein-Personen-Unternehmen
Beigetreten
Nov. 2023
Nachricht
260
#16

Gut, dass du diesen Thread eröffnet hast.

FFatma G***TeilnehmerCommunity-Mitglied
Beigetreten
März 2023
Nachricht
24
#17

Kannst du das etwas genauer erklären? naja nach der Übergabe lebt das System weiter; Wartung ist ein separater Posten.

Nur als Notiz, könnte nützlich sein.

MMurat T***Teilnehmer
Funktion
Netzwerkadministrator
Branche
Versicherungswesen
Organisationsform
Boutique-Agentur
Beigetreten
Jan. 2025
Nachricht
80
#18

Da verstehe ich etwas nicht ganz. Bei uns war der größte Zeitfresser die Unklarheit darüber wer entscheidet.

CCeren K***TeilnehmerCommunity-Mitglied
Beigetreten
Jan. 2023
Nachricht
377
#19

Ich habe diesen Weg schon hinter mir, ich erzähl mal... ehrlich gesagt fehler auf der API-Integrationstest-Seite sind meist rückgängig zu machen aber teuer.

Nur als Notiz könnte nützlich sein.

SSinan B***VeteranCommunity-Mitglied
Beigetreten
Apr. 2022
Nachricht
48
#20

Bleibe dran.

Antwort schreiben