Introduction and Installation

This guide contains step-by-step instructions on installing the Converge plugin for Magento. It also shows how to use all the plugin's features. In order to get started, you must have the following items:

  • Converge Merchant ID
  • Converge API User ID
  • Converge User PIN
  • Download the plugin below

The plugin is compatible with versions of Magento: Community 2.2.7 +

The plugin is not compatible with versions of Magento: Community earlier than 2.03

To integrate using Magento, you will need to contact the Software Technical Support Team or Customer Service at 1-800-377-3962 | Option 2 | Option 2 to:

  • Register and whitelist the IP address and Web URL of your server.
  • Set a Converge User ID with a Hosted Payment API User status with permission to post a session token request.
  • Associate the Converge User ID with the eCommerce terminal.

Installation Steps

1.1 Installation Requirements and Guide for Magento 2

You have to install Magento 2 before you can install the Converge plugin for Magento.

Magento provides a list of the requirements for installing Magento 2 on their website.

To install Magento 2, please follow the Magento Installation Guide available

error_outline
important

Only Linux distributions support Magento.

Magento is not supported on machines running Windows or Mac OS.

Please see the Magento site for more detail:

1.2 Installation for Converge Plugin using COMMAND LINE

  1. Download the plugin.

  2. Unzip archive

  3. Login to your Magento 2.x hosting site using SSH connection

  4. Open the Magento root directory

  5. The content of unzipped extension should be copied into the Magento "app/code" folder

    Magento root folder structure should look like this


    The files structure of a program open in an IDE.


    *Figure 0-1 Folder structure*
  6. To enable module from console line open the Magento root directory and run command:

    bin/magento module:enable Elavon_ConvergePayment

    *Figure 0-2 List of modules*

    The list of enabled modules can be checked with the following command: bin/magento module:status

  7. To update the database schema and modules run command: bin/magentosetup:upgrade

  8. To clear the cache run the command:bin/magento cache:flush

This completes the module installation.