Plentymarkets

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), 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 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ügenund 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 Plentymarkets 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

Laden Sie sich zunächst aus dem Plenty Marketplace unser kostenloses Plugin herunter und installieren Sie dieses in Ihrem Shop.

Sie finden das Plugin anschließend in Ihrem Account unter Plugins > Plugin Übersicht > payever.

Zunächst wählen Sie Ihren Shop aus oder erstellen über das + Symbol einen neuen Reiter.

Achten Sie darauf, dass der payever Plugin aktiviert ist. Klicken Sie dieses nun an, um in die Plugin-Set-Übersicht zu gelangen.

Schritt 5: Plugin konfigurieren

Wählen Sie links den Reiter Einstellungen und nehmen Sie einige Konfigurationen vor.

• Modus: Bitte wählen Sie den Live-Modus (es sei denn Sie möchten zunächst einige Testtransaktionen durchführen, in diesem Fall wählen Sie bitte den Sandbox-Modus aus - mehr Informationen dazu finden Sie am Ende dieser Anleitung). 
• Client ID, Client Secret und Business UUID: Hier geben Sie bitte die Daten ein, die Sie in Schritt 3 in Ihrem payever Account generiert haben (es sei denn Sie befinden sich im Sandbox-Modus). 
• Zahlungsgebühr: Hier können Sie wählen, ob die Zahlungsgebühr angezeigt werden soll (dies ist dringend zu empfehlen wenn Sie entschieden haben, dass der Kunde die Gebühren tragen soll - wenn Sie die Gebühren selbst tragen, ist das nicht nötig! Beachten Sie jedoch bitte, dass dies nur bei einigen Zahlarten geht, bei den Santander Zahlarten z.B. trägt der Händler stets die Gebühren, dies kann auch nicht geändert werden.)
• Icon der Zahlart sichtbar: Wählen Sie hier, ob Sie im Checkout ein passendes Icon für die jeweilige Zahlart angezeigt bekommen wollen (z.B. Santander oder PayPal Logo).
• Beschreibung der Zahlart sicher: Wählen Sie hier, ob Sie im Checkout eine Beschreibung für die jeweilige Zahlart angezeigt bekommen wollen. Fall Sie sich hier für Ja entscheiden, vergessen Sie bitte nicht vor dem Livegang zu überprüfen, ob die Texte für Ihre Situation passen und in der richtigen Sprache sind!
• Integrationsart: Hier empfehlen wir die Einstellung Iframe. Wenn Sie hier Iframe wählen, wird der payever Checkout in einem Bereich/Iframe innerhalb Ihrer Webseite geladen, der Kunde verlässt Ihren Shop nicht. Wählen Sie Redirect wird der Kunde hierfür auf ein neues Fenster mit einer payever URL weitergeleitet.
• Checkout Sprache: Hier wählen Sie entweder die Sprache Ihres Shops oder die Einstellung Standard - diese bewirkt, dass payever automatisch die Sprache wählt, die im Browser dieses Kunden eingestellt ist. 
• Bestellung vor Zahlungseingang anlegen: Hier legen Sie fest, wann genau die Bestellung in Ihrem Shop angelegt werden soll. Bei Ja wird eine Bestellung in Plentymarkets angelegt, sobald der Kunde zu payever weitergeleitet wurde, unabhängig davon ob er dort den Vorgang abschließt oder nicht. Bei Nein werden nur Bestellungen angelegt, die der Kunde abgeschlossen hat, und auch nur dann wenn der Zahlungsanbieter den Kunden akzeptiert hat (abgelehnte Anfragen erzeugen keine Bestellung). Hinweis: Wählen Sie hier die Option Nein, kann es in seltenen Fällen vorkommen, dass trotz Annahme des Kunden durch den Zahlungsanbieter keine Bestellung angelegt wird. Dies passiert dann, wenn der Kunde das Fenster schließt oder z.B. der Browser des Kunden abstürzt, bevor die Bestätigungs-Seite geladen hat, oder es Netzwerkstörungen beim Zahlungsanbieter oder payever gibt.  Grund dafür ist, dass in diesen Fällen die Bestellung dann durch eine späteres Statusupdate erstellt werden müsste, was erfahrungsgemäß aber in Plentymarkets leider nicht richtig funktioniert. 

Klicken Sie nun auf das Speichern-Symbol, um Ihre Änderungen abzuspeichern. 

Schritt 6: Zahlungsarten konfigurieren

