Micropayment Vorkasse

Micropayment Vorkasse richtet die Prepay-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 Vorkasse. 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_ep_projectidentifer: Projektkürzel des Vorkasse-Projekts. Dieses Feld ist variantenbezogen und unterscheidet Vorkasse 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 Vorkasse-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 Vorkasse ist besonders wichtig, dass Zahlungseingang, Rechnungsfreigabe und Versandprozess zusammenpassen.

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 Vorkasse-Zahlart. Die Infobox im Formular verweist auf die Micropayment-Projekteinrichtung und unterstützt beim Abgleich von Kundennummer, Projektkürzel und AccessKey.

1. Kundennummer, Vorkasse-Projektkürzel und AccessKey eintragen.
2. Status- und Rechnungseinstellungen mit dem gewünschten Bestellablauf abstimmen.
3. Layoutwerte nur setzen, wenn das Micropayment-Projekt eine angepasste Darstellung nutzt.
4. Speichern und anschließend einen Testauftrag auslösen.

Zahlungsweiterleitung

Beim Zahlungsaufruf baut der Shop die Vorkasse-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 Vorkasse-Variante wird das Modul prepay 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 Vorkasse-Protokolltabelle gespeichert.
• Mailfreigabe: Die Vorkasse-Klasse setzt bei der neutralen Rückkehr die Mailfreigabe für den weiteren Bestellablauf.

Nach einer Änderung sollten erfolgreicher Abschluss, Abbruch und fehlerhafte Rückmeldung mit kleinen Beträgen geprüft werden. Bei Vorkasse sollte zusätzlich kontrolliert werden, ob die Kommunikation zum erwarteten Zahlungsstatus 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 Vorkasse-Variante besitzt kein Direktkauf-Feld.

Prüfung nach Änderungen

1. Vorkasse-Zahlung mit kleinem Betrag starten.
2. Projektkürzel, Kundennummer und AccessKey prüfen, wenn Micropayment den Aufruf ablehnt.
3. Nach erfolgreicher Rückkehr Bestellstatus, Warenkorbabschluss und Rechnungsoptionen kontrollieren.
4. Abbruch testen und prüfen, ob der nicht abgeschlossene Auftrag entfernt wird.
5. Kommunikation und Mailfreigabe im Vorkasse-Ablauf kontrollieren.
6. In der Bestellansicht Logtabelle, Statusanzeige und ServerLogs kontrollieren.