Saferpay für die Nutzung im Shop einrichten: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
 
Zeile 73: Zeile 73:
 
#'''bei Nutzung des HTTPS-Interface (bis September 2019)'''<br>Tragen Sie in der Konfiguration des {{link|Konfiguration - Zahlungssysteme|Zahlungssystems}} Saferpay in der Warenwirtschaft Ihre ''Account-ID'' ein. Das HTTPS-Interfacepasswort hinterlegen Sie bitte im Feld ''Passwort'' und im Feld ''URL (HTTPS-Interface)'' den Wert <nowiki>https://www.saferpay.com/hosting</nowiki>.<br>'''bei Nutzung der JSON-API (ab April 2019)'''<br>Saferpay teilt Ihnen die nötigen Konfigurationsdaten mit. Hinterlegen Sie diese in der {{link|Konfiguration - Zahlungssysteme|Zahlungssysteme-Konfiguration}} im Reiter ''Saferpay'' > Unterreiter ''JSON API''.
 
#'''bei Nutzung des HTTPS-Interface (bis September 2019)'''<br>Tragen Sie in der Konfiguration des {{link|Konfiguration - Zahlungssysteme|Zahlungssystems}} Saferpay in der Warenwirtschaft Ihre ''Account-ID'' ein. Das HTTPS-Interfacepasswort hinterlegen Sie bitte im Feld ''Passwort'' und im Feld ''URL (HTTPS-Interface)'' den Wert <nowiki>https://www.saferpay.com/hosting</nowiki>.<br>'''bei Nutzung der JSON-API (ab April 2019)'''<br>Saferpay teilt Ihnen die nötigen Konfigurationsdaten mit. Hinterlegen Sie diese in der {{link|Konfiguration - Zahlungssysteme|Zahlungssysteme-Konfiguration}} im Reiter ''Saferpay'' > Unterreiter ''JSON API''.
 
#Konfigurieren Sie bei Saferpay das VT (Virtuelle Terminal) bzw. die Payment Page korrekt entsprechend der in diesem Dokument noch folgenden Anleitung.  
 
#Konfigurieren Sie bei Saferpay das VT (Virtuelle Terminal) bzw. die Payment Page korrekt entsprechend der in diesem Dokument noch folgenden Anleitung.  
#Legen Sie in der Warenwirtschaft eine {{link|Konfiguration - Zahlart|Zahlungsart}} an und verknüpfen diese mit dem Zahlungssystem Saferpay (im {{link|Konfiguration - Zahlart#Details|Reiter ''Details''}}). Konfigurieren Sie die Zahlungsart sonst nach Belieben und geben Sie diese für die Nutzung im Webshop frei.<br>Sollen alle Zahlungsmittel, die Sie bei Saferpay gebucht haben, über eine Zahlungsart aus dem Shop heraus angeboten werden und der Kunde soll dann erst im Terminal bei Saferpay die Unterscheidung vornehmen, so lassen Sie das Feld "eShop Steuercode" leer.<br>Haben Sie mehrere Zahlungsmittel bei Saferpay gebucht und möchten diese schon als getrennte Zahlungarten im Shop anbieten, so legen Sie die gewünschten Zahlungsarten in der Warenwirtschaft an, verknüpfen alle diese mit dem Zahlungssystem Saferpay und hinterlegen nun bei jeder Zahlungsart, im Feld ''eShop Steuercode'' (im {{link|Konfiguration - Zahlart#Details eShop|Reiter ''Details eShop''}}) das bzw. die Zahlungsmittel (Provider-ID), die hier eingeschränkt zur Verfügung stehen sollen. Je nach Verwendung des HTTPS-Interfaces oder der JSON-API müssen hier unterschiedliche Werte hinterlegt werden, welche im Artikel zur Zahlungsartenkonfiguration erläutert sind. Die entsprechenden Werte können bei Saferpay erfragt werden.
+
#Legen Sie in der Warenwirtschaft eine {{link|Konfiguration - Zahlart|Zahlungsart}} an und verknüpfen diese mit dem Zahlungssystem Saferpay (im {{link|Konfiguration - Zahlart#Details|Reiter ''Details''}}). Konfigurieren Sie die Zahlungsart sonst nach Belieben und geben Sie diese für die Nutzung im Webshop frei.<br>Sollen alle Zahlungsmittel, die Sie bei Saferpay gebucht haben, über eine Zahlungsart aus dem Shop heraus angeboten werden und der Kunde soll dann erst im Terminal bei Saferpay die Unterscheidung vornehmen, so lassen Sie das Feld "eShop Steuercode" leer.<br>Haben Sie mehrere Zahlungsmittel bei Saferpay gebucht und möchten diese schon als getrennte Zahlungarten im Shop anbieten, so legen Sie die gewünschten Zahlungsarten in der Warenwirtschaft an, verknüpfen alle diese mit dem Zahlungssystem Saferpay und hinterlegen nun bei jeder Zahlungsart, im Feld ''eShop Steuercode'' (im {{link|Konfiguration - Zahlart#Details eShop|Reiter ''Details eShop''}}) das bzw. die Zahlungsmittel (PaymentMethod), die hier eingeschränkt zur Verfügung stehen sollen. (Bei Nutzung des alten HTTPS-Interface sind hier die Provider-IDs zu hinterlegen.)
  
  

