Back Office Configuration

An overview of all transactions and Converge related settings can be found in the Converge BackOffice:

After successful installation, please follow the steps below to configure the various integration options supported by this plugin.

Login to the Magento Admin Panel and navigate to Stores -> Configuration under the Sales heading click the Payments Methods.

On top of the page there will be a field called Store View, where you can find different levels for your configuration. Choosing one of the levels available will influence the fields available for configuration for the Converge Gateway payment method.



Figure 0-3 Magento Admin -- Configuration level

The only field from the configuration page available for the store level is the title of plugin.

Under the OTHER PAYMENT METHODS section you can find Converge Gateway configuration panel. The configuration panel contains three sections:

  • The first section is displayed right after the Converge Gateway title
  • The second section - "Basic Converge Payment Settings"
  • The third section - "Advanced Converge Payment Settings"


*Figure 0-4 Magento Admin - Plugin Configuration*

Converge Gateway Configuration

This section is displayed under the title of the payment method, the other two sections being collapsed by default.

Environment

This dropdown is used to switch between Sandbox and Production environment. By default Sandbox is selected and this enables users to test out payment method without using real credit cards.



*Figure 0-5 Magento Admin -- Environment*

Converge Gateway Region

This option has currently only one value, Converge NA. Converge EU will be added once the functionalities are available.



*Figure 0-6 Magento Admin -- Gateway Region*

Module version

This option is not configurable, it is showing the currently installed version of Converge plugin.



*Figure 0-7 Magento Admin -- Module Version*

Merchant ID, User ID and User PIN

To configure the plugin to work with Converge, you will need to have the following data:

  • Converge Merchant ID
  • Converge User ID
  • Converge User pin


*Figure 0-8 Magento Admin -- Converge connection data*

Terminal name

This field represents the name provided by Converge once a new terminal is setup. The values for this field is displayed after you click on the "Terminal Setup".



*Figure 0-9 Magento Admin -- Terminal name*

Basic Payment Settings

Title

This option allows you to enter a specific title. By default, the title is set to Payment method (ConvergeGateway).



*Figure 0-10 Magento Admin -- Title*

Enabled

By default this option is set to NO and it needs to be changed to YES for Converge plugin option to show up on checkout page.



*Figure 0-11 Magento Admin -- Enabled*

Recurring Enabled

The value for this field is determined based on the options supported by the terminal and cannot be edited. Also, the value for this field determines if the section for subscriptions from the product configuration is displayed or not



*Figure 0-12 Magento Admin -- Recurring Enabled*

error_outline
important

If recurring is enabled on the terminal, the following options are not currently supported:

  • Wallets/gift cards will not be supported
  • HPP will not be displayed as an integration method

Payment Action

This dropdown enables user to select how he wants transaction to be captured in Converge:

  • Authorize -> Order amount will only be authorized on Credit Card used for the transaction, and merchant will have to create invoice to capture this amount from Magento.
  • Authorize and Capture -> Sale transaction will be captured for this option, invoice will be created automatically and no additional action is needed from merchant side for this transaction to be settled.


*Figure 0-13 Magento Admin -- Payment Action*

Integration Method

This dropdown enables user to select the integration method:

  • Hosted Payment Page (PCI SAQ A) -> the merchant redirects the customer away from the merchant\'s website to the securely externally-hosted HPP.
  • Checkout.js (PCI SAQ A-EP) -> this is an integration method where the webpage is generated by Magento and displayed on the cardholder browser. The Payment data is collected on the browser and sent to Converge for processing. The response is sent back to the browser and appropriate action taken.


*Figure 0-14 Magento Admin -- Integration Method*

License Code

This value for this field is provided by Converge and should be sent with each transaction.



*Figure 0-15 Magento Admin -- License code*

Save for later use message

This field allows the merchant to define a message that is displayed to the user when he is trying to save card from later use.



*Figure 0-16 Magento Admin -- Save for later use message*

Disclosure message for subscription options

This field allows the merchant to define a message that is displayed to the user when he is trying to place an order with subscription products. The default message will be: "By placing your order, you agree to the recurring charges." This message will be displayed to the customer next to the Place Order button.



*Figure 0-17 Magento Admin -- Disclosure message for subscription options*

Advanced Payment Settings

Merchant name

This option is not editable and it will be loaded from Converge.



*Figure 0-18 Magento Admin -- Merchant name*

Region

This option is not configurable and it will be loaded from Converge, displayed to the user and used to limit the selection for other options like the language.



*Figure 0-19Magento Admin- Region*

Payment Types Accepted

This field is not configurable, it is displaying the available options for the selected terminal. Besides the response from Converge Terminal, the options are influenced by the Payment action type. If Authorize option is selected, all options except Credit Card are removed.

The possible values are:

  • Credit Card
  • ACH
  • Gift Card


*Figure 0-20 Magento Admin- Payment Types Accepted*

Credit Cards Accepted

This field is not configurable, it is displaying the available options for the selected terminal. The possible values are:

  • VISA
  • Master Card
  • American Express
  • Discover
  • JCB (Japan Credit Bureau)
  • CUP (China UnionPay)


*Figure 0-21 Magento Admin- Credit Cards Accepted*

Wallets enabled

This field is not configurable, it is displaying the available options for the selected terminal. The possible values are:

  • Masterpass
  • VISA Checkout
  • PayPal
  • Apple Pay


*Figure 0-22 Magento Admin- Wallets enabled (1/2)*

Please note that if the recurring functionality is enabled, wallets will be disabled. The wallets form this field will be hidden and replaced with the message "None - Recurring is enabled".



*Figure 0-23 Magento Admin- Wallets enabled (2/2)*

Currency Conversion

Values for this option are loaded from Converge, displayed to the user and use only to show the possible features in the future.

The possible values are:

  • Multi-Currency Conversion -- coming soon

  • Dynamic Currency Conversion -- coming soon

*Figure 0-24 Magento Admin- Currency Conversion*

Language Translations

This field is a dropdown where the language options are displayed for a selected region.



*Figure 0-25 Magento Admin-Language Translations*

Value Added Service

Values for this option are loaded from Converge, displayed to the user based on terminal settings. The possible values are:

  • Recurring billing - if this option is available for the terminal, the merchant will be able to configure subscriptions for a product.
  • Tokenization - if the terminal allows tokenization, the customers will have the option to save cards for later use.
  • Level 3 data - this options allow sending additional data with each transaction based on the data provided by the merchant.
  • 3D Secure - if this option is enabled for the terminal, the transactions will be authenticated using 3D Secure in case the card is enrolled for 3DS.


*Figure 0-26 Magento Admin-Value Added Service*

Log level

This fields allow you to define the level for the logging. The options are Debug, Error and Critical. These values indicate the severity, Debug being the lowest level and Critical the highest one. By default, the values is set to Debug.

*Figure 0-27 Magento Admin-Log Level*

Currency Setup

Based on terminal settings, the values for Base Currency, Default Display Currency and Allowed Currencies from Stores -> Configuration -> General -> Currency setup will be filled automatically and the fields will be disabled. Therefore, it will not be allowed to change those values.

*Figure 0-28 Magento Admin - Currency setup*