Skrill

Skrill ist im Backend als Zahlungsmodul Moneybookers umgesetzt. Die Seite beschreibt Konfiguration, Weiterleitung zur Zahlung, Rueckmeldepruefung, Bestellstatus, Rechnungserstellung und die Statusanzeige in der Bestellung.

Aufgabe der Zahlungsart

Nach dem Bestellabschluss erzeugt das Modul eine Zahlungsanforderung an Skrill. Der Shop uebergibt Betrag, Waehrung, Bestellnummer, Kundendaten, Rueckmeldeadresse, Abbruchadresse und die im Zahlungsmodul hinterlegte Skrill-Zahlungsmethode.

• Modulname: Technisch heisst das Zahlungsmodul Moneybookers, fachlich wird es als Skrill gefuehrt.
• Zahlungsweiterleitung: Nach Vorbereitung der Zahlungsdaten wird zur Skrill-Zahlseite weitergeleitet.
• Rueckmeldung: Skrill sendet den Zahlungsstatus an die Rueckmeldeverarbeitung des Shops.
• Bestellabschluss: Bei gueltiger Rueckmeldung wird die Bestellung als abgeschlossen markiert.
• Folgeaktionen: Bei erfolgreichem Status werden Bestellstatus, Bestellmail und optionale Rechnungserstellung verarbeitet.

Konfigurationsfelder

Die Einstellungen werden pro Multishop in der Konfigurationsgruppe payment_moneybookers gespeichert. Beim Initialisieren fehlender Variablen werden Standardwerte fuer Zugangsdaten, Erfolgsstatus und Rechnungslogik angelegt.

• moneybookers_email - Moneybookers-Email: Empfaengerkonto bei Skrill. Dieser Wert wird als Zahlungsempfaenger an Skrill uebergeben.
• moneybookers_pass - Geheim-Passwort: Geheimwert fuer die Signaturpruefung der Rueckmeldung. Der Hash wird aus Merchant-ID, Transaktions-ID, Passwort-Hash, Betrag, Waehrung und Status gebildet.
• order_status_ok - Bestellstatus fuer erfolgreiche Zahlungen: Status, der bei erfolgreichem Skrill-Status an der Bestellung gesetzt wird.
• status_ok_createBill - Rechnung bei erfolgreicher Zahlung erstellen: Steuert, ob nach erfolgreicher Zahlung eine Rechnung erzeugt wird. Im Bootstrap-Formular kann das Feld deaktiviert sein, wenn das Finanzbuchhaltungsmodul nicht aktiv ist.
• status_ok_sendBill - Rechnung bei erfolgreicher Zahlung an Kunde senden: Steuert den Versand der erzeugten Rechnung an den Kunden, ebenfalls abhaengig von der Rechnungslogik.

Weiterleitung zur Zahlung

Beim Redirect baut das Modul einen Zahlungsdatensatz fuer Skrill auf und fordert eine Session an. Aus dem von Skrill gelieferten Cookie wird die Session-ID gelesen und fuer die Weiterleitung verwendet.

• pay_to_email: Empfaengerkonto aus moneybookers_email.
• transaction_id: Shop-Bestellnummer. Diese Nummer wird spaeter in der Signaturpruefung verwendet.
• status_url: Rueckmeldeziel des Shops mit der Order-ID.
• amount: Bruttosumme der Bestellung inklusive Steuer.
• currency: ISO-Code der Bestellwaehrung.
• cancel_url: Ziel fuer abgebrochene Zahlungen. Dort wird ein abgebrochener Status zur Bestellung gespeichert.
• return_url: Ziel nach erfolgreicher Zahlung, normalerweise die Checkout-Fertigseite.
• Kundendaten: Vorname, Nachname, Adresse, PLZ, Ort und Land werden zur Zahlung uebergeben.
• payment_methods: Einschränkung auf den in der Zahlungsart hinterlegten Skrill-Zahlungswert.

Rueckmeldung und Signaturpruefung

Die Rueckmeldeverarbeitung berechnet lokal den erwarteten MD5-Signaturwert und vergleicht ihn mit md5sig aus der Skrill-Rueckmeldung.

• Gueltige Signatur: Zahlungsstatus, Zeitstempel und komplette Rueckmeldedaten werden als Moneybookers-Datensatz zur Bestellung gespeichert.
• Ungueltige Signatur: Die Verarbeitung wird mit Forbidden beendet. Es werden keine Bestellfolgeaktionen ausgefuehrt.
• Statuswert: Der uebermittelte Status wird als payed gespeichert und spaeter in der Bestellansicht ausgewertet.
• Status 2: Gilt als erfolgreiche Zahlung. Nur in diesem Fall werden Erfolgsstatus, Bestellmail und Rechnungslogik ausgefuehrt.
• Andere Statuswerte: Werden protokolliert, loesen aber nicht die Erfolgsfolge aus.

Bestellstatus, Rechnung und Mail

Bei erfolgreicher Rueckmeldung wird die Bestellung fertiggestellt und der konfigurierte Erfolgsstatus gesetzt.

• Bestellung abschliessen: Die Bestellung wird als abgeschlossen markiert.
• Status setzen: order_status_ok wird bei Status 2 an der Bestellung gespeichert.
• Bestellmail: Wenn der Shop den Versand von Bestellbestaetigungen aktiviert hat, wird die Bestellmail gesendet.
• Rechnungslauf: Die Felder status_ok_createBill und status_ok_sendBill werden an die zentrale Rechnungserstellung im Checkout uebergeben.
• Abbruch: Bei abgebrochener Zahlung speichert das Modul einen Datensatz mit Status -2 und leitet zurueck in den Shop.

Statusanzeige in der Bestellung

Die Bestellansicht liest den gespeicherten Moneybookers-Datensatz zur Bestellung und zeigt den aktuellen Zahlungsstatus inklusive Logbereich.

• 2: Erfolgreich. Die Anzeige wird gruen ausgegeben und mit Zeitstempel ergaenzt.
• -2: Fehlgeschlagen. Die Anzeige wird rot ausgegeben und mit Zeitstempel ergaenzt.
• 0: Offen. Es liegt noch keine erfolgreiche oder fehlgeschlagene Rueckmeldung vor.
• -1: Abgebrochen.
• ServerLogs: Der gespeicherte Rueckmeldeinhalt kann in einem einklappbaren Logbereich angezeigt werden.

Pruefung bei Problemen

1. Pruefen, ob moneybookers_email dem richtigen Skrill-Empfaengerkonto entspricht.
2. Pruefen, ob moneybookers_pass mit dem Geheimwort fuer die Skrill-Rueckmeldung uebereinstimmt.
3. Bei fehlendem Abschluss kontrollieren, ob eine Rueckmeldung mit gueltiger Signatur gespeichert wurde.
4. Bei Status ohne Erfolgsfolge den gespeicherten payed-Wert und den ServerLogs-Bereich in der Bestellung auswerten.
5. Bei fehlender Rechnung pruefen, ob das Finanzbuchhaltungsmodul aktiv ist und status_ok_createBill beziehungsweise status_ok_sendBill passend gesetzt sind.
6. Bei falschem Bestellstatus die Auswahl order_status_ok und die Bestellstatus-Konfiguration abgleichen.