Wix kombiniert Website-Erstellung, E-Commerce-Funktionen und Business-Tools in einer zentralen Plattform und wird von Unternehmen weltweit genutzt. Mit der payever-Integration können Händler ihre Zahlungsprozesse direkt in Wix erweitern und ihren Kund:innen eine größere Auswahl an Zahlungsmöglichkeiten im Checkout anbieten.
Schritt 1: Konto registrieren
Erstellen Sie sich hier, sofern noch nicht geschehen, Ihren kostenlosen payever Account. Sollten Sie bereits einen Account haben, können Sie sich hier einloggen.
Schritt 2: Zahlungsoptionen konfigurieren
Um zu den Zahlungsarten zu gelangen, öffnen Sie zunächst die Checkout App. Klicken Sie dazu entweder auf das Checkout-Symbol in der Kachel Business Apps oder auf Öffnen in der Kachel Checkout.
Sie finden die Zahlarten im Reiter Zahlarten an der linken Navigationsleiste.
Klicken Sie auf + Hinzufügen.
Nun erscheint eine Liste an verschiedenen Zahlarten, die Sie nach Bedarf auswählen können. Klicken Sie hierfür auf installieren.
Nachdem Sie die Zahlart erfolgreich installiert haben, klicken Sie auf Öffnen, um gegebenenfalls die Zugangsdaten einzugeben. Dies können Sie auch zu einem späteren Zeitpunkt unter dem Reiter Connect > Settings konfigurieren.
Nun öffnet sich eine Schaltfläche, deren Aufbau sich je nach Zahlungsart unterschiedlich gestaltet.
Bei den Zahlungsarten Kreditkarte, Lastschrift und Paypal klicken Sie einfach den Verbinden Button und werden zum jeweiligen Anbieter weitergeleitet. Dort verknüpfen Sie entweder Ihren bestehenden Account bei diesem Anbieter, oder erstellen sich einen neuen.
Bei den Zahlungsarten Ratenkauf (DE), Rechnungskauf (DE,NO), Openbank Pay (DE, ES), Direktüberweisung (DE, AT, CH) und Ratenkredit (DE, AT, DK, NO, SE, FI) müssen Sie hier Ihre Zugangsdaten eingeben, die Sie vom Zahlungsanbieter erhalten haben, und anschließend auf Verbinden klicken.
Die Zugangsdaten können je nach Zahlart ganz unterschiedlich aussehen (von nur einem Zahlen/Buchstaben-Code bis hin zu vier ist alles möglich) - Details dazu finden Sie in der Anleitung zur jeweiligen Zahlart.
Unabhängig von der Zahlart, achten Sie bitte darauf, Ihre Zugangsdaten stets in den Reiter Standard bzw. Default einzutragen. Klicken Sie nicht auf + Hinzufügen und tragen dort die Zugangsdaten ein (dies müssen Sie nur dann, wenn Sie für einen besonderen UseCase mehrere Paare Zugangsdaten für die gleiche Zahlart haben - auch in diesen Fällen müssen Sie aber immer erst die Default/Standart-Variante mit Zugangsdaten befüllen, bevor Sie weitere hinzufügen können).
Unabhängig von der Zahlart, achten Sie bitte darauf, Ihre Zugangsdaten stets in den Reiter Standard bzw. Default einzutragen. Klicken Sie nicht auf + Hinzufügen und tragen dort die Zugangsdaten ein (dies müssen Sie nur dann, wenn Sie für einen besonderen UseCase mehrere Paare Zugangsdaten für die gleiche Zahlart haben - auch in diesen Fällen müssen Sie aber immer erst die Default/Standart-Variante mit Zugangsdaten befüllen, bevor Sie weitere hinzufügen können).
Nachdem Sie die Zahlarten verbunden haben, können Sie an der Zahlart noch eine oder mehrere Einstellungen treffen - welche genau das jeweils sind und was diese zu bedeuten haben, entnehmen Sie bitte ebenfalls unserer Dokumentation zu der betroffenen Zahlungsart, welche Sie hier finden können.
Schritt 3: Kanal einrichten
Nachdem Sie sich bei payever registriert und die gewünschten Zahlungsoptionen eingerichtet haben, wählen Sie in der Checkout-App die Registerkarte „Kanäle“ aus.
Klicken Sie auf + Hinzufügen.
Aus der nun erscheinenden Liste wählen Sie WIX aus und klicken Sie auf Installieren.
Nun ist auf Öffnen zu klicken, damit Sie im nächsten Schritt die API-Schlüssel generieren können.
1. Wählen Sie den Reiter API Schlüssel und klicken Sie auf + Hinzufügen.
2. Geben Sie dem API Schlüssel einen beliebigen Namen und klicken Sie auf Erstellen.
3. Klicken Sie nun auf das + Symbol.
4. Sie sehen nun die Daten, die Sie später in Ihrem Shop System eingeben müssen (Client ID, Client Secret und Business UUID). Bitte kopieren Sie sich diese in die Zwischenablage.
Schritt 4: Plugin installieren
Die Payever-Integration in Wix wird nicht wie eine normale App aus dem Wix Marketplace installiert. Stattdessen wird sie als benutzerdefinierte Zahlungsanbieter-Einrichtung zu Ihrer Wix-Website hinzugefügt. Das bedeutet, dass die Integration zunächst in Ihrer Website konfiguriert werden muss, bevor sie verbunden und an der Kasse genutzt werden kann. Um mit der Einrichtung zu beginnen, melden Sie sich bei Ihrem Wix Studio-Konto an und klicken Sie oben rechts auf Edit Site (Seite bearbeiten). Stellen Sie sicher, dass der Entwicklermodus in Wix aktiviert ist.
Klicken Sie anschließend auf das Symbol Developer Tools (Entwicklertools) auf der linken Seite, wie im folgenden Screenshot zu sehen ist.
Klicken Sie unter Public & Backend auf das Pluszeichen neben Service Plugins und wählen Sie Payment (Zahlungen) aus.
Sobald Sie die vorherigen Schritte abgeschlossen haben, erstellt Wix automatisch einen Ordner für den Zahlungsanbieter im Bereich Service-Plugins der Code-Seitenleiste. In diesem Ordner finden Sie einen weiteren Ordner, der nach Ihrem Plugin benannt ist. Dieser Ordner enthält zwei Dateien: -config.js und .js.
Benennen Sie den Plugin-Ordner „payever-<selected-payment>“, wobei Sie „<selected-payment>“durch die Zahlungsmethode ersetzen, die Sie integrieren möchten. Achten Sie bitte auf die korrekte Schreibweise und beachten Sie die Groß- und Kleinschreibung. Die genaue Benennung der einzelnen Zahlungsmethoden können Sie hier im GitHub-Repository nachlesen: Git Hub WIX .
In diesem Beispiel ist die Zahlungsmethode HSBC. Sobald der Ordner erstellt wurde, kopieren Sie den Inhalt von /payment-provider/<payment>.config.js und /payment-provider/<payment>.js aus dem GitHub-Repository in die entsprechenden Dateien in Wix Studio.
Klicken Sie im Bereich „Backend“ auf das Pluszeichen (+) und wählen Sie Add Web module (Web Modul hinzufügen). Benennen Sie die neue Datei anschließend „payever.api.js“. Kopieren Sie nach dem Erstellen der Datei den Inhalt von „payever.api.js“ in diese Datei.
Klicken Sie im Bereich Backend erneut auf das Pluszeichen (+) und wählen Sie „.Add .js File“. Kopieren Sie anschließend den Inhalt von „http-functions.js“ in die neu erstellte Datei.
Nun müssen Sie Ihre Änderungen veröffentlichen, indem Sie oben rechts auf Publish (Veröffentlichen) klicken
Schritt 5: Mit payever verbinden
Sobald Sie unser Plugin installiert haben, öffnen Sie Ihr Wix-Dashboard, navigieren Sie zu Settings (Einstellungen) und wählen Sie Accept payments (Zahlungen akzeptieren) aus.
Aktivieren Sie anschließend die ausgewählte Zahlungsmethode und klicken Sie auf Connect (Verbinden).
Die folgenden Einstellungen können nun konfiguriert werden:
Environment (Umgebung): Bitte deaktivieren Sie den Sandbox-Modus, es sei denn, Sie möchten zunächst Testtransaktionen durchführen. Wenn Sie die Integration vor der Inbetriebnahme testen möchten, wählen Sie „Live“. Weitere Informationen zum Testen finden Sie am Ende dieses Artikels.
Client-ID, Client-Secret und Business-UUID: Bitte geben Sie die Zugangsdaten ein, die Sie zuvor in Ihrem payever-Konto generiert haben. Wenn Sie den Sandbox-Modus verwenden, nutzen Sie bitte die entsprechenden Sandbox-Anmeldedaten.
Redirect directly to PSP (Direkt zum Zahlungsdienstleister weiterleiten): Diese Option legt fest, ob Kunden während des Bezahlvorgangs direkt auf die Zahlungsseite des Zahlungsdienstleisters weitergeleitet werden, um die Zahlung abzuschließen.
Site-URL: Bitte geben Sie die vollständige URL Ihrer Wix-Website ein.
Sobald Sie alle erforderlichen Informationen eingegeben haben, klicken Sie auf Connect (Verbinden).
Die Integration ist nun abgeschlossen.
Das Plugin Testen: der Sandbox-Modus
Sie möchten das Plugin und die Zahlungsmöglichkeiten testen, bevor Sie live gehen? Kein Problem – es gibt den sogenannten Sandbox-Modus, in dem Transaktionen ohne tatsächliche Zahlungsabwicklung durchgeführt werden können. Um den Sandbox-Modus zu aktivieren, ändern Sie den Modus in den Einstellungen des payever Plugins auf Sandbox und geben Sie die hier bereitgestellten Testzugangsdaten (Business UUID, Client Secret, Client ID).
Nachdem Sie die Zugangsdaten und den Modus geändert haben, klicken Sie auf "Speichern", damit Ihre Änderungen wirksam werden. Sie befinden sich jetzt im Sandbox-Modus!
Beachten Sie, dass Sie im Sandbox-Modus nicht mit Ihrem eigenen payever-Konto verbunden sind, sondern mit unserem allgemeinen Testkonto – daher sehen Sie im Sandbox-Modus alle verfügbaren Zahlungsmethoden in Ihrem WIX Shop, und nicht nur die, die Sie in Ihrem payever Live Account verwenden.
Um die verschiedenen Zahlungsstatus im Sandbox-Modus zu testen, verwenden Sie bitte die entsprechenden Stub-Daten, die Sie hier finden.
Jetzt können Sie das Plugin testen, ohne eine echte Transaktion auszulösen. Wir bitten Sie, möglichst nur im Sandbox-Modus zu testen, da Testtransaktionen im Live-Modus, auch wenn sie nachträglich storniert werden, unerwünschte Folgen haben können (so können z.B. Gebühren anfallen, oder Sie können als Kunde bei Rechnungskauf- und Ratenzahlungs-Dienstleistern vorübergehend gesperrt werden).
Wenn Sie mit dem Testen fertig sind und live gehen möchten:
- Vergessen Sie bitte nicht, die Testdaten zu entfernen und stattdessen Ihre eigenen Daten aus Ihrem payever Account (siehe Schritt 3) einzutragen und abzuspeichern. Sie können weder Ihre Live-Daten im Sandbox-Modus nutzen, noch können Sie unsere Testdaten in Live verwenden!
- Beachten Sie außerdem, dass getroffene Einstellungen (Plugin-Einstellungen, Namen und Texte der Zahlarten, etc.) beim Wechsel zwischen Live- und Sandbox-Modus (egal in welche Richtung) verloren gehen können. Mit dem Wechsel setzen Sie diese Einstellungen ggf. automatisch zurück - wenn Sie also im Sandbox-Modus alles konfiguriert haben, zufrieden sind und somit live gehen wollen, merken Sie sich bitte, was Sie eingestellt hatten, und prüfen & wiederholen Sie diese Einstellungen nochmal, nachdem Sie in den Live-Modus gewechselt haben.
Um den Staging-/Sandbox-Modus zu aktivieren, setzen Sie Environment auf Sandbox
Nach der Integration: Informationen zur Zahlungsabwicklung
Generell sind unsere Plugins so konzipiert, dass alle im payever-Konto verfügbaren Aktionen auch über Ihr WIX-Backend ausgelöst werden können. In der Regel müssen Sie sich nicht in Ihr payever-Konto einloggen, um beispielsweise den Status einer Zahlung abzurufen, oder eine Zahlung zu stornieren!
Statusmeldungen – Der Zahlungsstatus In Progress (In Bearbeitung) tritt in der Regel nur bei Ratenkrediten auf und bedeutet, dass die Zahlung noch nicht abgeschlossen ist (der Kunde muss noch einen Identifizierungsprozess durchlaufen und/oder erforderliche Dokumente einreichen). Wenn Sie diesen Status sehen, warten Sie bitte ab und versenden Sie die Ware noch nicht an Ihren Kunden. Der Status Accepted (Akzeptiert) bedeutet, dass die Zahlung erfolgreich und abgeschlossen ist – in diesem Fall können Sie die Ware an Ihren Kunden versenden. Der Status Cancelled (Storniert) bedeutet, dass die Zahlung fehlgeschlagen ist, abgelehnt wurde oder von Ihnen storniert wurde (auch hier gilt: Versenden Sie bei diesem Status keine Ware an Ihren Kunden).
Erfassung / Warenversand – Bitte beachten Sie, dass Sie bei einigen unserer Zahlungsmethoden (z. B. Rechnung und Ratenkredit, möglicherweise auch PayPal und Kreditkarte, sofern Sie die automatische Erfassung für diese Zahlungsoption in den Einstellungen deaktiviert haben) den Warenversand melden müssen. Dies müssen Sie jedoch nicht manuell tun; es reicht aus, wenn Sie den Status der betreffenden Bestellung in WIX nach dem Versand der Ware auf „Bezahlt“ setzen.
Stornierungen und Rückerstattungen – Wenn Sie eine Transaktion teilweise oder vollständig erstatten möchten, öffnen Sie bitte die Bestelldetails. Für eine Stornierung wählen Sie „Stornieren / Gutschrift“, für eine Teilrücksendung oder Teilstornierung wählen Sie bitte „Teilrückerstattung“ und geben Sie den zu erstattenden Betrag ein.
Bitte beachten Sie jedoch, dass nicht alle unsere Zahlungsmethoden über eine automatische Stornierungsfunktion verfügen: Ratenkredite können nur über payever / WIX storniert werden, bevor die Ware an den Kunden versandt wird. Direktüberweisungen und Lastschriften können nur von Ihrem Bankkonto aus durch eine Überweisung an den Kunden erstattet werden.
Noch Fragen oder Probleme?
Sie erreichen unseren kostenlosen Support Montags bis Freitags zwischen 8 und 17 Uhr unter support@payever.de
Bitte teilen Sie uns in Ihrer Nachricht mit, welches Shopsystem und welche Plugin-Version Sie verwenden, um welchen Shop (URL und/oder E-Mail-Adresse mit der Sie bei uns registriert sind) es bei Ihrer Anfrage geht und welche Fehlermeldung/Störung Sie an welcher Stelle bemerkt haben - so können wir Ihr Anliegen schneller bearbeiten! Schicken Sie gerne Screenshots mit, die uns helfen die Problematik nachzuvollziehen.