Unterhalb der Einstellungen sehen Sie links alle Zahlarten aufgelistet, die Sie in Ihrem Account aktiviert haben (Live-Modus), bzw. alle Zahlungsarten, die payever anbietet (Sandbox-Modus). Hier können Sie nun für jede einzelne Zahlungsart nochmals einige Einstellungen treffen: 

• Aktiviert: Hier können Sie die Zahlart aktivieren und deaktivieren. 
• Titel: Legen Sie fest, welchen Namen die Zahlart in Ihrem Checkout haben soll.
• Beschreibung: Sofern Sie sich dazu entschieden haben, Beschreibungen einzublenden, geben Sie hier bitte eine passende Beschreibung für die Zahlart ein.
• Gebühren übernehmen: Wählen Sie Ja, wenn Sie als Händler die Gebühren tragen wollen. Achtung: bei manchen Zahlarten muss der Händler die Gebühren zahlen, daran ändert auch ein Nein in diesem Fenster nichts. In Ihrem payever Account können Sie an den verfügbaren Einstellungen der jeweiligen Zahlungsart erkennen, ob es hier möglich ist, den Kunden die Gebühren tragen zu lassen. Die Einstellungen in Ihrem payever Account überschreiben zudem diese Einstellung in Plentymarkets (geben Sie im Plugin an, dass der Kunde die Gebühren trägt,  im payever Account aber, dass Sie die Gebühren tragen, tragen Sie die Gebühren). Beachten Sie zudem, dass Plentymarkets Zahlungsgebühren an den Kunden nur begrenzt unterstützt - beim Eingang der Zahlung führt dies noch nicht zu Problemen (Ihnen wird lediglich auffallen, dass die Bestellung als zu mehr als 100% bezahlt angezeigt wird, z.B. 102%), wenn Sie aber eine Bestellung wie hier beschrieben über Plenty stornieren möchten, wird dies auch bei richtiger Konfiguration wie in Schritt 7 beschrieben nicht automatisch an payever weiterübertragen (Aktionen wie Stornierung demnach nur über den payever Account möglich). Demnach empfehlen wir Ihnen hier die Option Ja.
• Minimaler und maximaler Warenkorb: Geben Sie an, für welche Warenkorb-Werte die Zahlungsart angezeigt werden soll. Achtung: vom Zahlungsanbieter festgelegte Limits können mit dieser Einstellung zwar weiter eingegrenzt, aber nicht überschritten werden. Brauchen Sie ein höheres Limit als standardmäßig vom Zahlungsanbieter gewährt, setzen Sie sich bitte mit dem Zahlungsanbieter in Verbindung und geben Sie uns Ihr abweichendes Limit ebenfalls bekannt (support@payever.de). 
• Erlaubte Länder: Bitte wählen Sie nur Länder, die der jeweilige Zahlungsanbieter tatsächlich auch bedient.
• Erlaubte Währungen: Bitte wählen Sie nur Währungen, die der jeweilige Zahlungsanbieter tatsächlich auch bedient (Santander Deutschland und Sofortüberweisung: nur €).

 

Schritt 7: Automatischen Statusupdate zwischen payever und Plentymarkets einrichten

Wir empfehlen Ihnen aus Gründen der Zeitersparnis und Fehlerreduktion, Statuses und Aktionen zwischen payever und Plentymarkets automatisch abgleichen zu lassen. Hierfür müssen Sie konfigurieren, welche Status-Meldungen und Aktionen in Plentymarkets mit welchen Statusmeldungen und Aktionen in payever verknüpft werden sollen. Öffnen Sie dazu bitte Einrichtung > Aufträge > Ereignisse.

Sie brauchen insgesamt drei Ereignisse: eines für die Meldung des Versands an payever (zum Capturen der Zahlung), eines für Stornierungen und eines für Erstattungen.

Klicken Sie unten link auf das + Symbol, um ein neues Ereignis zu erstellen. Vergeben Sie einen passenden Namen, zum Beispiel "payever Versand", und wählen Sie bei Ereignis Statuswechsel aus dem Dropdown aus. Im dritten Feld wählen Sie 7) Warenausgang gebucht.

Vergessen Sie nicht Ihre Ereignisaktion zu speichern bevor Sie fortfahren.

