Moneris

Moneris provides online payment services with different card types (debit, credit card, Visa), especially for customers in the USA and Canada. Mageplaza Moneris extension will help you integrate this payment gateway with your store. Customers can save and edit credit card information at the first payment to save time at the next purchase. In particular, admin can configure the module to redirect to Moneris payment gateway. Also, Moneris support authorizes, capture and 3D secure, AVS Verification.

Mageplaza Moneris extension is fully compatible with Mageplaza One Step Checkout

How to download and install

How to get the Moneris credentials

1. Register Moneris account

  • To register the Moneris account, please access to this link

https://i.imgur.com/UPMqPNw.png

  • After logging in the Moneris account, request to sign in information in USA or Canada by clicking to Full Profile

https://i.imgur.com/740IGON.png

  • At Full Profile, look at My Testing Credentials, click to Request Testing Credentials then a popup shown requires you to fill in your Password and Country to verify your test account.

https://i.imgur.com/L59DskV.png

https://i.imgur.com/ROPSK5i.png

  • At homepage, Test Credentials is on the right bar menu. Store ID is at the first line (represented by store icon). The second line is API Token (represented by a key icon). Admin needs this two information to configure the module Moneris.

https://i.imgur.com/EBm20d1.png

  • After logging in to your account, you need to fill in some account information and questions.

https://i.imgur.com/jfuRXQJ.png

2. Configure Redirect Moneris Checkout

For USA:

  • At Moneris Page, please go to Admin > Hosted Config. You need to configure Magento 2 using hpp_id, hpp_key. If you do not have these keys, please click to Generate a New Configuration to create new keys.

https://i.imgur.com/8mt186n.png

  • At Response Method, insert your Store Response URL then Save Changes. URLs must start with http or https and must be a registered domain. IP addresses are not supported here.

https://i.imgur.com/0KzlCAq.png

For Canada:

  • Log in to your Moneris account and go to Admin > Hosted Paypage Config. You need to configure Magento 2 using ps_store_id and hpp_key. If you do not have those keys, please click to Generate a New Configuration to create new keys.

https://i.imgur.com/bKrLLHT.png

  • At Paypage Appearance choose Configure Appearance to add the Cancel button Url.

https://i.imgur.com/bOjLp5R.png

  • At Response/Receipt Field Configuration, choose Return the txn_number. This is a required selection.

https://i.imgur.com/sstsymO.png

  • Checkout page: Choose the Moneris Payment method. Fill in the credit card information: Credit Card Number, Expiration Date, Card Verification Number. Here, customers can save the credit card information for the next payments.

https://i.imgur.com/R8fCX6T.png

  • Stored Payment Methods: Here saves the credit card info. Customers can delete the outdated/ no-longer-used credit card.

https://i.imgur.com/B6iGiqU.png

  • Redirect Moneris Checkout: This feature will be configured by admin at backend, which allows customers to be redirected to Moneris Payment Gateway to process their payment.

https://i.imgur.com/B6iGiqU.png

  • Here is the USA Moneris Checkout Page after being redirected:

https://i.imgur.com/c2xEfdd.png

  • Here is the Canada Moneris Checkout Page after being redirected:

https://i.imgur.com/14WrWzW.png

How to Configure

1. Configuration

Login to the Magento Admin, choose Stores > Configuration > Sales > Payment Method > Moneris.

https://i.imgur.com/TmrUkzE.png

  • Enable: Select Yes to activate the module.

1.1. Credentials

https://i.imgur.com/LeMyMmO.gifv

  • Environment:
    • Admin can choose Sandbox environment to test the payment by Moneris
    • For real payment on your live site, change the environment to Production
  • Merchant Server: Choose the Moneris Payment in:
    • Canada:
    • USA:
  • Store ID:
    • Insert the Store ID got after sign up the Moneris account above.
    • If left blank or insert the wrong ID, you can not connect to Moneris.
  • API Token:
    • Insert the API Token got after sign up the Moneris account above.
    • If left blank or insert the wrong ID, you can not connect to Moneris.
  • Enable Hosted Payment Gateway:
    • Select Yes, customers are redirected to Moneris Paypage. And show more fields following:
      • For Canada users:
        • PS Store ID: Insert the PS Store ID at configuration of Moneris hosted paypage to allow redirecting to Moneris Paypage.
        • Accept URL: Use Accept URL to configure the Moneris Hosted Paypage
        • Cancel URL: Use Accept URL to configure the Moneris Hosted Paypage
        • HPP Key: Insert the HPP key from Moneris Hosted Paypage to HPP Key Field.
      • For USA users:
        • HPP ID: Insert the HPP ID at configuration of Moneris hosted paypage to HPP ID Field.
        • Response URL: Use Response URL to configure the Moneris Hosted Paypage
        • HPP Key: Insert the HPP key from Moneris Hosted Paypage to HPP Key Field.
  • Test Credential button: Admin can check your app by clicking to Test Credential.