Aktuelle Version vom 12. Juni 2019, 11:29 Uhr

Der e-vendo Webshop hat eine Schnittstelle zur Zahlungslösung Saferpay eCommerce. Die Zahlungslösung Saferpay wird von der Firma SIX Payment Services S.A. und ihren Tochtergesellschaften in verschiedenen Ländern betrieben. Auf der Website der Firma finden Sie ausführliche Informationen: https://www.six-payment-services.com.



Die Zahlungslösung Saferpay eCommerce bietet eine Reihe von Zahlungsmitteln, die damit für den Webshop zur Verfügung gestellt werden können. Zu den Zahlungsmitteln gehören:

Kreditkarten
  • Visa
  • Verified by Visa
  • MasterCard
  • MasterCard SecureCode
  • JCB
  • American Express
  • Diners Club Card
Debitkarten
  • Maestro
  • V PAY
Rechnungskauf
  • Billpay
Lastschrift
  • Billpay
Bezahldienste
  • PayPal
  • clickandbuy
Deutschland
  • giropay
  • Elektronisches Lastschriftverfahren
Österreich
  • eps
Schweiz
  • PostFinance Card
  • PostFinance E-Finance
  • myOne Kundenkarte
  • Valartis Bonus Card
Niederlande
  • iDeal

Eine vollständige Liste der aktuell verfügbaren Zahlungsmittel kann der Website des Anbieters entnommen werden: https://www.six-payment-services.com/de/site/e-commerce/solutions.html.

Das Zahlungssystem Saferpay kann überall innerhalb der EU genutzt werden.

Die Anbindung erfolgt dergestalt, dass die Authorisierung der Zahlung durch den Kunden im Webshop vorgenommen und mit Buchen der Rechnung in der Warenwirtschaft die Zahlung ausgelöst wird. Bei der Kreditkartenzahlung z.B. wird der Betrag mit der Authorisierung im Webshop auf der Kreditkarte des Kunden reserviert, was eine Zahlungssicherheit innerhalb von 7 Tagen gewährleistet.


Voraussetzungen und Kosten

Voraussetzungen bei Saferpay

Für die Nutzung des Zahlungssystems ist ein Vertrag mit SIX Payment Services abzuschließen. Dafür ist das Paket "Saferpay eCommerce" zu buchen. Die zu nutzenden Zahlungsmittel sind dabei festzulegen und ein Paket mit Transaktionen ist zu ordern.

Jede Transaktion hat direkt bei Saferpay einen pauschalen Preis und ist nicht umsatzabhängig. Für die Abrechnung der Transaktionen werden Transaktionspakete gekauft, die in unterschiedlichen Größen (Anzahl der Transaktionen) und Preisen angeboten werden. Je größer das Paket, desto günstiger ist eine einzelne Transaktion.

Je nach Zahlungsmittel müssen Verträge mit z. B. Kreditkarten Aquirern vorliegen bzw. abgeschlossen werden. Die dafür anfallenden Gebühren sind vom Aquirer und Ihrem konkreten Vertrag abhängig.


