Zahlungs-Gateways erstellen - Versionsgeschichte

Richard Reiber am 5. Oktober 2018 um 11:09 Uhr

2018-10-05T11:09:47Z

Richard Reiber: /* Gebühren */

2015-06-12T21:40:03Z

‎Gebühren

Richard Reiber: /* Gebühren */

2015-06-12T21:39:46Z

‎Gebühren

Richard Reiber: /* Gebühren */

2015-06-12T21:39:29Z

‎Gebühren

Richard Reiber: /* Gebühren */

2015-06-12T21:38:54Z

‎Gebühren

Richard Reiber: /* Gebühren */

2015-06-12T21:34:37Z

‎Gebühren

Richard Reiber am 12. Juni 2015 um 21:29 Uhr

2015-06-12T21:29:50Z

Richard Reiber: /* getPaymentForm() */

2015-06-12T21:29:30Z

‎getPaymentForm()

Richard Reiber: /* Aktivieren / Deaktivieren */

2015-06-12T21:27:46Z

‎Aktivieren / Deaktivieren

Richard Reiber am 12. Juni 2015 um 21:26 Uhr

2015-06-12T21:26:04Z

@@ Zeile 4: / Zeile 4: @@
 Im Ordner '''modules/payment''' liegen alle Zahlungs-Gateways. Jedes Zahlungsgateway hat dort einen Ordner mit einem Namen für dieses (nur Kleinbuchstaben; natürlich können Abkürzungen verwaltet werden). Dieser kurze Name wird im Folgenden als ''Kurzname'' bezeichnet.
-In einem Ordner eines Gateways wiederum muss sich eine Datei mit dem Kurznamen des Gateways und der Endung ''.php'' befinden. Diese Datei stellt die Hauptdatei des Gateways dar. Außerdem muss ein Ordner ''language'' für den Support mehrerer Sprachen existieren. Für [[Smarty]]-Templates kann zum Beispiel ein seperater Ordner ''templates'' angelegt werden.
+In einem Ordner eines Gateways wiederum muss sich eine Datei mit dem Kurznamen des Gateways und der Endung ''.php'' befinden. Diese Datei stellt die Hauptdatei des Gateways dar. Außerdem muss ein Ordner ''language'' existieren, wenn Sie mehrere Sprachen unterstützen möchten. Für [[Smarty]]-Templates kann zum Beispiel ein separater Ordner ''templates'' angelegt werden.
 == Aufbau der Hauptdatei ==
@@ Zeile 19: / Zeile 19: @@
 </source>
-Für jede Gateway-Klasse sollte ein eigener Konstruktor geschrieben werden. Dieser muss den Konstruktor von ''PaymentGateway'' (der Oberklasse) aufrufen und sollte die aktuelle Sprache festsetzen. Außerdem müssen die Sprachdateien geladen werden. Wir lernen hier den Ausnahmen-Typ ''ModuleException'' kennen. Ein Wurf einer solchen Ausnahme wird das Modul nicht laden sondern ignorieren.
+Für jede Gateway-Klasse sollte ein eigener Konstruktor geschrieben werden. Dieser muss den Konstruktor von ''PaymentGateway'' (der Oberklasse) aufrufen und sollte die aktuelle Sprache festsetzen. Außerdem müssen die Sprachdateien geladen werden. Wir lernen hier den Ausnahmen-Typ ''ModuleException'' kennen. Ein Wurf einer solchen Ausnahme wird das Modul nicht laden, sondern ignorieren.
 <source lang="php">
@@ Zeile 77: / Zeile 77: @@
 == getPaymentHandler() ==
-...
+Diese Methode kann definieren, welcher Code ausgeführt werden soll, wenn die URL <code>SOURCEDESK_URL/credit/pay/GATEWAY_NAME</code> aufgerufen wird.
 == makeCashboxPayment($hash) ==
-...
+Diese Methode startet den Zahlungsvorgang für eine Cashbox-Zahlung mit dem Hash ''$hash''.
 == getIpnHandler() ==
-...
+Diese Methode wird aufgerufen, wenn die URL <code>SOURCEDESK_URL/ipn/GATEWAY_NAME</code> aufgerufen wird.
 == Gebühren ==