Nun klicken Sie auf das Plus-Symbol (+) neben Aktionen und wählen aus der Liste folgendes Event aus (am Besten einfach in das Suchfeld eingeben, so finden Sie es am schnellsten): Versand der Auszahlung (falls Sie Plenty auf Englisch verwenden: Shipping the payever payment).

Nun aktivieren Sie noch Ihr neues Ereignis und speichern dieses ab.

Nun wiederholen Sie das selbe Prozedere für die Erstattung und die Stornierung. Für die Erstattung wählen Sie zunächst wieder das Event Statuswechsel und wählen dann den Status 9) Retoure. Anschießend klicken Sie wieder auf das + Aktionen Symbol und verknüpfen es mit dem Event Rückzahlung der payever-Zahlung (bzw. Refund the payever payment).

Für die Stornierung verknüpfen Sie Status 8) Storniert mit Stornieren sie die Auszahlung (bzw. Cancel the payever payment). Vergessen Sie auch hier das aktivieren und speichern der Ereignisse nicht!

Wenn Sie alles richtig gemacht haben, sollten die beiden Ereignisse bei Ihnen so aussehen:

Erstattung:

Stornierung:

 

Achtung: Nicht bei allen Zahlarten sind Erstattungen und Stornierungen unbegrenzt möglich. Beim Ratenkredit z.B. funktioniert nur der Storno automatisiert und dies auch nur vor Warenversand, Stornierungen nach Warenversand müssen per Email an die Santander gemeldet werden. Bei der Direktüberweisung sind weder Erstattung noch Stornierung möglich, hier muss im Fall eines Stornos/einer Retoure das Geld einfach zurücküberwiesen werden. 

 

Schritt 8: Das Plugin bereitstellen

Als letzten Schritt müssen Sie, falls dies noch nicht der Fall ist, das Plugin-Set bereitstellen. Dies können Sie über das Speichern-Symbol in der oberen Leiste durchführen. Es kann einige Minuten dauern, bis das Plugin-Set bereitgestellt ist.

Achtung: Verwenden Sie das PayPal-Plus Iframe?

Generell ist die Kombination des PayPal Plus Iframes mit unseren Zahlarten möglich, allerdings ist die Formatierung (Icon & Beschreibung) innerhalb des PayPal Plus Iframes suboptimal und kann leider nicht angepasst werden. Beachten Sie außerdem, dass Sie die Zahlart explizit zum PayPal Plus Iframe hinzufügen müssen, wenn Sie möchten, dass die Zahlart innerhalb dieses Iframes angezeigt wird. Tun Sie das nicht, wird die Zahlart unterhalb des Iframes separat angezeigt (und kann so ggf. vom Kunden übersehen werden).

 

Das Plugin Testen: der Sandbox-Modus

Möchten Sie das Plugin zuerst testen? Bitte aktivieren Sie dazu den Sandbox Modus, tragen Sie  in die Felder Business UUID, Client Secret und Client ID unsere Testdaten ein, die Sie hier finden, und speichern Sie ab.

Im Sandbox-Modus werden Sie nicht mit Ihrem eigenen payever Account verbunden, sondern mit unserem generellen Test-Account - deswegen bekommen Sie hier nun auch alle verfügbaren Zahlarten angezeigt, nicht nur die, die Sie in Ihrem payever Account aktiviert haben (Sie werden diese Test Transaktionen auch nicht in Ihrem payever Account sehen). 

Um die Bezahlung im Testmodus bestätigt zu bekommen, nutzen Sie bitte die entsprechenden Test-Daten, die Sie hier finden können.

Nun können Sie das Plugin testen, ohne dabei eine echte Transaktion auszulösen. Wir möchten Sie bitten, ausschließlich im Sandbox Modus zu testen, da Test-Transaktionen in Live, auch wenn Sie diese anschließend umgehend stornieren, ungewünschte Folgen haben können (testen Sie z.B. zu oft mit Ihrer Kreditkarte kann diese ggf. gemeldet und gesperrt werden, stellen Sie mehrfach Ratenkredit-Anträge auf Ihren Namen, kann dies Ihren Schufa-Score verschlechtern, etc.). 

Wenn Sie mit 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, zu speichern und anschließend zu synchronisieren (sonst erhalten Sie beim Synchronisieren eine Fehlermeldung). 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. Mit jedem Synchronisierungs-Vorgang setzen Sie diese Einstellungen 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 wiederholen Sie diese Einstellungen nochmal, nachdem Sie in den Live-Modus gewechselt und synchronisiert 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 Plentymarkets Backend heraus angestoßen werden können. In der Regel brauchen Sie sich also nicht in Ihren payever Account einzuloggen, um sich über den Status einer Zahlung zu informieren oder z.B. eine Zahlung zu stornieren!

