Toggle navigation

WC Moneris Payment Gateway Pro

Version 3.3

Moneris is Canada’s leading processor of Debit and credit card payments. This WooCommerce extension automatically adds moneris payment gateway to your woocommerce website and allows you to keep the customer on your site for the checkout process.

System Requirements

To get the best experience of Moneris Pro, we suggest the following:

  1. PHP 7.0+
  2. MySQL 5.6+
  3. WordPress 5.5+
  4. WooCommerce 4.0+

This documentation assumes you have already installed WordPress. If you do not know how to install WordPress, please contact your hosting provider for assistance and also ask him to make sure that the PHP and MySQL version above is ensured.

Moneris production credentials

To accept payments, you’ll need two IDs:

  • Store ID: Your Moneris account representative can provide your Store ID.
  • API Token: Log into your Merchant Resource Center store, and click on Admin > Store Settings in the main menu. When the "Store Settings" page displays, your store’s API token will be shown in the "API Token" area on the page.
  1. Get the PRO zip file from WPHEKA. If you have not already downloaded the PRO .zip file, download it from your account dashboard. You will find all your purchased plugins there.
  2. Login to your site’s admin panel and navigate to Plugins → Add New → Upload.
  3. Click choose file, select the plugin file and click Install
  4. Activate after installation.

If you are using FTP to transfer your files to your server. Then just unzip the plugin and upload wc-moneris-payment-gateway-pro directory to your /wp-content/plugins/ directory.

Activate your license key

After installing WC Moneris Payment Gateway Pro, You need to activate your license. To activate your license key and to get automatic updates, go to WPHEKA > Moneris Pro Activation.

Click Save Changes after entering your API Key and Product ID that you have received in your order email.

What are the License Keys Used For?

License keys are used to verify your purchase of Moneris Pro. It’s a vital part of getting support and updates.

Moneris (API)

You can configure the following settings for the Moneris gateway:

  • Enable / Disable: Allow customers to use this gateway to checkout.
  • Title: The text shown for the payment during checkout and on the Order Received page.
  • Description: The text shown under the gateway’s title during checkout. Limited HTML is allowed.

  • Multicurrency setup: You can connect to multiple Moneris accounts to route payments based on their currency.
  • Transaction Type: Controls how transactions are submitted to Moneris. Defaults to "Charge" to automatically capture payments. "Authorize" allows you to optionally capture previously authorized transactions directly from the WooCommerce Edit Order screen. Simply edit the order, select the “Capture Charge” action, and charges will be captured through Moneris.
  • Sandbox: Switch between "Production" and "Sandbox" credentials. Enable it to send transactions to your Moneris sandbox account.
  • Preferred Cards: Select your desired cards from the multiple-select box. The logo of the selected card(s) will be displayed on the checkout page.
  • Statement Descriptor: Enter what customers should see on their bank statements for charges from your store.
  • AVS: Address Verification Service (AVS) is an optional fraud-prevention tool offered by issuing banks whereby a cardholder’s address is submitted as part of the transaction authorization. When enabled, you can choose how the gateway should respond in different scenarios based on the street address / zip code matching and address verification results. You must enable AVS on your Moneris account to use this feature.
  • CVD: The Card Validation Digits (CVD) value refers to the numbers appearing on the back of the credit card rather than the numbers imprinted on the front. It is an optional fraud prevention tool that enables merchants to verify data provided by the cardholder at transaction time. When enabled, you can determine how the gateway should respond in different scenarios based on the CSC match / verification results.
  • Saved Cards: Enable it to let logged-in customers save payment methods during your checkout process by default to use them in future checkouts
  • Logging: Enable it to store warnings, error messages and status information in log file, If you’re having issues processing transactions. As a best practice, please do not enable this setting unless you’re having issues with the plugin.

Moneris Checkout (MCO)

Moneris Checkout is hosted by Moneris, on a PCI-Compliant infrastructure. This means that the payment page where cardholder data is entered and where the payment is processed and settled is all managed on Moneris secure servers, sensitive cardholder data does not pass through your servers nor is it ever shared with WooCommerce, so there is less risk for you.

Key Features:

  • Supports fraud tools including min/max spends, 3-DSecure, Moneris Kount, AVS and CVV.
  • Moneris Kount proactively detects fraud before it occurs, using predictive modeling and risk scoring to analyze and assess customers in real-time.
  • 3-D Secure provides real-time authentication of an online shopper to their card issuer through Visa® Secure and MasterCard Identity Check®.
  • Address Verification Service (AVS) matches the address the customer provided to the address on record with the issuing card bank.
  • Card Verification Value (CVV) confirms the customer knows the 3-4 digit code on the card provided, and validates it with what is on record with the issuing card bank.
  • Transaction limits control the minimum and maximum dollar amounts that can be charged for any one order submitted by a customer in the checkout.
  • Determine whether to allow Moneris to manage auto-decisioning with regards to how transaction requests are handled and processed through your checkout.
  • Manage your transactions and how you want to receive your payments through the Merchant Resource Center. Your options include Purchase and Preauthorization.

