1 Disclaimer
2 Installation in Magento ®
   2.1 Voraussetzungen
   2.2 Installation ab Magento 1.7
3 Konfiguration
   3.1 Viveum Back-Office
      3.1.1 Benötigte Optionen
      3.1.2 Benutzerverwaltung
      3.1.3 Technische Informationen
   3.2 Magento ®
      3.2.1 Zahlungsservices
      3.2.2 Zahlungsarten
      3.2.3 Zahlungsart Rechnung
      3.2.4 Zahlungsart Intersolve
      3.2.5 Zahlungsart Kreditkarte mit Alias Manager
      3.2.6 Zahlungsart Paypal mit Verkäuferschutz
      3.2.7 Device fingerprinting
4 Verwendung
   4.1 Allgemein
      4.1.1 Zahlungsart InterSolve
      4.1.2 Zahlungsart Kreditkarte mit Alias Manager
      4.1.3 Zahlungsart Lastschrift
   4.2 Sendungserstellung
   4.3 Stornierungen
   4.4 Rechnungsstellung
   4.5 Gutschriften
   4.6 Zusätzliche Informationen
   4.7 Zahlungen im Magento ® Backend auslösen
      4.7.1 Zahlung mit bestehender Viveum Transaktion
5 Hinweise
   5.1 Allgemein
   5.2 Multistore
      5.2.1 Beispiel - Store Code in URL unter Verwendung eines gemeinsamen Viveum Kontos
      5.2.2 Beispiel - unterschiedliche Domains unter Verwendung unterschiedlicher Viveum Konten
      5.2.3 Beispiel - unterschiedliche Domains unter Verwendung eines gemeinsamen Viveum Kontos
      5.2.4 Store Code in URL unter Verwendung unterschiedlicher Viveum Konten
6 Zahlungs-Workflow

1 Disclaimer

Copyright © 2016 Viveum .

Alle in diesem Material angegebenen Warenzeichen, Handelsmarken und Markennamen sind das Eigentum ihrer jeweiligen Inhaber. Die hierin enthaltenen Informationen werden aus Gefälligkeit angegeben und dienen nur zur allgemeinen Information. Dieses Dokument soll keine vollständige Beschreibung aller anwendbaren Bestimmungen, Politiken und Verfahren darstellen. Die Angelegenheiten, auf die Bezug genommen wird, unterliegen gelegentlichen Änderungen, und die individuellen Umstände könnten variieren.

Viveum übernimmt keine Verantwortung für ungenaue oder unvollständige Informationen. Die hierin enthaltenen Informationen beinhalten unter anderem eine Zusammenstellung von Informationen Dritter; solche Informationen sind und bleiben Eigentum ihrer jeweiligen Inhaber. Nichts in dieser Präsentation soll geltende Verträge, Bestimmungen oder Regulierungen ergänzen, berichtigen oder ändern.

Viveum hat dem Inhalt dieses Dokuments eine umfassende Aufmerksamkeit geschenkt, übernimmt jedoch keinerlei Verantwortung für dessen Genauigkeit oder Vollständigkeit. Weder Viveum noch dessen Tochtergesellschaften sind für etwaige Kosten, Verluste und/oder Schäden infolge des Zugriffs oder der Verwendung von Inhalten dieses Dokuments verantwortlich. Aufgrund der Komplexität des Prozesses und des Rechtes von Banken, Bedingungen zu ändern, kann dieses Dokument nur als Beschreibung fungieren und unterliegt weiteren Änderungen.

Die Erweiterung, auf die in diesem Dokument Bezug genommen wird, wurde als allgemeine Lösung entwickelt. Viveum übernimmt keine Verantwortung für Schäden infolge die Erweiterung. Falls die Erweiterung auf irgendeine Weise von einem Nutzer geändert wird, übernimmt Viveum keine Verantwortung für Schäden infolge der geänderten Erweiterung. Die Beschreibung der Erweiterung in diesem Dokument wird nur zu Informationszwecken angegeben und Viveum übernimmt keine Garantie hinsichtlich der Nutzung oder des Betriebs der Erweiterung. Weder Viveum noch dessen Tochtergesellschaften sind für etwaige Kosten, Verluste und/oder Schäden infolge des Zugriffs oder der Verwendung der Erweiterung verantwortlich.

2 Installation in Magento ®

2.1 Voraussetzungen

  • PHP 5.4+
  • Ein aktives Viveum Konto
  • Die unterstützten Versionen Magento ® Community und Enterprise Edition sind auf der Seite „Official Viveum Extension“ abrufbar.

2.2 Installation ab Magento 1.7

3 Konfiguration

3.1 Viveum Back-Office

Melden Sie sich bei Ihrem Viveum Back-Office an, um die folgenden Einstellungen vorzunehmen.

3.1.1 Benötigte Optionen

Je nach gewähltem Viveum Abonnement müssen möglicherweise zusätzliche Pflichtoptionen in Ihrem Viveum Konto aktiviert werden.

Diese Optionen sind:

Bitte überprüfen Sie, ob diese Optionen standardmäßig aktiviert sind. Ist dies nicht der Fall, wenden Sie sich für die Aktivierung bitte an unser Vertriebsteam.

Magento ® Viveum extension classic.brandname-offered-by funktioniert möglicherweise nicht in Verbindung mit anderen Extensions. Wir empfehlen, mögliche weitere Extensions in Magento ® zu deaktivieren, um Fehlfunktionen zu vermeiden.

