Merchant Login

Magento 2

Integration manual
Direct Bank Transfer

1. Introduction to Direct Bank Transfer.

Customers (end customers) do not have to register for Direct Bank Transfer: They make a fast and easy payment using their online banking details. Thanks to real time acknowledgment of the transfer order, you as a merchant can immediately ship the goods or provide services. Furthermore, you can optionally offer buyer protection, providing additional security for your customers.

From your customer's perspective, a Direct Bank Transfer transaction consists of the following steps:

As soon as payment by Direct Bank Transfer is requested, the customer is redirected to a Direct Bank Transfer page.

Below the overview of the transfer data (recipient, reason, amount), your customer is requested to enter the sort code.

Subsequently, your customer is asked to log on by entering the online banking details.

After successful logon, the customer has to confirm and release the transfer by entering a valid confirmation code.

If a valid confirmation code has been entered, the transfer is authorized and your customer will receive a summary of the executed transaction.

Finally, the customer is redirected to your online shop with one click.

2. Integration steps

The following steps are required to integrate  in :

  1. Register as a merchant on our website https://www.sofort.com/register
  2. Create a new Direct Bank Transfer project and configure it
  3. Install the Direct Bank Transfer module in the shop
  4. Set up the Direct Bank Transfer module in the administration backend of your shop

3. Direct Bank Transfer project setup

3.1. Registration at Sofort GmbH

In order to be able to offer Direct Bank Transfer in your shop, a customer account with Direct Bank Transfer is required.

If you do not have such an account you may register at https://www.sofort.com/register.

After your registration, you have to be logged on in the merchant area and have to create a project for your system / online shop. If you do not use  Direct Bank Transfer, you have to activate the desired product. Go to "My account > Product activation" in the left navigation bar.

3.2. Create new Direct Bank Transfer project

To set up a project, click "New project" in the left column and create a Direct Bank Transfer Gateway project. If you already us another payment method offered from Sofort GmbH in your shop, you may activate  in the project that already exists.

Attention: Please create a "Direct Bank Transfer Gateway" project

Functions such as automatic refunds and buyer protection are only available if you provide a Deutsche Handelsbank account. You will have the possibility to apply for a Deutsche Handelsbank account during project setup.

Complete your project data now. The most important settings are:

General settings

  • Project name: Enter the name of your shop here.
  • Shop system: Select your shop system.
  • Industry: Select your industry.
  • Website: Enter the URL of your online shop.

Address

The address entered here will be displayed to your customer on our payment wizard.

Bank account information

Enter your bank information here for the receipt of payments. Please keep in mind that international transactions in other currencies require a corresponding currency account. After you have created the project, you may store additional bank information for foreign currencies (e.g. a Złoty currency account for transactions from Poland) in the "Extended settings".

Settings for all payment methods

Select your merchant profile first:

  • Merchant/Shop provider: Select this profile if you offer goods for sale.
  • Content provider: Select this profile if you offer digital goods (downloads, credits, etc.) or services for sale.

Automatic redirection: Please activate this option

Please do not change the other settings as they are determined by the module.

Buyer protection

If you have a Deutsche Handelsbank account, you may activate buyer protection. Your account must be activated for this feature; please check with Deutsche Handelsbank for this purpose. More information on Deutsche Handelsbank and buyer protection can be found at https://www.handelsbank.com/

Payment methods

Activate  here by enabling the checkbox.

  • Test mode: By activating this option, you can test . More information can be found in the "Testing" chapter. Test transactions and real transactions are possible in parallel. However, we recommend to deactivate the test mode for productive operation.
  • Block sender country: Leave this option disabled.

Configuration key

After you have created the project, you can view the configuration key in your project. Please store this key with your module.

Project logo

After you have created the project, you can upload a logo of your shop or company in the "Extended settings". This logo will be displayed on our payment wizard instead of the registered address.

4. Interface installation

It is recommended to make a backup copy of your shop and database before you make any changes in your shop.

4.1. Module installation

To provide the module for your Magento Shop, you have to add it to your Magento Account using the Magento Marketplace and download it or you have to download it in our Integration center.

Extension installation

  • Connect to your Magento 2 webserver using ssh
  • In the root directory run the command "mkdir -p app/code/Sofort/Payment"
  • Copy the ZIP file of the module into this directory: app/code/Sofort/Payment
  • Unzip "sofort.zip" in the directory above
  • Start the setup process on Magento 2 root directory by using the command "php bin/magento setup:upgrade"
  • Refresh your shop system and clean the cache as recommended from Magento.

5. Module configuration

  1. Go to Stores → Configuration in your shop backend.
  2. Select "Sales" -> „Payment methods“ in the left menu.
  3. Select the in the module „Direct Bank Transfer“ "Configure"
  4. Activate Direct Bank Transfer by selecting "Yes" from the drop-down menu "Activate Direct Bank Transfer in your shop"
