Micropayment Lastschrift
Micropayment Lastschrift im Backend
Micropayment Lastschrift richtet die Lastschrift-Variante der Micropayment-Gruppe ein. Die Seite erklärt Projektzugang, Status- und Rechnungseinstellungen, Gestaltung, signierte Zahlungsweiterleitung, Rückkehrlogik und die Protokolle in der Bestellung.
Einordnung
Diese Unterseite gehört zur Micropayment-Gruppe und betrifft die Variante Lastschrift. Allgemeine Zahlungsart-Einstellungen wie Aktivierung, Kundengruppen, Versandarten, Versandzonen und Betragsgrenzen bleiben in der übergeordneten Zahlungsart gepflegt.
Zugangsdaten und Testmodus
- mp_kdnr: Kundennummer des Micropayment-Kontos. Der Wert wird im Zahlungsaufruf als Account übergeben.
- mp_ls_projectidentifer: Projektkürzel des Lastschrift-Projekts. Dieses Feld ist variantenbezogen und unterscheidet Lastschrift von den anderen Micropayment-Unterseiten.
- mp_accesskey: AccessKey für die Signatur. Der Shop bildet aus den versiegelten Parametern und diesem Schlüssel den seal.
- sandbox: vorhandene Konfigurationsvariable für den Testbetrieb. In der Lastschrift-Klasse wird dieser Wert gespeichert, im Zahlungsrequest aber nicht als eigener Parameter übergeben.
Status und Rechnungen
- order_status_ok: Bestellstatus nach erfolgreicher Zahlung.
- status_ok_createBill: steuert, ob bei erfolgreicher Zahlung eine Rechnung erzeugt wird. Im Bootstrap-Formular kann das Feld gesperrt sein, wenn die FiBu nicht aktiv ist.
- status_ok_sendBill: steuert, ob die erzeugte Rechnung nach erfolgreicher Zahlung versendet wird. Auch dieses Feld kann bei inaktiver FiBu gesperrt sein.
- order_status_error: Bestellstatus für fehlgeschlagene oder abgebrochene Zahlungsprozesse.
Die Statusfelder greifen auf die im Shop vorhandenen Bestellstatus zurück. Für Lastschrift sollte die Auswahl zu Zahlungseingang, Rechnungslogik, Versandfreigabe und möglicher Rücklastschriftbearbeitung passen.
Layout und Kampagne
- mp_theme: Layoutname für die Micropayment-Zahlungsseite.
- mp_bgcolor: Hintergrundfarbe für die externe Zahlungsseite.
- mp_gfx: Logo- oder Grafikwert für die externe Zahlungsseite.
- mp_projectcampaign: Kampagne des Projektinhabers, die zusätzlich an Micropayment übertragen wird.
Diese Felder beeinflussen die Darstellung auf der externen Micropayment-Seite. Änderungen sollten mit einem Testauftrag kontrolliert werden, weil ungültige Layout- oder Grafikwerte nicht im Shop selbst gerendert werden.
Speichern und Projekthinweis
Beim Speichern übernimmt das Backend die Formularwerte in die Konfiguration der Lastschrift-Zahlart. Die Infobox im Formular verweist auf die Micropayment-Projekteinrichtung und unterstützt beim Abgleich von Kundennummer, Projektkürzel und AccessKey.
- Kundennummer, Lastschrift-Projektkürzel und AccessKey eintragen.
- Status- und Rechnungseinstellungen mit dem gewünschten Bestellablauf abstimmen.
- Layoutwerte nur setzen, wenn das Micropayment-Projekt eine angepasste Darstellung nutzt.
- Speichern und anschließend einen Testauftrag auslösen.
Zahlungsweiterleitung
Beim Zahlungsaufruf baut der Shop die Lastschrift-Anfrage aus Bestell- und Kundendaten auf. Übertragen werden Projekt, Kundennummer, Betrag in Cent, Bestellnummer, Lieferland, Währung, Modul, Layoutwerte, Kampagne und Kundendaten wie Name, E-Mail, Adresse, Postleitzahl, Ort und Land.
Für die Lastschrift-Variante wird das Modul lastschrift gesetzt. Aus den Parametern entsteht eine versiegelte Parameterfolge. Zusammen mit mp_accesskey erzeugt der Shop den seal und leitet danach zur Micropayment-Zahlungsseite weiter.
Rückkehr, Erfolg und Abbruch
- Erfolgreiche Rückkehr: Der Shop aktualisiert Gutschein- und Umsatzdaten, leert den Warenkorb und führt zur Abschlussseite.
- Abbruch: Der noch nicht abgeschlossene Auftrag wird entfernt und der Warenkorb wird wieder angesteuert.
- Serverrückmeldung: Zahlungsstatus, Transaktionsnummer und Logdaten werden in der Lastschrift-Protokolltabelle gespeichert.
Nach einer Änderung sollten erfolgreicher Abschluss, Abbruch und fehlerhafte Rückmeldung mit kleinen Beträgen geprüft werden. Bei Lastschrift ist zusätzlich wichtig, ob der gewählte Bestellstatus zur internen Prüfung des Lastschriftvorgangs passt.
Bestellansicht und Serverlogs
In der Bestellansicht zeigt das Modul den aktuellen Transaktionsstatus und darunter die gespeicherten Micropayment-Rückmeldungen. Die Logliste ist eine feste Tabelle und keine konfigurierbare Datentabelle.
- Datum/Zeit: Zeitstempel der gespeicherten Rückmeldung.
- Type: lesbarer Status. billing wird als erfolgreich, storno als storniert und backpay als erfolgreich nach Storno dargestellt. Andere Werte bleiben als unbekannt sichtbar.
- Auth/Ident-Nummer: gespeicherte Transaktions- oder Identnummer aus der Rückmeldung.
- ServerLogs: aufklappbarer Detailbereich mit dem gespeicherten Rückmeldeprotokoll.
Die Tabelle besitzt keine Optionsspalte, keine Sortierkonfiguration und keine Spaltenauswahl. Für diese feste Bestellansicht wird deshalb kein Spalten-Snippet verwendet.
Filter, Tabellen und Aktionen
- Die Konfigurationsseite besitzt keine Suche und keine Datenfilter.
- Es gibt keine Übersichtstabelle mit Zeilenaktionen.
- Die sichtbare Formularaktion ist das Speichern der Zahlungsartkonfiguration.
- Die Bestellansicht enthält nur die feste Logtabelle mit Status- und Protokolldaten.
- Die Lastschrift-Variante besitzt kein Direktkauf-Feld.
Prüfung nach Änderungen
- Lastschrift-Zahlung mit kleinem Betrag starten.
- Projektkürzel, Kundennummer und AccessKey prüfen, wenn Micropayment den Aufruf ablehnt.
- Nach erfolgreicher Rückkehr Bestellstatus, Warenkorbabschluss und Rechnungsoptionen kontrollieren.
- Abbruch testen und prüfen, ob der nicht abgeschlossene Auftrag entfernt wird.
- Den Status für interne Lastschriftprüfung und Versandfreigabe kontrollieren.
- In der Bestellansicht Logtabelle, Statusanzeige und ServerLogs kontrollieren.