logo

OXID ESALES

Unterstützte Zahlarten
  Rechnung
  Lastschrift
Features
  Zahlungszielaktivierung
  Vollstornierung
  Teilstornierung
+
-
Schritt 1 – Installation des BillPay-Plugins

  1. Kopieren Sie den Inhalt des erhaltenen Archivs in Ihr Shop-Stammverzeichnis.
  2. Installieren Sie im Admin-Bereich unter eShop Admin → BillPay → BillPay-Installation das Plugin.
  3. Setzen sie im Admin-Bereich unter eShop Admin → Shopeinstellungen → Zahlarten → BillPay das Häkchen bei „Aktiv“.
  4. Loggen Sie sich aus den Admin-Bereich aus und erneut ein.
  5. Löschen Sie den Cache des Shops.
+
-
Schritt 2 (V4.9 CE) – Anpassung der Oxid-Dateien

  1. Laden Sie die folgende Datei vom ftp-Server herunter und öffnen Sie diese:
    modules/oe/invoicepdf/models/invoicepdfarticlesummary.php (Anpassung nur nötig wenn das Pdf-Modul installiert ist)
  2. Editieren Sie die modules/oe/invoicepdf/models/invoicepdfarticlesummary.php wie folgt:
    Suchen Sie nach der Zeile:

    $this->_oData->oxorder__oxpaymenttype->value );

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
    $billpayUtils = oxNew('billpayutil');
    $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
    if ($billpayUtils->isBillpayPayment($sPaymentType)) {
       if ($sPaymentType == $billpayUtils->getTCName()) {
         $billpayUtils->setAdditionalTotal($this, $this->_oPdf,
         $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
        } else {
         $billpayUtils->setInvoiceText($this, $this->_oPdf,
         $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
        }
        return;
      }
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach der Zeile:

    $text = $this->_oData->translate( 'ORDER_OVERVIEW_PDF_PAYUPTO'

    Fügen Sie bitte VOR dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
        $billpayUtils = oxNew('billpayutil');
        $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
        if ($billpayUtils->isBillpayPayment($sPaymentType)) {
            return;
        }
    /** EOF BILLPAY CHANGED **/

+
-
Schritt 2 (V4.5 – 4.8 CE / 5.0 – 5.1 EE) – Anpassung der Oxid-Dateien

  1. Laden Sie die folgende Datei vom ftp-Server herunter und öffnen Sie diese:
    modules/invoicepdf/myorder.php (Anpassung nur nötig wenn das Pdf-Modul installiert ist)
  2. Editieren Sie die modules/invoicepdf/myorder.php wie folgt:
    Suchen Sie nach der Zeile:

    $this->_oData->oxorder__oxpaymenttype->value );

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
    $billpayUtils = oxNew('billpayutil');
    $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
    if ($billpayUtils->isBillpayPayment($sPaymentType)) {
       if ($sPaymentType == $billpayUtils->getTCName()) {
         $billpayUtils->setAdditionalTotal($this, $this->_oPdf,
         $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
        } else {
         $billpayUtils->setInvoiceText($this, $this->_oPdf,
         $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
            }
            return;
      }
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach der Zeile:

    $text = $this->_oData->translate( 'ORDER_OVERVIEW_PDF_PAYUPTO'

    Fügen Sie bitte VOR dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
            $billpayUtils = oxNew('billpayutil');
            $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
            if ($billpayUtils->isBillpayPayment($sPaymentType)) {
                return;
            }
    /** EOF BILLPAY CHANGED **/

+
-
Schritt 2 (V4.3 – 4.4.8) – Anpassung der Oxid-Dateien

  1. Laden Sie die folgende Datei vom ftp-Server herunter und öffnen Sie diese:
    • modules/invoicepdf/myorder.php (Anpassung nur nötig wenn das Pdf-Modul installiert ist)
    • out/basic/tpl/payment.tpl
    • out/basic/tpl/order.tpl
  2. Editieren Sie die modules/invoicepdf/myorder.php wie folgt:
    Suchen Sie nach der Zeile:
  3. $this->_oData->oxorder__oxpaymenttype->value );

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
    $billpayUtils = oxNew('billpayutil');
    $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
    if ($billpayUtils->isBillpayPayment($sPaymentType)) {
      if ($sPaymentType == $billpayUtils->getTCName()) {
        $billpayUtils->setAdditionalTotal($this, $this->_oPdf,
        $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
       } else {
        $billpayUtils->setInvoiceText($this, $this->_oPdf,
        $this->_oData, $oPayment->oxpayments__oxdesc->value, $iStartPos);
           }
           return;
     }
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach der Zeile:

    $text = $this->_oData->translate( 'ORDER_OVERVIEW_PDF_PAYUPTO'

    Fügen Sie bitte VOR dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
            $billpayUtils = oxNew('billpayutil');
            $sPaymentType = $this->_oData->oxorder__oxpaymenttype->value;
            if ($billpayUtils->isBillpayPayment($sPaymentType)) {
                return;
            }
    /** EOF BILLPAY CHANGED **/

  4. Editieren Sie die out/basic/tpl/payment.tpl wie folgt:
    Suchen Sie nach der Zeile:
  5. [{ oxmultilang ident="PAYMENT_COMLETEALLFIELDS" }]

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
    [{ elseif $iPayError == $billpayUtils->getPaymentErrorCode() }]
      [{include file="billpay_payment_error.tpl"}] 
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach der Zeile:

    [{elseif $sPaymentID == "oxidcreditcard"}]

    Fügen Sie bitte VOR dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
    [{elseif $sPaymentID == $billpayUtils->getIName()}]
        [{if !$hide_billpay && !$hide_billpay_rec}]
          [{include file="billpay_payment_invoice.tpl"}]
        [{else}]
          [{assign var="inptcounter" value="`$inptcounter-1`"}]
        [{/if}]
    [{elseif $sPaymentID == $billpayUtils->getDDName()}]
        [{if !$hide_billpay && !$hide_billpay_elv}]
          [{include file="billpay_payment_direct_debit.tpl"}]
        [{else}]
          [{assign var="inptcounter" value="`$inptcounter-1`"}]
        [{/if}]
    [{elseif $sPaymentID == $billpayUtils->getTCName()}]
        [{if !$hide_billpay && !$hide_billpay_rtk}]
          [{include file="billpay_payment_transaction_credit.tpl"}]
        [{else}]
          [{assign var="inptcounter" value="`$inptcounter-1`"}]
        [{/if}]
    [{elseif $sPaymentID == $billpayUtils->getPayLaterName()}]
        [{if !$hide_billpay && !$hide_billpay_pl}]
          [{include file="billpay_payment_pay_later.tpl"}]
        [{else}]
          [{assign var="inptcounter" value="`$inptcounter-1`"}]
        [{/if}]
    /** EOF BILLPAY CHANGED **/

  6. Editieren Sie die out/basic/tpl/order.tpl wie folgt:
    Suchen Sie nach folgenden Zeilen:

    $currency->sign}]
                                    
                                    

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
     [{if $bputil->isBillpayPayment($sPaymentID)}]
        [{include file="billpay_order_confirmation.tpl"}]
    [{/if}]
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach folgender Zeile:

    [{ oxmultilang ident="ORDER_EMAIL" }]

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
     [{if $bputil->isBillpayPayment($sPaymentID) }]
        [{include file="billpay_order.tpl"}]
    [{else}]
    /** EOF BILLPAY CHANGED **/

    Suchen Sie nach folgender Zeile:

    [{ oxmultilang ident="ORDER_PHONE" }]

    Fügen Sie bitte NACH dieser Zeile folgendes ein:

    /** BEGIN BILLPAY CHANGED **/
     [{/if}]
    /** EOF BILLPAY CHANGED **/

+
-
Schritt 3 – Konfiguration der BillPay-Zugangsdaten und der BillPay-Zahlungsarten

Tragen Sie unter eShop Admin → BillPay → BillPay-Konfiguration die Zugangsdaten ein und stellen den Transaktionsmodus auf “Test”.

1

+
-
Schritt 4 – Bestellung im Shop anlegen

1. Gehen Sie bitte in Ihren Shop und legen Sie eine Testbestellung an. Die Testbestellung muss folgendes beinhalten:

  1. Nutzen Sie bei der Eingabe des Kundennamens bzw. der –adresse Umlaute (ä,ö,ü)
  2. 2 verschiedene Artikel in den Warenkorb
  3. Nutzen Sie einen Gutscheincode (Rabatt) bei der Bestellung. (Bitte bestätigen Sie uns schriftlich, falls keine Gutscheincodes genutzt werden)
  4. Wert der Artikel darf 1000€ nicht übersteigen
  5. Nutzen Sie Versandkosten für die Bestellung. (Bitte bestätigen Sie uns schriftlich, falls keine Versandkosten angeboten werden)

Wichtig:
Das Wort „Test“ darf weder als Kundennamen noch in der Kundenadresse genutzt werden
Es sind nur 3 offene Bestellungen erlaubt. Für die 4. Bestellung muss ein anderer Name genutzt oder zuvor eine „alte“ Bestellung storniert werden.

+
-
Schritt 5 – Aktivierung der Bestellung im Admin-Bereich des Shops

Rufen Sie unter eShop Admin → Bestellungen verwalten → Bestellungen die Bestellung auf und klicken Sie im Reiter „BillPay“ auf den „Zahlungsziel aktivieren“-Button.

+
-
Schritt 6 – Bestellbestätigung und Rechnung senden

1. Senden Sie die Bestellbestätigung bitte an abnahme@billpay.de

  1. Es dürfen keine Shop eigenen Kontodaten enthalten sein
  2. Prüfen Sie ob die BillPay Zahlungsinformationen enthalten sind

2. Wenn Sie die Oxid-Standardrechnung verwenden, senden Sie diese ebenfalls an abnahme@billpay.de

  1. Zahlart (Kauf auf Rechnung): Es müssen die dynamischen Kontodaten von BillPay enthalten sein.
  2. Zahlart (Lastschrift bzw. PayLater): Es müssen die Standardtexte von BillPay enthalten sein.
  3. Es dürfen keine Shop eigenen Kontodaten enthalten sein.

3. Wenn Sie externe Rechnung verwenden, senden Sie diese ebenfalls an abnahme@billpay.de

  1. Zahlart (Kauf auf Rechnung): Es müssen die dynamischen Kontodaten von BillPay enthalten sein. (https://www.billpay.de/de/geschaeftskunden/zahlungsinformationen/).
  2. Zahlart (Lastschrift bzw. PayLater): Es müssen die Standardtexte von BillPay enthalten sein.
  3. Es dürfen keine Shop eigenen Kontodaten enthalten sein.

+
-
Schritt 7 – Gutschrift erstellen

  1. Unter eShop Admin → Bestellungen verwalten → Bestellungen im Reiter „Artikel“ eine Artikelposition wie gewohnt stornieren oder die Artikelmenge verringern.
  2. Unter eShop Admin → Bestellungen verwalten → Bestellungen kann mit dem „Pause“-Button die gesamte Bestellung storniert werden.

+
-
Schritt 8 – Abnahmetest wiederholen

Wiederholen Sie den Abnahmetest (ab Punkt 4) für alle vertraglich festgelegten BillPay-Zahlarten in allen vereinbarten Ländern.

+
-
Schritt 9 – Anpassung der AGB und Datenschutzbestimmung

Von BillPay wurden Ihnen AGB Textbausteine zur Verfügung gestellt. Bitte füge Sie diese in Ihre Shop AGB und Shop Datenschutzbestimmung ein.
Wichtig: Erstellen Sie die Links innerhalb der Texte und ändern Sie: „20 oder 30 Kalendertage“, entweder in „20 Kalendertage“ oder „30 Kalendertage“. Je nachdem wie lang das Zahlungsziel sein soll.

+
-
Schritt 10 – Einfügen eines BillPay Logos

Bitte fügen Sie ein BillPay-Logo bei den Zahlarten-Logos ein. Hier finden Sie die BillPay Logos:

https://www.billpay.de/de/shopintegration/downloads/
Beispielbild1
Beispielbild 2