Voraussetzungen bei e-vendo

Um das Zahlungssystem Saferpay mit dem e-vendo Webshop zu nutzen, wird das Zusatzmodul Saferpay benötigt.


Einrichtung und Inbetriebnahme

Für die Nutzung des Zahlungssystems Saferpay im e-vendo Webshop steht folgender Ablauf:

  1. Teilen Sie e-vendo mit, dass Sie das Zahlungssystem Saferpay nutzen möchten.
  2. e-vendo informiert die Firma SIX Payment Services.
  3. Ein Mitarbeiter der Firma SIX Payment Services nimmt mit Ihnen Kontakt auf. Stimmen Sie mit ihm/ihr ab, welche Zahlungsmittel Sie einsetzen möchten und ob ggf. Saferpay Ihnen beim Abschluss eines Vertrags mit einem Kreditkarten-Aquirer helfen soll oder Sie bereits einen entsprechenden Vertrag haben.
  4. Schließen Sie den Vertrag mit SIX Payment Services ab und leiten ggf. in Abhängigkeit der gewünschten Zahlungsmittel weitere Schritte ein, die Sie von SIX Payment Services erfahren.
  5. nur bei Nutzung des HTTPS-Interface (bis September 2019)
    Lassen Sie bei SIX Payment Services für Ihren Account das HTTPS-Hosting (Zertifikats-Hosting) mit dem HTTPS-Interfacepasswort freischalten. Dies ist ein zusätzlicher Service und muss dort aktiviert werden, damit die Kommunikation zwischen den Systemen e-vendo und Saferpay funktioniert.
    Das HTTPS-Interfacepasswort ist für das Verbuchen von Aufträgen mit verringerter Auftragssumme und für die Abwicklung des Kaufes auf Rechnung über Billpay notwendig.
    Dieses Passwort wird normalerweise bei der Einrichtung des HTTPS-Hostings nicht automatisch und kostenfrei eingerichtet.
    Zwischen Saferpay und e-vendo besteht aber eine Vereinbarung, dass den e-vendo-Kunden diese Funktion zur Verfügung gestellt wird.
  6. Ist die Einrichtung des Saferpay-Accounts abgeschlossen, so nehmen Sie bitte mit e-vendo Kontakt auf. e-vendo wird die Nutzung des Moduls in Webshop und Warenwirtschaft vorbereiten.
  7. bei Nutzung des HTTPS-Interface (bis September 2019)
    Tragen Sie in der Konfiguration des Zahlungssystems Saferpay in der Warenwirtschaft Ihre Account-ID ein. Das HTTPS-Interfacepasswort hinterlegen Sie bitte im Feld Passwort und im Feld URL (HTTPS-Interface) den Wert https://www.saferpay.com/hosting.
    bei Nutzung der JSON-API (ab April 2019)
    Saferpay teilt Ihnen die nötigen Konfigurationsdaten mit. Hinterlegen Sie diese in der Zahlungssysteme-Konfiguration im Reiter Saferpay > Unterreiter JSON API.
  8. Konfigurieren Sie bei Saferpay das VT (Virtuelle Terminal) bzw. die Payment Page korrekt entsprechend der in diesem Dokument noch folgenden Anleitung.
  9. Legen Sie in der Warenwirtschaft eine Zahlungsart an und verknüpfen diese mit dem Zahlungssystem Saferpay (im Reiter Details). Konfigurieren Sie die Zahlungsart sonst nach Belieben und geben Sie diese für die Nutzung im Webshop frei.
    Sollen alle Zahlungsmittel, die Sie bei Saferpay gebucht haben, über eine Zahlungsart aus dem Shop heraus angeboten werden und der Kunde soll dann erst im Terminal bei Saferpay die Unterscheidung vornehmen, so lassen Sie das Feld "eShop Steuercode" leer.
    Haben Sie mehrere Zahlungsmittel bei Saferpay gebucht und möchten diese schon als getrennte Zahlungarten im Shop anbieten, so legen Sie die gewünschten Zahlungsarten in der Warenwirtschaft an, verknüpfen alle diese mit dem Zahlungssystem Saferpay und hinterlegen nun bei jeder Zahlungsart, im Feld eShop Steuercode (im Reiter Details eShop) das bzw. die Zahlungsmittel (PaymentMethod), die hier eingeschränkt zur Verfügung stehen sollen. (Bei Nutzung des alten HTTPS-Interface sind hier die Provider-IDs zu hinterlegen.)