Statusmeldungen - der Zahlungsstatus (3) Warten auf Zahlung bedeutet, dass der Kunde die Zahlung begonnen, aber noch nicht abgeschlossen hat (Kunde wurde zu payever weitergeleitet und füllt gerade Daten ein, hat das Formular aber noch nicht vollends ausgefüllt und abgeschickt). Hin und wieder kommt es vor, dass ein Kunde die Zahlung nicht abschließt - in diesem Fall wird die Bestellung nach 8 Stunden von uns automatisch storniert. 

Der Status (3.3) Versandfertig; warten auf Zahlung tritt i.d.R. nur beim Ratenkredit auf und bedeutet, dass die Zahlung noch nicht vollständig ist (Kunde muss noch einen Identifizierungsprozess durchlaufen und/oder Dokumente nachreichen). Wenn Sie diesen Status sehen, warten Sie bitte ab und versenden Sie die Ware noch nicht. Der Status 3.3 kann auch bei der Kreditkartenzahlung auftreten, sofern Sie dort im payever Account das manuelle Capture ausgewählt haben (In diesem Fall bedeutet Status 3.3, dass die Zahlung angenommen, aber noch nicht eingezogen wurde).

Der Status (5) Freigabe Versand bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden.

Der Status (8) Storniert bedeutet, dass die Zahlung fehlgeschlagen ist, vom Zahlungsanbieter abgelehnt wurde oder durch Sie storniert (auch hier keine Ware versenden). 

Capture/ Warenversand - Bitte beachten Sie, das bei einigen unserer Zahlungsarten (definitiv bei Rechnungskauf, Ratenkauf und Ratenkredit, ggf. auch PayPal und Kreditkarte, sofern Sie sich dort in den Einstellungen gegen ein automatisches Capture entschieden haben), den Warenversand melden müssen. Dies müssen Sie allerdings nicht händisch erledigen, es reicht aus, wenn Sie den Status der betroffenen Bestellung nach dem Warenversand in Plentymarkets auf (7) Warenausgang gebucht setzen. Bitte beachten Sie, dass dies nur gilt, wenn Sie Schritt 7 befolgt haben - haben Sie diesen Schritt ausgelassen findet gar keine automatische Übertragung statt, haben Sie einen anderen Status als Status 7 festgelegt (z.B. 6 oder 7.1) müssen Sie dementsprechend diesen Status setzen, um den Warenversand zu melden. Nur für Santander Ratenkredit Österreich gilt zusätzlich: Senden Sie regelmäßig Ihre Rechnungen an teilzahlung@santanderconsumer.at, um die Auszahlungen des Kreditbetrags zu erhalten.

Stornierungen und Erstattungen - Wenn Sie eine Transaktion erstatten möchten, können Sie dies tun, indem Sie die Bestellung auf Status 8 Storniert bzw. Status 9 Retoure umstellen. Teilstornierungen- und Retouren können Sie allerdings nicht über Plentymarkets anfragen, dies geht nur über Ihren payever Account (unter Transactions App > betroffene Transaktion anklicken > oben rechts "Erstattung" oder Dreipunktmenü > "Stornierung"). 

Bitte beachten Sie dabei aber, dass nicht alle unsere Zahlarten über eine automatische Stornierungsfunktion verfügen: Den Ratenkredit Deutschland können Sie nur vor dem Warenversand über payever/Shopware stornieren (danach nur händisch per Email an cfs-abrechnung@santander.de), Direktüberweisungen und Lastschriften können nur über eine Rücküberweisung an den Kunden von Ihrem Bankkonto aus erstattet werden. Außerdem haben nicht alle Zahlarten sowohl Storno- als auch Erstattungs-Funktion, einige haben nur jeweils eines davon (Sofortüberweisung und Kreditkarte nur Erstattung, Ratenkredit Deutschland nur Stornierung).

 

Noch Fragen oder Probleme?

Sie erreichen unseren kostenlosen Support Montags bis Freitags zwischen 8 und 19 Uhr unter support@payever.de 

Bitte teilen Sie uns in Ihrer Nachricht mit, welche Plentymarkets und Plugin-Version Sie verwenden, um welchen Shop (URL und/oder Email-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!