xt:commerce -Plugin Installation des Billpay-Zahlungsmoduls

Transkript

1 xt:commerce -Plugin Installation des Billpay-Zahlungsmoduls 1

2 Inhalt 1 Installation Konfiguration Funktionsweise des Moduls Häufige Fragen & Antworten Kontaktdaten für Rückfragen

3 1 Installation 1.1 Systemvoraussetzungen Folgende Voraussetzungen benötigt ihr System: - PHP Version 4 oder höher. - aktivierte CURL-Bibliothek Wenn Sie das Plugin auf einem Produktivsystem installieren, sollten Sie vorher ein Backup der Dateien des Shops machen. 1.2 Installation Kopieren Sie den Inhalt des erhaltenen Archivs in Ihr Shop- Stammverzeichnis Meldungen zum Überschreiben von Dateien mit Ja bestätigen Sollten Sie im Adminbereich eingeloggt sein Loggen Sie sich bitte aus und noch einmal ein 1.3 Dateien anpassen Bitte öffnen Sie die Datei admin/print_order.php NACH Zeile 104 (Dies gilt für die Datei im Ausgangszustand nach Installation des Shops (Version 3.04 SP2.1). Bei anderen Versionen oder nach Installation anderen Addons kann die Zeilennummer abweichen.) steht in dieser Datei folgender Text: $payment_method=constant(strtoupper('module_payment_'.$order->info['payment_method'].'_text_title')); require_once(dir_fs_catalog. DIR_WS_INCLUDES. '/billpay/utils/billpay_display_bankdata.php'); $payment_method.= display_billpay_bankdata(); Falls Sie das Plugin "pdfrechnung" verwenden, ändern Sie bitte die print_order.php folgendermaßen: NACH Zeile 57: $pdf->rechnungstart($order->customer['lastname'], $customer_gender['customers_gender'], PDF_LIEFERSCHEIN); if($order->info['payment_method'] == 'billpay' $order- >info['payment_method'] == 'billpaydebit') { require_once(dir_fs_catalog. DIR_WS_INCLUDES. '/billpay/utils/billpay_display_pdf_data.php'); } 3

