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 gibt zu bezahlen.
https://www.six-payment-services.com/de/site/e-commerce/solutions/paymentsolution.html?gclid=EAIaIQobChMI9rKd-Oyj6QIVlOR3Ch0mggdyEAAYASAAEgJ56PD_BwE#country=ch
Wir unterstützen Saferpay in der
API Version 1.17
Saferpay unterstützt alle bekannten Zahlungsmethoden, darunter auch 3rd-Party Anbieter, wie zum Beispiel PayPal.
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
In der Administration können sie das Modul nachdem Sie sich in Ihren Account eingeloggt haben und das Modul für sich Aktiviert ist an folgender Stelle finden:
Dort wird das Saferpay Modul ganz unten als letztes aufgelistet unter dem Namen: Saferpay JSON API Spec-Version 1.17
Hier finden sie die Globalen Einstellungen von Saferpay sowie Neues Saferpay Modul anlegen
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
- User
- Passwort
- Währungscode (gemäß ISO4217) (bsp: EUR, USD)
Nun können Sie Zahlungsarten unterhalb der Globalen Einstellungen von Saferpay im Bereich Neues Saferpay Modul anlegen, anlegen.
hierbei achten sie bitte darauf das sie nur Zahlarten auswählen welche von ihrere hier angegeben Terminal Id auch abgedeckt sind. Da ansonsten alle Zahlarten angeboten werden welche Saferpay bei dieser Terminal Id hinterlegt hat.
Beim anlegen einer neuen Zahlart über das Saferpay Modul müssen die Felder:
- Bezeichnung ( Diese Bezeichnung wird dem Kunden angezeigt. )
- Terminal ID ( Die Terminal ID finden Sie im Saferpay Backoffice )
- Zahlart ( 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.
Unbedingt ausgefüllt werden da es ansonsten keine funktionierende Schnittstelle darstellt und der Kunde im Shop Bereich ein Problem beim auswählen der Zahlart hat.
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.
Sollten sie Wünschen können sie hier auch zwischen dem Live und Demo System von Saferpay wechseln und die Schnittstelle ersteinmal testen. Bedenken sie das in jedemfall die Schnittstelle im Shop Bereich nur angezeigt wird wenn das Modul in den Globalen Einstellungen von Saferpay aktiviert worden ist.
Shop Bereich
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.
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
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.
Die Saferpay Schnittstelle kann bei folgenden Problemen eine Ausgabe auf der auftrag detail seite 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 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