Schritt 1: Account anlegen
Erstellen Sie sich hier, sofern Sie das noch nicht getan haben, Ihren kostenlosen payever Account. Alternativ können Sie sich auch hier einloggen.
Schritt 2: Zahlungsart 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 Zahlungsarten im Reiter Zahlungsarten an der linken Navigationsleiste.
Klicken Sie auf + Hinzufügen.
Nun erscheint eine Liste an verschiedenen Zahlungsarten, die Sie nach Bedarf auswählen können. Klicken Sie hierfür auf installieren.
Nachdem Sie die Zahlungsart 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), Direktüberweisung (angeboten von Santander DE, aber auch verfügbar in AT) und Ratenkredit (DE, AT) müssen Sie hier Ihre Zugangsdaten eingeben, die Sie von der Santander erhalten haben, und anschließend auf Verbinden klicken.
(Sofern noch kein Kontakt zur Santander besteht: Sie erreichen die deutsche Niederlassung der Santander Consumer Bank unter ecommerce@santander.de, die Österreichische unter sales.ecommerce@santanderconsumer.at).
Die Zugangsdaten können je nach Zahlungsart 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 Zahlungsart.
Unabhängig von der Zahlungsart, 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 Zahlungsart 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 Zahlungsarten verbunden haben, können Sie an der Zahlungsart 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 Commercetools 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 eingeben müssen (Client ID, Client Secret und Business UUID). Bitte kopieren Sie sich diese in die Zwischenablage.
Schritt 4: Adapter Installieren
Installieren Sie den payever Adapter in Ihrem Commercetools Projekt. Richten Sie sich dabei nach der allgemeinen Vorgehensweise, wie sie in der Dokumentation von Commercetools beschrieben ist.
Notieren Sie sich aus Ihrem Commercetools Projekt den Commercetools Project Key, die Commercetools Client ID und das Commercetools Secret, welche Sie im nächsten Schritt benötigen werden.
Schritt 5: Verbindung herstellen
Klicken Sie auf "Verbindung hinzufügen" und füllen Sie in das nun erscheinende Formular die Commercetools-Daten aus Schritt 4 sowie die payever API Keys aus Schritt 3 ein.
Sie können zudem einen Namen für die Verbindung festlegen ("Connection Name", frei wählbar) sowie in den Feldern Success URL, Pending URL, Failure URL und Cancel URL jeweils die URL eingeben, auf die wir Ihren Kunden im Falle einer erfolgreichen Zahlung, einer abgelehnten Zahlung, etc. weiterleiten sollen.
Under "Order creation Status" können Sie auswählen, ab welchem Zahlungs-Status unser Adapter eine Bestellung in Commercetools generieren soll. Stellen Sie hier "new" ein, generieren wir die Bestellung in Commercetools sobald der Bezahlvorgang begonnen wurde, stellen Sie "Paid" ein, erstellen wir die Bestellung erst dann, wenn die Zahlung abgeschlossen und erfolgreich gecaptured wurde.
2.) Technische Implementation
Unsere technische Dokumentation zur Einbindung unseres Adapters in Ihren Shop finden Sie hier:
https://support.payever.org/hc/en-us/articles/6699064172316-Commercetools
3.) Versand erfassen, Stornieren und Erstattung einer Transaktion in Commercetools
- Versand erfassen: Um den Versand zu erfassen, müssen Sie auf die Bestellseite im Händlerzentrum von Commercetools gehen und den Versandstatus auf Versendet oder Ausgeliefert ändern.
- Rückerstattung: Wenn Sie Ihrem Kunden das Geld zurückerstatten möchten, z.B. wenn er einen Artikel zurückgegeben hat, müssen Sie die Bestellseite im Händlerzentrum von Commercetools öffnen -> Rücksendung und Rückgabe erstellen. Dort müssen Sie die Anzahl der Artikel auswählen, die zurückgegeben werden sollen, und am Ende auf die Schaltfläche "Speichern" klicken.
- Zahlung stornieren: Wenn Sie eine Zahlung autorisiert haben, diese aber nicht ausführen möchten, müssen Sie eine Stornierungsanfrage stellen, um den Betrag an den Käufer zurückzuerstatten. Wenn die Zahlung bereits verbucht wurde, müssen Sie sie stattdessen eine Rückerstattung durchführen.
Um eine Stornierung vorzunehmen, gehen Sie auf die Bestellseite im Händlerzentrum von Commercetools und ändern Sie den Bestellstatus in Storniert.