Enable Payments Using Moneris Hosted Pay Page

OVERVIEW

There are many payment gateways that can be used to accept payments from customers.  Moneris Solutions has several methods for you to use to do just that.  Hotcakes Commerce comes with the Moneris Hosted Pay Pagefeature available out of the box.  This feature allows you to accept payments from customers without having to worry about PCI compliance, since the payments are input and processed on the Moneris website and not your own.  This is very similar to how PayPal Express works.

REQUIREMENTS

The following pre-requisites will be necessary to accomplish the goals of this article:

GETTING STARTED

Before you begin using Moneris, you should know that this implementation only supports our Canadian customers.  U.S. customers should use another payment gateway.  Hotcakes has several for you to choose from, including Stripe, Authorize.net, PayPal, and more.  We also have extension points for custom payment methods and custom payment gateways, if you need to build your own.

If you haven't done so already, create your Moneris account, or log into it so that you can access your account information easily.

TESTING THE MONERIS PAYMENT GATEWAY

If you need to test payments using Moneris, the following two resources will be necessary.

ENABLING MONERIS HOSTED PAY PAGE

HOTCAKES STORE ADMINISTRATION

In order to enable the Moneris payment method, you'll first need to be logged in and in your store administration area.  Once there, navigate to payment methods in the Settings menu.

Navigate to the Payment Method settings page

At this point, you can enable as many payment methods as you wish, but for now you should just check the Moneris payment method.  Don't forget to save your changes.

Check to enable Moneris, then click the Edit link

If you click the edit link next to Moneris, you'll be able to enter your payment settings that will allow Hotcakes and Moneris to communicate properly with each other. Saving your changes here should have your Moneris payment method working now, provided everything is enabled in the Moneris administration area too.

Enter the desired settings for the Moneris payment method

Setting Description
Hosted Pay Page ID This value is the same as the "ps_store_id" value that you see in the Moneris administration area.
Hosted Pay Page Token This value is the same as the "hpp_key" value that you see in the Moneris administration area.
Developer Mode When checked, this setting tells the module to communicate with the developer/test API in Moneris.
Debug Mode Enabling debug mode allows you to see messages about the transaction processing in the CMS event viewer.
Accept/Decline URL This is the URL that you will want to add to the Approved URL and Declined URL settings in the Moneris admin.  This allows the Moneris Pay Page feature to properly route your customers back to the shopping cart.  Simply copy it from here and paste it into the Moneris administration area as discussed below.

MONERIS ADMINISTRATION

There is a tiny bit of set-up in the Moneris administration.  Navigate to the Admin > Hosted Config view in their administration area.  You'll see a view like shown below.  You'll need to set the following settings, and then you're all done!

Setting Description
Description Any description that you want can go here.
Transaction Type Only the "Purchase" transaction type is supported at this time.
Payment Method Choose "Credit Cards," though it's probably the only option you'll see.
Response Method You should select "Sent to your server as a POST containing XML."
Approved URL This value should contain the URL you copied from the Moneris Payment method settings in the Hotcakes store administration area.
Declined URL This value should contain the URL you copied from the Moneris Payment method settings in the Hotcakes store administration area.
Use Enhanced Cancel The Moneris Hosted Pay Page will contain a cancel button.  It will not work properly if you do not check this setting.

Moneris Adminsitration Settings

 

Have more questions? Submit a request

Need More Help?

Do you need more assistance with this article? Please review your support options.