Ich stehe gerade vor einer kleinen, aber nervigen Entscheidung in meinem aktuellen Projekt. Wir müssen eine externe Zahlungsabwicklung anbinden und ich schwanke zwischen dem direkten Implementieren der offiziellen API und der Nutzung einer vermeintlich einfacheren Wrapper-Bibliothek eines Drittanbieters. Die offizielle Dokumentation ist zwar umfangreich, aber irgendwie auch überwältigend. Hat jemand schon mal eine ähnliche Integration durchgeführt und erinnert sich, wie der Weg war, der am Ende weniger Kopfzerbrechen bereitet hat? Ich habe etwas Sorge, mich in Details zu verlieren, die später schwer zu warten sind.
Ich erinnere mich an eine ähnliche Wahl Die offizielle API hat einen klaren Vertrag aber der Umfang fühlt sich überwältigend an Trotzdem bietet sie gute Typen und nachvollziehbare Fehlercodes Der Nachteil ist der Lernaufwand und das akribische Mapping von Triggern und Limits Vielleicht hilft es mit einem kleinen PoC zu starten und die wichtigsten Pfade abzudecken Wie groß ist dein Druck sofort funktional zu sein
Analytisch gedacht könnte die Wahl zwischen direkter API und Wrapper nur die Wartungstiefe betreffen Eine offizielle API gibt dir definierte Grenzen und klare Testbarkeit Ein Wrapper mag schnell erscheinen doch oft versteckt er Abhängigkeiten und Versionswechseln Wenn du langfristig wartbare Integrationen willst ist die direkte API oft besser zu debuggen und zu testen
Der Wrapper wirkt wie eine einfache Lösung doch er verschleiert oft die Komplexität Du musst wissen wie aktuell die Abdeckung ist und wer die Verantwortung für Fehler übernimmt Ich bleibe skeptisch ob der Wrapper wirklich das hält was der Entwickler verspricht Vielleicht läuft es letztlich auf den gleichen API Rhythmus hinaus
Vielleicht geht es gar nicht nur um API oder Wrapper Denk an Contracts Monitoring und Fallbacks Wenn die Zahlung ausfällt willst du kurze Reaktionswege Die eigentliche Frage verlagert sich auf wer den Notfallplan hat Wer kümmert sich um die API bei Ausfällen
Mein Tipp ist zuerst einen kleinen Proof of Concept mit der offiziellen API Baue eine minimale Zahlungsabfrage und teste Fehlerfälle Das bringt Klarheit über Setup Kosten und Wartung Danach weißt du besser ob der Wrapper wirklich spart
Man könnte von einer dritten Schicht sprechen die zwischen dem Geschäftscode und der API liegt Ein Konzept der adaptiven Abstraktion Du definierst eine Schnittstelle die beide Wege akzeptiert und dann wählst du je nach Situation
