Skip to main content

Moneris Checkout

This article provides OPS-COM system admins with a comprehensive guide to setting up and configuring Moneris Checkout as a payment provider. Moneris Checkout is a full full-service partner provider that will allowallows you to support manya wide range of payment options for payment inwithin OPS-COM.

This is our only integration that currently supports ApplePay

Setup and GooglePayConfiguration

if

Properly youconfiguring chooseMoneris toCheckout enableinvolves it.

two

Howkey tostages: configureconfiguring the settings within your Moneris Checkoutmerchant Portalaccount Settings

and then mirroring the appropriate settings within OPS-COM.

Information Required for Setup

This

guide

Before willbeginning givethe configuration, you must create a run down of the required settings to configureprofile in your Moneris Checkoutaccount. Configuration Portal,From there, you will need to obtain the following credentials from within the Moneris account. OPS-COM will require these details to connect to the service.

  • store_id: store#

  • api_token: xxXXXXX

  • checkout_id: xxxxxxxxStore#

  • Hosted_token_id (Generated by you, later on in order to have this paymentdocument)

    processor
    • correctly
communicate

<div withclass="info-box"> OPS-COM,You andmust importalso paymentdetermine dataif withoutyour errors.Moneris Ifsecurity these settings are correct, it is possible to have problemssettings, such as paymentsAddress beingVerification approvedService without(AVS), notifyingwill require your customer's billing address to be collected. This decision affects which fields OPS-COM towill releaseprompt the permit, this can leaduser to doublecomplete.

payments,

</div>

and

Moneris bookPortal keepingConfiguration

discrepancies
    if
  1. it

    Log is not noticed right away. Please take carein to make sure the following settings are configured correctly, and consider sending a screenshot of each to OPS-COM support, support@ops-com.com.


    When setting up an account as a merchant with Moneris, you MUST make sure that you are setting it up as an eCommerce account, and not as a terminal. Moneris offers both options, but if you have a terminal account, you cannot use hosted tokenization to store card information.

    Information the client will supply: 

    store_id:    store#
    api_token:     xxxxxxx
    checkout_id:      xxxxxxxxStore#

    hosted_token: xxxxxxx

    In order to get information above, first you must log into your Moneris Merchant Resource Centre,Center clickand navigate to the configuration area.

  1. Click Admin dropdown,in the main menu and select Moneris Checkout Config.

  2. Locate your checkout profile (e.g., MOC-SPO) and click Storeto Settings.edit Thisit.

    page
    3. should
show

From there, you can change any of the firstsettings:

three

values.

Checkout Type

Select;

“I have my custom order form and want to use Moneris simply for payment processing.”

This ensures that Moneris provides the payment fields embedded within your existing OPS-COM order form.

Multi-Currency

This feature can be enabled if you need to process payments in multiple currencies.

TheFeature HostedLimitations: Tokenwith Multi-Currency Enabling Multi-Currency will disable support for Recurring Billing, Gift Cards, 3-DSecure 1.0, and Google Pay.

Payment

This section defines transaction rules and security options.

  • Payment Security: It is alsoyour founddecision inwhether to enable security features like AVS and CVV. If you enable these, you must configure OPS-COM to collect the Admin dropdown, this time selecting Hosted Tokenization. Click Create Profile, without entering a source domain, and copy and paste the profile ID.

    Hosted Token is only required for storing cards or processing automated permit rollovers (subscriptions) Click Here for more info!

    image.png

    We need to know iffull billing address needsfrom to be supplied (AVS or other security options are enabled)users. WithoutNote thisthat information,if the payments will always fail. 


    How to configure your settings in Moneris Checkout

    BelowMulti-Currency is aactive, guide for3D how your settings should be set up to communicate correctly with OPS-COM

    Checkout type

    Select the following checkout configuration type:

    (If you have the other option selected, Use Moneris Checkout, the integration will not work and payments will not be recorded in OPS-COM)

    image.png

    Multi-Currency

    image.png

    Note: the following. If multi-currencySecure is enabled; recurring billing, gift cards, 3-DSecure 1.0 and Google Pay and not supported.

  • image.pngTransaction Type: You can set this to either preauthorize, or purchase. THE PAYMENT TYPE IN OPS-COM MUST ALSO BE CONFIGURED THE SAME WAY.

    Payment

  • SetTokenize Card: Ensure the followingTokenize parameters.

    Card

    image.png

    option
    is Paymentdisabled. securityCard options
    tokenization

    It'sfor uprecurring topayments is handled by the clientMoneris toVault, enablewhich theseis optionsconfigured orseparately.

    not.
    • Note
the issue about 3D Secure

Branding and Multi-currency above.

Design

Warning:To If Moneris is expecting no address information, and we are sending address information in our custom checkout form,ensure the payment willform notintegrates gosmoothly through, we recommend you screenshot your settings and send it to us to make sure there is no incorrect information.


Transaction Type

Purchase iswith the onlyuser functionality currently supported, make sure Preauthorization,  Card Verification, and Tokenize Card, are not checked.experience:

  • Disable the
    Enable Fullscreen checkbox. This prevents the checkout form from taking over the entire screen.

    Branding
    • and Design

The onlyrest settingof thinkthe isbranding importantand isdesign Enabledecisions Fullscreen shouldan be Off. You can configure the restconfigured to your liking.

Order Confirmation

Configure Moneris to redirect the user back to OPS-COM after a payment attempt.

  • Select the option  “Use Own Page” for the order confirmation. This allows OPS-COM to display the final success or failure receipt.

OPS-COM System Configuration

Payment Types Setup

Please click this hyperlink to be redirected to our Payment Types Setup documentation, and then finish the remaining steps after that has been finished.

Create a new section for setting up Hosted providers. We currently have only 3:

We recommend

Moneris Vault for Stored Payments

 

Moneris Vault is a complementary service used for tokenizing and storing credit cards for future use, such as with parking rollovers or Text2ParkMe. This functionality requires one additional piece of information during setup:

  • hosted_token_id: This ID is generated from the Hosted Tokenization page within the Moneris portal.

If you takeencounter an "Invalid credentials" error when attempting to tokenize a screenshotcard, ofit is likely due to a missing hosted_token_id or because the token's "Source URL" authentication does not match the domain you are using. For testing, you can use a profile without Source URL authentication. 

 

 

Best Practices and Troubleshooting

Common Billing and AVS/CVV Errors

The most common issue during setup is a mismatch between Moneris's expectations and the data OPS-COM provides.

<div class="warning-box"> If Moneris is configured to require and validate billing details (AVS is enabled), but OPS-COM is only configured to ask for an email address (promptFor is set to anonymous), all yourtransactions settingswill andfail. sendingYou itmust ensure the OPS-COM configuration matches the security requirements you set in the Moneris portal. </div>

Investigating Failed Transactions

To diagnose issues, use the following resources:

  • Papertrail: The raw JSON response from Moneris is logged here, providing detailed error information.

  • Moneris Merchant Resource Center: Log in to support@ops-com.com,the reporting section to verifyview alltransaction thehistory. informationThe isreports correct.here provide human-readable details about why a transaction was declined.

Testing Resources

Moneris provides comprehensive guides for testing various scenarios:

Back to top