| Inhalt |
|---|
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.
Weitere Informationen finden Sie direkt beim Anbieter unter: https://www.six-payment-services.com/de/site/e-commerce/solutions/paymentsolution.html
| Info | ||
|---|---|---|
| ||
API Version 1.16 ab DRUCKSHOP 6.10.0 |
Saferpay unterstützt alle bekannten Zahlungsmethoden, darunter auch 3rd-Party Anbieter, wie zum Beispiel PayPal oder ApplePay.
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. 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 | ||||
|---|---|---|---|---|
|
Dort wird das Saferpay Modul ganz unten als letztes aufgelistet unter dem Namen: Saferpay JSON API Spec-Version 1.20
Hier finden sie die Globalen Einstellungen von Saferpay sowie
die Möglichkeit ein neues Saferpay Modul
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.
Neues Saferpay Modul anlegen
| Anker | ||||
|---|---|---|---|---|
|
Nun können Sie Zahlungsarten unterhalb der Globalen Einstellungen von Saferpay im Bereich Neues Saferpay Modul anlegen, anlegen.
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 )
- Zahlarten ( Es können mehrere Zahlarten ausgewählt werden. )
Unbedingt ausgefüllt werden (es sind also Pflichtfelder) 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.
| Hinweis | ||
|---|---|---|
| ||
Bitte beachten Sie |
, dass die Zahlungsart "Klarna" nicht in allen Ländern unterstützt wird. Bei der Einrichtung von Klarna bei Saferpay erfahren Sie hierzu mehr. |
Shopbereich
Wenn Sie im Administrations Bereich Administrationsbereich die Saferpay Einstellungen Erfolreich ausgefüllt haben -Einstellungen erfolgreich konfiguriert- und ein Modul angelegt haben sollten , erscheinen im Warenkorb des Shops , in der Auswahl der Zahlungsart, nu alle zuvor angelegten Saferpay Module erscheinenals Auswahlmöglichkeit.
Sollte dies nicht der fall Fall sein, dann kehren Sie bitte in die Administration zurück und überprüfen Ihre einstellungen Einstellungen und probieren versuchen es erneut. Denken sie daran das Saferpay in den Globalen Einstellungen von Saferpay aktiviert werden muss damit es im Shop Bereich angezeigt werden kann.
Nachdem Sie nun die Zahlungsart ausgewählt haben können Sie nun die Bestellung mit der neu angelegten Zahlungsart abschließen und sie werden werden Sie automatisch von unserem System zu der externen Zahlungsseite von Saferpay weitergeleitet.
Bedenken sie das sie Sie, dass der Kunde hier den Bereich des Printshops verlassen DRUCKSHOPs verlässt und Sie sich nicht mehr auf der Webseite Ihres Printshops Shops befinden, sondern auf der Zahlungsseite von Saferpay, . Auf diese Seiten haben wir haben nur im Rahmen der Zahlungsmodalitäten begrenzten einfluss Einfluss auf diese Seiten.
Während dieses passiert wird die Bestellungung Bestellung im Hintergrund vom System auf "Warten auf Bezahlung" gesetzt und wenn die Bestellung Erfolgreich erfolgreich abgeschlossen wird der Status auf "Neu"gewechselt.
Zudem wird in den Auftragsdetails im neuen Payment Log (mehr dazu unten) ein Vermerk getätigt sollte , falls die Weiterleitung zu Saferpay fehlschlagen sollte.
Auf der Zahlungsseite von Saferpay können Sie nun eine der von Ihnen in der zuvor von Ihnen angelegten Saferpay Module die Zahlungsart auswählen die sie möchten.
Sollten Sie in dem von Ihnen angelegten Saferpay Module nur eine Zahlungsart ausgewählt haben werden Sie nicht auf diese auswahl Seite weitergeleitet sondern direkt auf die entsprechende Zahlungsseite.
Es handelt sich bei der Kreditkarte im Bild um eine Test Kreditkarte von Saferpay mit Japanischem Ursprungs. In diesem Fall bedeutet das, das Sie bei einem klick auf "Kaufen" auf die Währungsauswahl von Saferpay geleitet werden
Wo es nun möglich ist die gewünschte Währung auszuwählen. Das Geld kommt weiterhin in der von Ihnen zuvor ausgewählten Währung bei Ihnen an ohne einen Wechselkurs abzug, dieser wird hier mit einem Vermerk von Saferpay vom Käufer übernommen.
Wenn Sie nun auf "Weiter" klicken wird nun eine 3D Prüfung von Saferpay bzw. der ausgewählten Zahlungsart auf Richtigkeit der Daten durchgeführt.
Erstmal werden Sie als Nutzer der Zahlungsart auf Ihren Printshop zurück geleitet ( weiter unten sehen sie ein Beispiel hierzu. ) unter anderem wird jedoch auch von Saferpay
Eine Server zu Server Kommunikation, ohne jegliches zutun ihrerseits, aufgebaut und Informationen zu der eben getätigten Zahlung ausgetauscht. Diese Überprüft die Zahlung auf Gültigkeit
und captured diese für Sie sobald alles in Ordnung ist wird dieser Prozess abgeschlossen.
Das bedeutet für Sie dann das die Zahlung abgeschlossen wurde und wenn es kein beanstandungen von Saferpay gibt ( Wie zb. bei einer gefälschten Kreditkarte ) Ihnen das Geld, im Rahmen der Saferpay Geschäftsbedingungen, gutgeschrieben wird.
Sobald die Zahlungsdaten eingegeben und abgesendet wurdenm wird der Kunde wieder zurück in den DRUCKSHOP geleitet und die Zahlung ist somit abgeschlossen.
Administration > Auftragsdetails ( Zahlungshistorie )
Innerhalb der Administration unter:
finden Sie absofort| Anker | ||||
|---|---|---|---|---|
|
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.
Hier einige Beispiele von Fehlermeldungen welche Sie hier finden können.
Die Saferpay Schnittstelle kann bei folgenden Problemen eine Ausgabe auf der
Auftragsdetailseite liefern:
- Invalid License: Der genutzte Account ist nicht aktiv und sie müssen sich mit Saferpay in Verbindung setzen um diese zu aktivieren
- .
- Invalid credentials: Die
- 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