Wirecard Shop Plugin for osCommerce

Wirecard Shop Plugin for osCommerce

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.

Step 1

Since changes in the database will occur during the plugin installation process, you have to uninstall the old plugin before installing the new plugin.

Upload the zip file containing the Wirecard Checkout Page plugin to the document root of your osCommerce installation and unzip the file. The zip-archive already contains the directory path allowing the plugin to be stored automatically in the right folder.

If you need to unzip the file on your own computer and then upload the plugin, please maintain the directory structure which already exists in the zip file.

Next you need to install the plugin in your shop back-end. To do this, select "Modules" → "Payment" in your shopsystem’s back-end. In the upper right corner you see the "Install module" button.


Step 2

If you have already installed an older version of our plugin, please remove the old plugin first. Then select and install the Wirecard Checkout Page plugin.


Step 3

After installing the plugin you need to configure the plugin by clicking the "Edit" button.


Step 4

You need to set your merchant credentials (CustomerId, ShopId and Secret).


Step 5

Finally, verify that the Wirecard payment method is displayed.



My consumers keep getting “customer fax missing” error during the payment process and cannot do a payment!? What is the problem?

The Customer FAX field is mandatory so either enter your real fax number or just enter 0.

My web server is running PHP 4 and I get the following error: "Fatal error: Call to undefined function: file_put_contents() in …​/includes/modules/payment/wirecard_checkout_page.php on line 1081". What can I do?

It is highly recommended that you update your PHP version to at least PHP 5. If this is not possible you can comment out this line or replace it with your own logging implementation.

After finishing the payment process, my shop redirects the consumer to a login screen. The order is not stored either. How can this be fixed?

In order to process the payment correctly in your online shop, Wirecard needs direct access to the session via server-to-server call. Therefore we need to parse through the sessionId as GET Parameter to the confirmUrl. Therefore, the usage of the sessionId as GET Parameter in your shop and PHP configuration must be allowed.