Worldline / Saferpay
Worldline wird in edoobox über die Saferpay-Schnittstelle angebunden. Welche Zahlungsmittel im Buchungsprozess verfügbar sind, hängt von Ihrem Worldline-Vertrag, Terminal, Land, Währung und der providerseitigen Freigabe ab. edoobox benötigt dafür vier Zugangswerte und eine API-Version.
Voraussetzungen beim Anbieter
Ein aktiver Worldline/Saferpay-Vertrag für Onlinezahlungen.
Eine Customer ID und Terminal ID.
API-Benutzer beziehungsweise API Schlüssel und zugehöriger Secret Key.
Freigeschaltete Zahlungsmittel, Währungen und ein abgestimmter Auszahlungsprozess.
Aktuelle Konditionen und unterstützte Zahlungsmittel stammen aus Ihrem Providervertrag. Historische Paketnamen oder Preisbeispiele sind keine zuverlässige Grundlage für diese technische Anleitung.
Zugangsdaten in edoobox speichern
Öffnen Sie Einstellungen → Zahlungssysteme → Worldline.
Erfassen Sie Customer ID, Terminal ID, API Schlüssel und Secret Key.
Wählen Sie die in edoobox für diese Integration angebotene Version 1.50.
Klicken Sie auf Speichern. Der Button bleibt gesperrt, solange Pflichtwerte fehlen.
Prüfen Sie den Aktivschalter und führen Sie sofort eine interne Testzahlung durch.
Version 1.23 ist veraltet: Die V2 führt 1.23 weiterhin in der Auswahl und kennzeichnet diese Version als veraltet. Verwenden Sie für neue oder aktualisierte Setups Version 1.50 und stimmen Sie den Wechsel mit Worldline ab.
Die Versionsauswahl bezeichnet die von dieser edoobox-Integration verwendete Saferpay-Schnittstelle. Der Anbieter kann bereits neuere Versionen dokumentieren; deren Funktionen stehen dadurch nicht automatisch in edoobox zur Verfügung. Prüfen Sie benötigte Zahlungsmittel und Mindestversionen mit Worldline. Die Zuordnung erklärt die Saferpay-Dokumentation zur Versionierung.
API-Schlüssel und Secret sicher ändern
Bestehende Geheimnisse werden nicht im Klartext zurück in das Formular geladen. Die V2 zeigt dafür eine maskierte Platzhalterdarstellung. Lassen Sie ein Geheimnisfeld leer, wenn der gespeicherte Wert unverändert bleiben soll; geben Sie einen neuen Wert nur bei einer bewussten Rotation ein.
Customer ID und Terminal ID bleiben sichtbar und können separat geändert werden. Die V2 sendet beim Speichern nur tatsächlich veränderte Zugangsteile. Zeigen Sie API- und Secret-Key weder in Screenshots noch in Supportnachrichten.
Aktivstatus nach dem Speichern kontrollieren
Eine unvollständige Konfiguration kann nicht aktiviert werden. Die aktuelle V2-Oberfläche prüft beim Öffnen ausserdem, ob eine vollständige Konfiguration vorhanden ist, und kann einen vollständigen, bisher inaktiven Datensatz aktivieren. Kontrollieren Sie den Schalter deshalb nach jedem Öffnen oder Ändern bewusst.
Aktiv bedeutet nur, dass edoobox die Zahlungsart anbieten darf. Ob eine konkrete Methode funktioniert, zeigt erst eine erfolgreiche Providerzahlung mit korrekter Rückleitung und Transaktion.
Rückerstattung über Worldline/Saferpay
Die V2 unterstützt Rückerstattungen für eine rückerstattbare Saferpay-Originaltransaktion. Der Betrag muss positiv sein und darf den verbleibenden rückerstattbaren Betrag nicht überschreiten. edoobox sendet die Provider-Transaktions-ID, Betrag, Währung und die gespeicherten API-Zugangsdaten an Saferpay.
Je nach Providerstatus wird eine Rückerstattung direkt als erfasst gemeldet oder anschliessend erfasst. Bei einem Providerfehler zeigt die V2 die Saferpay-Meldung länger an, damit Sie den konkreten Grund notieren können.
Konfiguration zurücksetzen
Zurücksetzen löscht in edoobox Customer ID, Terminal ID, API-Zugang und Secret, setzt Version 1.50 und deaktiviert Worldline. Verwenden Sie diese Aktion nicht als normalen Testschritt.
Vor dem Zurücksetzen: Prüfen Sie veröffentlichte Angebote, laufende Zahlungen und offene Rückerstattungen. Halten Sie die Providerdaten ausserhalb von edoobox gemäss Ihrem Sicherheitsprozess bereit, falls eine spätere Wiederanbindung nötig ist.
Testmatrix
Vollständige Version-1.50-Konfiguration und bewusst geprüfter Aktivstatus.
Erfolgreiche Zahlung mit jeder im Vertrag tatsächlich angebotenen Methode.
Abbruch oder Ablehnung beim Provider ohne falschen edoobox Zahlungsstatus.
Geheimnisrotation, bei der unveränderte Felder nicht überschrieben werden.
Teilrückerstattung und zweiter Vorgang bis zum verbleibenden Betrag.
Rückerstattungsfehler mit dokumentierter Provider-Meldung.
Anwendungsbeispiel: Neue Saferpay-1.50-Verbindung
Die Administration erhält vier Zugangswerte von Worldline, speichert sie mit Version 1.50 und prüft den Aktivstatus. Eine interne Zahlung kontrolliert Provider-Rückleitung, edoobox Transaktion, Buchung und Bestätigungsmail.
Anwendungsbeispiel: Secret Key wird rotiert
Worldline stellt einen neuen Secret Key bereit. Das Team trägt nur den neuen Secret ein, lässt den weiterhin gültigen API-Schlüssel leer und speichert. Danach wird sofort eine Testzahlung durchgeführt, ohne die Geheimnisse in einem Screenshot zu dokumentieren.
Anwendungsbeispiel: Teilrückerstattung schlägt zunächst fehl
Eine Saferpay-Transaktion befindet sich noch in einem ungeeigneten Providerstatus. edoobox zeigt die konkrete Rückerstattungsmeldung. Das Team notiert Provider-ID und Text, wartet auf den korrekten Status und versucht nur den weiterhin rückerstattbaren Betrag erneut.
Aktuelle Verbindung und Zahlungszweck kontrollieren
Wenn eine Zahlungsart im Worldline-Konto freigeschaltet ist, testen Sie sie mit der tatsächlich verwendeten Angebotswährung. Der edoobox-Aktivschalter bestätigt nur die konfigurierte Verbindung; Vertrag und Terminal bestimmen weiterhin, welche Methoden akzeptiert werden.
Bei einem Fehler notieren Sie Betrag, Währung, Zeitpunkt, Buchungsnummer und Providerreferenz. Prüfen Sie im Anbieterportal, ob bereits eine erfolgreiche Zahlung oder Rückerstattung existiert, bevor Sie denselben Vorgang erneut auslösen.