@@ Zeile 148: / Zeile 148: @@
 Als ''$data'' verwenden Sie am besten die eingegeben Rohdaten, indem Sie zum Beispiel ''$_POST'' dumpen. Achten Sie hierbei unbedingt auf die Entfernung langer oder unnötiger Werte, um das Zahlungs-Log im Adminbereich nicht zu sprengen. Für ''$log'' ist normalerweise ein eigener String vorgesehen, der die Aktionen des IPN-Handlers beschreibt. (Zeilenumbruch durch \n) Es eignet sich hierfür eine try-catch-Struktur.
 == Weiteres ==
@@ Zeile 161: / Zeile 155: @@
 $this->admin_warning = "Warntext";
 </source>

@@ Zeile 113: / Zeile 113: @@
 	if(!paypalFeesAdded){
      	        var percent = <?=$this->settings['percent']; ?>;
-     	        var fix  = Number(<?=$cur->convertAmount(null, $this->settings['fix']); ?>);
+     	        var fix     = Number(<?=$cur->convertAmount(null, $this->settings['fix']); ?>);
      	        var value   = Number(document.getElementById("paypal_amount").value.replace(',', '.'));

@@ Zeile 113: / Zeile 113: @@
 	if(!paypalFeesAdded){
      	        var percent = <?=$this->settings['percent']; ?>;
-     	        var fix  	= Number(<?=$cur->convertAmount(null, $this->settings['fix']); ?>);
+     	        var fix  = Number(<?=$cur->convertAmount(null, $this->settings['fix']); ?>);
      	        var value   = Number(document.getElementById("paypal_amount").value.replace(',', '.'));

@@ Zeile 116: / Zeile 116: @@
      	        var value   = Number(document.getElementById("paypal_amount").value.replace(',', '.'));
-		value += Math.ceil(value / 100 * percent * 100) / 100;
+		value += Math.ceil(value * percent) / 100;
 		value += fix;
 		value  = String(value);

@@ Zeile 86: / Zeile 86: @@
 == Gebühren ==
-Es ist dem Administrator für jedes Gateway individuell möglich, Gebühren einzustellen. Diese kann er sowohl prozentual als auch fix angeben (natürlich auch beides gleichzeitig). Bei einer Einstellung beider Gebühren-Typen für ein Gateway wird zuerst der prozentuale Wert gebildet und dann von diesem der fixe.
+Es ist dem Administrator für jedes Gateway individuell möglich, Gebühren einzustellen. Diese kann er sowohl prozentual als auch fix angeben (natürlich auch beides gleichzeitig). Bei einer Einstellung beider Gebühren-Typen für ein Gateway wird zuerst der prozentuale Wert gebildet und dann von diesem der fixe. Außerdem ist es möglich einzustellen, ob der vom Kunden eingegebene Betrag inklusive oder exklusive Gebühren sein soll.
 Für die Gebührenrechnung gibt es zwei Methoden, der innerhalb der Klasse verfügbar sind. Die erste Methode ist ''addFees'', sie erwartet zwei Parameter. Der erste beinhaltet den Betrag ohne Gebühren, der zweite ist ein Boolean (true/false) und gibt an, ob der Betrag noch konvertiert werden muss. Für die Konvertierung wird die aktuell eingestellte Währung angenommen und der Betrag dann in die Basiswährung konvertiert. Außerdem vorhanden ist die Methode ''deductFees'', sie erwartet nur einen Parameter, nämlich den Betrag. Eine automatische Konvertierung kann hier nicht erfolgen.
 Mit einer Zeile Code im Konstruktor kann das Gebührensystem übrigens für dieses Gateway deaktiviert werden:

← Nächstältere Version		Version vom 12. Juni 2015, 21:29 Uhr
Zeile 83:		Zeile 83:

	== getIpnHandler() ==		== getIpnHandler() ==
		+	...
		+
		+	== Gebühren ==
	...		...

@@ Zeile 68: / Zeile 68: @@
 == getPaymentForm() ==
-...
+Diese Methode soll den HTML-Code zurückgeben, der auf der Seite zum Einzahlen von Guthaben angezeigt werden soll. Dieser ist meist eine HTML-Form.
 == getPaymentHandler() ==

@@ Zeile 54: / Zeile 54: @@
 == Aktivieren / Deaktivieren ==
-...
+Es ist möglich, bestimmte Aktionen beim Aktivieren bzw. Deaktivieren eines Gateways auszuführen. Dafür können Sie eine Methode nach folgendem Schema erstellen:
 == getPaymentForm() ==

@@ Zeile 52: / Zeile 52: @@
 $this->settings[$key];
 </source>
 == Zahlungs-Log ==