4 Bitte öffnen Sie die Datei admin/orders.php NACH Zeile 74: if ($check_status['orders_status']!= $status $comments!= '') { require_once(dir_fs_catalog. 'includes/billpay/utils/billpay_status_requests.php'); Bitte öffnen Sie die Datei send_order.php NACH Zeile 67: $smarty->assign('phone',$order->customer['telephone']); require_once(dir_fs_catalog. 'includes/billpay/utils/billpay_mail.php'); Bitte öffnen Sie die Datei admin/orders_edit.php NACH den Zeilen 29: require_once(dir_fs_inc. 'xtc_oe_get_options_values_name.inc.php'); require_once(dir_fs_catalog. 'includes/billpay/utils/billpay_edit_orders.php'); 4

5 2 Konfiguration 2.1 Daten für die Billpay Händler-API Verkäufer ID, Portal ID und Security Key erhalten Sie auf Anfrage unter 2.2 Einrichten der Zahlarten Gehen Sie in Ihrem Shopadmin zu den Zahlungsmodulen (Module -> Zahlungsoptionen) Wählen Sie eine Billpay Zahlart aus und klicken Sie Installieren im Rechten Bereich Wählen Sie eine bereits installierte Billpay Zahlart aus und klicken Sie auf Bearbeiten Geben Sie die erhaltenen Daten in die jeweiligen Felder ein 2.3 Einrichten der Gebühren Darstellung variiert von Shop- zu Shopversion. Gehen Sie in Ihrem Shopadmin zu den Zahlungsmodulen (Module -> Zusammenfassung) Wählen Sie eine Billpay Gebühr aus und klicken Sie Installieren im Rechten Bereich Wählen Sie eine bereits installierte Billpay Gebühr aus und klicken Sie auf Bearbeiten Geben Sie gewünschten Daten in die jeweiligen Felder ein achten Sie darauf dass die Gebühr vor der Summe und nach der Steuer liegen muss (Anzeigereihenfolge). Darstellung variiert von Shop- zu Shopversion. 5

6 3 Funktionsweise des Moduls Das Billpay-Zahlungsmodul erweitert die XTC-Standardfunktionalität sowohl im Frontend als auch im Adminbereich um die notwendige Kommunikation mit der Billpay-Schnittstelle. 3.1 Frontend Durch das Zahlungsmodul werden Ihrem xtc Onlineshop zwei Zahlungsmöglichkeiten. Der Kunde muss die Billpay-AGB und Datenschutzbestimmungen bestätigen. Durch die Auswahl einer Billpay Zahlungsmethode und Eingabe der erforderlichen Daten, wird eine Autorisierungsanfrage an Billpay gesendet. Billpay prüft diese Daten auf Korrektheit und Bonität. Wenn die Zahlung nicht über Billpay stattfinden kann, wird eine entsprechende Fehlermeldung ausgegeben. Ist die Datenprüfung erfolgreich verlaufen, kann die Bestellung normal abgeschlossen werden. Bei Bestätigung der Bestellung durch den Kunden wird eine weitere Anfrage an Billpay versandt und finalisiert. Im Falle der Zahlungsoption Kauf auf Rechnung werden die relevanten Kontodaten von Billpay an den Shop übertragen. Die übertragenen Kontodaten variieren von Bestellung zu Bestellung, es ist also nicht möglich diese statisch auf Ihrer Bestellbestätigung / Rechnung einzutragen. 3.2 Adminbereich Die Prozesse im Adminbereich sind für den Nutzer weitest gehend unsichtbar Bestelldetails und Rechnung Bei Aufruf der Detailseite einer Bestellung werden im Abschnitt Zahlungsinformation die oben erwähnten Billpay-Kontodaten angezeigt Zahlungsziel aktivieren und Rechnung erstellen Der Billpay-Rechnungskauf garantiert dem Kunden ein Zahlungsziel von 20 Tagen ab Rechnungsdatum. Um dieses Zahlungsziel einhalten zu können, muss Billpay über den Zeitpunkt der Rechnungserstellung informiert werden. Über den Status Billpay Zahlungsziel aktivieren können Sie dieses bei Billpay aktivieren sollte es dabei zu Problemen kommen, werden Sie selbstverständlich informiert. Billpay überträgt das Zahlungsziel, welches dann auf der Rechnung zu finden ist. Für die Billpay-Zahlart Kauf per Lastschrift wird der Kunde auf der Rechnung darauf hingewiesen, dass der fällige Betrag, durch Billpay, von dem angegebenen Konto abgebucht wird Stornierung einer Bestellung Die Stornierung einer Bestellung kann über den Stornieren -Status gesetzt werden. Nach Betätigung des Aktualisieren Buttons wird Stornierung an Billpay gesendet und die Bestellung wird storniert. 6

7 3.2.4 Teilstornierung einer Bestellung Teilstornierungen von Bestellungen, die mit einer der Billpay-Zahlarten abgewickelt werden, werden im Oxid Shop durch das editieren von Bestellungen durchgeführt. Durch das editieren der Anzahl eines Bestellartikels können Sie die Bestellung ändern. Nach Bestätigung der Änderungen werden die geänderten Daten an Billpay gesandt und die Bestellung entsprechend angepasst. Der Rechnungsbetrag kann nur gesenkt werden eine Erhöhung (Bsp. Mehr Artikel ist nicht möglich)! 4 Häufige Fragen & Antworten 4.1 Das Plugin wurde installiert aber es taucht nicht bei der Auswahl der Zahlarten auf. Bitte prüfen Sie das Logfile welches sich im Verzeichnis includes/billpay/log/billpay.log befindet. Erzeugen Sie die Datei, falls sie nicht drin ist. Geben Sie der Datei Schreibberechtigung. Die häufigsten Ursachen für das Ausblenden der Zahlart sind: - Fehlerhafte Zugangsdaten kontaktieren Sie uns um das zu korrigieren - die Curl-Lib ist auf Ihrem Webspace nicht aktiviert kontaktieren Sie Ihren Provider - Die Zahlart hat eine Sortierreihenfolge, welche bereits von einem anderen Modul verwendet wird. Geben Sie dem Modul eine andere Sort-Order. 4.2 Ich habe das Zahlungsziel aktiviert, aber der Request ist nicht bei Ihnen angekommen. Bitte benutzen Sie für die Zahlungsziel die Schaltfläche Zahlungsziel aktivieren und nicht das Kombinationsfeld für die Statusänderung. Das Kombinationsfeld sendet kein Aktivierungssignal an die Billpay Schnittstelle. Falls diese Schaltfläche nicht sichtbar ist, wurde die Datei admin/orders.php nicht angepasst. Möglicherweise wurde die Datei nicht richtig angepasst. Prüfen Sie, ob der Billpay Code nicht in einem Kommentarbereich gelandet ist. Haben Sie die Extension für die Mehrfach-Bearbeitung von Bestellungen installiert: Dann ist der Billpay-Code in der admin/orders.php an zwei Stellen einzufügen. 4.3 Ich habe die Bestellung storniert, aber der Request ist nicht bei Ihnen angekommen. Gleiches gilt hier wie bei der Zahlungszielaktivierung. Bitte benutzen Sie die Schaltfläche Stornieren. Eine Statusänderung über die Drop-Down-Box bzw. das Löschen der Bestellung löst keine Aktion aus. 4.4 Beim Aktivieren der Bestellung erhalte ich die Fehlermeldung: Der Betrag hat sich gegenüber der Vorauthorisierung geändert. Haben Sie die Zahlartgebühr aktiviert? Prüfen Sie, ob diese angezeigt wird und an der richtigen Stelle ist (nach allen Zusammenfassungsmodulen aber vor der Endsumme). Prüfen Sie, ob ein anderes Zusammenfassungsmodul die gleiche Sort-Order hat wie das Gebührenmodul. Achten Sie insbesondere darauf, dass die Versandkosten vor den Zahlartgebühren einsortiert sind. 7

8 4.5 Beim Abschluss der Bestellung erhalte ich die Fehlermeldung headers already send...table does not exists billpay_bankdata. Möglicherweise ist die Billpay Tabelle bei der Installation nicht erzeugt worden. Bitte führen Sie den SQL-Befehl aus, der die Tabelle nachträglich einfügt: CREATE TABLE IF NOT EXISTS `billpay_bankdata` (`api_reference_id` varchar(64) NOT NULL, `account_holder` varchar(100) NOT NULL, `account_number` varchar(50) NOT NULL, `bank_code` varchar(50) NOT NULL, `bank_name` varchar(100) NOT NULL, `invoice_reference` varchar(250) NOT NULL, `invoice_due_date` varchar(9) default NULL, `tx_id` varchar(64) NOT NULL, `orders_id` int(11) unsigned default NULL ) 5 Kontaktdaten für Rückfragen Bei technischen Fragen zur Schnittstelle wenden Sie sich bitte an: Billpay GmbH Saarbrücker Straße 20/21 D Berlin Telefon: +49 (0) support@billpay.de 8