Jump to content

VirtualMerchant Gateway Module for WHMCS (Elavon/Virtual Merchant)


Recommended Posts

VirtualMerchant Payment Gateway Module for WHMCS

 

Overview

 

This module allows you to process transactions in WHMCS through the Virtual Merchant gateway. This is the gateway generally provided by Elavon and its associated resellers.

 

It supports both sales and refunds with WHMCS, and also performs full CVV and address verification (AVS). Transactions are handled entirely within WHMCS, and clients will not have to leave your website to complete the transaction.

 

The module correctly logs all data to the built in payment gateway log of WHMCS.

 

Requirements

 

  • WHMCS v3.7 or higher
  • ionCube Loader
  • VirtualMerchant account

 

Installation

 

  • Copy the supplied virtualmerchant.php file into your whmcs_location/modules/gateways directory.
  • Set the file permissions and ownership to match the rest of the files in that directory ("chmod 644 virtualmerchant.php" and "chown websiteuser:websitegroup virtualmerchant.php")
  • Log into the client area of myvirtualmerchant.com using the credentials supplied by Elavon. Go to Terminal/Advanced/System Setup and make sure the "Enable HTTP Transaction" and "Use HTTP Referrers" boxes are both checked. Under "Authorized Referrer", type a URL into the textbox (i.e. https://www.yourdomain.com/whmcs/creditcard.php) and click "Add Referrer". The URL does not have to actually exist, however you must remember this URL as it needs to be set to match in WHMCS. This adds a level of security to your VirtualMerchant account, as only people who know this referrer URL will be able to submit transactions to it.
  • Log in to your WHMCS administration console. Click Setup/Payment Gateways. From the dropdown list, choose VirtualMerchant and click activate.
  • Make sure "Show on Order Form" is checked.
  • In the settings form, choose a visible name (such as "Visa/MasterCard"), and fill in the appropriate account ID, user ID, and PIN. (NOTE: the account ID is generally the same one you use to log into myvirtualmerchant.com, however a seperate user ID for web-based transactions should have been provided to you, along with an associated PIN. If this has not been provided to you, contact Elavon support)
  • Set the HTTP Referrer URL to exactly match the one you set in the "Authorized Referrers" box in myvirtualmerchant.com.
  • OPTIONAL: The "Payment Instructions" field can also be filled in with information to display to your customers on the payment collection page. However this is generally left blank as the page is quite straightforward.

 

Notes

 

  • When the "Test Mode" setting is checked, VirtualMerchant always returns a successful transaction. You must use one of the test credit card numbers listed on the WHMCS website, otherwise WHMCS will complain about the card number being invalid before it is ever sent to VirtualMerchant.
  • To view details of each transaction, you can use the built in payment gateway log in the WHMCS admininistration console. Click Billing/View Gateway Log. If a transaction failed or was declined, the reason for the failure will be logged here.

 

Licensing & Cost

 

The module provided here is the full version of the module. It has been encoded with ionCube.

 

Without a valid license key, you will only be able to process transactions that are $1 or less. Transactions for any greater amount will be automatically declined. This allows you to download and install/test the module to make sure it is working correctly.

 

A valid license key can be purchased for $129 USD via PayPal, and will be tied to your specific machine. The cost includes lifetime upgrades (ie if the VirtualMerchant gateway changes in the future due to PCI rules), and help with installation. Please send me a private message for more details on how to purchase.

 

Download Link

virtualmerchant-whmcs.zip

Link to comment
Share on other sites

  • Replies 129
  • Created
  • Last Reply

Top Posters In This Topic

Here are the test credit card numbers provided by WHMCS that you can use to test:

 

4007000000027 - Visa Test Card

4012888818888 - Visa Test Card II

5424000000000015 - MasterCard Test Card

 

Use any expiry date in the future, and any CVV. If you use these with the module's Test Mode ON, the transactions should be approved. With Test Mode OFF, they should be declined. You can see what information VirtualMerchant returned about the transaction by checking the WHMCS payment gateway logs (as described above).

 

Also make sure that in the WHMCS admin console, you've correctly chosen the credit cards you are able to process. Go to Setup/General Settings/Invoices, choose the appropriate cards, and press save. On the same page you can also uncheck "Issue Number/Start Date" box, as VirtualMerchant does not do anything with this data.

Link to comment
Share on other sites

  • 4 weeks later...
  • 4 weeks later...
  • 6 months later...
  • 4 weeks later...

FYI I've had two customers who get an error when WHMCS tries to bill a customer for a recurring charge. For these two clients, the first time their customers placed an order it worked fine, but when WHMCS tried to automatically bill them for some recurring charge, they get the following error in the gateway log:

 

"CVV2 check cannot be performed as no data was supplied in the authorization request."

 

CVV information cannot be stored by WHMCS (companies are not allowed to store CVV data), so it isn't supplying it to the module when it attempts to automatically bill them. However it is not required to be supplied for recurring transactions anyway.

 

Both clients successfully solved this problem by contacting Elavon and asking them to remove the CVV requrement for http transactions.

 

Just an FYI in case anyone is having this issue.

Link to comment
Share on other sites

  • 4 months later...
  • 4 months later...
  • 1 month later...

Hello Gei,

we bought your module for Elavon paying S129.00USA

we have some issues and you have not sent us your contact number to contact you if help is needed:

can you please let me know how to contact you?

Thanks.

Link to comment
Share on other sites

Hi,

 

We purchased this module about a year ago.

Now we've started to receive error messages and transactions are not going through.

 

ssl_customer_code is not supplied the error says. We know the cards are OK.

 

Error log for AMEX:

Invoice ID => 1127

User ID => 32

Amount => 1.00

errorCode => 4009

errorName => Required Field Not Supplied

errorMessage => The field Customer Code (ssl_customer_code) required but not supplied in the authorization request.

 

 

Error for VISA:

Invoice ID => 1121

User ID => 30

Amount => 100.00

errorCode => 4009

errorName => Required Field Not Supplied

errorMessage => The field Customer Code (ssl_customer_code) required but not supplied in the authorization request.

 

We need this fixed ASAP obviously....

Link to comment
Share on other sites

  • 3 weeks later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

  • Recently Browsing   0 members

    • No registered users viewing this page.

×
×
  • Create New...

Important Information

By using this site, you agree to our Terms of Use & Guidelines and understand your posts will initially be pre-moderated