Einführung

Bei dem Saferpay Modul handelt es sich um eine Zahlungsschnittstelle welche eine Verbindung zum Saferpay Zahlungsdienst aufbaut und den Benutzer über Saferpay die möglichkeit Möglichkeit gibt zu bezahlen.
Weitere Informationen finden Sie direkt beim Anbieter unter: https://www.six-payment-services.com/de/site/e-commerce/solutions/paymentsolution.html?gclid=EAIaIQobChMI9rKd-Oyj6QIVlOR3Ch0mggdyEAAYASAAEgJ56PD_BwE#country=chWir unterstützen Saferpay in der

Info
title Versionshistorie
API Version 1.16 ab DRUCKSHOP 6.10.0 API Version 1.17 ab DRUCKSHOP 6.11.0 API Version 1.20 ab DRUCKSHOP 6.26.0

Saferpay unterstützt alle bekannten Zahlungsmethoden, darunter auch 3rd-Party Anbieter, wie zum Beispiel PayPal oder ApplePay.

Image Added

Eine vollständige liste finden sie unter: https://www.six-payment-services.com/de/site/e-commerce/learn-more/merchant.html#saferpay-jso
Sie können Ihren Kunden also über nur eine Schnittstelle viele verschiedene Zahlungsarten zur Verfügung stellen.
Was für Sie weniger aufwand mit der Verwaltung verschiedener Schnittstellen bedeutet da Sie nur eine und nicht 6 Schnittstellen verwalten müssen.

Administration:

Shop Bereich:

Sobald das Modul aktiviert ist taucht am ende der Seite "Einstellungen => Zahlarten" das Saferpay Modul auf:

Image Removed

Dort müssen folgende Daten welche man zuvor von Saferpay erhalten hat eingegeben werden:

Kunden ID

Dies macht die Verwaltung für Sie deutlich komfortabler.

Administration > Zahlarten ( Einstellungen )

In der Administration können Sie das Modul unter Einstellungen > Zahlarten konfigurieren.

Globalen Einstellungen von Saferpay

Anker
GlobaleSaferpaySettings GlobaleSaferpaySettings

Hier finden sie die Globalen Einstellungen von Saferpay sowie die Möglichkeit ein neues Saferpay Modul anzulegen

Dort müssen von Ihnen folgende Daten ausgefüllt werden damit Sie das Modul verwenden können und im weiteren Schritt Zahlungsarten anlegen können.

• Kunden ID (Heißt bei Saferpay "Kundennummer" bsp: 212412)
  
• User
• Passwort
• Währungscode (gemäß ISO4217) (bsp: EUR, USD)

Bei diesen Angaben handelt es sich nicht um Printshop Kunden ID, User oder Passwort sondern um die Saferpay-Login Daten welche Sie von Saferpay erhalten haben bzw. Sie können diese im SAFERPAY-Backend eigenständig generieren indem Sie einen neuen JSON API Login erstellen.

Sollten sie Wünschen können sie hier auch zwischen dem Live und Demo System von Saferpay wechseln und die Schnittstelle erst einmal testen. Beachten Sie bitte, dass die Schnittstelle im Shop Bereich nur angezeigt wird wenn das Modul in den Globalen Einstellungen von Saferpay aktiviert wurde.

Image Added

Neues Saferpay Modul anlegen 

Anker
NewSaferpayModule NewSaferpayModule

Nun können Sie Zahlungsarten unterhalb der Globalen Einstellungen von Saferpay im Bereich Neues Saferpay Modul anlegen, anlegen.
Beim anlegen
Image Added

Achten Sie bitte darauf, dass sie nur Zahlarten auswählen welche von Ihrer hier angegeben Terminal ID auch abgedeckt sind.
Beim Anlegen einer neuen Zahlart über das Saferpay Modul müssen die folgenden Felder ausgefüllt werden, damit die Funktion gewährleistet ist:

• Bezeichnung der Zahlart( Diese Bezeichnung wird dem Kunden angezeigt. )
• Terminal ID ( Die Terminal ID finden Sie im Saferpay Backoffice )
• Zahlart Zahlarten ( Es können mehrere Zahlarten ausgewählt werden. )
• Info ( Wird als Info Button rechts neben dem Dropdown Menü angezeigt )

ausgewählt werden.

Die gewählte Terminal ID muss die gewählten Zahlarten abdecken. Wenn dem nicht so ist werden automatisch alle möglichen Zahlarten angezeigt welche die Terminal ID unterstützt.

Image Removed

Um das ganze zu testen können sie ganz einfach ein Produkt bestellen und den normalen Prozess durchlaufen. als Zahlart wählen sie die von Ihnen zuvor erstellte Zahlart aus und klicken dann auf Zahlungspflichtig bestellen

Sie sollten nun auf die Zahlungsseite von Saferpay geleitet werden.

Image Removed

Dort wählen sie die gewünschte Zahlart an und nutzen die von Saferpay zur verfügung gestellten Daten unter: https://saferpay.github.io/sndbx/paymentmeans.html

Image Removed

Durchlaufen Sie dann den Bestellprozess welcher von Saferpay vorgegeben wird und bezahlen sie ganz normal.

Am Ende sollten Sie folgende Seite sehen welche dann zeigt das der Bestellprozess durchlaufen ist.

Image Removed

Image Removed

Haben sie alle Einstellungen vorgenommen können Sie das Modul im Shop Bereich online stellen indem Sie im Bereich Globale Einstellungen von Saferpay in den Button Aktivieren ein häcken rein machen.

Sobald die Zahlungsdaten eingegeben und abgesendet wurdenm wird der Kunde wieder zurück in den DRUCKSHOP geleitet und die Zahlung ist somit abgeschlossen. 

Image Added

Administration > Auftragsdetails ( Zahlungshistorie )

Auf der Auftragsdetailseite finden Sie ab sofort einen neuen Bereich "Zahlungshistorie". Hier finden Sie sämtliche Aufrufe welche in Richtung Saferpay getätigt werden.
Sollten Probleme beim Bezahlvorgang auftreten werden sie hier gezeigt.

Image Added

Hier einige Beispiele von Fehlermeldungen welche Sie hier finden können. Die Saferpay Schnittstelle kann bei folgenden Problemen eine Ausgabe auf der auftrag detail seite Auftragsdetailseite liefern:

• Invalid License: Der genutzte Account ist nicht aktiv und sie müssen sich mit Saferpay in Verbindung setzen um diese zu aktivieren oder korrekt zu erhalten.
• Invalid credentials: Die genutzen genutzten API Daten sind nicht korrekt, überprüfen Sie diese bitte.
• Invalid action: Die Zahlung ist abgeschlossen oder gecanceled worden und es wird versucht diese in einen nicht mehr gültigen Zustand zu bringen.
• Action blocked by risk management: Lösen sie dieses im Saferpay Risk Management Backoffice

Weitere Fehlermeldungen welche sie unter https://saferpay.github.io/jsonapi/#errorhandling