Menu

User Tools

Create PDF

Site Tools


Wirecard Shop Plugin for ePages

Installation guide for Wirecard Checkout Page

This installation guide shows the step-by-step installation of the plugin to your installed shop system on your web server. Please test your online shop and the configuration of the plugin on a test system before installing the plugin on your production system.

Installing the Wirecard integration cartridge

Please follow these steps to integrate the Wirecard Cartridge to your project as described in “Installing the Cartridge”.

Step 1

Install the DE_INNOCHANGE Wirecard Cartridge package in your ePages shop environment.

Step 2

First of all the cartridge has to be assigned to the desired shop types in the publisher back office (PBO). Open the “Shop types” tab and select the desired shop type (in example “Demo”). Open the “Features” tab, select “Yes” for “Payment via Wirecard” and save and apply to all shops.

Step 3

Go to the payment settings in the merchant back office (MBO). In the main menu select “Settings” → “Payment”:

Step 4

In the last line of the displayed table select “Wirecard” as payment method as well as a name which is then visible in the shop. After clicking the “Save” button the new payment method becomes visible at the bottom of the table.

The new payment method remains disabled until configuration is completed.

Step 5

For configuration, click “Wirecard” in the Payment Settings. The “General” tab opens. If the payment method is new and the settings are incomplete, there is a warning saying that the payment cannot be made visible. In the “General” tab set whether the payment method should be made visible in the shop and whether the payment method shall be a default payment method offered to the consumer. The payment method can only be set to “Default” if “Visible” is set to “Yes”.

Step 6

Define whether the payment method shall only be available for orders within a certain order value range. The minimum and maximum order value can be defined for each currency offered in the shop. If the value field is left empty, no restrictions will apply. The payment method is not displayed if the value of the respective order is outside the defined range.

Step 7

A discount or fee may be applied to the consumer's transaction. The value of the discount or fee can be set as a fixed amount or as a certain percentage. Unless “Without” is selected, a new input field opens which allows to set the discount or fee. A fixed discount or fee has to be defined separately for each currency offered in the shop.

Step 8

The payment method can be restricted to billing addresses in certain regions. The list in this drop down field is based on the regions that were previously configured for the shop (“Settings” → “Country Settings” → “Regions”). If no regions are defined, “All countries of the shop” is displayed.

Step 9

Define the name which is displayed to the consumer as well as a comment field for each defined language of the shop. On the left there is the language set as default for the current administrator, on the right the language for translations can be selected. The comments can be designed using a WYSIWYG (“What you see is what you get”) editor.

Step 10

Now, proceed to upload a logo for the payment method. Depending on whether the checkbox for “Change size during upload” is checked or not, the logo will be scaled to a maximum of 64 x 64 pixels. Irrespective of any already uploaded image, the logo can be made invisible by setting “Display logo” to “No”.

Step 11

Open the “Settings” tab to complete configuration of the Wirecard payment method.

Customer ID and secret are provided by Wirecard and are needed for authorizing the shop on the Wirecard server. An optional shop ID is provided if more than one online shop uses Wirecard as a payment method.

Now, select which payment methods the consumer may use.

If more than one payment method is available for the consumer to choose, create multiple Wirecard payment methods with different names and individual payment methods.

Step 12

Select whether the transaction should be debited directly or if only an authorization for the payment is made. The debit has to be confirmed manually afterwards.

Step 13

An order is created after the transaction via Wirecard was successfully made. The options “Order status for authorized payment” and “Order status for debited payment” allow to select which state the new order should receive. Depending on the transaction type, the state of one of the two options is used.

The following states are available:

  • Viewed
  • Rejected
  • In process
  • Pending
  • Ready for dispatch
  • Partially dispatched
  • Dispatched
  • Delivered
  • Partially invoiced
  • Invoiced
  • Partially paid
  • Paid
  • Closed
  • Archived

Please do not use “Pending” or “Rejected” for the order state as these states are used for payments with pending behavior.

Step 14

Choose whether or not the consumer billing data, consumer shipping data or the shopping basket data should be sent during the payment transaction. This is only needed for certain payment methods, e.g. Invoice by payolution and Invoice by RatePAY, or PayPal.

Step 15

Now, define whether the Wirecard payment transaction should be concluded in a separate pop-up window, in the same shop window or in an iframe which is included in the shop.

Step 16

Use “Customer groups” to restrict Wirecard to certain consumer groups.

If no groups are assigned, Wirecard can be used by any consumer. The following list shows exemplary groups defined for a shop.

Step 17

To configure Wirecard in the publisher back office (PBO), open the “Settings” tab.

Then click “Payment” in category “External systems”.

Next, select the store on which the shop is running and for which the Wirecard cartridge was installed. A new page opens, click “Wirecard” to show the settings.

Step 18

If the “Activate logging” checkbox is ticked, the entire communication between the shop and the Wirecard server is logged into the file “communication.log” on the server.

The URL of the Wirecard server is by default set to https://checkout.wirecard.com/page/init-server.php.

Furthermore there are fields to set the registration URL for the Checkout Portal and the URL for general information for shop plugins. By default these URLs are set and displayed in the MBO. If there is no value, the specific text with link in the MBO is invisible.

Step 19

The consumer can choose Wirecard as payment method during the payment process. Wirecard is only displayed if the payment method has been made visible and the order value is within the defined range.

Both name and logo are displayed if the corresponding settings of the payment method have been made. If Wirecard is selected as payment method, a new step in the shopping basket is added.

Step 20

After confirming the order in “Check & Order”, payment via Wirecard is executed.

The layout is in line with the corresponding settings made in the MBO (see Display of Payment Pages).

First, select the desired payment method. If the payment method was already selected in the settings, this step is omitted. Now the consumer has to fill in the required information for authentication. After successful transaction, the shop's order confirmation page is displayed. In case of a failure, an error message is sent.

If Wirecard is not able to detect whether the payment was successful or not, a forward to an alternative confirmation page is provided and information that the financial institution has not yet approved the payment is displayed. Also, there is an entry in the order table showing a pending state. If the payment is approved later, the order is confirmed and set to the order state which was selected in the MBO.

Installing the Cartridge

For installing or deleting the cartridge on Linux, SSH access is needed.

After establishing connection with the server, change the path to the “Cartridges” folder of ePages which is usually located at “/srv/epages/eproot/Cartridges”.

Look for the folder “DE_INNOCHANGE” (next to “DE_EPAGES”). If this folder is not available, create the folder. Copy the complete cartridge into “DE_INNOCHANGE” folder. In the command line set the right permissions by entering the following command: /etc/init.d/epages6 perm cartridges Set the environment variable to epages6 with the command: . /etc/default/epages6 Go to the folder where the Wirecard cartridge is located and create a makefile with: $PERL Makefile.PL

Now the cartridge can be installed using the following command. Replace <Store> with the store on which the corresponding shop is running:

Deleting the Cartridge

Depending on the cartridge installation, the environment variables have to be loaded with: “. /etc/default/epages6” Now change the directory to the “$EPAGES_CARTRIDGES/DE_INNOCHANGE/Wirecard” folder and execute the following commands: (STORE=<Store> has to be replaced with the name of the store on which the corresponding shop is running):


This website uses cookies to deliver the best service to you. By continuing to browse the site, you are agreeing to our use of cookies.