CCV Shop

Schritt 1: Account anlegen

Haben Sie schon einen payever Account? Falls nein, können Sie hier einen erstellen oder falls bereits vorhanden, hier einloggen.

Schritt 2: Zahlungsarten 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 auch die 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 Sofortüberweisung, Ratenkauf (DE), Rechnungskauf (DE,NO), Zinia (DE, NL), Direktüberweisung (DE, AT, CH) und Ratenkredit (DE, AT, NL, 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).

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

Wählen Sie in der Checkout App den Reiter Kanäle aus.

Klicken Sie auf + Hinzufügen. 

Aus der nun erscheinenden Liste wählen Sie CCV Shop aus und klicken Sie auf Installieren.

Nun müssen Sie auf Öffnen 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

Melden Sie sich in Ihrem CCV-Shop-Backend an, gehen Sie zum App Store und suchen Sie in der Kategorie Zahlungsmethoden nach unserer App. Klicken Sie auf die blaue Schaltfläche Installieren.

Schritt 5: Plugin konfigurieren

Geben Sie die API-Schlüssel ein, die Sie in Ihrem payever-Konto generiert haben (siehe Schritt 3) und stellen Sie den Modus auf Live ein (es sei denn, Sie möchten zuerst testen - in diesem Fall lesen Sie bitte den Abschnitt zum Sandbox-Modus).

Wenn Sie die Checkbox Disable redirect anhaken, werden unsere Zahlungsoptionen in einem Iframe auf Ihrer Seite angezeigt (vorausgesetzt, die jeweilige Zahlart unterstützt dies - beachten Sie, dass einige Zahlarten immer im Vollbildmodus geöffnet werden, weil die zugehörigen Anbieter keine iFrame-Integrationen unterstützen). Wenn Sie die Checkbox leer lassen, sieht der Kunde unsere Zahlarten immer im Vollbildmodus (unabhängig davon, ob die gewünschte Zahlart generell iFrame-Integrationen unterstützt oder nicht).

Bestätigen Sie Ihre Konfigurationen mit einem Klick auf Save.

Schritt 6: Zahlarten konfigurieren

Klicken Sie auf Mein Webshop > Einstellungen und wählen Sie Bestellprozess & Lagerbestand aus. Wählen Sie Zahlungsarten aus, um Ihre Zahlungsarten einzusehen und zu verwalten.

Ganz oben auf der Seite, die sich nun öffnet, sehen Sie in der Regel zuerst die CCV-Zahlarten – scrollen Sie nach unten, um zu den von payever bereitgestellten Zahlungsoptionen zu gelangen. Hier können Sie unsere Zahlarten aktivieren oder deaktivieren, indem Sie ein Häkchen in das entsprechende Kästchen auf der linken Seite setzen bzw. es entfernen.

Wenn Sie Änderungen vornehmen, vergessen Sie nicht, in der unteren rechten Ecke auf Änderungen Übernehmen zu klicken, bevor Sie fortfahren.

Unter Zahlungsarten Optionen können Sie einige weitere Konfigurationen vornehmen. Sie können die Reihenfolge ändern, in der Ihren Kunden die Zahlarten in Ihrem Checkout angezeigt werden, sowie jeder Zahlart Länder zuweisen. Wenn Sie kein Land zuweisen und diese Einstellungen leer lassen, zeigt der CCV-Shop die Zahlungsoption jedem Kunden an, unabhängig von seiner Adresse. Da wir einige Zahlarten haben, die nur in einem Land verfügbar sind, empfehlen wir Ihnen, diese Einstellungsmöglichkeit zu nutzen, falls Sie eine davon verwenden und in mehr als dieses eine Land verkaufen/liefern (um sicherzustellen, dass Kunden später im Zahlungsprozess nicht auf Fehler stoßen).

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) ein: https://docs.payever.org/resources/de/test-credentials 

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 CCV 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. 

Nach der Integration: Hinweise zur Abwicklung von Zahlungen

Generell sind unsere Plugins so konzipiert, dass alle im payever Account verfügbaren Aktionen auch aus Ihrem CCV Backend heraus initiiert werden können. In der Regel müssen Sie sich nicht in Ihr payever Konto einloggen, um sich beispielsweise über den Status einer Zahlung zu informieren oder eine Zahlung zu stornieren.

Status - Der Status Bezahlt bedeutet, dass die Zahlung erfolgreich und vollständig war - in diesem Fall können Sie die Ware an Ihren Kunden versenden. Abgelehnte Transaktionen werden im payever-Konto als „Fehlgeschlagen/Abgelehnt“ gekennzeichnet und in Ihrem CCV-Shop-Backend als Nicht bezahlt angezeigt.

Capture/ Warenversand – Bitte beachten Sie, dass Sie bei den meisten unserer Zahlungsoptionen die Bestellung als versandt melden müssen, um die Zahlung zu aktivieren/capturen. Sie müssen dies jedoch nicht manuell in Ihrem payever-Account tun - es reicht aus, den Status der betroffenen Bestellung in Ihrem CCV-Backend auf Verschickt zu setzen, nachdem die Ware versendet wurde. Sie können dies tun, indem Sie die Bestellung in Ihrem CCV-Shop-Backend öffnen (Meine Bestellungen > Auftragsverwaltung > Bestellung auswählen), auf Status ändern klicken und den entsprechenden Status aus der Dropdown-Liste auswählen, wie in den folgenden Screenshots gezeigt.