3.1.2 Benutzerverwaltung

Für die Kommunikation mit Viveum benötigt der Shop einen separaten API-User.

API-User erstellen:

  1. Zu „Configuration > Users“ [Konfiguration > Benutzer] gehen.
  2. „New User“ [Neuer Benutzer] wählen.
  3. Eine USERID (beispielsweise APIUSER) wählen.
  4. Den Namen und eine existierende E-Mail-Adresse eintragen (das Feld „External USERID“ [Externe Benutzer-ID] kann leer bleiben).
  5. Das Profil „Administrator“ auswählen.
  6. Als Access Type [Zugriffsart] „API only“ [Nur API] auswählen.
  7. Die gerade erstellte USERID und das Passwort notieren.

    Hinweis: USERID und Passwort dürfen keine Sonderzeichen enthalten.

3.1.3 Technische Informationen

Konfigurieren Sie die technischen Informationen im Viveum Back-Office:

  1. Zu „Configuration > Technical Information > Global Transactionparameters“ [Konfiguration > Technische Informationen > Globale Transaktionsparameter] gehen.
  2. Im Bereich „Default operation code“ [Standard-Operationswert] die Option „Sale“ [Direktbuchung] oder „Authorisation“ [Autorisierung] wählen.
  3. Im Bereich „Payment retry“ [Maximale Anzahl Zahlungsversuche] wenn gewünscht den vorhandenen Wert ändern.
  4. Die Schaltfläche „Save“ [Speichern] anklicken.
  5. Das Register „Global security parameters“ [Sicherheit] auswählen.
  6. Im Bereich „Hashing method“ [Hash-Methode] „SHA-1“ als „Hash algorithm“ [Hash-Algorithmus] und „UTF-8“ für „Character encoding“ [Zeichenkodierung] auswählen.
  7. Im Bereich „Template“ [Template] für „Enable JavaScript check on template“ [Aktivierten Sie die JavaScript-Überprüfung im Template] die Option „No“ [Nein] wählen.
  8. Die Schaltfläche „Save“ [Speichern] anklicken.
  9. Das Register „Data and origin verification“ [Daten und Ursprung] auswählen.
  10. In den Bereichen „Checks for e-Commerce & Alias Gateway“ [Überprüfungen für e-Commerce & Alias Gateway] und „Checks for Viveum DirectLink and Viveum Batch (Automatic)“ [Überprüfungen für Viveum DirectLink und Viveum Batch (Automatisch)] das Feld „SHA-1-IN pass phrase“ [SHA-IN Signatur] ausfüllen. Beide Schlüssel dürfen nur aus alphanumerischen Zeichen bestehen und müssen identisch sein.
  11. Das Register „Transaction feedback“ [Transaktions-Feedback] auswählen.
  12. Im Bereich „e-Commerce“, Abschnitt „HTTP redirection in the browser“ [HTTP-Umleitung im Browser] die Option „I would like to receive transaction feedback parameters on the redirection URLs“ [Ich wünsche die Transaktionsfeedbackparameter auf die zur Umleitungs angegebenen URLs zu erhalten] auswählen und die Auswahl der Option „I would like Viveum to display a short text to the customer on the secure payment page if a redirection to my website is detected ...“ [Bei der Umleitung auf eine der URLs soll auf der Bezahlseite ein Hinweis zur Umleitung durch Viveum ausgegeben werden] aufheben.
  13. Im Bereich „e-Commerce“, Abschnitt „Direct HTTP server-to-server request“ [Direktes Feedback über HTTP Server-zu-Server-Anfrage] ...
    1. „Online but switch to a deferred request when the online requests fail“ [Online, aber Wechsel zu zeitlich versetzte Anfrage (deferred Request), wenn die Online Anfrage fehlschlägt] auswählen.
    2. Den Wert „YOUR_SHOP_URL/ops/api/postBack“ in beide Felder für „URL of the merchant's post-payment page“ [ULR der Händler-Seite an die das Transaktionsfeedback gesendet wird] eintragen.
    3. „POST“ als „Request method“ [Anfragemethode] auswählen.
  14. Im Abschnitt „e-Commerce“, Unterabschnitt „Dynamic e-Commerce parameters“ [Dynamische e-Commerce-Parameter]: Alle verfügbaren Parameter auswählen mit Ausnahme von „ECOM_BILLTO“ und „ECOM_SHIPTO“, da diese sehr leicht zu Übertragungsfehlern führen können.
  15. Im Abschnitt „All transaction submission modes“ [Alle Transaktionsübertragungsmodi ]: die „SHA-OUT pass phrase“ [SHA-1-OUT Signatur] eintragen. Die SHA-OUT pass phrase muss identisch mit der zuvor eingegebenen SHA-IN pass phrase [SHA-1-IN Signatur] sein.
  16. Unter „HTTP request for status changes“ [HTTP-Anfrage für Statusänderungen] „For each offline status change (payment, cancellation, etc.)“ [Für jede Offline-Statusänderung (Zahlung, Stornierung...)] auswählen und den Wert „YOUR_SHOP_URL/ops/api/directLinkPostBack“ eintragen.
  17. Die Schaltfläche „Save“ [Speichern] anklicken.
  18. Das Register „Transaction e-mails“ [E-Mails] auswählen.
  19. Im Abschnitt „E-mails to the merchant“ [E-Mails an den Händler] folgende Schritte optional ausführen ...
    1. Ihre E-Mail-Adresse eintragen.
    2. Die Option „Yes, for all transaction submission modes“ [Ja für alle Transaktionsübertragungsmodi] auswählen.
    3. Die Option „Yes, for each offline status change (payment, cancellation, etc.)“ [Ja für jede Offline-Statusänderung (Zahlung, Stornierung...)] auswählen.
  20. Das Register „Test info“ [Testinformation] auswählen.
  21. Im Bereich „Test info“ die Option „I would like to simulate transaction results based on the card number“ [Ich möchte Transaktionsergebnisse in Abhängigkeit von der Kartennummer simulieren] auswählen.