1.2. Card

https://i.imgur.com/MkExXbb.png

  • Title: Add the Title of Payment Method, which will be shown at checkout page.
  • Payment Action:
    • Authorize and Capture: Payment is captured right after customers place order successfully. At that time, customers’ credit card is used to pay before invoice is created then.
    • Authorize: Payments captured only when Invoice is created.
  • Card Types:
    • You can choose one or several card types to use in payment.
    • Cards will be authorized after customers fill in Card ID at checkout. For the unselected cards, there is an invalid message shown here.
  • Allow Customer Credit Vault:
    • Select Yes, Credit Card Information will be saved in Customer account and can use it for payment right after.
    • You can tick on the tick box to save the credit card ino. Do not apppy for Not Logged In customers.
  • Vault Title:
    • Enter an alternate name in the Vault Title field. This name will be displayed when customer order is completed and using the previously saved credit card.   - If left blank, use the default name
  • Payment from Applicable Countries:
    • Select All Countries to allow Card payment method available in all countries
    • Select Specific Countries to restrict certain countries to use this payment method
      • Payment from Specific Countries: Choose the countries that allow this Card payment method
  • Debug Mode: If Yes, diagnostic information is stored in log file on Magento web server.
  • Sort Order:
    • Specify the display position of this payment method compared to other payment methods
    • 0 is the largest number. The smaller the number, the more priority the country is displayed first.

1.3. Verification and Security

https://i.imgur.com/fccLy2a.png

  • Enable AVS Verification: Select yes to turn on AVS verification for Billing Address of customers. AVS is only supported by Visa, MasterCard, Discover and American Express.
  • AVS verification failed: AVS verification for Billing Address failed when Customer Name, Street Address and Zip/ Postal Code do not match. In case AVS verification fails, you can:
    • Reject Payment: deny payment and customers cannot continue making payments.
    • Accept Payment: still accept payment for customers who want to keep making payments.
  • Enable CVD verification: Select Yes to enable CVD verification for payment address (CVD is 3 digits on the back of the card). CVD is only supported by Visa, MasterCard, Discover, JCB and American Express.
  • CVD verification failed: Verify CVD for Billing Address failed when CVD is wrong or unable to verify. In case CVD verification fails, you can:
    • Reject Payment: deny payment and customers cannot continue making payments.
    • Accept Payment: still accept payment for customers who want to keep making payments.
  • Enable 3D secure: Select Yes to use 3D Secure to verify Customer’s card, thereby preventing payment fraud. Display add Force To Use field.
  • Force To Use: Select Yes to force user to verify their card. Only successful 3D Secure verified cards can process orders.
  • Response Setting:
    • Fill in the Code, Message fields to list the error cases that customer often encountered. Please refer here.
    • Click the Add button to add the case, click the Delete icon to delete the error cases you want.

2. Admin order

This section records the Credit Card (Moneris) information that the customer has ordered and paid.

https://i.imgur.com/qA0zXcZ.png

3. Order Frontend

https://i.imgur.com/Hpbt53W.png

4. Compatible with Instant Purchase

  • Customers can use Instant Purchase to place orders quickly.
  • Note: Instant Purchase only shown when you have saved your payment cards. Also, you should disable 3D Secure because the card verification was done when customers fill in the payment card information.

https://i.imgur.com/oL1Ujmt.png

https://i.imgur.com/wfD3x1q.png

  • Compatible with Mageplaza Payment Restriction: Payment Restriction extension supports hiding/showing Moneris at Frontend following admin configurations.

https://i.imgur.com/kCMzpqE.png

5. Refund Order

Here admin can Refund Online/ Offline individual or all orders.

https://i.imgur.com/J8PsUS2.png

6. Instructions for installing the library

  • Create directory: lib/internal/Mageplaza
  • Visit the link to download the Moneris library here
  • Extract the module-moneris-library into lib/internal/Mageplaza and rename the file name you just extracted as: Moneris

https://i.imgur.com/HR4N1M2.png