How to configure your Sofort and Ingenico epayments account
Table of contents 1. Getting started 1.1 What to configure 1.2 How to configure 1.2.1 Automatic configuration 1.2.2 Manual configuration 1.3 Test project/account 2. Ingenico epayments account configuration 2.1 Configuration with automatic registration and/or project creation at Sofort Banking 2.2 Configuration after project creation at Sofort Banking 3. Sofort Project Configuration 3.1 Create a project 3.2 Basic settings 3.2.1 General settings 3.2.2 Interface 3.2.3 Other 3.3 Extended settings 3.3.1 Shop System Interface 3.3.2 Nonchangeable parameters 3.3.3 Notifications 3.3.4 Project password and input check Page 1 of 7-09/09/2017
1. Getting started 1.1 What to configure At Sofort Banking, a configuration is known as a Project. Before you can use Sofort Banking, you will need to do the following: 1. 2. You must be registered and have a user ID and project on the Sofort website. The process for creating a project is described here. You must complete the Sofort Banking project details on the Sofort payment method configuration page in your Ingenico epayments back office. The configuration in your Ingenico epayments account is described here. 1.2 How to configure You can configure the necessary steps either automatically or manually. 1.2.1 Automatic configuration The configuration process is initiated in your Ingenico epayments back office on the Sofort payment method configuration page. A Sofort Banking userid and projectid can be obtained automatically by clicking a button on the payment method configuration page in your Ingenico epayments back office. This way, most of the project details will be pre-configured by Ingenico epayments in the Sofort Banking website. If you would like to create a configuration automatically, please see here. 1.2.2 Manual configuration The configuration process is initiated on the Sofort Banking website. You must first create your user and project manually on the Sofort Banking website and, after that, enter the necessary payment method configuration details in your Ingenico epayments account. 1.3 Test project/account We have developed a Sofort Banking transaction simulator in the Ingenico epayments test environment. To perform Sofort Banking test transactions you can simply enable the Sofort Banking payment method in your Ingenico epayments test account. You do not need to configure anything on the Sofort Banking website. Page 2 of 7-09/09/2017
2. Ingenico epayments account configuration The Sofort Banking payment method can be configured via the Payment methods link in the back office. 2.1 Configuration with automatic registration and/or project creation at Sofort Banking If you have not yet created a project on the Sofort Banking website, you can create one automatically by clicking the Obtain UserID and ProjectID for this Payment Method button. You will then be redirected to the Sofort Banking website. Ingenico epayments provides most of the configuration information directly to Sofort Banking. If you already have a Sofort Banking account, click the option I have registered already for sofort.com and a project will be created in your existing account. If you have not yet registered for Sofort Banking, click the option I am not a customer yet. The system will then create a new account and a new project for you. When you click the Obtain UserID and ProjectID for this Payment Method button in your Ingenico epayments TEST account, a TEST project will be created at Sofort Banking. When you click the Obtain UserID and ProjectID for this Payment Method button in your Ingenico epayments PROD account, a PROD project will be created at Sofort Banking. Once the project has been created and configured, you need to enter the project details (User_ID, Project_ID and Project password) in the Sofort Banking payment method configuration page. 2.2 Configuration after project creation at Sofort Banking You must now enter the project details (User_ID, Project_ID and Project password) of the project you created on the Sofort Banking website. The User_ID and the Project_ID can be found in the project overview in your Sofort Banking account. In the example below the User_ID is 11111 and the Project_ID is 44444. You can find the Project password in the "Extended Settings" tab for your project > "Project Password and Input check". Page 3 of 7-09/09/2017
Click (Activation) Yes and Submit in the Sofort Banking payment method configuration page in your Ingenico epayments account. Page 4 of 7-09/09/2017
3. Sofort Project Configuration To enter the Sofort Banking back office, go to https://www.sofort.com, click on Merchant and then "Login"complete your login details. 3.1 Create a project Click on My Projects in the Projects menu. Click on the Add new project link in the Project overview page. On the Choose your project type page, select "Create a SOFORT Classic project". 3.2 Basic settings Remark: The notification password must not be set! If the notification password (Benachrichtigungskennwort) is set, it can be cleared on request by Sofort. 3.2.1 General settings Enter a project name and select your payment solution provider (Ingenico epayments) in the Shop system drop down menu. Important The Testing Mode checkbox should only be enabled if you wish to create a test project containing Ingenico epayments test URLs for use in your Ingenico epayments test account. If you are configuring a production project containing Ingenico epayments production URLs for your Ingenico epayments production account, please leave the Testing mode checkbox disabled! Do not mix test and prod projects, URLs and configurations as that would lead either to authentic transactions being generated in the test environment or authentic transactions being lost in prod. To avoid any errors, if you would like to carry out a test configuration, you need to create a separate project, i.e. you need to configure two projects at Sofort.com: a test project and a prod project. 3.2.2 Interface In the Interface section, you need to configure the following URLs: Success link: https://secure.ogone.com/ncol/prod/order_anetb_flowhandler_utf8.asp?op=success&txid=-transaction-&payid=-user_variable_0-& Abort link: https://secure.ogone.com/ncol/prod/order_anetb_flowhandler_utf8.asp?op=cancel&payid=-user_variable_0-& PM=-USER_VARIABLE_1-&HASHPSP=-USER_VARIABLE_2-&SIGN=-USER_VARIABLE_3_HASH_PASS- PM=-USER_VARIABLE_1-&HASHPSP=-USER_VARIABLE_2-&SIGN=-USER_VARIABLE_4_HASH_PASS- Enable the Automatic redirection checkbox. The Show feedback page checkbox is optional. 3.2.3 Other Enter your details in the Address, Common settings for Sofort.com and Bank account sections. Click on Save when you have finished your Basic settings configuration. Page 5 of 7-09/09/2017
3.3 Extended settings You need to configure some extended settings for your project via the Extended Settings tab. 3.3.1 Shop System Interface On the Shop system interface page, you will see the Success and Abort links that you entered earlier in the Interface section of the Basic Settings tab, and an additional section, called Timeout. Configure the value 900 for the Timeout in seconds. Configure the following URL for the Timeout link: https://secure.ogone.com/ncol/prod/order_anetb_flowhandler_utf8.asp?op=cancel&payid=-user_variable_0-& PM=-USER_VARIABLE_1-&HASHPSP=-USER_VARIABLE_2- Enable the Skip first steps checkbox in the Skip steps section. Click on Save when you have finished your Shop System Interface configuration. 3.3.2 Nonchangeable parameters Configure the nonchangeable parameters as follows and click "Save": 3.3.3 Notifications In the Notifications page there are two types of notifications: email and HTTP. You can add new/additional notifications by clicking the "Add new notification" link. Email Enter your e-mail address in the "E-mail" field, select your language, enable the "activated" checkbox and click "Save". HTTP Enter the URL in the Notification URL field, enable the activated checkbox and click Save. Page 6 of 7-09/09/2017
HTTP Notification URL: https://secure.ogone.com/ncol/prod/order_anetb_direct_utf8.asp?op=serverserver 3.3.4 Project password and input check Choose a password, and complete the "Input Check" as shown below. The password chosen here is the one you need to enter in the "Project password" field in the Sofort Banking payment method configuration page in your Ingenico epayments back office. Page 7 of 7-09/09/2017