3.2 Magento ®

3.2.1 Zahlungsservices

Führen Sie nach Installation der Extension die folgenden Schritte aus:

  1. Bei Ihrem Magento ® Back-Office anmelden.
  2. Zu „System > Configuration > Sales > Payment services“ [System > Konfiguration > Umsätze > Zahlungsdienste] gehen. Die Option „Viveum Account“ ist verfügbar.
  3. Die Option auswählen und die folgenden Informationen eingeben:
Einstellung Beschreibung
PSPID Die PSPID Ihres Viveum Kontos eintragen.
SHA-IN Pass phrase [SHA-1-IN Signatur] Die SHA-1-IN Signatur eintragen, die Sie in Ihrem Viveum Back-Office unter „Technical information > Data and origin verification“ [Technische Informationen > Daten- und Ursprungsüberprüfung] eingerichtet haben.
SHA-OUT Pass phrase [SHA-1-OUT Signatur] Die SHA-1-OUT Signatur eintragen, die Sie in Ihrem Viveum Back-Office unter „Technical information > Transaction feedback“ [Technische Informationen > Transaktions-Feedback] eingerichtet haben.
Gateway URLs Die Gateway URLs sind bereits korrekt konfiguriert. Beim Wechsel von der TESTUMGEBUNG in die PRODUKTIONSUMGEBUNG müssen Sie jedoch diese TEST-URLs durch PRODUKTIONS-URLs ersetzen, die in der Anmerkung zu diesen Konfigurationsfeldern gezeigt werden.
API User / API Password [API-Benutzer / API-Passwort] Tragen Sie die API-Daten ein, die Sie in Ihrem Viveum Back-Office erstellt haben.
Zahlungsvorlage
Wenn Sie die Shop-Vorlage "Magento® – Internal" (Intern) herunterladen, wird die Zahlungsseite im gleichen Layout wie Ihr Shop dargestellt. Wenn Sie eine der Ingenico ePayments-Optionen auswählen, müssen alle nachfolgenden Felder mit Bezug auf die Ogone-Vorlage ausgefüllt werden.
- Dynamische Ingenico ePayments-Vorlage: Der Kunde wird an die Zahlungsseite von Ingenico ePayments umgeleitet. Aussehen und Gestaltung der Seite werden von einer dynamisch geladenen Vorlagendatei festgelegt, die Sie mittels "Vorlagen-ID/URL" direkt nachfolgend definieren können.
- Modus "Ingenico ePayments – iFrame": Der Kunde muss die Zahlungsdetails auf einer Seite in Ihrem Shop eingeben, welche die Zahlungsseite von Ingenico ePayments in einem iFrame hostet. Sie können die Stilparameter direkt nachfolgend konfigurieren.
- Modus "Ingenico ePayments – Umleiten": Der Kunde wird zur Eingabe seiner Zahlungsdetails an Ingenico ePayments umgeleitet. Sie können die Stilparameter direkt nachfolgend konfigurieren.
- Shop-Vorlage Magento® – Internal" (Intern): Der Kunde wird an die Zahlungsseite von Ingenico ePayments umgeleitet, die in Aussehen und Gestaltung Ihrer Shop-Seite entspricht. Die URL der verwendeten Vorlage wird direkt nachfolgend angezeigt.
Payment template [Zahlungsvorlage] Wenn Sie Magento ® auswählen, erhält die Zahlungsseite den gleichen Aufbau wie Ihr Shop. Wenn Sie Viveum auswählen, müssen alle Felder mit Bezug auf die Viveum Vorlage ausgefüllt werden.
Order reference in case of
redirect (or inline) payments [Referenz der Bestellungen für
Redirect- (oder Inline-) Zahlungen]
Mit dieser Option kann festgelegt werden, ob die Orders increment ID [Order-Increment-ID] oder die Quote ID [Quote-ID] als Zahlungsreferenz für die Bestellungen an Viveum übertragen werden. Die Order ID ist eine Zahl im Format 100000001, die in der Backend Order Grid in der Spalte „Order #“ [Bestellung-Nr.] erscheint. Ist „Order ID“ ausgewählt, wird diese Nummer im Zahlungsprozess an Viveum übertragen.

