Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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 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
titleVersionshistorie

API Version 1.16 ab

der Printshop Version

DRUCKSHOP 6.10.0

API Version

API Version 1.17

wird

ab

Printshop Version

DRUCKSHOP 6.11.0

unterstützt werden.


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üssenDies macht die Verwaltung für Sie deutlich komfortabler.


Administration > Zahlarten ( Einstellungen )

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

Image Removeddas Modul unter Einstellungen > Zahlarten konfigurieren.


Globalen Einstellungen von Saferpay
Anker
GlobaleSaferpaySettings
GlobaleSaferpaySettings

Hier finden sie die Globalen Einstellungen von Saferpay sowie Neues die Möglichkeit ein neues Saferpay Modul anlegenGlobale Einstellungen von SaferpayImage Removedanzulegen

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.


Globale Einstellungen von SaferpayImage 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.

Image Removed


hierbei achten sie Image Added

Achten Sie bitte darauf das , dass sie nur Zahlarten auswählen welche von ihrere Ihrer hier angegeben Terminal Id ID auch abgedeckt sind. Da ansonsten alle Zahlarten angeboten werden welche Saferpay bei dieser Terminal Id hinterlegt hat.
Beim anlegen 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.

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 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

Wenn Sie im Administrations Bereich die Saferpay Einstellungen Erfolreich ausgefüllt haben

Hinweis
titleHinweis:

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 Administrationsbereich die Saferpay-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

erscheinen

als Auswahlmöglichkeit.

Image Removed

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.

Image Added


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

Image Removed

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.

Image Removed

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.

Image Removed

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

Image Removed

Wenn Sie hier nun auf Process klicken passieren mehrer dinge.

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.

Image Removed

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.

.

Während dieses passiert wird die Bestellung im Hintergrund vom System auf "Warten auf Bezahlung" gesetzt und wenn die Bestellung erfolgreich abgeschlossen wird der Status auf "Neu"gewechselt.
Zudem wird in den Auftragsdetails im neuen Payment Log ein Vermerk getätigt, falls die Weiterleitung zu Saferpay fehlschlagen sollte.

Image Added


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 )

Innerhalb der Administration unter:

Image Removed

finden Sie absofort
Anker
paymentLog
paymentLog

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

Weiter unten ein Beispiel zu einer Fehlermeldung.

Image Removed



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