Moneris Go Portal - Developer Tools
This article covers information regarding how to access your Moneris Go portal store's API token and how to create and configure your Moneris Checkout profiles and hosted tokenization profiles for your ecommerce integrations.
Table of Contents
Procedure
Product
Moneris Go portal - API token
Moneris Go portal - API token
The steps below describe how to view and copy your Moneris Go portal store's API token.
Note: The API token is a unique alphanumeric value that is assigned to every Moneris Go portal store. The API token is used to authenticate a store and facilitate ecommerce transactions through that store. For information on how to use the API token in your ecommerce integration, visit the Moneris Developer Portal (https://developer.moneris.com), and refer to the ecommerce integration guide for your integration type.
- Log into the Moneris Go portal, and access the store containing the API token that you want to view or copy (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account, you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, you should see the "API Token" module (shown below), which lists your store's API token and store ID.
Note: If the "API Token" module is not displayed, click on the API token tab to display the module.
Important! To prevent your API token from being compromised, do not share it over email, text message, etc. - If you want to copy the API token to your device's clipboard:
- Click on the Copy
icon.
- When the "API Token copied" response displays, the operation is complete.
Important! To prevent your API token from being compromised, do not share it over email, text message, etc.
- Click on the Copy
Moneris Go portal - Moneris Checkout
Moneris Go portal - Moneris Checkout - How to get started
Moneris Checkout allows you to process transactions by integrating a Moneris-hosted checkout page into your ecommerce website. Moneris Checkout uses server-to-server communications at the back end in conjunction with your own merchant server and identifies each transaction with a unique ticket number, without exposing the data in the Web browser.
How it works
Moneris Checkout supports a cohesive, modular pay page design with parameters that you can customize such as order summary, customer details, and payment details. Once you integrate Moneris Checkout into your solution, you can use the Moneris Go portal's Moneris Checkout (MCO) configurator to configure your checkout parameters and manage anti-fraud tools such as Moneris Kount®, AVS, CVV, and 3-D Secure. You can also enable Visa installment plans (Installments enabled by Visa®) and set minimum/maximum purchase limits. Supported payment types include credit, debit, gift cards and digital wallets, including Apple Pay® and Google Pay™.
To begin, please follow the steps below:
- Ensure your Moneris Go portal user account is activated, and you can log in and access your Moneris Go portal store (for setup instructions, see Moneris Go portal - How to get started).
Note: Your user account must be enabled with full administrative access and user-level permissions so that you can perform the setup and configuration steps as directed below. (Contact your store administrator if you need to have these permissions enabled.) - Review the specifications in the Moneris Checkout Integration Guide (This guide is available on the Moneris Developer Portal at https://developer.moneris.com).
Note: If you need to view or copy your store's API token, see Moneris Go portal - API token. - Create a Moneris Checkout profile (see Moneris Go portal - Creating a Moneris Checkout profile).
Note: If you want to make configuration updates to an existing profile, skip this step. - Configure your Moneris Checkout profile per your integration requirements (see List of Moneris Go portal - Moneris Checkout features/settings).
Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile
Follow the steps below to create a new checkout profile. A profile defines the parameters and behaviour of your Moneris Checkout integration.
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Log into the Moneris Go portal, and access the store through which you want to create the checkout profile (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account , you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, click on the Moneris Checkout Configuration tab to display the "Create a checkout profile" module (shown below).
Note: If one or more checkout profiles are saved, they will be listed in the "Checkout profiles" module (shown below). - Go to the "Create a checkout profile" module, and do following:
- In the Checkout alias field, optionally enter checkout profile alias.
Note: An alias can make it easier for you to identify a specific checkout profile when you have more than one. If you do not append a custom alias, the default alias, "Standard" will be applied. (You can always update the alias at a later time.) - Click on the Create profile button.
- When the new profile is created (shown below), click on the Save profile button.
Note: The profile's "Checkout ID" (shown below) is a unique alpha-numerical string that is used in the preload request to identify and regulate the checkout integration in your ecommerce solution. - When the "Successfully saved profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- In the Checkout alias field, optionally enter checkout profile alias.
Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile
Follow the steps below to reopen a checkout profile.
- Log into the Moneris Go portal, and access the store containing the MCO profile that you want to reopen (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account , you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, click on the Moneris Checkout Configuration tab to display the "Checkout profiles" module (shown below).
- Go to the "Checkout profiles" module, and click on the profile that you want to open.
Note: To change the number of profiles listed on the page, click on the "Show # items per page" drop-down, and select a number (10, 25, or 50). To advance to the next page or last page, click on the Next page > icon or the Last page >> icon respectively. To go back to the previous page or the first page, click on the Previous < icon or the First page << icon respectively. - When the profile is open in your configurator (shown partially below), you can:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- Delete the profile (see Moneris Go portal - Moneris Checkout - Deleting a Moneris Checkout profile).
Moneris Go portal - Moneris Checkout - Previewing the checkout
Follow the steps below to generate a full-screen preview of your MCO checkout. The preview is based on the checkout profile's current configuration.
Note: The preview function is supported only if the checkout is configured to use Moneris for the complete set of online payment forms (see Moneris Go portal - Moneris Checkout - Configuring the "Checkout type" setting).
- Ensure the profile for the checkout that you want to preview is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator (shown below), click on the more options (ellipsis)
button.
- When the drop-down displays (shown below), click on Full screen preview.
- Wait while the MCO configurator generates the checkout preview (shown below).
Note: Your checkout preview will look different depending on how you have configured the profile. - When you are finished previewing the checkout, click on the Exit full screen preview button to return to your MCO configurator screen.
- To configure profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
Moneris Go portal - Moneris Checkout - Deleting a Moneris Checkout profile
Follow the steps below to delete a checkout profile by using the delete function in the "Checkout profiles" module.
Note: To delete the profile using the delete function in the open profile, see Moneris Go portal - Moneris Checkout - Using an open MCO profile's deletion function.
Important! Please ensure that you perform this operation per your ecommerce solution's integration requirements. A profile's unique checkout ID is used in the preload request to identify your ecommerce solution's Moneris Checkout integration. You must develop your ecommerce solution per Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Log into the Moneris Go portal, and access the store containing the MCO profile that you want to delete (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account , you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, click on the Moneris Checkout Configuration tab to display the "Checkout profiles" module (shown below).
- Go to the "Checkout profiles" module, and do the following:
- Locate the MCO profile that you want to delete, and click on its Delete
icon.
Note: To change the number of profiles listed on the page, click on the "Show # items per page" drop-down, and select a number (10, 25, or 50). To advance to the next page or last page, click on the Next page > icon or the Last page >> icon respectively. To go back to the previous page or the first page, click on the Previous < icon or the First page << icon respectively. - When the "Delete profile" dialog displays, click on its Yes button.
- When the "Profile deleted successfully" response displays, the operation is complete.
Note: The deleted profile will be de-listed from the "Checkout profiles" module.
- Locate the MCO profile that you want to delete, and click on its Delete
Moneris Go portal - Moneris Checkout - Using an open MCO profile's delete function
Follow the steps below to use an open MCO profile's delete function to delete the profile.
Note: To delete a closed profile, see Moneris Go portal - Moneris Checkout - Deleting a Moneris Checkout profile.
- While the profile is open in your configurator (shown partially below), click on the (more options) ellipsis
button.
- When the drop-down displays (shown below), click on Delete profile.
- When the "Delete profile" dialog displays (shown below), click on its Yes button.
- When the "Profile deleted successfully" response displays, the operation is complete.
Note: The configurator will refresh back the "Developer tools" page, and the deleted profile will be de-listed from the "Checkout profiles" module on that page.
Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings
This section describes the features/settings that are supported by Moneris Checkout.
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
3-D Secure
Fraud-prevention tool that uses smart authentication methods such as SMS, knowledge-based, or biometric verification in real-time. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment security".
Alias/name
The customizable alias can make it easier for you to identify a specific checkout profile. To configure this setting, see Moneris Go portal - Moneris Checkout - Editing the checkout profile's alias.
Apple Pay
Digital wallet payment method for your checkout customers. To configure this setting, see Moneris Go portal - Moneris Checkout - Enabling Apple Pay in the checkout.
Address verification (AVS)
Fraud-prevention tool that allows for verification of cardholder address details against card issuer records. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment security".
Brand colors
Design element you use to customize the look and feel of your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Branding & design".
Business logo
Design element you use to customize the look and feel of your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Branding & design".
Button customization
Design element you use to customize the look and feel of your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Branding & design".
Card logos
Display for customers which card types are supported by your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Checkout type
Set parameters for your checkout's payment forms. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the "Checkout type" setting.
Confirmation page
Set the content in your checkout's order confirmation page, displayed when your checkout customer submits their order. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Order confirmation" content.
Customer personal details
Set which personal details are to be captured when customers use your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Customer details".
CVV
Fraud-prevention tool that sends the 3- or 4-digit card validation values to the card issuer for authentication. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment security".
Email contents
Set the contents in your checkout's confirmation email and set the permissions that trigger the sending of confirmation email. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Email communication" content.
Gift cards
Moneris Gift card payment method for your checkout customers. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Google Pay
Digital wallet payment method for your checkout customers. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Header/footer
Design element you can use to customize the look and feel of your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Branding & design".
Kount
Fraud-prevention tool that uses smart authentication methods such as SMS, knowledge-based, or biometric verification in real-time. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment security".
Merchant email
Set the event(s) that must occur in your checkout to trigger the sending of a confirmation email to you. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Email communication" content.
Multi-currency pricing (MCP)
Allow customers to pay in the currency of their choice while you receive settlement and reporting in Canadian dollars. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings.
Order summary details
Set the content that your checkout customers see in their order cart. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Order summary (cart)" details.
Shipping destinations
Set your checkout's shipping destination controls. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Customer details".
Transaction limits
Set your checkout's maximum and minimum transaction limits. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Tokenize cards
Allow customers to register (tokenize) a debit/credit card through your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Transaction type
Set the transaction type that your checkout will support. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Vault update cards
Allow customers to update card data tokenized through your checkout. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment" settings.
Visa installments
Allow customers to pay using an installment plan. To configure this setting, see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Visa installments" settings.
Moneris Go portal - Configuring a Moneris Checkout profile
Moneris Go portal - Moneris Checkout - Configuring the “Checkout type” settings
Follow the steps below to configure the checkout to use Moneris for the complete set of online payment forms or to use Moneris only for payment processing.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Checkout type in the navigation pane to jump to the "Checkout type" module (shown below).
- Select the checkout type for your integration:
- To use Moneris for all order processes, select the Use Moneris for the complete set of online payment forms radio button.
- To use your own custom order form, select the I have my custom order form and want to use Moneris simply for payment processing radio button.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Editing the checkout profile's alias
Follow the steps below to edit the checkout profile's alias. If you configure a custom alias yourself, it can make it easier for you to identify a specific profile if you have more than one.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on the alias
icon (shown below).
- When the "Edit checkout alias" window displays (shown below), do the following:
- Enter the new alias in the Checkout alias field.
- Click on the Save button to close the window.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Order summary (cart)” details
Follow the steps below to configure the details to include in the checkout's order summary cart. Order summary details include product images, product names, product price, quantity, and subtotal.
Note: Order summary details settings are visible only if the profile is configured to use Moneris for the complete set of online payment forms (see Moneris Go portal - Moneris Checkout - Configuring the "Checkout type" setting).
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Order summary (cart) in the navigation pane to jump to the "Order summary (cart)" module (shown below).
- Enable/disable order summary details:
To enable order summary details:- Checkmark the Order summary (cart) details box.
- Enable/disable each line item to include in the order summary. Line items include Product image, Product name, Product price, Quantity, and Subtotal.
Note: To enable a line item, checkmark the box beside the desired line item. To disable a line item, unmark the box beside the undesired line item. (If a field/checkbox is locked, it means you cannot enable/disable it from the configurator.)
To disable order summary details:- Unmark the Order summary (cart) details box.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Customer details”
Follow the steps below to configure the customer details to capture in the checkout. Customer details include first name, last name, phone, email, billing address, and shipping address.
Note: Customer details settings are visible only if the profile is configured to use Moneris for the complete set of online payment forms (see Moneris Go portal - Moneris Checkout - Configuring the "Checkout type" setting).
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Customer details in the navigation pane to jump to the "Customer details" module (shown below).
- Configure which customer details to support in the checkout:
To enable support for capturing customer details:- Checkmark the Customer's personal details box.
- Enable/disable each line-item field (First name, Last name, Phone, Email, Billing address, and Shipping address) to include/exclude in customer details.
Note: To enable a line-item field, checkmark the box beside the desired line item. To disable a line item, unmark the box beside the undesired line item. - The customer phone number and email data must be submitted in the transaction: If you do not enable the Phone field and the Email field (step 3b), you must send the "phone" data and "email" data in your preload request.
- If you enabled "First name", "Last name", "Phone", and/or "Email", click on their corresponding drop-down, and select Mandatory or Optional data entry
Note: If you enabled the "Phone" field and "Email" field, you must enable mandatory data entry for each field. - If you enabled the "Shipping address" fields in step 3b, optionally add/remove shipping controls:
- To add a shipping control, see Moneris Go portal - Moneris Checkout - Adding shipping controls in the checkout.
- To remove a shipping restriction, see Moneris Go portal - Moneris Checkout - Removing shipping controls in the checkout.
To disable support for capturing customer details:- Unmark the Customer's personal details box.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Adding shipping controls in the checkout
Follow the steps below to add one or more shipping controls to restrict the available shipping address(es) that customers will be permitted to select when entering their shipping details in the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and is enabled to support capturing customer personal details (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Customer details").
- Go to the "Customer details" module (shown partially below), and checkmark the Shipping address box.
- Click on Add countries provinces/states.
- When the "Add shipping controls" window displays (shown below), click on the "Countries" drop-down and select one or more countries (e.g., Canada) as desired.
- If the "Provinces/States" drop-down displays (shown below), and you want to impose a province state shipping control, click on the drop-down and select the desired province(s)/state(s).
- When you are finished, click on the Save button to close the window.
Note: When the page refreshes, the countries/provinces/states to which you applied shipping controls will be listed under "Shipping countries" and "Shipping provinces/states" respectively (shown below). - Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Removing shipping controls in the checkout
Follow the steps below to remove one or more shipping controls in the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and is enabled to support capturing customer personal details (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Customer details").
- Go to the "Customer details" module (shown partially below), and do the following:
- Under "Shipping countries" and/or "Shipping provinces/states", click on the delete icon (X) beside the destination that you want to remove (de-list).
- When the "Shipping control deleted successfully" response displays, go to the next step.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Multi-currency pricing” settings
Follow the steps below to configure multi-currency pricing (MCP) in the checkout. With multi-currency pricing, your checkout customers can opt to pay in the currency of their choice while you receive settlement and reporting in Canadian dollars.
Note: If you want to use MCP in your checkout, the MCP feature must be enabled on your Moneris Go portal store (contact us to enable this feature on your store). The multi-currency settings described in this procedure are applicable only to the payment page through which you are integrating Moneris Checkout and are not applicable to your entire Website.
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Multi-currency in the navigation pane to jump to the "Multi-currency" module (shown below).
- Enable/disable multi-currency pricing (MCP) in the checkout:
To disable MCP:- Unmark the Enable multi-currency box.
- Continue at step 4.
To enable MCP:- Checkmark the Enable multi-currency box.
- Enable/disable location-based multi-currency pricing (geo-location) in the checkout: [1]
- To enable geo-location, checkmark the Geo-locate box.
- To disable geo-location, unmark the Geo-locate box.
- Enable/disable BIN lookup in the checkout: [2]
- To enable BIN lookup, checkmark the BIN lookup box.
- To disable BIN lookup, unmark the BIN lookup box.
- Configure optional currency settings as desired:
- To enable/disable a specific default currency, see Moneris Go portal - Moneris Checkout - Enabling/disabling a default currency.
Editing the percentage markup(s): - To edit one currency at a time, see Moneris Go portal - Moneris Checkout - Editing a currency's percentage markup: "Add all currencies" disabled.
- To edit all currencies simultaneously, see Moneris Go portal - Moneris Checkout - Editing a currency's percentage markup: "Add all currencies" enabled.
Adding/removing supplemental currency listing(s): - To add a specific currency, see Moneris Go portal - Moneris Checkout - Enabling a supplementary currency.
- To remove a specific currency, see Moneris Go portal - Moneris Checkout - Disabling/de-listing a supplementary currency.
- To add all supplemental currency listings simultaneously, see Moneris Go portal - Moneris Checkout - Enabling/listing all supplemental currencies simultaneously.
- To remove all supplemental currency listings simultaneously, see Moneris Go portal - Moneris Checkout - Disabling/de-listing all supplementary currencies simultaneously.
- To enable/disable a specific default currency, see Moneris Go portal - Moneris Checkout - Enabling/disabling a default currency.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
- 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).
- BIN Lookup is supported only for Visa and Mastercard. BIN lookup compares the customer billing currency (determined by card issuer) against the default currencies supported by your checkout (or, if geo-location is enabled, BIN lookup compares customer billing currency against the currency corresponding to the location in which the customer is using the checkout). If BIN lookup detects a discrepancy and the checkout supports more than one default currency, the checkout will prompt the customer to choose a preferred (supported) currency for the transaction. If the checkout supports only one default currency, the customer will not be prompted to choose a different currency.
Moneris Go portal - Moneris Checkout - Enabling/disabling
Follow the steps below to enable/disable a default currency in the checkout.
Note: Default currencies include Australian Dollar, Canadian Dollar, Euro, Hong Kong Dollar, Indian Rupee, Pound Sterling, UAE Dirham, US Dollar, Won, Yen, and Yuan Renminbi. If a currency listing is enabled, customers may opt to pay in that currency when using the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and confirm that the "Default currencies" list is displayed. (If it is not displayed, unmark the Add all currencies box.)
- Enable/disable one or more default currencies as desired.
Note: To enable a currency, checkmark the box beside it. To disable a currency, unmark the box beside the undesired currency. Support for pricing in Canadian dollars is mandatory (i.e., the "Canadian Dollar" listing is always enabled). - Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Editing a currency's percentage markup: “Add all currencies” disabled
Follow the steps below to edit a percentage markup for one or more listed checkout currencies when the "Add all currencies" feature is disabled.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and do any of the following:
Note: Ensure the Add all currencies box is unmarked.
To edit the percentage markup of each currency independently:- Locate the currency that you want to edit, and enter a numeric % value in the currency's Markup field.
- Repeat for each currency that you want to edit.
To edit the percentage markup of all currencies simultaneously:- In the % Markup to all currencies field, enter a numeric % value.
- Click on the Apply to all button.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Editing a currency's percentage markup: “Add all currencies” enabled
Follow the steps below to edit a percentage markup for one or more listed currencies in the checkout when the "Add all currencies" feature is enabled.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and click on Edit markup.
Note: The Add all currencies box must be checkmarked. - When the "Edit currency markup" window opens (shown below), do one of the following:
To edit the percentage markup of any currency independently:- Enter a numeric % value in field beside the currency that you want to edit.
- Repeat for each currency that you want to edit.
- Click on the Save button to close the window.
To edit the percentage markup of all currencies simultaneously:- In the % Markup to all Currencies field, enter a numeric % value.
- Click on the Apply to all button.
- Click on the Save button to close the window.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Enabling a supplementary currency
Follow the steps below to add (enable) a supplemental currency in the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below) and confirm that the "Default currencies" list is displayed. (If it is not displayed, unmark the Add all currencies box.)
- Click on Add currency.
- When the "Add currency" window displays (shown below), do the following:
- Click on the drop-down, and select the currencies that you want to add.
- When you are finished, click on the Save button to close the window.
- When the "Additional currency saved successfully" response displays, confirm that the "Additional currencies" list is updated.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Disabling/de-listing a supplementary currency
Follow the steps below to disable and de-list a supplemental currency in the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and confirm that the "Additional currencies" list is displayed. (If it is not displayed, unmark the Add all currencies box.)
- Go to the "Additional currencies" list, and do the following:
- Locate the currency that you want to disable, and click on its Delete
icon.
- When the "Delete currency" dialog displays (shown below), click on Yes.
- When the screen refreshes, confirm that the currency is no longer listed under "Additional currencies".
- Locate the currency that you want to disable, and click on its Delete
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Enable/listing all supplemental currencies simultaneously
Follow the steps below to enable and list all supplemental currencies in the checkout simultaneously.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and checkmark the Add all currencies box.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Disabling/listing all supplemental currencies simultaneously
Follow the steps below to disable and de-list all supplemental currencies in the checkout simultaneously.
- Ensure the checkout profile that you want to configure is open on your screen and multi-currency pricing is enabled in the checkout (see Moneris Go portal - Moneris Checkout - Configuring the checkout's "Multi-currency pricing" settings).
- Go to the profile's "Multi-currency" module (shown below), and unmark the Add all currencies box.
- If any currency is listed under "Additional currencies", you can disable/de-list it now (continue at step 3 in Moneris Go portal - Moneris Checkout - Disabling/de-listing a supplementary currency).
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Payment” settings
Follow the steps below to configure the checkout's payment settings, including digital wallets, card logos, card details, transaction type, gift cards, and transaction limits.
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Payment in the navigation pane to jump to the "Payment" module (shown below).
- To configure digital wallets, go to the "Accepted digital wallets" area in the module, and:
For Apple Pay:
To enable Apple Pay, see Enabling Apple Pay in the checkout.
To disable Apple Pay, unmark the Apple Pay box.
For Google Pay:- To enable Google Pay, checkmark the Google Pay box.
- Click on Google Pay API Terms of Service to review the terms.
Note: To disable Google Pay, unmark the Google Pay box.
- To enable card logos, go to the "Card details" area in the module, and checkmark Display card logos box. [1]
Note: To hide (disable) card logos, unmark the Display card logos box. - To set the transaction type, go to the "Transaction type" area in the module, and:
- Select the radio button beside the desired transaction type (Purchase, Preauthorization, or Card verification).
- To enable Moneris to tokenize and store card data, checkmark the Tokenize card box: [2]
Note: Enabling this feature will allow your checkout customers to register a debit/credit card for future transactions through the checkout. Returning customers can opt to use a previously registered card as their payment method. - To allow stored card data to be updated through the checkout, checkmark the Vault Update Card box. [3]
Note: Enabling this feature will allow returning checkout customers to update debit/credit card data that they previously registered through the checkout.
- To configure gift card acceptance in the checkout, go to the "Gift cards" area in the module, and:
- To enable gift card processing, checkmark the Accept gift cards box. [4]
Note: To disable gift card processing, unmark the Accept gift cards box. - To limit the number of gift cards that can be used to pay for any one transaction, enter a numeric value from 1 to 5 in the Max number of gift cards field. Otherwise, to disable limits, leave the field unfilled.
- To enable gift card processing, checkmark the Accept gift cards box. [4]
- To set the transaction amount minimum and/or maximum that can be charged for any one order submitted through the checkout, go to the "Transaction Limits" area in the module, and:
- To set a minimum, checkmark the box beside Transaction min ($), and enter a dollar amount (#.##) in the corresponding field
- To set a maximum, checkmark the box beside Transaction max ($), and enter a dollar amount (#.##) in the corresponding field.
Note: To disable a limit, unmark the box beside the undesired limit type.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
- Card details such as "Cardholder name", "Card number", "Card expiry date", and "CVV" cannot be enabled/disabled from the configurator.
- If you want to use the card tokenization and Vault update card features, Moneris Vault must be enabled on your store. Contact us if you want Moneris Vault enabled on your store.
- This feature can be enabled only if you select "Card Verification" as the transaction type. See also the previous footnote.
- If you want to accept gift cards, Moneris Gift must be enabled on your store. Contact us if you want Moneris Gift enabled on your store. Gift card transactions are always processed as a "Purchase" even if the checkout is configured to support Pre-authorizations.
Moneris Go portal - Moneris Checkout - Auto-decisioning rules and responses for Moneris Checkout
If you enabled the "Auto decision by Moneris" feature for the checkout as described in Moneris Go portal - Moneris Checkout - Configuring the checkout's "Payment security", please refer to the table below to inform your fraud-prevention tool configuration choices.
AVS = address verification service | CVV = card verification value [1] | CAVV = cardholder authentication verification value
Fraud-Prevention Tool | Enabled? | Pass Response Mandatory? | Deny Response Codes | Description of Deny Response Codes |
AVS | Yes | Yes | C | Full address, including postal code, submitted but not verified due to incompatible formats. |
Yes | I | Address information not verified. | ||
Yes | N | No match, or no billing information supplied. | ||
Yes | R | Retry, system unable to process. | ||
No | N/A |
AVS will be performed on address and postal code but no decision will be made by Moneris. Note: You may opt to decision manually. |
||
No | N/A | N/A | AVS not performed. | |
Postal code only | Yes | Yes | C | Postal code submitted but not verified due to incompatible formats. |
Yes | I | Postal code submitted but not verified. | ||
Yes | N | Postal code submitted. No match, or no billing information supplied. | ||
Yes | R | Retry, system unable to process. | ||
No | N/A |
Postal code verification will be performed, but no decision will be made by Moneris. Note: You may opt to decision manually. |
||
No | N/A | N/A | AVS not performed. | |
CVV3 |
Always | Yes | N | No match. |
P | Not processed. | |||
S | CVV[2] should be on card but no CVV was presented. | |||
D |
Invalid security code. Note: American Express & JCB only. |
|||
Other | Invalid response code. | |||
No | N/A |
CVV[3] will be performed but no decision will be made by Moneris. Note: You may opt to decision manually. |
||
3D Secure | Yes | Always | 0 | CAVV could not be verified or CAVV data was not provided when expected. |
B | CAVV passed verification—attempted authentication, no liability shift. | |||
No | N/A | N/A | 3-D Secure not performed. | |
Kount (Enterprise) |
No | N/A | N/A |
Kount risk inquiry not performed. |
Yes | Yes | As per your rules |
You determine rules and responses based on your risk portfolio. Moneris Checkout makes decisions based on an "Accept" or "Deny" notification from your rule configuration with Kount. Note: If Kount status code "A" (approve), "R" (review), or "E" (escalate) is accompanied by a Gateway response code that is less than "50", the transaction will be sent for authorization. (You may subsequently use Kount's Admin Portal to manually review the authorized transaction.) However, Kount status code "D" (decline) or a Gateway response code that is equal to/greater than "50" will result in a declined transaction. |
|
No | As per your rules |
You determine rules and responses based on your risk portfolio. Moneris Checkout will not make a decision based on these responses but will return the response from Kount to inform your post-transaction risk management. Note: All transactions will be sent for authorization, and Kount status code/response details will be included in every transaction's JSON receipt response. (You may manually review the Kount details for any transaction.) |
- May be referenced as "CVD" (card verification digits) on some reports and transaction pages.
- May be referenced as "CVD" (card verification digits) on some reports and transaction pages.
- May be referenced as "CVD" (card verification digits) on some reports and transaction pages.
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Order confirmation” content
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Order confirmation in the navigation pane to jump to the "Order confirmation" module (shown below).
- Configure who does the order confirmation processing:
- Go to the "Order confirmation processing" area in the module, and:
- To enable Moneris to perform the order confirmation processing, select the Use Moneris radio button.
- To enable your own system to perform the order confirmation processing, select the Use Own Page radio button.
- Go to the "Order confirmation processing" area in the module, and:
- To configure the checkout's confirmation page content:
- Go to the "Confirmation page content" area in the module, and enable/disable the line items Order ID, Customer info, Shipping info, Billing info, Payment info, and Custom message.
Note: To enable a field, checkmark the box beside the desired field. To disable a field, unmark the box beside the undesired field. If a field/checkbox is locked, it means you cannot enable/disable it from the module. - If you enabled the "Custom message" field, enter your message in the field.
- Go to the "Confirmation page content" area in the module, and enable/disable the line items Order ID, Customer info, Shipping info, Billing info, Payment info, and Custom message.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Configuring the checkout's "Branding & design)
Follow the steps below to configure the checkout's branding and design elements, including logo, colours, and customizations like payment window type, merchant name, headers, footers, and navigation button names.
Important! To integrate Moneris Checkout into your ecommerce solution, you need to create and configure your Moneris Checkout profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Moneris Checkout - How to get started.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Branding & design in the navigation pane to jump to the "Branding & design" module (shown below).
- Configure the checkout's branding & design elements as desired:
Logo- Go to the "Logo" area in the module, and enable/disable a logo:
- To enable a logo, enter the logo image file address in the URL field.
- To disable a logo, leave the URL field unfilled.
Colours- Go to the "Colours" area in the module, and do one or more of the following:
- In the Header text and Header background fields, enter HEX values to format the respective colour aspects of the checkout header.
- In the Button text and Button background fields, enter HEX values to format the respective colour aspects of the button on which your customer will click on to submit their order for processing.
- In the "Background" drop-down list, click on a supported background colour (Light grey or White) to select (enable) it.
Customizations- Go to the "Customizations" area in the module, and set controls for the size of the checkout's payment form window
- To enable Moneris to control the size of the payment form window, checkmark the Enable fullscreen box.
Note: If this option is enabled, you may customize the checkout's payment form further by configuring additional options as instructed in step b of this procedure. - To control the size of the payment form window yourself, unmark the Enable fullscreen box.
- To enable Moneris to control the size of the payment form window, checkmark the Enable fullscreen box.
- Enable/disable the payment form customization options Header, Merchant name in header, Powered by Moneris footer, and Card borders/shadows per your requirements. [1]
- To enable a customization, checkmark the box beside the desired customization.
- To disable a customization, unmark the box beside the undesired customization.
- From the "Process text" drop-down list, select a label to display on the button on which the checkout customers will click to submit their order (e.g., Checkout, Buy, Purchase, Book, Subscribe, Donate, or Process).
- From the "Cancel text" drop-down list, select the text of the hyperlink on which the checkout customers will click to interrupt the submission of their order so that they can return to your ecommerce site (e.g., Cancel, Back, Back to Store, or Continue Shopping).
- Go to the "Customizations" area in the module, and set controls for the size of the checkout's payment form window
- Go to the "Colours" area in the module, and do one or more of the following:
- Go to the "Logo" area in the module, and enable/disable a logo:
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
- If the "Enable fullscreen" customization option is disabled (unmarked), all other payment form customization options on your module will be disabled (locked) except for the "Card borders/shadows" setting.
Moneris Go portal - Moneris Checkout - Configuring the checkout's “Email communication” content
Follow the steps below to configure the checkout's confirmation email content (includes order, payment, customer, and shipping details), and set approved/declined permissions for sending auto-response emails to customers and any specified merchant recipients.
- Ensure the checkout profile that you want to configure is open on your screen.
Note: To reopen an existing profile, see Moneris Go portal - Moneris Checkout - Reopening a Moneris Checkout profile. To create a new profile, see Moneris Go portal - Moneris Checkout - Creating a Moneris Checkout profile. - While the profile is open in your configurator, click on Email communication in the navigation pane to jump to the "Email communication" module (shown below).
- To configure confirmation email contents:
- Go to the "Email contents" area in the module, and enable/disable email content including Order info, Customer info, Shipping info, and Payment info.
Note: To enable any content, checkmark the box beside the desired content. To disable content, unmark the box beside the undesired content.
- Go to the "Email contents" area in the module, and enable/disable email content including Order info, Customer info, Shipping info, and Payment info.
- To configure the email permission(s) that will cause a confirmation email to be sent to customers:
- Go to the "Customer emails" area in the module, and enable/disable the email permissions Approved transactions and Declined transactions.
Note: To enable a permission, checkmark the box beside the desired permission. To disable a permission, unmark the box beside the undesired permission.
- Go to the "Customer emails" area in the module, and enable/disable the email permissions Approved transactions and Declined transactions.
- To configure one or more recipients to receive confirmation emails for approved/declined transactions that are processed through the checkout:
- To add a new email recipient, see Moneris Go portal - Moneris Checkout - Adding a new merchant email recipient.
- To remove an email recipient, see Moneris Go portal - Moneris Checkout - Removing a merchant email recipient.
- To edit the details of an email recipient, see Moneris Go portal - Moneris Checkout - Editing a saved merchant email recipient.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Adding a new merchant email recipient
Follow the steps below to set up a new recipient address to receive confirmation email regarding every approved/declined transaction that is processed through the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and email content and permissions are set (see Moneris Go portal - Configuring the checkout's "Email communication" content).
- While the profile's "Email communication" module (shown partially below) is open in your configurator, click on Add email recipient.
- When the "Add email recipient" window displays (shown below), do the following:
- In the First name field, enter the recipient’s given name.
- In the Last name field, enter the recipient’s surname.
- In the Position/label, enter the recipient’s position title.
- In the Email address field, enter the recipient’s email address to which you want customer confirmation emails to be sent.
- To enable the recipient to receive confirmation emails for transactions that are approved, checkmark the Approved transactions box.
- To enable the recipient to receive confirmation emails for transactions that are declined, checkmark the Declined transactions box.
- Click on the Save button to close the window.
Note: When the page refreshes, the added merchant address will be listed in the "Merchant email recipients" area in the module (shown below).
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Editing a saved merchant email recipient
Follow the steps below to edit the details of a saved recipient address, which is configured to receive confirmation email regarding every approved/declined transaction that is processed through the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and email content and permissions are set (see Moneris Go portal - Moneris Checkout - configuring the checkout's "Email Communication").
- While the profile's "Email communication" module is open in your configurator, go to the "Merchant email recipients" list (shown below), and click on the email recipient that you want to edit.
- When the "Edit email recipient" window displays (shown below), edit any of the fields/settings as desired:
- In the First name field, enter the recipient’s given name.
- In the Last name field, enter the recipient’s surname.
- In the Position/label, enter the recipient’s position title.
- In the Email address field, enter the recipient’s email address to which you want customer confirmation emails to be sent.
- To enable the recipient to receive confirmation emails for transactions that are approved, checkmark the Approved transactions box.
- To enable the recipient to receive confirmation emails for transactions that are declined, checkmark the Declined transactions box.
- Click on the Save button to close the window.
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Moneris Checkout - Removing a merchant email recipient
Follow the steps below to remove a recipient from the checkout's merchant email recipient list thereby preventing them from receiving confirmation email regarding approved/declined transactions that are processed through the checkout.
- Ensure the checkout profile that you want to configure is open on your screen and the checkout's email content and permissions are set (see Moneris Go portal - Moneris Checkout - configuring the checkout's "Email Communication").
- While the profile's "Email communication" module is open in your configurator (shown partially below), go the "Merchant email recipients" list, and do the following:
- Locate the recipient that you want to remove, and click on its Delete
icon.
- When the "Delete email recipient" dialog displays (shown below), click on the Yes button to close the dialog.
Note: When the page refreshes, the deleted recipient address will no longer be listed in the "Merchant email recipients" area. Repeat these steps to remove another recipient addresses as desired.
- Locate the recipient that you want to remove, and click on its Delete
- Save the profile's new configuration:
- Click on the Save profile button.
- When the "Successfully updated the profile" response displays, the operation is complete:
- To preview a full-screen version of the checkout, see Moneris Go portal - Moneris Checkout - Previewing the checkout.
- To configure other profile settings, see Moneris Go portal - Moneris Checkout - List of Moneris Checkout features/settings.
- To exit the MCO configurator, click on the Go back button (unsaved changes will be discarded).
Moneris Go portal - Hosted tokenization
Moneris Go portal - Hosted tokenization - How to get started
The steps below describe what you need to do to integrate Moneris Hosted Tokenization into your ecommerce solution. The Moneris Hosted Tokenization (HT) is a solution that you can integrate into your ecommerce site if you prefer not to handle credit card numbers directly but still want the ability to fully customize your checkout page appearance.
How it works
Moneris Gateway will, on your behalf, present text boxes on your checkout page. The cardholder then enters their credit card information into the text boxes. When the payment information is submitted through your checkout page, Moneris Gateway generates a temporary token representing the credit card number. This token is then used in an API call to process a financial transaction directly with Moneris. When your server receives a response to the financial transaction, it generates a receipt and allows the cardholder to continue with their online shopping experience.
To begin, please follow the How to get started steps below:
- Ensure your Moneris Go portal user account is activated, and you can log in and access your Moneris Go portal store (for setup instructions, see Moneris Go portal - How to get started).
Note: Your user account must be enabled with full administrative access and user-level permissions so that you can perform the setup and configuration steps as directed below. (Contact your store administrator if you need to have these permissions enabled.) - Review and configure your ecommerce solution per the specifications in the Hosted Tokenization Merchant Integration Guide (this guide is available on the Moneris Developer Portal.
Note:If you need to view or copy your store's API token, see Moneris Go portal - API token. - Create the hosted tokenization profile (see Moneris Go portal - Hosted tokenization - Creating a Moneris Hosted Tokenization profile).
Moneris Go portal - Hosted tokenization - Creating a Moneris hosted tokenization profile
The steps below describe how to create a new Moneris hosted tokenization profile.
Important! To integrate Moneris hosted tokenization into your ecommerce solution, you need to create and configure your hosted tokenization profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Hosted tokenization - How to get started.
- Log into the Moneris Go portal, and access the store through which you want to create the hosted tokenization profile (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account , you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, click on the Hosted Tokenization tab to display the hosted tokenization control panel page (shown below).
Note: Any saved profiles are listed on this page. - Click on the Create profile button.
- When the "Create profile" window displays (shown below), do the following:
- In the Source URL field, enter the address for the main outer page that will send transactions to Moneris.
- In the Profile alias field, enter a customized alias that describes the profile.
Note: A unique alpha-numeric profile ID will be assigned to the profile once it is created. - Click on the Create profile button.
- When the "New profile" window displays (shown below), do the following:
- If you want to copy the profile ID to your clipboard now, click on the Copy
icon in the window.
Note: This ID must be included in your HTML iFrame code as specified in the integration guide. - When you are finished, click on the OK button to close the window.
- If you want to copy the profile ID to your clipboard now, click on the Copy
- When you confirm that the new profile is listed in the profiles list, the operation is complete.
Note: The profile alias, profile ID, and source URL are displayed in the profiles list.
Moneris Go portal - Hosted tokenization - Deleting a Moneris hosted tokenization profile
Follow the steps below to delete a Moneris Hosted Tokenization profile.
Important! To integrate Moneris hosted tokenization into your ecommerce solution, you need to create and configure your hosted tokenization profile in conjunction with developing your ecommerce solution according to Moneris' integration specifications as outlined in Moneris Go portal - Hosted tokenization - How to get started.
- Log into the Moneris Go portal, and access the store containing the hosted tokenization profile that you want to delete (see Moneris Go portal - Logging into the Moneris Go portal).
Note: If you have multiple stores linked to your user account , you can use the My Stores function to move between your stores (see Moneris Go portal - Using My Stores). - On the sidebar menu (shown below), click on Settings > Developer tools.
Note: If the sidebar menu is not displayed on your screen, click on the "menu" iconin the top left corner of your screen, or expand your browser window to display the sidebar menu.
- When the "Developer tools" page displays, click on the Hosted Tokenization tab to display the hosted tokenization control panel page (shown below).
- Locate the hosted tokenization profile that you want to delete, and click on its Delete
icon.
Note: To retrieve a specific profile, go to the Search by profile alias, profile ID, or source URL field, and enter a full or partial alias, ID, or URL.
To change the number of profiles listed on the page, click on the "Show # items per page" drop-down, and select a number (10, 25, or 50). To advance to the next page or last page, click on the Next page > icon or the Last page >> icon respectively. To go back to the previous page or the first page, click on the Previous < icon or the First page << icon respectively. - When the "Delete profile" dialog displays (shown below), click on its Yes button.
- When the "Profile deleted successfully" response displays, the operation is complete.
Note: The deleted profile will be de-listed from the profiles list.