Aus Kompatibilitätsgründen wird der Order ID ein Hash-Zeichen ("Lattenzaun") vorangestellt. Ist „Quote ID“ ausgewählt, wird diese Nummer im Zahlungsprozess an Viveum übertragen. Die Quote ID ist auch der einzige Modus für alle Inline-Zahlungsarten wie Kreditkarte (falls aktiviert), Lastschrift und Kwixo.
Show Quote ID in the order
grid [Quote-ID im Order-Grid anzeigen]
Ist diese Option aktiviert, wird Quote ID als Spalte in der Backend Order Grid hinzugefügt.
Submit extra parameters [Zusätzliche Parameter übertragen]
Ist diese Option aktiviert, werden zusätzliche Parameter an Viveum übermittelt, um die Betrugserkennung oder den Paypal Verkäuferschutz zu nutzen.
Device ID [Device-ID] Ermöglicht das Kundentracking zum Zweck der Betrugserkennung
Zahlungsinformations-ID/Vorlage erneut senden
Sie können Ihren Kunden eine E-Mail senden, wenn deren Zahlung bei Ogone fehlgeschlagen ist (Status 0 oder 2). Die E-Mail enthält einen Link zur Ogone-Zahlungsseite. Dort kann der Kunde seine Zahlungsdetails erneut eingeben, um den Auftrag zu korrigieren.
fZahlungsinformations-ID erneut senden: Wählen Sie den gewünschten Ansprechpartner als Absender der E-Mail aus (verknüpft mit "E-Mailadressen speichern")
fZahlungsinformationsvorlage erneut senden: Wählen Sie die gewünschte E-Mailvorlage aus.
Debug [Fehlerprotokoll] Ist diese Option aktiviert, werden alle Anfragen und Antworten von Viveum überprüft. Wir empfehlen Ihnen, diese Option nur zu aktivieren, wenn Sie sich im Testmodus befinden, nicht im Produktionsmodus. Die Debug-Datei wird auf dem Fileserver im Verzeichnis /Var/Logs/ops.log gespeichert.

Hinweis: Wir raten, unter „System > Configuration > General > Web > URL options“ [System > Konfiguration > Allgemein > Web > URL-Optionen] die Option „Add store code to URL's“ [Store-Code zu URLs hinzufügen] zu deaktivieren, weil dies zu einem unkorrekten Verhalten der Extension führen kann.

3.2.2 Zahlungsarten

Konfigurieren Sie Ihre Zahlungsarten unter „System > Configuration > Payment Methods“ [System > Konfiguration > Zahlungsarten].

Achten Sie darauf, nur Zahlungsarten zu aktivieren, die in Ihrem Viveum Back-Office unter „Configuration > Payment methods > Selected payment methods“ [Konfiguration > Zahlungsarten > Ausgewählte Zahlungsarten] aktiviert sind.

Sie können die Zahlungsarten der relevanten Länder konfigurieren. Beispiel: Wenn die Niederlande als Rechnungsland für iDeal ausgewählt werden, wird sie nicht angezeigt, wenn der Kunde ein anderes Rechnungsland eingibt.

Wenden Sie sich für weitere Aktivierungen und weitere Änderungen bitte an unsere Kundendienst via office@viveum.at.

3.2.3 Zahlungsart Rechnung

Aktivieren Sie die folgenden zusätzlichen Einstellungen unter „System > Configuration > Customer Configuration > Name and address options“ [System > Konfiguration > Kundenkonfiguration > Namens- und Adressoptionen]:

  • Display Birthday [Geburtstag anzeigen]
  • Display VAT number [Umsatzsteuer-ID-Nummer anzeigen] (nur für Open Invoice NL)
  • Display Gender [Geschlecht anzeigen]

Hinweis: Wenn Sie als Acquirer Afterpay nutzen, ist es nicht möglich, Teilbuchungen mit Open Invoice NL durchzuführen).

Wenn Sie Open Invoice AT via Klarna aktivieren, gelten folgende Voraussetzungen:

  1. Der "Titel" (Title) muss auf "Kauf auf Rechnung - zahlen in 14 Tagen" gesetzt werden.
  2. Unter https://developers.klarna.com/en/at+php/kpm/logos muss das Logo hochgeladen und zur Verfügung gestellt werden.
  3. Die Datenverschlüsselung muss auf "Andere" gesetzt werden, da die aktuelle Integration keine UTF-8-Verschlüsselung unterstützt.
  4. Der "Rechnungsbedingungstitel" (Invoice terms title) muss auf "Rechnungsbedingungen" gesetzt werden.
  5. Die "Rechnungsbedingungs-URL" (Invoice terms url) muss auf https://cdn.klarna.com/1.0/shared/content/legal/terms/123/de_at/invoice?fee=0#
  6. gesetzt werden. Eine Teilerfassung oder Teilerstattung via Magento ist nicht möglich. Diese Aktionen können nur über das Back-Office von Viveum ausgeführt werden.
  7. Magento darf keine Rechnungen zur Erfassung/Erstattung an die Kunden senden. Dies ist Klarna vorbehalten. Während der Erfassung/Erstattung muss die Einstellung "Rechnungskopie per E-Mail senden" deaktiviert sein.

3.2.4 Zahlungsart Intersolve

Sie können einige Marken definieren, die bestimmten Viveum Zahlungsarten entsprechen.

Diese Marken müssen vorab im Viveum Back-Office konfiguriert werden, ehe sie in Ihrem Shop nutzbar sind. Sie können jeder „Brand“ [Marke] einen individualisierten „Title“ [Titel] zuweisen, die dem Kunden auf der Bezahlseite gezeigt wird.

Intersolve

3.2.5 Zahlungsart Kreditkarte mit Alias Manager

Alias Manager bezieht sich auf den Viveum Alias Manager.

Konfiguration:

Einstellung Beschreibung
Enabled Alias Manager [Alias Manager aktivieren] Ist diese Option aktiviert, kann Ihr Kunde seine Daten zu Kreditkartenzahlungen speichern und die gespeicherten Informationen bei künftigen Zahlungen wiederverwenden. Diese Informationen können nur für Karten gespeichert werden, die Online-Zahlungen unterstützen.
Show Alias Manager information for guests [Alias Manager-Info für Gäste anzeigen] Ist diese Option aktiviert, weist ein Tipp Gastkunden auf die Vorteile hin, die das Speichern von Kreditkartendaten bietet, da diese Funktionalität nur Kunden zur Verfügung steht, die angemeldet sind.

