logo
 

gambio software

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

  1. Copy the contents of the plug-in zip archive into your shop’s 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 Gambio Files (from V2.1)

  1. Download and open the following files from your shops ftp-server:
    • admin/orders.php
    • admin/gm/classes/gmOrderPDF.php
    • system/classes/orders/SendOrderProcess.inc.php
  2. Edit the admin/orders.php file as follows:
    Find the following line:

    if(xtc_db_input($status) == gm_get_conf('GM_ORDER_STATUS_CANCEL_ID')) {
        $gm_update = "gm_cancel_date = now(),";
    }

    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 **/

    Find the following line:

    case 'deleteconfirm':

    Paste the following AFTER the code above:

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

    if(!empty($this->order_info))
    {

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/
    require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_gm_pdf.php');
    /** EOF BILLPAY CHANGED **/
    {

    Find the following line:

    $this->getWithdrawal();
    }
    {

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/
    require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_gm_pdf.php');
    /** EOF BILLPAY CHANGED **/
  4. Edit the system/classes/orders/SendOrderProcess.inc.php file as follows:
    Find the following line:

    $t_payment_info_text = '';

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/
    require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_mail_gambio21.php');
    /** EOF BILLPAY CHANGED **/
+
-
Step 2 – Modification of Gambio Files (GX1 – GX2)

  1. Download and open the following files from your shops ftp-server:
    • send_order.php
    • admin/orders.php
    • admin/gm/classes/gmOrderPDF.php
  2. Edit thesend_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:

    gm_get_conf('GM_ORDER_STATUS_CANCEL_ID')) || $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/gm/classes/gmOrderPDF.php file as follows:

    Find the following line:

    function getBody() {

    Paste the following AFTER the code above:

    /** BEGIN BILLPAY CHANGED **/
    
    require_once (DIR_FS_CATALOG . DIR_WS_INCLUDES . 'billpay/utils/billpay_gm_pdf.php');
    
    /** EOF BILLPAY CHANGED **/

+
-
Step 2 – Modification of Gambio Files (from GX3)

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

    • admin/orders.php
    • admin/includes/gm/classes/gmOrderPDF.php
    • system/classes/orders/SendOrderProcess.inc.php
    • templates/Honeygrid/module/checkout_payment_block.html
    1. Edit the admin/orders.php as follows
    2. Find the following line:

       if($gm_status == gm_get_conf('GM_ORDER_STATUS_CANCEL_ID')) {	
      $gm_update = "gm_cancel_date = now(),";
}


      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 **/ 

      Please look for the following code:

      case 'deleteconfirm':

      Paste the following AFTER the code above:

      /** BEGIN BILLPAY CHANGED **/
      require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_order_delete.php');
      /** EOF BILLPAY CHANGED **/

    3. Edit the admin/includes/gm/classes/gmOrderPDF.php file as follows:
    4. Find the following line:

      if(!empty($this->order_info))
      {
      

      Paste the following BEFORE the code above:

      /** BEGIN BILLPAY CHANGED **/
      require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_gm_pdf.php');
      /** EOF BILLPAY CHANGED **/

      Find the following line:

      $this->getWithdrawal();
      }

      Paste the following AFTER the code above:

      /** BEGIN BILLPAY CHANGED **/
      require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_gm_pdf.php');
      /** EOF BILLPAY CHANGED **/

    5. Edit the system/classes/orders/SendOrderProcess.inc.php file as follows:
    6. Find the following line:

      $t_payment_info_text =; ''

      Paste the following AFTER the code above:

      /** BEGIN BILLPAY CHANGED **/
      require_once(DIR_FS_CATALOG . 'includes/billpay/utils/billpay_mail_gambio21.php');
      /** EOF BILLPAY CHANGED **/
      

    7. Edit the templates/Honeygrid/module/checkout_payment_block.html file as follows:
    8. Find the following line:

      <li class="list-group-item {$module_data.id}">
      

      Replace the above code with the following:

      <!-- BEGIN BILLPAY CHANGED -->
      {if $module_data.id == 'billpay' || $module_data.id == 'billpaydebit' || $module_data.id ==
       'billpaytransactioncredit' || $module_data.id == 'billpaypaylater'}
       <li style="background: white; border: 
      1px solid #eee;" class="list-group-item
       {$module_data.id}{if $module_data.id === 'paypal3' && $module_data.module === ''}-
      plus{/if}" {if $module_data.id === 'paypal3' && $module_data.module === ''}data-gambio-
      widget="paypal_checkout" data-paypal_checkout-third-party-payments
      -block="{get_paypal_third_party_payments_block|escape}"{/if}>
      {else}
      <li class="list-group-item {$module_data.id}">
      {/if}
      <!-- EOF BILLPAY CHANGED -->
      

      Please look for the following code:

      <strong>{$module_data.module}</strong>
      

      Replace the above code with the following:

      <!-- BEGIN BILLPAY CHANGED -->
      {if $module_data.id == 'billpay' || $module_data.id ==
       'billpaydebit' || $module_data.id == 'billpaytransactioncredit' || 
      $module_data.id == 'billpaypaylater'}
      <span style="color: black"><strong>{$module_data.module}
       </strong></span>
      {else}
       <strong>{$module_data.module}</strong>
      {/if}
      <!-- EOF BILLPAY CHANGED -->

      Please look for the following code:

      <div class="col-xs-6 {if $module_data.id !
      = 'paypal3' && $module_data.module != ''}col-md-
      {if $module_data.fields != '' && $module_data.fields|@count > 0}7{else}3{/if}{/if} 
      price text-right">
      <p>{$module_data.module_cost}</p>
      </div>
      </div>

      Paste the following AFTER the code above:

      <!-- BEGIN BILLPAY CHANGED -->
      {if $module_data.id == 'billpay' || $module_data.id ==
       'billpaydebit' || $module_data.id == 'billpaytransactioncredit' || $module_data.id ==
       'billpaypaylater'}
      <div style="background-color: #dbdbdb; color: black">
      {$module_data.fields.0.field}
      </div>
      {/if}
      <!-- EOF BILLPAY CHANGED -->

    9. Please clear your template cache.
+
-
Step 3 – Configuring the BillPay Settings

  1. In the admin component of your shop under: Module → Zahlungsweisen → Neu hinzugefügte Module →BillPay Please select here the payment methods, which were contractually agreed.
  2. Click on „Installieren“
  3. Enter your merchant account credentials and select “Testmodus”.
  4. Configure the allowed countries. Enter here the countries that have been contractually agreed upon.
  5. Click „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

  1. In the admin component of your shop under Bestellungen à Bestellungen. Click on „Anzeigen“.
  2. In Bestelldetails click in the Bestellstatushistorie on „Bestellstatus ändern“
  3. 5

  4. To activate an order (start the debt management process and set the payment due date), change the order status „BillPay aktivieren“.
  5. 8

  6. If the activation was successful, a BillPay comment will be visible in the comment field of the order history history. In the case of a BillPay invoice order, the BillPay bank account data for the order is displayed in the comment field.
  7. 7

+
-
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 Gambio 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

  1. At the moment, the BillPay plugin only supports full cancellations. If you want to perform partial cancellations, you must edit the order via the BillPay Backoffice.
  2. Set the status of the order in the order details to „BillPay storniert“.
  3. If the cancellation was successful, you will see a BillPay comment in the comment field of the order history history.
  4. 9

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

Please repeat the compliance test (starting at Step 4) 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

+
-
„Privatkunde“ not able to be selected

  1. This problem can come about in Gambio GX2 because a Javascript in the checkout overwrites the radio buttons.
  2. In the file: gm/javascript/gm_start.js.php replace the following line:
     ?>
         var coo_button_checkout_module_handler = new ButtonCheckoutModuleHandler();
         
    

    with:

     //BEGIN BILLPAY CHANGE
         if(MODULE_PAYMENT_BILLPAY_B2BCONFIG == 'BOTH')
         {
          // nothing to do here
         }else {
         ?>
         var coo_button_checkout_module_handler = new ButtonCheckoutModuleHandler();
         
    

+
-
Payment methods are clumped together

Edit the /templates/EyeCandy/module/checkout_payment_block.html file as follows:

In this line

{if $method_data.title && $method_data.title != ' '}
{$method_data.title}
{/if}

comment the following out:

{if $method_data.title && $method_data.title != ' '}{$method_data.title}{/if}

+
-
When I click „Kaufen“ the shop sends me back to the payment method selection

Edit the includes/classes/payment.php file as follows:
Replace this code

if((xtc_count_payment_modules()==1)&& (!is_object($_SESSION['payment'])){
if((xtc_count_payment_modules()==1)&& (!is_object($_SESSION['payment']))&& strpos($_SESSION['payment'], 'billpay')===false) {

+
-
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.