Schritt 1: Voraussetzungen prüfen

Stelle sicher, dass WiseCP installiert ist und du Zugriff auf die Administrationsoberfläche sowie auf die Dateien deiner WiseCP-Installation hast.

Du benötigst außerdem ein Vivid-Money-Konto mit den für die Zahlungsintegration erforderlichen API-Zugangsdaten.

Schritt 2: Modul installieren

1. Erstelle vor der Installation eine Sicherung deiner WiseCP-Dateien.
2. Entpacke das gelieferte Modularchiv.
3. Lade die enthaltenen Moduldateien in die dafür vorgesehene Verzeichnisstruktur deiner WiseCP-Installation hoch. Beachte dabei die mitgelieferte Paketstruktur.
4. Öffne anschließend den Administrationsbereich von WiseCP und navigiere zu den Einstellungen der Zahlungsmethoden.
5. Suche nach Vivid Money und öffne die Konfiguration des Moduls.

Schritt 3: Modul aktivieren

Aktiviere das Modul über die Statusoption. Vergib bei Bedarf einen Anzeigenamen, beispielsweise „Kreditkarte“ oder „Vivid Money“.

Schritt 4: API-Zugangsdaten eintragen

Trage die von Vivid Money bereitgestellten Zugangsdaten in die entsprechenden Felder ein:

• API-Schlüssel (apiKey): API-Zugangsschlüssel des Zahlungsanbieters.
• API-Geheimnis (HMAC): Geheimnis für die erforderliche Authentifizierung.
• Kombinierter API-Schlüssel: Optional, sofern die verwendete API-Konfiguration dieses Format unterstützt.
• CMS-Code: Kennzeichnung des verwendeten Shopsystems, standardmäßig „WiseCP“.

Verwende ausschließlich die Zugangsdaten, die zu deiner jeweiligen Vivid-API-Umgebung gehören.

Schritt 5: Testmodus konfigurieren

Aktiviere den Sandbox-Modus, wenn du die Testumgebung von Vivid verwendest. Bei der späteren Produktivschaltung muss die Einstellung zur verwendeten API-Umgebung passen.

Teste die Zahlungsabläufe zunächst mit den dafür vorgesehenen Testdaten.

Schritt 6: Gebühren und Zahlungsoptionen einstellen

Konfiguriere die gewünschten Einstellungen:

• Gebührenhinweis im Checkout aktivieren oder deaktivieren.
• Gebühreninformationen aus dem Merchant-Portal hinterlegen.
• Optionalen prozentualen Kommissionssatz festlegen.
• Gewünschte Zielwährung auswählen.
• Optionalen minimalen und maximalen Zahlungsbetrag einstellen.
• Akzeptierte und nicht akzeptierte Länder definieren.

Prüfe vor der Freischaltung, ob die gewählte Gebührenkonfiguration zu deinen tatsächlichen Kosten und den geltenden rechtlichen Vorgaben passt.

Schritt 7: Rückleitungs-URLs kontrollieren

Hinterlege beziehungsweise überprüfe die im Modul angezeigten URLs:

• Callback URL: Adresse für die Zahlungsrückmeldung.
• Success URL: Seite nach erfolgreicher Rückleitung.
• Failed URL: Seite nach fehlgeschlagener oder abgebrochener Zahlung.

Stelle sicher, dass die URLs korrekt erreichbar sind und den Anforderungen der Vivid-API entsprechen.

Schritt 8: Einstellungen speichern und testen

Speichere die Konfiguration und führe einen vollständigen Test durch:

1. Erstelle eine Testrechnung in WiseCP.
2. Wähle Vivid Money als Zahlungsmethode.
3. Prüfe, ob die Weiterleitung zur Zahlungsseite funktioniert.
4. Teste erfolgreiche und fehlgeschlagene Zahlungsvorgänge.
5. Kontrolliere die Zahlungsrückmeldung und den Rechnungsstatus in WiseCP.
6. Prüfe bei Problemen die PHP-Fehlerprotokolle, sofern das Debug-Logging aktiviert wurde.

Schritt 9: Produktivbetrieb aktivieren

Nach erfolgreichem Test kannst du auf die Live-API umstellen und die Zahlungsfunktion für deine Kunden freigeben.

Wichtig: Eine Rückleitung auf die Erfolgsseite allein ist kein ausreichender Zahlungsnachweis. Die Rechnungsbuchung muss auf einer zuverlässig validierten Zahlungsbestätigung beruhen. Verlasse dich dabei auf den tatsächlichen Implementierungsumfang des Moduls und die Vorgaben der Vivid-API.

Version: 1.0.14
Release-Datum: 11.10.2026
Status: Stable / Stable Release
Release-Typ: Initial Release
Entwickler: IT-Solutions Frank Schulz