Credit Card with Alias Manager [Kreditkarte mit Alias Manager]

Zur korrekten Nutzung dieser Funktion müssen Sie die Datei cron.php regelmäßig ausführen. Sie befindet sich im Stammverzeichnis von Magento ®. Auf UNIX- oder Linux-Systemen müssen Sie einen der folgenden Einträge auf Ihrem crontab vornehmen:
  • */5 * * * * /bin/sh /absolute/path/to/magento/cron.sh
  • 0,5,10,15,20,25,30,35,40,45,50,55 * * * * /bin/sh /absolute/path/to/magento/cron.sh

Weitere Details zur Nutzung finden Sie unter Kreditkarte mit Alias Manager.

3.2.6 Zahlungsart Paypal mit Verkäuferschutz

Konfigurieren Sie die folgenden Einstellungen:

Einstellung Beschreibung
Configuration > General > State options > State is required for [Konfiguration > Allgemein > Bundesland > Bundesland ist Pflichtfeld erforderlich] Wählen Sie die Länder aus, bei denen die Landesangabe gemäß den Anforderungen des PayPal Verkäuferschutzes eine Pflichtangabe ist.
Configuration > Payment Services > Viveum account > Submit extra parameters [Konfiguration > Zahlungsdienste > Viveum Einstellungen > Zusätzliche Parameter übertragen] Die Option auf „Yes“ [Ja] setzen, um die notwendigen Parameter an Viveum zu übertragen.

3.2.7 Device fingerprinting

Diese Funktion ermöglicht das Fingerprinting von Kundengeräten in einem Schlüssel, damit Viveum Daten (z. B. Bildschirmauflösung, User Agent usw.) erfassen und prüfen kann. In einigen europäischen Ländern gibt es hierzu rechtliche Vorbehalte. Daher sollten die Kunden der Erfassung dieser Daten einwilligen.
Das Geräte-Fingerprinting kann pro Transaktion aktiviert/deaktiviert werden. Dies wird durch einen speziellen Parameter für e-Commerce-Transaktionen angezeigt. Bei DirectLink-Transaktionen müssen die Informationen durch Pixel-Tracking auf der Site erfasst werden.

Integration mittels JavaScript Hook

Die Erweiterung stellt eine JavaScript-Funktion für die Verarbeitung der Einwilligung des Kunden beim Bezahlvorgang bereit. Kunden können die Datei
(js/netresearch/ops/deviceFingerprinting.js) auch anderen Teilen des Shops hinzufügen, um auf die
nachfolgend beschriebenen Funktionen zuzugreifen. Dies kann mit folgendem Code durchgeführt werden:
consentHandler.toggleConsent( consent , callback );
Einwilligung: Boolesch und Zielstatus der Einwilligung, die in der Kundensitzung gespeichert werden sollten.
Callback: Eine optionale Funktion, die mit der gespeicherten Einwilligung aufgerufen
werden sollte, nachdem sie gespeichert wurde.
Der Einwilligungs-Handler (Consent Handler) hat zudem die Funktion, den aktuellen Einwilligungsstatus abzurufen mittels
consentHandler.getConsent (callback)
Wie auch bei der anderen Funktion wird der Callback mit dem Ergebnis der Anforderung aufgerufen (der aktuelle Einwilligungsstatus).

Integration mittels benutzerdefiniertem Aufruf von bereitgestelltem Controller

Die Einwilligung kann auch mittels Direktaufruf eines Controllers über folgende URL angezeigt werden:
http://www.yourshop.tld/ops/device/toggleConsent

Der erwartete Parameter für die Anforderung lautet "consent". Er wird in einen booleschen Wert umgewandelt und mit
der Kundensitzung gespeichert. Beispielantwort (JSON) auf den aktuellen Einwilligungsstatus:
{"consent":false}

Hier können Sie einen aktuellen Einwilligungsstatus anzeigen: http://www.yourshop.tld/ops/device/consent

Diese URLs werden von den vorkonfigurierten JavaScript-Funktionen aufgerufen.



4 Verwendung

4.1 Allgemein

Die Extension funktioniert wie die meisten Magento ®-Extensions. Wenn Sie die Verarbeitung von Kreditkarten ausgewählt haben, erfolgt deren Verarbeitung über die Magento ®-Plattform. Ist jedoch 3-D Secure aktiviert, wird der Karteninhaber auf die Viveum Zahlungsseite umgeleitet.

Dies gilt ebenso für jede andere Zahlungsart, bei dem Daten des Kontoinhabers von der kartenausgebenden Organisation bestätigt werden müssen. Wenn die Transaktion verarbeitet wird, erscheint sie in Ihrem Magento ® Back-Office unter „Sales > Orders“ [Verkäufe > Bestellungen].

4.1.1 Zahlungsart InterSolve

Bei der Konfiguration in Magento ® können Sie einige Marken definieren, die der Kunde im Bezahlprozess zur Auswahl angeboten bekommt. Die ausgewählte Marke wird an Viveum übermittelt.

Wird nur eine Marke definiert, kann der Kunde keine Marke auswählen, sondern diese wird direkt angezeigt und sofort an Viveum übermittelt.