Einrichtung der Payment Page Konfiguration bei Saferpay

Für eine reibungslose Nutzung des Zahlungssystems Saferpay mit dem e-vendo Webshop ist die richtige Einrichtung im Saferpay-Zahlungsterminal, der Payment Page, erforderlich. Dazu gehen Sie bitte wie folgt vor:

  1. Loggen Sie sich bei Saferpay mit Ihren Zugangsdaten ein.
  2. Gehen Sie im Bereich "Saferpay eCommerce" unter "Administration" auf den Menüpunkt "VK Konfiguration".
  3. Gehen Sie darin auf den Button "Neue Konfiguration erstellen".
  4. Stellen Sie in der neuen Konfiguration folgende Werte ein:
    • Name der Konfiguration
      Name Ihrer Wahl
    • Beschreibung
      Beschreibung Ihrer Wahl
    • "Aktiv" , "Inaktiv"
      Setzen Sie die Option Aktiv.
    • Werden einzelne Attribute sowohl in dieser Konfiguration als auch im PayInit definiert, kann über folgende Einstellung der Vorrang der doppelt definierten Attribute bestimmt werden.
      Aktivieren Sie die Option (PayInit) Attribute im PayInit haben Vorrang gegenüber den hier konfigurierten Werten.
    • Sprache
      Wählen Sie die Standardsprache und entscheiden Sie selbst, ob die Sprachauswahl im Virtuellen Terminal angezeigt werden soll.
    • Inhalt der Konfiguration
      Das Feld der Adresse der AGB lassen Sie leer und die Option für das Akzeptieren der AGB wird nicht gesetzt. (Dies ist ja alles schon über den e-vendo Webshop umgesetzt.)
      Setzen Sie die Option Name des Karteninhabers abfragen.
      Die Option Adresse des Karteninhabers abfragen NICHT setzen.
    • Weiterleitung & Bestätigungsseiten
      Setzen Sie die Option Nach erfolgreicher Zahlung den Kunden automatisch zum Shop weiterleiten.
      Tragen Sie bei Anzahl Sekunden den Wert 0 ein.
      Die Eingabefelder für die Adressen der einzelnen Seiten lassen Sie leer.
    • E-Mail-Bestätigung an den Karteninhaber
      Wenn Sie möchten, dass der Kunde eine E-Mail-Bestätigung von Saferpay erhält, dann aktivieren Sie die Option E-Mail-Bestätigung an den Karteninhaber senden und konfigurieren darunter die Optionen korrekt. Es ist dann aber auch notwendig eine Konfiguration im e-vendo Shop vorzunehmen, damit der Shop die E-Mail-Adresse des Kunden mit an Saferpay übergibt und Saferpay somit auch in der Lage ist, den Kunden zu informieren. Sollten Sie Ihre Shoptemplates selber pflegen, so tragen Sie in der layout.inc.php den Konfigurationswert
      $bSaferpayUserNotify = true;
      ein. Sind Ihre Layouts bei e-vendo in Pflege, so tragen Sie dies an uns heran.
    • Datenübergabe
      Diese Option NICHT setzen.
  5. Speichern Sie die Konfiguration
  6. Es sollte nun eine Konfiguration vorliegen, die aktiv ist und als Default gekennzeichnet ist. Die Default-Konfiguration wird vom e-vendo Webshop genutzt werden.
    Haben Sie mehrere e-vendo Shops und möchten jeweils unterschiedliche Saferpay-Terminals für die einzelnen Shops nutzen, so legt man die einzelnen Terminals in Saferpay an und konfiguriert sie korrekt, wie in diesem Kapitel beschrieben. Bei Bedarf lässt sich dann auch jedes Terminal farblich direkt bei Saferpay gestalten, passend zum jeweiligen Shop.

