Menu

User Tools

Create PDF

Site Tools


Wirecard Shop Plugin for Gambio GX3

Installation guide for Wirecard Checkout Seamless

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.

This installation guide is also applicable for Gambio GX2.

Step 1

Upload the zip file containing the plugin to the document root of your Gambio GX3 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.

Step 2

Add the configuration links to the back-end using the following SQL queries:

ALTER TABLE admin_access ADD COLUMN wirecard_checkout_seamless_config INT NOT NULL DEFAULT 1; 
ALTER TABLE admin_access ADD COLUMN wirecard_checkout_seamless_backend INT NOT NULL DEFAULT 1;
ALTER TABLE admin_access ADD COLUMN wirecard_checkout_seamless_support INT NOT NULL DEFAULT 1;
ALTER TABLE admin_access ADD COLUMN wirecard_checkout_seamless_transferfund INT NOT NULL DEFAULT 1;

Step 3

Configure the payment methods adding the following values to _initMappingArray in file system/classes/languages/LanguageTextManager.inc.php around line 521:

	'modules/payment/wcs_ccard.php'                    => 'wcs_ccard',
	'modules/payment/wcs_ccardmoto.php'                => 'wcs_ccardmoto',
	'modules/payment/wcs_bancontact_mistercash.php'    => 'wcs_bancontact_mistercash',
	'modules/payment/wcs_epay_bg.php'                  => 'wcs_epay_bg',
	'modules/payment/wcs_eps.php'                      => 'wcs_eps',
	'modules/payment/wcs_giropay.php'                  => 'wcs_giropay',
	'modules/payment/wcs_idl.php'                      => 'wcs_idl',
	'modules/payment/wcs_invoice.php'                  => 'wcs_invoice',
	'modules/payment/wcs_installment.php'              => 'wcs_installment',
	'modules/payment/wcs_maestro.php'                  => 'wcs_maestro',
	'modules/payment/wcs_moneta.php'                   => 'wcs_moneta',
	'modules/payment/wcs_paypal.php'                   => 'wcs_paypal',
	'modules/payment/wcs_pbx.php'                      => 'wcs_pbx',
	'modules/payment/wcs_przelewy24.php'               => 'wcs_przelewy24',
	'modules/payment/wcs_poli.php'                     => 'wcs_poli',
	'modules/payment/wcs_psc.php'                      => 'wcs_psc',
	'modules/payment/wcs_sepadd.php'                   => 'wcs_sepadd',
	'modules/payment/wcs_skrilldirect.php'             => 'wcs_skrilldirect',
	'modules/payment/wcs_skrillwallet.php'             => 'wcs_skrillwallet',
	'modules/payment/wcs_sofortueberweisung.php'       => 'wcs_sofortueberweisung',
	'modules/payment/wcs_tatrapay.php'                 => 'wcs_tatrapay',
	'modules/payment/wcs_trustly.php'                  => 'wcs_trustly',
	'modules/payment/wcs_trustpay.php'                 => 'wcs_trustpay',

Step 4

In file admin/orders.php add after

$jsEngineLanguage['iloxx'] = $languageTextManager->get_section_array('iloxx');

the following line

$jsEngineLanguage['wirecard_checkout_seamless'] = $languageTextManager->get_section_array('wirecard_checkout_seamless');

Step 5

Clear the cache. Go to “Toolbox” → “Cache” and execute “Empty page output cache”, “Empty modules cache”, “Empty submenus cache”, “Empty categories and products cache”, “Empty properties cache”, “Empty filter cache”, “Empty text cache”, “Empty email templates cache”.

Step 6

Open the Administration of your Gambio GX3 installation with your favourite web browser and navigate to “Modules” → “Payment Systems”.

Install the desired payment methods.

Step 7

You can carry out additional configurations for any installed payment method.

Go to “MODULES”, click “PAYMENT MODULES”, select the desired payment method and click “EDIT” on the right side to configure the payment method.

If “CCARD-MOTO” is one of the payment methods you offer in your online shop, mark this payment method and click the “Edit” button on the right to fill in the relevant fields including “Customer group” which is used to limit payment method CCARD-MOTO for certain customer groups.

Step 8

For payment methods “invoice” and “installment” you need to select either “payolution” or “RatePAY” as your preferred financial service provider from the dropdown list.

If payolution is your selected financial service provider, the allowed currencies and minimum age are predefined and cannot be changed.

If RatePAY is your selected financial service provider, the allowed currencies and minimum age may be freely configured.

Minimum and maximum order amount may be freely defined both for payolution and RatePAY.

Configuring the plugin

Step 1

Open the Administration of your Gambio GX3 installation with your favourite web browser, navigate to “MODULES” and to the “Wirecard Checkout Seamless” menu.

Step 2

Now you can configure the following elements:

Configuration For integration, select predefined configuration settings or “production” for live systems. Attention: Be aware that no payments are processed in demo or test mode!
Customer ID Your Wirecard customer number. See documentation.
Shop ID Unique ID of your online shop within your customer ID. See documentation. This parameter has to be enabled by Wirecard CEE for your customerId.
Secret Secret string for signing and validating data to prove their authenticity. See documentation.
Backend password Password for backend operations (Toolkit). See documentation.
Service URL URL which leads to the imprint page containing contact information. See documentation.
Shop name Additional text on invoice, max. 9 characters. See documentation.
Send detailed customer data Billing and shipping address data are sent to Wirecard Checkout Seamless.
Send confirmation e-mail E-mail address of merchant for receiving payment information details regarding the orders of the consumers in your online shop. See documentation.
Auto deposit Automated deposit of approved payments. See documentation.
Send basket information Shopping basket information is sent to Wirecard Checkout Seamless. See documentation.
PCI DSS SAQ A Compliance Whether Wirecard Checkout Seamless is PCI DSS SAQ A compliant or not.
Iframe CSS-URL URL pointing to CSS file to be included into iframe.
Display card holder Display input field for card holder in your credit card form in the online shop.
Display CVC field Display input field for CVC in your credit card form in the online shop.
Display credit card issue date Display input field for issue date field in your creditcard form in the online shop. Some credit cards do not have an issue date.
Display credit card issue number Display input field for issue number in your credit card form in the online shop. Some credit cards do not have an issue number.
Order State Choose the payment statuses, which are displayed on the order details page, for the available order results.

For a detailed description regarding the parameters used for communicating with Wirecard Checkout Seamless have a look at:

Step 3

Finally, to test your configuration click the “Test configuration” button at the bottom of the page. If the test is ok, the following screen appears:

Customizing and translating text resources

You may customize and translate text resources. Example files are available within the zip-file at /lang/[language code]/original_sections/modules/payment/wcs<paymenttype>.php.

The definitions of text resources regarding error messages for handling a cancelation or a failure of the payment (“cancelURL” and “failureURL”) are included in file /lang/[language code]/original_sections/modules/payment/wirecard_checkout_seamless.lang.inc.php.

Supported back-end operations

This plugin for Gambio GX3 and Wirecard Checkout Seamless has been developed to carry out the following back-end operations directly from within our online shop:

To carry out these back-end operations go to “Orders”.

Go to the details for the order.

All relevent order related data are displayed as in the following example:

Starting from the above displayed screen, you may carry out the back-end operations deposit or approveReversal.

approveReversal

To reverse an approved payment, click the “Approve reversal” button on the order details page as described above.

deposit

To deposit the fully approved amount, click the “Deposit” button on the order details page as described above.

depositReversal

Once the amount is deposited, a depositReversal may be carried out. Click the “Deposit reversal” button as shown on the following screen:

Note that the back-end operations approveReversal, deposit, and depositReversal may only be executed before the day-end closing was carried out. Once a day-end closing was performed, these operations may no longer be carried out.

refund

In order to refund an amount to your consumer, click on the “Add credit” button in the segment “Wirecard Checkout Seamless - Credits” in the order details. Enter the amount to refund in the following pop-up window.

refundReversal

In the following example, the refunded amount is EUR 20.00. In order to reverse this refund, click the “Refund reversal” button.

Note that the back-end operations refund, and refundReversal may only be executed after the day-end closing was carried out.

transferFund

In order to carry out a fund transfer, navigate to “Modules” → “Wirecard Checkout Seamless” and click “Fund Transfer”. A screen opens which allows you to choose one of the fund transfer types from the dropdown list: Existing order, Skrill Digital Wallet, moneta.ru, or SEPA-CT.

For fund transfer type EXISTINGORDER, the fields “Amount”, “Order description”, and “Source order number” are mandatory. Fill in the fields and click the “Execute fund transfer” button. The following screen appears when the operation was successful.

For fund transfer type Skrill Digital Wallet, the fields “Amount”, “Order description”, “Customer statement”, and “Consumer e-mail address” are mandatory.

For fund transfer type moneta.ru, the fields “Amount”, “Order description”, “Customer statement”, and “Consumer wallet ID” are mandatory.

For fund transfer type SEPA-CT, the fields “Amount”, “Bank account owner”, “BIC” and “IBAN” are mandatory.

Request Wirecard Support

For enhanced user experience, we have included in our plugin a new feature which allows to send a support request to our support teams directly from the online shop.

Click the “Request support from Wirecard” button at the bottom of the page. A dropdown list allows you to choose whether your request is sent to our support teams in Austria or Germany.

Enter the e-mail address in the “Reply to” field to which you would like to receive the answer from the support team.

After entering your message in the “Problem description” field, click the “Send support request” button to forward the message correspondingly.

Our support teams then receive a summary of the configuration settings of your online shop and the problem description.

Please note that your secret and passwords are NOT included in this configuration setting summary.


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.