4.1.2 Zahlungsart Kreditkarte mit Alias Manager

Bei Verwendung der Zahlungsart „Kreditkarte“ und aktivierter Alias Manager-Funktion bekommt ein angemeldeter Kunde seine gespeicherten Kreditkartendaten angezeigt, sofern er diese zuvor gespeichert hat.

Ist der Kunde nicht angemeldet, wird ein Hinweis angezeigt, der ihm die Möglichkeit aufzeigt, seine Kreditkartendaten für die künftige Wiederverwendung zu speichern.

Klickt der Kunde den Link im Hinweistext an, wird er zum Schritt „checkout method“ [„Checkout-Methode“] geleitet und die Option „Registrieren“ wird ausgewählt.

Die Auswahl der angezeigten Zahlungsinformation ist abhängig von der Rechnungsadresse und der Lieferadresse, um Missbrauch vorzubeugen.

Wenn Ihre Kunde seine Zahlungsinformationen speichern möchte, muss er diese Option im Fenster Kreditkartenzahlung auswählen.

Wenn gespeicherte Kreditkartendaten verfügbar sind, wird das Formular im Fenster Kreditkartenzahlung vorab ausgefüllt und die Eingabefelder erscheinen abgeblendet.

Wenn der Kunde seine gespeicherten Kreditkartendaten aktualisieren möchte, muss er wie folgt vorgehen:

  1. Eines der abgeblendeten Eingabefelder anklicken. Alle Eingabefelder werden daraufhin geleert.
  2. Die neuen Kreditkartendaten eingeben.
  3. Die Option „Save payment information“ [Zahlungsdaten speichern] auswählen. Wird diese Option nicht aktiviert, finden die neuen Zahlungsinformationen für den aktuellen Bezahlvorgang Verwendung, werden aber nicht gespeichert. Die bisherigen Zahlungsinformationen bleiben somit für künftige Verwendung erhalten.

Wenn Sie der Kunde seine Zahlungsinformationen anzeigen bzw. löschen möchte, müssen Sie er wie folgt vorgehen:

  • Im Viveum Back-Office zu „payment information“ [Zahlungsinformationen] gehen und die gewünschte Aktion ausführen.
  • In Magento ®:
    1. Gehen Sie zu "customers > manage customers" [Kunden > Kundenverwaltung].
    2. Klicken Sie die Zeile des Kunden an.
    3. Wählen Sie "Payment information" [Meine Zahlungsinformationen].
    4. Führen Sie die gewünschte Aktion aus.

4.1.3 Zahlungsart Lastschrift

Sie können das Lastschriftverfahren für Österreich, Deutschland und die Niederlande verwenden. Es erlaubt Ihrem Kunden die Verwendung seiner Kontodaten für Zahlungen.

Funktionen im Überblick

Ursprung des Lastschriftverfahrens Deutschland Österreich Niederlande
Der Kunde muss seine Kontonummer eingeben (Kontonummer, rekeningnummer)
X
X
X
Der Kunde muss seine Bankleitzahl (BLZ) eingeben
X
X
Der Kunde kann die IBAN eingeben
X
X
Der Kunde kann den BIC eingeben
X
X

Hinweis: Wenn der Kunde sowohl IBAN als auch BIC eingibt und anschließend auch die entsprechenden Kontodaten, werden für die Verarbeitung der Zahlung IBAN und BIC verwendet.

Sie können das Lastschriftverfahren auch für so genannte MOTO-Transaktionen in Magento ® nutzen. Das bedeutet, Sie akzeptieren Transaktionen aus Bestellungen per Post/Telefon und geben diese manuell ein. Der übrige Ablauf ist, wie oben beschrieben.

4.2 Sendungserstellung

Die Erstellung einer Sendung erfolgt ohne Verbindung zum Zahlungsservice und daher wie nach Magento ®-Standard.

4.3 Stornierungen

War die Autorisierung erfolgreich, bekommen Sie die Schaltfläche „Void“ [Stornieren] in der „order view“ [Bestellungsübersicht] von Magento ® angeboten (unter „Sales > Orders“ [Verkäufe > Bestellungen] die Bestellung anklicken). Für ein Storno müssen Sie diese Schaltfläche anklicken, nicht die Schaltfläche „Cancel“ [Abbrechen]. Grund dafür ist der Verarbeitungsablauf im Gateway.

Bei erfolgreicher Verarbeitung des Stornos durch Viveum kann es bei einigen Magento ®-Versionen notwendig sein, dass Sie die Schaltfläche „Cancel“ [Stornieren] anklicken, um in Magento ® den korrekten Stornostatus herzustellen.

Wenn die Bestellung den Status „Pending Payment“ [ausstehende Zahlung] und der Viveum-Status „0“ oder „empty“ [Leer] lautet, können Sie die Bestellung mittes „Cancel“ [Stornieren] Schaltfläche stornieren:

  • Es wird keine Gateway-Anfrage an Viveum gesendet.
  • Der Lagerbestand wird wieder um die stornierte Bestellmenge hochgesetzt.
Kontrollieren Sie vorher den Zahlungsstatus im Viveum Back-Office, andernfalls können Sie den Status in Magento ® nicht mehr aktualisieren.

4.4 Rechnungsstellung

Wenn Sie „Authorization“ [Autorisierung] als „Zahlungsvorgang“ in der Magento ®-Konfiguration gewählt haben, müssen Sie immer eine Rechnung für Kreditkarten-Zahlungsarten erstellen, um den Buchungsprozess durch Viveum anzustoßen.

