Europabank

Europabank Merchant Plugin FAQ

Table of contents
All of my transactions are tagged as Pending, inside my shop. ....................................................... 3 All of my transactions are denied. ....................................................................................................... 3 After a transaction, i get a mail with We were unable to give feedback at www.yoursite.com ..... 3 When using a custom css in the payment module, internet explorer complains about security. ....... 4 What is the difference between Client-secret and Server-secret? ...................................................... 4 How is the SHA-1 calculated and what is it used for? ......................................................................... 4 Must my shop, or the checkout of my shop, be SSL? ........................................................................... 5 The installation of the MPI-plugin(magento, oscommerce, virtuemart, wordpress) is not working. 5 My server (site) cannot connect to your MPI server, through server-to-server. ................................. 5 Getting mails like We were unable to give feedback at example.com ............................................ 5 How does the integration tests work? What do I have to do? ............................................................ 6 Why are transactions with high amounts denied? .............................................................................. 6 Which plugins exist and what are the versions? ................................................................................. 6 What if my webshop or webshop version is not supported?............................................................... 6 Where can I find the plugins for Magento? ......................................................................................... 7 Where can I find the plugins for osCommerce?................................................................................... 7 Where can I find the plugins for Virtuemart (Joomla)? ....................................................................... 7 Where can I find the plugins for Wp-ecommerce (wordpress)? .......................................................... 7 Where can I find a technical manual for MPI? .................................................................................... 7 Do you support any payed plugins and/or shops? .............................................................................. 7 Magento : How can an invoice be sent to the client after a successfull transaction? ........................ 7 Magento : Is one-step-checkout (http://www.onestepcheckout.com) supported? ........................... 7

All of my transactions are tagged as Pending, inside my shop.

By default, when opening a test account, the transactions are processed as authorization. Those payments are meant to be processed manually. So if a customer buys something, you as a merchant have to let the transaction pass. The other way of processing, is sale. Then all transactions will be completed automatically. In your shop, orders will show processed. If you want this setting changed, please mail to mpi.support@europabank.be

All of my transactions are denied.

There could be many reasons why your transactions are rejected. Several of these reasons are listed here : By default, the country of the cards, the country of the delivery address and the country of the ip-address (customer) must be the same! If this is not the case, in real world, this could mean that there is fraud going on. Of course, this check can be disabled. In your MPI-test account, you can change security from Yes into No. This is the same page where you change your server and client secret and change your email address. Be sure the domain name is entered well in the same page as above. If a transaction is ending, the MPI will return to the shop. If that is not working, the transaction will be denied. A transaction, with a given orderid from the shop, can be processed only once, if the transaction ends succesful. So, a transaction can not be processed twice with the same orderid, if the first was successful. A transaction can not be processed successfully twice within 15 minutes, if the cardnumber and amount are the same.

After a transaction, i get a mail with We were unable to give feedback at www.yoursite.com
There could be many reasons why we couldnt give feedback. Several of these reasons are listed here : It is possible that your website is not reachable all the time. If so, the connection times-out an we cannot continue feedback. Be sure that the description of your shop items, do not contain special characters. The only characters allowed are the following : a-z A-Z

0-9 . , : ; ? - !

When using a custom css in the payment module, internet explorer complains about security.
When so, you can use a PROXY URL If the merchant has no https domain and wishes to use some pictures in his templatepage or css, he can use the proxy url of the Europabank MPI: You need to submit the url of your webshop into the administrative module Proxy url is : https://www.ebonline.be/(test/)mpi/image?uid=XXXXXXXXXX&url=YYYYY Parameter uid is your accountnumber Parameter url is the url of your image/css file on your webserver. Europabank MPI will retrieve the image/css on your webserver and stream it to the payment form page.

What is the difference between Client-secret and Server-secret?

The client and server secret can be provided in the parameters page, where you change your e-mail address etc The client-secret is used to log in to the MPI-test account. But also for executing your transaction, if you use the POST method for posting payment data. So the payment is running from client to server. The server secret is only used for server-to-server communication. This means the the payment information is sent through an xml to the MPI site.

How is the SHA-1 calculated and what is it used for?

The SHA-1 is used to check and authenticate the payments, to be sure it is a genuine payment. For Client-to-server payments (Via POST), the client-secret is involved. For server-to-server payments, the server-secret is used. Calculating the hash happens by stringing all the necessary fields and hashing it with sha-1. The fields are in order of appearing: UID orderId Amount Description Client or server-secret

Must my shop, or the checkout of my shop, be SSL?

No.

The installation of the MPI-plugin(magento, oscommerce, virtuemart, wordpress) is not working.

There are many reasons why the plugin, or even the transactions are not working at all. Some of the reasons are listed below: Be sure that you use the appropriate plugin for your webshop. Also be sure that the versions of the plugin correspond to your shop-version. See further for version information. One of the main problems is that the secret in the sha-1 is not correct. Be sure that the appropriate secret is used and that it is the same as the secret provided in the parameters page in the MPI-test account. Another common problem is that the shop is hosted on an external server by a hosting company. If you do not have full admin access to the server, a lot of features could be disabled due to security reasons. For example allow external connections, allow sending mail, allow specific php modules etcTo solve such problems, contact your hosting company. If you work with the client-to-server POST method, to pass your payment data, be sure that only the needed fields are posted and that they are written casesensitive. If not, the request will be rejected. Be sure that the urls provided in the MPI-test account are the good ones. If they do not correspond to the website you are working on, requests will be rejected.

My server (site) cannot connect to your MPI server, through server-to-server.

Most probably your provider does not allow external connections. See The installation of the mpi-plugin(magento, oscommerce, virtuemart, wordpress) is not working. in this document. Another reason could be that CURL is not supported and/or stream_context_create via fopen is not working.

Getting mails like We were unable to give feedback at example.com

After a transaction, a feedbackurl can be requested from our server. If that url is not reachable or an unvalid http-status-code is returned, a mail will be send to the merchant that looks like : We were unable to give feedback at example.com. Therefore we send you the feedbackparameters by email: ...

How does the integration tests work? What do I have to do?

Once your webshop is up and running and configured with our MPI-plugin, you can start testing. During the registration you received several card numbers. Visa, Mastercard and Maestro. With these testcards, you have to do all the test transactions with the amounts provided on the integration page. If a transaction has been successfully executed, it will be shown in the integration test page.

Why are transactions with high amounts denied?

During the tests, amounts over 250 euros will be denied. This will not be the case in a live situation. In a live situation, the CARDS department can adjust this limit.

Which plugins exist and what are the versions?

There are 4 shops supported, so there are 4 shop plugins, with their versions. Magento plugin works for magento 1.4.x, 1.5.x, 1.6.x Oscommerce plugin works for oscommerce 2.2rc2 and 2.2.3 Virtuemart plugin works for virtuemart 1.1.9 and 2.0 Wp-ecommerce plugin works for wp-ecommerce 3.8.7.x Prestashop plugin works for Prestashop 1.4.x and 1.5

What if my webshop or webshop version is not supported?

There are 2 solutions. If you are a developer, you can start coding the MPI interaction yourself. For that, you will need the MPI technical manual. You can mail to mpi.support@europabank.be , asking for a plugin for your shop. The chance that a plugin will be developed for new shops, or developed for existing shops but with new version, depends on the number of demands of that particular shop. So, do not hesitate, and mail us. If done so, we can better map which shops are used and popular and better answer the needs of our customers.

Where can I find the plugins for Magento? Where can I find the plugins for osCommerce? Where can I find the plugins for Virtuemart (Joomla)? Where can I find the plugins for Wp-ecommerce (wordpress)? Where can I find a technical manual for MPI?
The plugins for those shops can be found in the MPI-test account in the section downloads. There is also a technical pdf document (manual) to be found.

Do you support any payed plugins and/or shops?

All the plugins and/or shops that are payed, are not supported by us. We just cannot buy every existing item, just to let things work. Nevertheless, if a payed item is a really hot item, asked by many of our customers, we could start some support.

Magento : How can an invoice be sent to the client after a successfull transaction?
Because not every merchant wants an automatic invoice sending system to his customers, this feature is not available in the magento plugin. But, if you want this feature, it is very simple to make it available. Take the php source code file, that is located at: app/code/local/Mage/Eub/controllers/StandardController.php Look for the line $invoice->save(); Just AFTER (or under) that line, put this : $invoice->sendEmail(true,"sometext"); Here is some extra documentation: http://docs.magentocommerce.com/Mage_Sales/Mage_Sales_Model_Order_I nvoice.html#sendEmail

Magento : Is one-step-checkout (http://www.onestepcheckout.com) supported?

We do not support this plugin. But as mentioned in the faq of one-step-checkout, our plugin should work with this plugin. If not, the technical issues are not our concern. This plugin is a paying plugin.