Friday, August 01, 2014
Text Size

Realex payments for VirtueMart 2 & Joomla! 2.5.x

Instructions

1Install the plugin like any Joomla extension

2Enable it in Joomla plugin manager

3Go to VirtueMart 2 > Payment methods

4Click "new" and select "VM - Payment, Realex"

5Name it and "Save" to have the configuration tab enable

6Add your Realex settings and "Save"

7Publish the Payment Method and "Save & Close"

Suggested Settings for Realex

These settings are done with Realex support service, not Puma-IT services. These are only suggestions that work on some live environments. Your environment might requires different ones.

  • Request URL: http://YOUR_DOMAIN_NAME/(*)
  • Response URL: http://YOUR_DOMAIN_NAME/plugins/vmpayment/realex/realex_response.php
  • For the Realex system, the maximum length of the response URL is 100 characters including http:// .

Recommendations

For the last testing on a live website, highly recommended to check user experience, and required by Realex, you can use a specific VM shopper group, to hide it from actual customers.

Realex Template page

New to Realex? Here are some tips for your convenience.

The merchant should provide a template page to be hosted by Realex secure servers.
Please see Realex customer services for more details, support for designing the template is not included in the plugin subscription.

The following comes from recommendations, from Realex included, to put links back to the merchant website (or not), in the template page, and not in the response. For example, if there is a temporary problem, the links will be there in any case, so the customer can click or not, that's the merchant choice. It is considered fair to the customer as well to put these link(s) as a way to cancel the order before placing a payment, or to change the payment method in case he/she chose the wrong one. It avoids the risk of abandoning the payment, or worst, closing the browsing session, so the transaction will be more clean for the merchant and there is less chances to upset the customer and to loose him/her!

So if there was a link in the plugin response too, we could end up with two or more links, and adding confusion to the customer.

Here is an example of the <div> tag that I am using in the Realex template:

<div class="realex">
<br / >
<!--E-PAGE TABLE HERE-->
</div>

<div align="left">
<br/>
<p>Return to <a 
href="http://YOUR_DOMAIN_NAME/index.php?option=com_virtuemart&view=orders&layout=list>
YOUR WEBSITE NAME</a>.</p>
<p>To review your order status, please <a 
href="http://YOUR_DOMAIN_NAME/index.php?option=com_virtuemart&view=orders&layout=list">
go to your account</a> and select your order in the list.</p>
</div>

in template.css, add these lines:

div.realex { font-family: Helvetica,Arial,sans-serif;font-size: 12px;}

div.realex form {width: 100%;float: none;}

div.realex form {margin: 0;padding: 0;}

div.realex form table#mainBody { margin-top: 10px; margin-bottom: 10px;
margin-left: 5px; margin-right: 5px;}

And if you use your website header and footer, you can have a nice looking payment page, hosted by Realex!

Support Hours

Reduced opening hours:
We will not provide support to our extensions' customers on the following day:
Monday 4th of August 2014.
Normal hours resume on Tuesday the 5th of August 2014.

Our opening hours are Monday to Friday 10:00 – 17:00 Irish Summer Time (GMT+1).
The ticket system is closed on weekends and outsides these days: you can neither file new tickets or reply to existing ones.

The Joomla! ® name is used under a limited license from Open Source Matters in the United States and other countries. Puma-IT is not affiliated with or endorsed by Open Source Matters or the Joomla! Project.