mpay24

mpay24 im Backend

mpay24 leitet Zahlungen an die mPAY24-Zahlseite weiter, speichert Zugangsdaten pro Multishop und verarbeitet anschließend Browser-Rückkehr sowie technische Rückmeldungen zur Bestellung.

Inhaltsverzeichnis

Einordnung

Die Seite beschreibt die mpay24-spezifische Konfiguration. Die allgemeine Zahlungsarten-Verwaltung bleibt zusätzlich zuständig für Aktivstatus, Kundengruppen, Versandarten, Versandzonen und Betragsgrenzen.

mpay24 nutzt eine Server-Rückmeldung. Der Zahlungsabschluss im Browser und die technische Rückmeldung können zeitlich getrennt eintreffen.

Zugangsdaten und Betriebsmodus

  • sandbox: wählt LIVE oder SANDBOX. Der Wert steuert, ob das SDK gegen das Produktiv- oder Testsystem arbeitet.
  • mpay_merchant_id: Merchant-ID des mPAY24-Kontos. Der Wert wird beim Erzeugen der Zahlungssession an das SDK übergeben.
  • mpay_secret: Merchant-Passwort für die mPAY24-Kommunikation. Das Modul setzt daraus das SOAP-Passwort für das SDK.
Merchant-ID, Passwort und Betriebsmodus müssen zusammenpassen. Testdaten dürfen nicht mit LIVE kombiniert werden.

Status und Rechnung

  • order_status_ok: Bestellstatus nach technischer Rückmeldung mit Status BILLED.
  • order_status_error: Bestellstatus nach technischer Rückmeldung mit Status REVERSED.
  • status_ok_createBill: erstellt bei erfolgreicher Zahlung automatisch eine Rechnung. Im neuen Backend ist der Schalter deaktiviert, wenn das FiBu-Modul nicht aktiv ist.
  • status_ok_sendBill: sendet die automatisch erstellte Rechnung an die Kundschaft. Auch dieser Schalter hängt im neuen Backend vom aktiven FiBu-Modul ab.

Die erfolgreiche Browser-Rückkehr schließt die Bestellung ab, aktualisiert Gutscheincodes, sendet bei aktiver Shop-Einstellung die Bestellbestätigung, leert den Warenkorb und leitet auf die Abschlussseite weiter. Bei Abbruch wird die noch nicht abgeschlossene Bestellung gelöscht und ein vorhandener mpay24-Datensatz zur Bestellung entfernt.

Zahlungsweiterleitung

Beim Start der Zahlung erstellt das Modul eine mPAY24-Order und leitet zur vom SDK gelieferten Zahlungsseite weiter.

  • Tid: verwendet die interne Bestell-ID als technische Transaktionskennung.
  • TemplateSet: setzt die Sprache aus der Kundensprache und nutzt das Template MODERN.
  • ShoppingCart: übergibt eine Position mit Bestellnummer, Beschreibung, Menge und Gesamtbetrag.
  • Price: setzt den Gesamtbetrag der Bestellung inklusive Steuer.
  • Success: Browser-Rückkehr für erfolgreichen Abschluss.
  • Error und Cancel: Browser-Rückkehr für Fehler oder Abbruch.
  • Confirmation: technische Rückmeldeadresse für mPAY24.

Die Reihenfolge der XML-Elemente ist im Backend bewusst festgelegt, weil mPAY24 die MDXI-Struktur erwartet.

Server-Rückmeldung

Die technische Rückmeldung wird nur verarbeitet, wenn die Anfrage von einer der im Modul hinterlegten mPAY24-IP-Adressen kommt.

  • TID: enthält die Bestell-ID und wird zum Laden der Bestellung verwendet.
  • STATUS: wird als Zahlungsstatus übernommen. Fehlt der Wert, speichert der Shop ERROR.
  • BILLED: setzt den Erfolgsstatus und stößt Rechnungserstellung sowie Rechnungsversand an.
  • REVERSED: setzt den Fehlerstatus.
  • MPAYTID: Transaktionsnummer von mPAY24, die im Zahlungsdatensatz gespeichert wird.
  • Log: alle Rückmeldeparameter werden als Text im Zahlungsdatensatz abgelegt.

Rückmeldungen von anderen IP-Adressen werden abgewiesen und nicht als Zahlung verarbeitet.

Bestellung und Loganzeige

In der Bestellung zeigt das Modul den gespeicherten mpay24-Status und den Serverlog zur Bestellung.

  • BILLED: wird als erfolgreich bezahlte Transaktion angezeigt und enthält Zeitpunkt sowie Transaktionsnummer.
  • REVERSED: wird als abgebrochene oder stornierte Transaktion angezeigt.
  • RESERVED: Status vorgemerkt.
  • CREDITED: Status gutgeschrieben.
  • ERROR: Fehlerstatus aus Rückmeldung oder fehlendem Statuswert.
  • ServerLogs: einklappbarer Bereich mit den gespeicherten Rückmeldeparametern.

Der Datensatz wird bei erster Rückmeldung angelegt und bei späteren Rückmeldungen derselben Bestellung aktualisiert.

Filter, Tabellen und Optionen

Die mpay24-Einstellungsseite enthält keine eigene filterbare Liste, keinen DataFilter und keine konfigurierbare BsTable. Deshalb wird kein Spalten-Snippet verwendet.

  • Die sichtbaren Felder liegen direkt im spezifischen Zahlungsarten-Formular.
  • Die Bestellansicht zeigt einen Status- und Logblock, aber keine sortierbare Tabelle.
  • Eine eigene Optionsspalte mit Zeilenaktionen existiert für mpay24 nicht.
  • Eine Rückzahlungs- oder Stornoaktion ist im aktuellen Backendformular nicht vorhanden.

Prüfung nach Änderungen

  • Nach Änderung von mpay_merchant_id, mpay_secret oder sandbox eine Testzahlung mit kleinem Betrag durchführen.
  • Nach Wechsel zwischen SANDBOX und LIVE prüfen, ob mPAY24 eine Zahlungsseite liefert.
  • Nach erfolgreicher Zahlung kontrollieren, ob die Browser-Rückkehr die Bestellung abschließt.
  • Zusätzlich prüfen, ob die technische Rückmeldung den Status BILLED und die Transaktionsnummer im Bestelllog speichert.
  • Nach Änderung der Rechnungsfelder prüfen, ob Rechnungserstellung und Rechnungsversand mit der FiBu-Konfiguration zusammenpassen.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.