logo
 

MODIFIED - ECOMMERCE SHOPSOFTWARE

Supported Payment Methods
 Invoice
 Installment Payment
 Direct Debit
Features
 Due Date Activation
 Full cancellation
 Partial cancellation
+
-
Step 1 – Plug-In Installation

  1. Copy the contents of the plug-in zip archive to your shop’s root folder.
  2. Confirm any messages relating to the over-writing of existing files with a “yes”.
  3. If you are logged into your shop’s admin component, log out and log back in.

+
-
Step 2 – Modification of modified Files

  1. Download and open the following files from your shops ftp-server:

    • send_order.php (in the site’s root folder);
    • admin/orders.php;
    • admin/print_order.php;
    • admin/orders_edit.php
  2. Edit the send_order.php file as follows:
    Find the following line:

    $smarty->assign('PHONE',$order->customer['telephone']);
    

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/
    
    require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_mail.php');
    
    /** EOF BILLPAY CHANGED **/
    
  3. Edit the admin/orders.php file as follows:
    Find the following line:

    if ($check_status['orders_status'] != $status || $comments != '') {
    

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/	
    
    require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_status_requests.php');
    
    /** EOF BILLPAY CHANGED **/
    
  4. Edit the admin/orders_edit.php file as follows:
    Find the following line:

    require_once (DIR_FS_INC.'xtc_oe_customer_infos.inc.php');
    // Benötigte Funktionen und Klassen Ende
    

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/	
    
    require_once(DIR_FS_CATALOG . 'includes/billpay/base/BillpayOrderEdit.php');
    $billpayOrderEdit = new BillpayOrderEdit();
    $billpayOrderEdit->onBeforeUpdate();
    
    /** EOF BILLPAY CHANGED **/
    

    Find the following line:

    xtc_db_query("delete from ".TABLE_ORDERS_RECALCULATE." where orders_id = '".xtc_db_input($_POST['oID'])."'");
    // Löschen des Zwischenspeichers Ende
    

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/	
    
    $billpayOrderEdit->onAfterUpdate();
    
    /** EOF BILLPAY CHANGED **/
    

+
-
Step 3 – Configuring the BillPay Settings

  1. In the admin component of your shop under: Module → Zahlungsoptionen → Rechnung (BillPay) or Lastschrift (BillPay) click “Installieren”
  2. 2

  3. Enter your merchant account credentials and select “Testmodus”
  4. 3

  5. Configure the allowed countries. Enter here the countries that have been contractually agreed upon.
    4

  6. Click on „Aktualisieren“

+
-
Step 4 – Place an Order in the Shop

1. Please go to your shop and create a test order. The test order must include the following:

  1. Diacritic characters (i.e. Umlauts: ä, ö, ü) in the customer name, address and an article when possible.
  2. Place two different articles in the basket.
  3. Please make sure the combined value of the articles does not exceed 1000 €.
  4. Apply a coupon code (discount) when ordering. Please confirm in writing if no coupon codes are used in your shop.
  5. For the test order, please use a shipping method that carries costs. Should you only offer free shipping, please confirm that in writing.

Important:
If the word “test” is used as the first or last name of the customer, the request will be rejected.
Every customer is allowed a maximum of 3 open orders. To place further orders, either a different name has to be used for the 4th order or one of the open orders needs to be canceled.

+
-
Step 5 – Activating an Order in the Admin Component of the Shop

Open the order details in the admin component of your shop and set the status of the order to „BillPay aktiviert“. In the comment field, you should now see the BillPay bank account details (when invoice is the payment method).

+
-
Step 6 – Send the Order Confirmation and Invoice

1. Please send a copy of the order confirmation to abnahme@billpay.de

  1. The shop bank account details must be removed from the order confirmation email templates.
  2. Check if the BillPay payment payment derails are included.

2. If you use the Modified standard invoice, please send a copy to abnahme@billpay.de

  1. Payment type (invoice): The dynamic bank account data of BillPay must be included.
  2. Payment method (direct debit or PayLater): The standard texts of BillPay must be included.
  3. The shop bank account details must be removed from the invoice templates.

3. If you are generating your invoices outside of the shop system, please send a copy to abnahme@billpay.de

  1. Payment type (invoice): The dynamic account data of BillPay must be included. (https://www.billpay.de/de/geschaeftskunden/zahlungsinformationen/).
  2. Payment method (direct debit or PayLater): The standard texts of BillPay must be included.
  3. The shop bank account details must be removed from the invoice templates.

+
-
Step 7 – Creation of Refunds/Cancellations/Credit Memos

Set the status of the order in the order details to „BillPay storniert“

 

 

+
-
Step 8 – Repeating Test Orders for the Compliance Test

Please repeat the compliance test (starting at Step 5) for all contractually agreed upon BillPay payment methods und countries.

+
-
Step 9 – Adjustment of terms and conditions

Merchants are required to include BillPay related text passages in the terms and conditions and privacy pages of their website. These passages were provided to you by BillPay.
Important: The pdf file/s you received contain references to linking text. Please create these links, and should you be offering invoice as a payment method, adjust the passage “20 or 30 calendar days” to reflect your payment due date – either in “20 calendar days” or “30 calendar days”.

+
-
Step 10 – BillPay branding

Should you display payment method logos in the footer of your website or in the payment method selection portion of your checkout, it is necessary for you to also include the relevant BillPay logos. These can be found and downloaded in either png or svg format via the following url: https://www.billpay.de/de/shopintegration/downloads/
Beispielbild1
Beispielbild 2

+
-
Order status „BillPay aktiviert“ is selected, but the payment due date is not set at BillPay.

  1. Please use the „Zahlungsziel aktivieren“ button and not the combo box for the status change. The combo box does not send an activation request to the BillPay API.
  2. Please check to make sure the admin/orders.php was correctly modified (Step 2.2).
  3. Save a copy of your BillPay credentials und un-install the BillPay payment methods. Using phpmyadmin, you will need to make some edits to your database. In the shop database, click on the search button in the main navigation bar. In the “Word(s) or value(s) to search for (wildcard: “%”):” field, enter %billpay%. Select all the tables and click “Go”.
  4. Click the “browse” button in the results display and delete all the entries with the following content:
    • „MODULE_PAYMENT_BILLPAY_STATUS_ACTIVATED“
    • „MODULE_PAYMENT_BILLPAY_STATUS_CANCELLED”
    • “MODULE_PAYMENT_BILLPAY_STATUS_ERROR”
  5. Browse the table „order_status“ and delete all the entries that contain BillPay.
  6. Un-install and then re-install the BillPay payment methods.
+
-
The plug-in is installed, but the BillPay payment methods aren’t visible in my shop.

Please check the log file in „includes/billpay/log/billpay.log“.
If the file is not there, please create it and make sure it has write permissions.
The most common causes for the inability to display the BillPay payment methods are:

  1. Error in the account details – please double check your account credentials and that they are correctly entered. Please copy and paste the Security-Key. When you copy the Security-Key, please make sure that you do not copy any blank spaces.
  2. Please make sure that the Curl-Library is installed and activated on your webserver. If it is not, please contact your webhost or service provider.
  3. The payment method has a sort order that is already in use by another plug-in. Please give the plug-in a different sort order.

+
-
When I activate an order, I receive the error message: Der Betrag hat sich gegenüber der Vorauthorisierung geändert.

Have you activated the “Zahlartgebühr”? Please check that this is displayed and in the correct position (after all the summary modules, but before the final total). Please check if you have another summary module that has the same sort order as the fee module. Be especially careful that the shipping costs are sorted before payment method fees.