Um eine Rechnung zu erstellen:

  1. Gehen Sie zur Magento ® „Order view“ [Bestellansicht] (unter „Sales > Orders“ [Verkäufe > Bestellungen] die Bestellung anklicken).
  2. Die Schaltfläche “Invoice” [Rechnung] anklicken.
  3. „Capture Online“ [Online erfassen] als Betrag wählen.
  4. Die Schaltfläche „Submit Invoice“ [Rechnung einreichen] anklicken.

4.5 Gutschriften

Um eine Gutschrift zu erstellen:

  1. Gehen Sie zu Sales> Rechnungen.
  2. Die Rechnung zur Gutschrift anklicken.
  3. Die Schaltfläche „Credit Memo“ [Gutschrift] anklicken.
  4. Den Gutschriftbetrag festlegen.
  5. Wenn gewünscht, wählen Sie die Option „Close Viveum transaction“ [Letzte Gutschrift (schließt die Viveum Transaktion] aus.
  6. Zum Bestätigen die Schaltfläche „Refund“ [Erstatten] anklicken. Nicht die Schaltfläche „Refund Offline“ [Erstattung (offline)] anklicken!
  7. Diese Prozedur wiederholen, bis die Viveum Transaktion abgeschlossen ist. Das bedeutet, entweder ist der volle Betrag bereits gutgeschrieben oder Sie haben die Option "Close the Viveum transaction" [Letzte Gutschrift (schließt die Viveum Transaktion] gewählt. In letzterem Fall sind nur Offline-Gutschriften verfügbar.

Abhängig von der Zahlungsart erfolgt die Gutschrift sofort oder nach einer Wartezeit durch Viveum.

Die Schaltfläche „Credit Memo“ [Gutschrift] in der „Order view“ [Bestellansicht] veranlasst nur eine interne Gutschrift und stößt keine Gutschriftaktion durch Viveum an.

Für einige Zahlungsarten (z. B. iDEAL) müssen Sie Gutschriften erst in Ihrem Viveum Konto aktivieren.

4.6 Zusätzliche Informationen

Um zusätzliche zahlungsbezogene Informationen über die Bestellung zu erhalten:

  1. Gehen Sie zu „Order view“ [Bestellansicht] unter „Sales > Orders“ [Verkäufe > Bestellungen].
  2. Wählen Sie „Information“ [Informationen].
  3. Prüfen Sie den Abschnitt „Payment Information“ [Zahlungsinformationen]. Die Informationen umfassen:
    • Zahlungsart (z. B. VISA Kreditkarte)
    • Zahlungs-ID
    • Aktueller Zahlungsstatus
    • Währung
  4. Prüfen Sie den Abschnitt „Comments History“ [Kommentarverlauf]. Dieser Abschnitt zeigt die Historie der Statusänderungen der Zahlung. Diese Informationen können Ihnen dabei helfen zu verifizieren, dass sich eine Kreditkartenautorisierung infolge einer Zahlungsbuchung geändert hat.

4.7 Zahlungen im Magento ® Backend auslösen

Im Kontext von Viveum MOTO (Mail Order/Telephone Order, Bestellung per Post/Telefon) eTerminal -Transaktionen stehen einige Zahlungsarten für die Erstellung von Bestellungen in Magento ® zur Verfügung.

Die Nutzung weitergeleiteter Zahlungsarten ist nicht erlaubt, weil sie nicht zulässig sind. Sie können auch 3-D Secure („Verified by VISA“, „MasterCard Secure Code“) nicht nutzen.

Um Kreditkarten- bzw. Lastschrift-Zahlungsarten für MOTO eTerminal-Transaktionen zu ermöglichen, müssen Sie die Option „Enable for backend“ [Für Zahlungen im Backend erlauben] auf „YES“ [Ja] setzen. Dies geschieht unter „System > Configuration > Payment methods > Select credit card and/or direct debit payment method“ [System > Konfiguration > Zahlungsarten > Kreditkarten- bzw. Lastschriftarten wählen].

Sofort nachdem Sie die Bestellung eingefügt haben, sendet Magento ® bereits einige Daten an den Shop. Darum könnten Sie den Eindruck gewinnen, dass sie zweimal auf die Schaltfläche „Order submit“ [Bestellung einreichen] klicken müssen.

Sie können auch einen Link der Zahlungsseite, auf der die Zahlung vorgenommen werden kann, per E-Mail senden. Um diese Funktion zu unterstützen, müssen Sie die Option unter System -> Konfiguration -> Zahlungsmethoden -> PayPerMail aktivieren.

4.7.1 Zahlung mit bestehender Viveum Transaktion

Mit dieser Zahlungsart, das nur in Magento ® und nicht in Ihrem Shop verfügbar ist, können Sie direkt die PAY ID einer existierenden Viveum Transaktion eingeben.

In diesem Fall wird keine Anfrage an Viveum ausgelöst und Sie müssen alle Statusänderungen manuell ausführen.

5 Hinweise

5.1 Allgemein

In Magento ® können folgende Status auftreten:

  • Keine Gutschriften im Viveum Backend: Das bedeutet, Sie können Ihre Gutschriftanfragen nur via Magento ® senden.
  • 3-D-Secure (MasterCard, SecureCode und Verified by Visa) muss aktiviert sein: Das bedeutet, Ihr Viveum Konto muss 3-D Secure akzeptieren. 

5.2 Multistore

Sie können die Extension in Magento ® Multistores verwenden mit:

  • mehrere Websites
  • mehreren Stores
  • mehreren Domains
  • mehreren Viveum Konten

Um mehrere Viveum Konten zu verwenden, müssen Sie für jedes Viveum Konto, jede Website und jeden Store den im Viveum Back-Office und Magento beschriebenen Schritten folgen.

Am wichtigsten ist, dass Sie die Antwort-URLs im Viveum Back-Office korrekt einrichten:

  1. Zu „Configuration > Technical Information > Transaction Feedback“ [Konfiguration > Technische Informationen > Transaktions-Feedback] gehen.
  2. Konfigurieren Sie die folgenden Felder:
    • Direct HTTP server-to-server request [Direktes Feedback über HTTP Server-zu-Server-Anfrage]
    • HTTP request for status changes [HTTP-Anfrage für Statusänderungen].

Die folgenden Beispiele sollen die korrekte Konfiguration dieser URLs verdeutlichen.

5.2.1 Beispiel - Store Code in URL unter Verwendung eines gemeinsamen Viveum Kontos

Der Multistore besteht aus zwei Stores, die der gleichen Website zugeordnet sind. Das Beispiel gilt auch für den Fall, dass beide Stores verschiedenen Websites zugeordnet sind:

  • Store A residiert unter http://www.my-shop.com/shopa/
  • Store B residiert unter http://www.my-shop.com/shopb/

Die korrekte Konfiguration im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direktes Feedback über HTTP-Server-zu-Server-Anfrage]: http://www.my-shop.com/shopa/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage für Statusänderungen]: http://www.my-shop.com/shopa/ops/api/directLinkPostBack.

Das Feedback für Store B wird korrekt verarbeitet, auch wenn die Antwort nur an die URL von Store A gesendet wird.

5.2.2 Beispiel - unterschiedliche Domains unter Verwendung unterschiedlicher Viveum Konten

Der Multistore besteht aus zwei Stores, die verschiedenen Websites zugeordnet sind, und nutzt zwei verschiedene Viveum Konten:

  • Store A residiert unter http://www.my-shop-a.com/
  • Store B residiert unter http://www.my-shop-b.com/

Die korrekte Konfiguration für Laden A im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direktes Feedback über HTTP-Server-zu-Server-Anfrage]: http://www.my-shop-a.com/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage für Statusänderungen]: http://www.my-shop-a.com/ops/api/directLinkPostBack

