====== Magento 2 Moneris Payment Extension ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide in the **Checkout & Payments** category. Use this page for installation, configuration, validation, and payment troubleshooting.

  * **Module name**: `Toweringmedia_Moneris`
  * **Composer package**: `toweringmedia/module-moneris`

===== Quick links =====

  * [[https://toweringmedia.com/moneris-payment-gateway-for-magento-2-hyva-react-checkout|Moneris Payment Gateway for Magento 2 product page]]
  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]]
  * [[magento2:extensions:toweringmedia-module-authorizenet|Magento 2 Authorize.Net Payment Extension]]

===== Overview =====

The Moneris extension adds first-party Moneris payment processing for Magento 2 checkout, including support for tokenized card handling and optional 3-D Secure controls.

Key capabilities:
  * Direct card flow support for compatible checkout implementations.
  * Hosted tokenization support where enabled.
  * Risk and fraud controls (AVS/CVD/3DS policy based on configuration).
  * Compatibility with React Checkout Pro payment stacks.

===== Installation =====

Install via Composer:

<code bash>
cd /path/to/magento
composer require toweringmedia/module-moneris:<VERSION>
php -d memory_limit=-1 bin/magento setup:upgrade
php -d memory_limit=-1 bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

===== Versioning notes =====

  * Pick the version you are licensed for.
  * To see available versions for your credentials:
    * `composer show -a toweringmedia/module-moneris`

===== Configuration =====

Primary config area:
''Stores > Configuration > Sales > Payment Methods > Toweringmedia Moneris''

Recommended setup order:
  - Enable method in sandbox mode first.
  - Configure Store ID and API token for the correct environment.
  - Set 3DS mode (`Off`, `Attempt`, or `Require`) based on risk policy.
  - Configure AVS/CVD rules.
  - Save config, flush cache, and run checkout test transactions.

===== Validation checklist =====

  * Payment method appears at checkout in target store views.
  * Sandbox test transaction succeeds end-to-end.
  * 3DS behavior follows configured mode where applicable.
  * Tokenization flow returns required token/data key before place order.
  * Orders, invoices, and payment details persist correctly in admin.

===== Troubleshooting =====

  * **Method not visible**: verify enablement, scope config, and checkout payment grouping.
  * **Token generation error before order**: confirm hosted tokenization configuration and browser script/iframe loading.
  * **Checkout submit fails**: redeploy static assets and verify API credentials/environment alignment.
  * **3DS mismatch**: re-check 3DS mode policy and test-card scenarios in sandbox.

===== SEO and conversion links =====

  * [[https://toweringmedia.com/moneris-payment-gateway-for-magento-2-hyva-react-checkout|Moneris Payment Gateway for Magento 2 Hyva React Checkout]]
  * [[https://toweringmedia.com/magento-2-react-checkout-pro-bundle|Magento 2 React Checkout Pro Bundle]]
  * [[https://toweringmedia.com/magento-2-extensions|Magento 2 Extensions Catalog]]
  * [[https://toweringmedia.com/magento-2-development-services|Magento 2 Development Services]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]]
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro-express|Magento 2 React Checkout Pro Express Extension]]
  * [[magento2:extensions:toweringmedia-module-authorizenet|Magento 2 Authorize.Net Payment Extension]]