Realex Registration Extension for Expression Engine

A simple Expression Engine 2.X extension to add payment via the Realex payment gateway to the member registration process.


Realex Registration Extension for Expression Engine

Introduction

Today I released some code to a client I thought might be of interest to others here in Ireland, the UK and France who wish to integrate the Realex Redirect online payment method into their Expression Engine 2.X member registration flow.

Features

The integration comes in the form of an Expression Engine extension which basically uses the hooks exposed by Expression Engine to redirect a user to the Realex site after the registration information they have submitted (username, password and email etc) have been validated but before they have been registered.  Registration is only completed on the user's return from Realex and only then if Realex indicates that the user's payment has been successful.  You have the option of having an alert email sent before the user is redirected to Realex and on their return from Realex for auditing and troubleshooting purposes.

Account Activation

The extension fully respects the native account activation methods, i.e. automatic, self-activation via email or manual.  In the case of automatic activattion, a confirmation email is sent to the new member, the text of which can be modified through the extension's settings screen.

The Settings Screen

The extension settings screen allows a site admin to comprehensively control the operation of the extension.  The following settings are accessible.

Membership Cost
The cost of membership in the site currency.  At this stage no subscription logic has been added to the extension.

Testing
This setting determines whether the extension uses the text merchant id and secret values provided by Realex for use as your site is being developed and tested or whether it should use the production values.

Merchant ID
This is the production merchant ID supplied by Realex

Secret
This is the production secret supplied by Realex.

Test Merchant ID
This is the merchant ID for use in testing supplied by Realex.

Test Secret
Obviously the test secret supplied by Realex.

Account Name
This is the sub account name for those with multiple Realex accounts - normally it is 'internet'.

Currency
The currency you wish your payments to be made in.

Auto Settle
Whether you wish to auto settle this transaction as it occurs or settle it as part of a batch later.  See the Realex documentation for more information on this topic.

Pre-payment Email
If completed, an alert email will be sent to this address before a user is redirected to Realex.  The email includes all information submitted by the user and can be very useful for auditing and/or troubleshooting purposes.

Post-payment Email
If completed, an alert email will be sent to this address after a user has returned from Realex.  Once again, the email includes all information submitted by the user as well as full details of the response sent from Realex and can, once again, be very useful for auditing and troubleshooting purposes.

HTML for Display on Successful Payment
This is the text displayed within the template you supply to Realex when a user has successfully paid and registered.  HTML markup is supported to reflect the look and feel of your template and indeed entire site.  It is an opportunity to thank the user and to provide further instructions/links.

HTML for Display on Failed Payment
This is the text displayed within the template you supply to Realex when a user encounters a payment error.  HTML markup is supported to reflect the look and feel of your template and website.  It is an opportunity to provide the user with extra guidance and offer support options.

Auto Activation Confirmation Email Template
In the case where you set member activation to automatic, the extension will send a confirmation email to your newly signed up member. with the text in this field.  The text contains some placeholders which are replaced with the real values at run time, these are:
{username} - replaced by the active user's username.
{password} - replaced by the active user's password.
{site_name} - replaced by the site name set in your Expression Engine installtion configuration.
{site_url} - replaced by the base site URL as set in your Expression Engine installation configuration - please note this URL includes the trailing  slash.

Conclusion

As you can see, this is a pretty comprehensive extension for Realex integration.  Due to the nature of the extension and its purpose, I am afraid I will not be open-sourcing this code but you are welcome to contact me to discuss purchase.


Comments (0)



This thread has been closed from taking new comments.

Subscribe

 Google Reader or Homepage  Add to My Yahoo!  Subscribe with Bloglines    Subscribe in NewsGator Online  Add to Technorati Favorites!  Add to My AOL  Add to netvibes  


Top Tags


On Twitter