You can configure the following settings for the Moneris Checkout gateway:

  • Enable / Disable: Allow customers to use this gateway to checkout.
  • Title: The text shown for the payment during checkout and on the Order Received page.
  • Description: The text shown under the gateway’s title during checkout. Limited HTML is allowed.
  • Store Id: Unique identifier provided by Moneris upon merchant account setup.
  • API Token: Unique alphanumeric string assigned by Moneris upon merchant account activation.
  • Statement Descriptor: Enter what customers should see on their bank statements for charges from your store.
  • Sandbox: Switch between "Production" and "Sandbox" credentials. Enable it to send transactions to your Moneris sandbox account.
  • Logging: Enable it to store warnings, error messages and status information in log file, If you’re having issues processing transactions. As a best practice, please do not enable this setting unless you’re having issues with the plugin.
  • Checkout Id: The first step is to configure your Moneris Checkout page in the Moneris Merchant Resource Center (MRC).

    In the initial stage of development, you create a test configuration in the testing MRC. Once the solution is ready to be deployed to production, you must create a new, separate configuration for the production environment in the production Merchant Resource Center (MRC).

    The checkout ID is the key value that is generated after the configuration is completed and used within the Preload Request in order to identify the specific Moneris Checkout configuration.

    To get the checkout ID and start configuring your page, do the following:

  1. Log into the Merchant Resource Center at one of the following URLs (according to your stage of development)
    Testing: https://esqa.moneris.com/mpg
    Production: https://www3.moneris.com/mpg
  2. In the Admin menu, select Moneris Checkout Config.
  3. Click the Create Profile button.
  4. Follow the on-screen steps to complete the configuration.
moneris-checkout-config
  • Under the Checkout Type section, ensure that the Use Moneris Checkout for the complete set of online payment forms radio button is selected, then click the Save button near the top of the screen.
moneris-checkout-type
  • Scroll down and expand the Order Summary (Cart) section. Ensure the Order Summary (Cart) details and Product Image check boxes are checked.
order-summary-mco
  • Scroll down and expand the Customer Details section. In this section, be sure to uncheck all of the checkboxes.
moneris-checkout-customer-details
  • Scroll down and expand the Multi Currency section:
    1. Enable/disable Multi-Currency
    2. Determine if you want to enable geo-location for transactions.
    3. Enable/disable the default currencies that you want to support in your checkout profile.
    4. Add/remove other currencies from your list of supported currencies.

      Note: Geo-location detects the IP address of customers using your checkout and displays product prices and transaction amounts in the currency corresponding to the country/location in which customers are using the checkout subject to the following restrictions: If a customer’s IP address does not correspond with a currency that your checkout is configured to support, the checkout will display prices and transaction amounts in United States dollars (USD). If a customer’s IP address does not correspond with a supported currency and your checkout is not configured to support USD, the checkout will display prices and transaction amounts in Canadian dollars (CAD).

moneris-checkout-multi-currency.png
  • Scroll down and expand the Payment section.
    1. Under the Accepted Digital Wallets section enable/disable digital wallet support per your integration requirements.
moneris-checkout-digital-wallets
  • Under the Card Logos section enable/disable the display of debit and credit card logos per your integration requirements.
moneris-checkout-card-logos
  • Under the Payment Security section, select fraud-prevention tools per your integration requirements.
    1. Determine whether to allow Moneris to manage autodecisioning concerning how transaction requests are handled and processed through your checkout:
      Note: Decisions are based on fraud-prevention response codes from supported fraud-prevention tools such as AVS, CVV, 3-D Secure, and Moneris Kount®. Autodecisioning may or may not be configurable from your settings panel, and may be enabled/disabled by default depending on the fraud-prevention features for which your store is enabled.
    2. Enable/disable each fraud-prevention tool (AVS, CVV, 3D Secure, and Kount) if displayed on your settings panel.
      Note: The fraud-prevention tools displayed on your settings panel are dependent on the fraud-prevention features for which your store is enabled. Some fraud-prevention tools may be enabled/disabled by default and may or may not be configurable from your settings panel.
moneris-checkout-payment-security
  • Scroll down to Transaction Type and select the preferred transaction type:
    1. To perform purchase transactions, select Purchase.
    2. To perform pre-authorization transactions, select Preauthorization.
      Note: You can select either Purchase or Preauthorization, but not both.

      Note: If you selected Preauthorization, a customer’s preauthorization can be completed either through the MRC, or through WooCommerce order edit screen.
moneris-checkout-transaction-type
  • Under Transaction Limits section enable/disable a minimum and maximum transaction dollar limit type.
moneris-checkout-transaction-limits
  • Scroll down and expand the Order Confirmation section.
    1. Under Order Confirmation Processing, select the Use Moneris option.
    2. Under the Confirmation Page Content section, select the desired information you wish to be displayed on the confirmation page (when the customer is completing their transaction).
moneris-checkout-order-confirmation
  • Scroll down and expand the Email Communications section.
    1. Under the Email Contents section, select the desired contents that will appear in the order confirmation email the customer will receive.
    2. Under the Customer Emails section, place a checkmark in the desired checkbox for what event triggers an email to be sent to a customer.
moneris-checkout-email-communications

Migration from Free to Pro

How do I migrate my settings from the free version of the WordPress plugin to the Pro version?

As the free version and the Pro version are two separate versions of the plugin then you need to deactivate the free version prior to activating the Pro version. You can keep your settings by following these steps:

  1. Deactivate the free version
  2. Install and activate the Pro version
  3. Delete/Remove the free version

API Token mismatch

What can cause an API Token mismatch?

  1. Incorrect Store ID: Make sure you use your store ID and not your merchant number.
  2. Incorrect API Token: The API token is case sensitive, make sure you copy and paste if from the Moneris Gateway website and that no letters or numbers are missing. Also make sure that no spaces were copied by accident.
  3. Incorrect server address: Payment gateway settings is pointing to the wrong server (test versus production)

No permission for CVD / AVS

Why am I getting the error “no permission for cvd_info / avs_info”?

You are sending CVD/AVS information when this feature is not enabled on your merchant account. To resolve this issue you can add AVS/CVD to your account by contacting Moneris representative or disable AVS/CVD in your application. Alternatively, you may also have the wrong API token entered into your payment gateway settings.