Die korrekte Konfiguration für Store B im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direktes Feedback über HTTP-Server-zu-Server-Anfrage]: http://www.my-shop-b.com/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage für Statusänderungen]: http://www.my-shop-b.com/ops/api/directLinkPostBack

5.2.3 Beispiel - unterschiedliche Domains unter Verwendung eines gemeinsamen Viveum Kontos

Der Multistore besteht aus zwei Stores, die verschiedenen Websites und dem gleichen Viveum Konto zugeordnet sind:

  • Store A residiert unter http://www.my-shop-a.com/
  • Store B residiert unter http://www.my-shop-b.com/

Die korrekte Konfiguration für beide Stores im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direktes Feedback über HTTP-Server-zu-Server-Anfrage]: http://www.my-shop-a.com/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage für Statusänderungen]: http://www.my-shop-a.com/ops/api/directLinkPostBack

Sie müssen außerdem die Magento ® Basis-URL für Laden B konfigurieren:

  1. Gehen Sie zu „System > Configuration > General > Web“ [System > Konfiguration > Allgemein > Web].
  2. Tragen Sie im Abschnitt „Unsecure“ [Unsicher] in die Felder „Base URL“ [Basis-URL] und „Base Link URL“ [Basis-Link-URL] die Adresse „http://www.my-shop-b.com/“ ein Verwenden/erhalten Sie die Standardwerte in den übrigen Feldern des Abschnitts „Unsecure“ [Unsicher].
  3. Tragen Sie im Abschnitt „Secure“ [Sicher] in die Felder „Base URL“ [Basis-URL] und „Base Link URL“ [Basis-Link-URL] die Adresse „https://www.my-shop-b.com/“ ein Verwenden/erhalten Sie die Standardwerte in den übrigen Feldern des Abschnitts „Secure“ [Sicher].

5.2.4 Store Code in URL unter Verwendung unterschiedlicher Viveum Konten

Der Multistore besteht aus zwei Stores, die der gleichen Website zugeordnet sind, und nutzt zwei verschiedene Viveum Konten: Das Beispiel gilt auch für den Fall, dass beide Stores mit verschiedenen Websites verbunden sind:

  • Store A residiert unter http://www.my-shop-a.com/
  • Store B residiert unter http://www.my-shop-b.com/

Die korrekte Konfiguration für Store A im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direktes Feedback über HTTP-Server-zu-Server-Anfrage]: http://www.my-shop-a.com/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage für Statusänderungen]: http://www.my-shop-a.com/ops/api/directLinkPostBack

Die korrekte Konfiguration für Store B im Viveum Back-Office ist wie folgt:

  • Direct HTTP server-to-server request [Direkte HTTP Server-zu-Server-Anfrage]: http://www.my-shop-b.com/ops/api/postBack
  • HTTP request for status changes [HTTP-Anfrage nach Statusänderungen]: http://www.my-shop-b.com/ops/api/directLinkPostBack

6 Zahlungs-Workflow

Payment workflow between the Magento ® Extension and your Payment Service Provider