Supported Payment Methods
 Installment Payment
 Direct Debit
 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. Clear the Magento cache: (System → Cache Management → Flush Magento Cache & Flush Cache Storage)
  3. If you are logged into the Magento Admin Component, log out and log back in.
  4. If you are using a customized template, please copy the contents from the app/design/ folder from the BillPay Plug-In archive into the relative folder of the template.

Step 2 – Configuring the BillPay Settings

  1. Under System → Configuration → BillPay Einstellungen enter the merchant account credentials:

  2. Activate the desired payment methods in the Admin component of the shop.

Step 3 – 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.

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.ssary to include these.)

Step 4 – Activating an Order in the Admin Component of the Shop

  1. When you generate the “Invoice” for the test order in the shop´s Admin component, the order is automatically activated at BillPay and the payment due date is set.

  2. If you do not use the shop´s Admin component, you can also set the payment due date in BillPay’s Backoffice Suite. You will receive login details for our Backoffice Suite upon the successful completion of the Compliance Test.

Step 5 – 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 Magento 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. (/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 6 – Creation of Refunds/Credit Memos

Create a partial refund for one of the items from the order and then a complete refund for the entire order. BillPay supports the shop’s internal functions/processes in relation to partial and complete refunds.

Step 7 – Repeating Test Orders for the Compliance Test

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

Step 8 – Completion of the Compliance Test

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 9 – 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: /de/shopintegration/downloads/
Beispielbild 2

Conflicts with Other Plug-ins

If the diagnosis script displays any conflicts, the effected classes need to be manually combined. The code of the BillPay Class identified as the “Rewrite Name” must be merged into the class identified as the “Active Class”. Zeigt das Diagnoseskript einen oder mehrere Konflikte an, müssen die entsprechenden Klassen manuell zusammengeführt werden. Zu diesem Zweck muss der Code der BillPay-Klasse, die unter Rewrite Name angezeigt wird, in die Klassen eingefügt werden, die unter Active Class angezeigt werden.

If the active class already overrides the save payment method, the lines 7-11 must be inserted at the end of this method.
If it does not exist, the rows 4-14 must be copied into the active class.
This procedure should be repeated for all other methods of conflicting BillPay Classes.

class Billpay_Model_Checkout_Type_Onepage extends Mage_Checkout_Model_Type_Onepage

    public function savePayment($data) {
            $result = parent::savePayment($data);

            Mage::dispatchEvent('billpay_after_save_payment', array(

            return result;

Please note: After resolving of the conflict, the diagnostic script may still show a conflict as the active class is still not the class of the BillPay Plug-in. This error can be ignored.

Boxen der Zahlarten klappen nicht auf

Bitte den Inhalt aus dem Ordner app/design in den entsprechenden Ordner des benutzten Themes kopieren.

Trouble Shooting in the Case of Errors

If the payment methods are not displayed in your shop or some other unforeseen error is occurring, you can enable logging in the Admin component of your Magento shop. Under System → Configuration → Developer → Log Settings set the Enabled dropdown to “Yes“. Moving forward, all shop events will be recorded/logged in the /var/log folder of your shop (you will find a BillPay-specific file named “billpay.log”). This billpay.log file can be sent to the BillPay Support Team as necessary.