Magento_2_Konfiguration_1_EN

The following settings can be made:

Settings:

  • Configuration key: Enter the configuration key of your Direct Bank Transfer Gateway-Project here. The settings of your project can be viewed in the merchant menu of Sofort GmbH. You have to enter the configuration key in order to use this plug in.
  • Activate Direct Bank Transfer in your shop: Select if you want to make Direct Bank Transfer available in your shop.

Extended Settings:

Recommended payment method: Choose the presentation of Direct Bank Transfer in the checkout as a recommended payment method. You can select Yes or No in the drop down.

Position in checkout: Select the position of the payment method in the checkout.

Reference and Reference 2: Define the reason which shall be used for the bank transfer.You can use the listed replacement parameters in order to fill this field dynamically with the desired parameters. The values will be filled by Direct Bank Transfer.

Accepted currency: Enter the accepted currency for the bank transfers.

Payment Applicable From:  Selected the allowed countries to use the payment method in the checkout.

Countries Payment Applicable From:  Select the countries, if the above setting is selected the option "Specific countries".

Enable logging:  Select the option in the dropdown for Yes or No, to enable logging.

Magento_2_Konfiguration_2_EN

Status settings

Attention: Please adjust these settings only if you are familiar with status handling of Magento, as this may have unpredictable effects on your shop and other modules might no longer work properly.

  • Temporary order status: Define the status for orders which have not been paid yet.
  • Confirmed order status: Define the status for orders which have been successfully completed by Direct Bank Transfer.
  • Order status for losses: Define the status of orders for which no payment or a different amount has been received on your Deutsche Handelsbank account. (A Deutsche Handelsbank account is required.)
  • Order status for payment received: Define the status of orders for which payment has been received on your Deutsche Handelsbank account. (A Deutsche Handelsbank account is required.)
  • Select the time of invoicing: Define when the invoice is generated.
  • Create credit memo automatically: A credit memo will be created automatically if a transaction was fully refunded by using the merchant menu of Sofort GmbH.
  • Send order confirmation: Define whether the order confirmation is sent to the end customer by selecting the Yes or No drop-down option.
  • Send receipt emails: Define if emails shall be sent out to the customer if the invoice or credit memo are generated
Magento_2_Order_Status_EN

6. Testing

In order to check the correct integration in your shopsystem please perform a test transaction by placing an order directly in your shop. The single steps are:

  1. Activate the test mode in the desired project in the merchant area.
  2. Place an order in your shop / system and choose as the payment method.
  3. In order to simulate German sender bank accounts use "88888888" (8x "8") on our payment form, for Belgium choose "Others" and "999" (3x "9") and for all other countries "00000" (5x "0") or select "Demo Bank". The following requested data can be chosen randomly with at least 4 digits. (Instead of the test bank code a country specific test BIC will shortly be available: "SFRT{ISO-country code}20XXX", e.g. "SFRTDE20XXX" for Germany)
  4. Please check if the redirect works properly:
    1. Redirect after successful payment to success page?
    2. Are all notifications sent properly?
    3. Order in your shopsystem is created correctly and status is updated accordingly?

Note: After successfully testing Direct Bank Transfer please deactivate the test mode in the project settings in the merchant area to prevent customers to simulate payments with the test data.

7. Support & Contact

The support team team will be available if you need help.

You may send us an email at service@sofort.com.

We are also glad to assist you in case of technical issues:

Technical support:
Phone: +49 (0)89 24 88 37 691
Email: integration@sofort.com

Business hours:
Monday to Thursday: 8:30 a.m. to 6:00 p.m.
Friday: 8:30 a.m. to 5:00 p.m.

8. Legal Notice

Sofort GmbH
Theresienhöhe 12
80339 Munich
Germany

Support for customers
Phone: +49 (0)89 24 88 37 690

Support for merchants
Phone: +49 (0)89 24 88 37 692

info@sofort.com
www.sofort.com

Directors

Felix Würtenberger
Wilhelmus Geerling Klaassen

External Data Protection Officer
Mr. Michael Schramm, LL.M. 
For privacy questions please contact us at: datenschutz@sofort.com

Registered at the District Court Munich
HRB 218675
VAT-ID: DE248376956

© Sofort GmbH. All rights reserved, including the translation.

The documentation including all published content is protected by copyright. Reprints or reproduction of any kind and processing, duplication, and distribution using electronic systems of any kind shall only be permitted with prior written consent of Sofort GmbH.

The contents of this documentation and the implementation of the information contained therein may only be used at your own risk. Sofort GmbH assumes no responsibility for the function of individual programs or of parts of them. In particular, Sofort GmbH assumes no responsibility for possible damages resulting from the use.