Um dem Shop nun mitzuteilen, welches Terminal er verwenden soll, muss man eine Konfiguration im Shop vornehmen. Dazu gibt es in der layout.inc.php ein Array $arrSaferpayLayout. Dieses ist um einen Eintrag mit dem Key VTCONFIG zu erweitern, der dann den Wert erhält, wie er im Feld Parameter für Aufruf in der Seite der Virtual Terminal Konfiguration bei Saferpay zu sehen ist. Somit wird dann genau dieses Terminal durch den Shop genutzt und nicht mehr das Default-Terminal.

Zahlungsvorgang während des CheckOut-Prozesses im Onlineshop

Der Zahlungsvorgang selbst läuft dann im Onlineshop wie folgt ab:

  1. Kunde begibt sich vom Warenkorb aus in den CheckOut-Vorgang
  2. Kunde wählt während des CheckOut-Vorgangs die Zahlungsart aus, hinter der das Zahlungssystem Saferpay liegt.
  3. Wenn der Kunde im letzten Checkout-Step die Daten seiner Bestellung noch einmal vor sich hat und den Bestellvorgang nun abschließen möchte, wird er im nächsten Schritt auf das Zahlterminal von Saferpay geleitet. Der Shop hat dafür alle für den Zahlungs- bzw. Authorisierungsvorgang notwendigen Information an Saferpay übergeben.
  4. Der Kunde führt nun bei Saferpay die Zahlung bzw. Zahlungsauthorisierung durch.
  5. Nach Fertigstellung des Vorgangs bei Saferpay wird der Kunde von dort direkt auf den Shop zurückgeleitet und darin enthalten ist dann auch die Rückinformation über Erfolg bzw. Nichterfolg des Vorgangs.
    Der Onlineshop wird nun anhand der Rückkehrinformation die entsprechende Folgeaktion durchführen.
    Bei Erfolg der Zahlung bzw. Authorisierung wird nun die Bestellung in der Datenbank eingetragen, die Transaktionsdaten von Saferpay im System hinterlegt, die eMail an den Kunden versendet und die Endeseite des CheckOut-Prozesses angezeigt. Bei Nichterfolg geht der Onlineshop wieder auf die Seite mit der Auswahl der Zahlungsart.
    In der Warenwirtschaft kann im Beleg im Reiter "Kalkulation" rechts oben unter "Betrag reserviert" gesehen werden, dass der Betrag erfolgreich reserviert worden ist.


Auftragsbehandlung in der Warenwirtschaft

Mit Buchung der Rechnung wird die Zahlung ausgelöst. Dafür erfolgt eine Kommunikation zwischen der Warenwirtschaft und Saferpay anhand der zu diesem Beleg durch den Authorisierungsvorgang im Webshop hinterlegten Transaktionsdaten.

Es kann nur ein solcher Buchungsvorgang pro Saferpay-Transaktion stattfinden. Von daher sind Teil-Rechnungen nicht möglich. Sollten Sie Teil-Lieferungen vornehmen wollen, so beachten Sie bitte, dass Sie die Rechnung nur in einem Vorgang buchen können.

Sollten Sie nicht den vollen Betrag berechnen, weil Sie ggf. nicht alle bestellte Ware liefern werden, so können Sie auch einen niedrigeren Betrag in Rechnung stellen. Der Rest des mit der Transaktion reservierten Betrages verfällt dann für die Transaktion.

Sie können nicht einen höheren Betrag berechnen, als im Authorisierungsvorgang vom Kunden freigegeben.

Sie können über Ihren Zugang bei Saferpay direkt ebenfalls Aktionen durchführen, die über die Kommunikation zwischen Warenwirtschaft und Saferpay hinausgehend noch Möglichkeiten bieten. Entsprechende Hilfe finden Sie bei Saferpay.


Besondere Hinweise

Sollte der seltene Fall eintreten, dass Sie eine Transaktion in Saferpay haben, für die kein Beleg in der Warenwirtschaft existiert, dann schauen Sie bitte bei den Aktivitäten des Kunden nach. Sie finden dann vermutlich eine sog. "Rettungsaktivität" bei ihm, die den Warenkorb-Inhalt vor Übergabe an Saferpay enthält, so dass Sie in der Lage sind, den Beleg in diesem Fall manuell anzulegen und weiter zu bearbeiten.

zum Anfang der Seite