Back Office Configuration

Once the plugin is successfully installed, follow the steps below to configure the various integration options supported:

  1. Log in to the Magento Admin Panel.

  2. Go to Store | Configuration | Sales | Payment Methods.

  3. On the right-hand panel, under the Elavon Converge EU Gateway section, select Yes to enable.

    The options available for configuration display.

Enable/Disable

By default, this option is disabled. This needs to be checked to ensure the Converge plugin option displays on the checkout page.

Yes option selected in Enable/Disable field

Environment

This option allows you to switch between the sandbox and production environments. Select Sandbox to send transactions to your Elavon Converge EU Gateway “Test/UAT” Account, and Production to send transactions to your “Live Production” Account.

Note: The credentials for each environment are different.

Sandbox option selected in the Environment field

Title

This option allows you to enter a specific title; this displays as the payment method title which the shopper sees during the checkout process. By default, the title is set to Elavon Converge EU Gateway.

Empty Title field

Debug Log

Debug logging can be enabled if you are having issues processing transactions correctly.

All debugging messages are cleaned of sensitive information before being displayed. However, do not enable this unless you are having issues with the plugin.

Yes selected in the Debug Log field

Processor Account Id

This is a unique ID used to identify merchants when connecting to Converge. The ID is provided by the Elavon Converge Helpdesk.

Empty Processor Account Id field

Merchant Name

Trading as, operating as, doing business as, fictitious, or assumed name, which may be different than the legal name. This value is automatically received from Converge based on the value for the Processor Account Id.

Empty Merchant Name field

Merchant Alias

This is a unique ID that acts as a username for authentication. The ID is provided by your Elavon Converge Helpdesk.

Empty Merchant Alias field

Public key

The public key for your account, provided by your Elavon Converge Helpdesk.

Empty public key field

Secret key

The secret key for your account, provided by your Elavon Converge Helpdesk.

Empty Secret Key field

Payment action

This option controls how transactions are submitted to Converge. You may select either Authorize and Immediate Capture or Authorize and Delayed Capture. If you select Authorized and Delayed Capture, you must initiate a manual capture after the transaction is submitted. This can be completed via the Magento 2 orders screen.

By default, this is set to Authorize and Immediate Capture.

Payment Action field set to Authorize and Immediate Capture

Integration option

Enable Lightbox if you would like to display the Elavon Converge EU Gateway hosted payments page as a pop-up on the Magento 2 payment page (uses JavaScript to show a pop-up window which appears seamlessly, keeping shoppers on your site for payment).

Enable HPP if you would like to redirect the shopper directly to the hosted payment page on Elavon servers from the Magento 2 checkout page. (Cardholder information is collected securely and not stored on merchant server).

Integration Option field set to Lightbox (PCI SAQ A)

Enabled Saved Payment Method

By default, this option is disabled. This needs to be enabled to ensure the saved cards and Save for later use options are displayed on the checkout page.

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 a card for later use. The default value is: “By placing your order, you agree with your card details being saved.”

Converge Email

This option allows you to choose if Converge should send emails to the shopper’s email address. By default, this option is set to No (disabled).

Converge Email field set to Yes

License Code

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

Note: This field is optional and can be left blank.

License Field showing as blank

Dynamic Descriptor Settings

The options under this section affect what appears on your shopper’s credit card statement.

Name

The value in the business name field of a shopper's statement. Company name/DBA section and the product descriptor contain an * in between. The name must be a max of 25 characters.

The Name field showing as blank

Phone

The value in the phone number field of a shopper's statement. The phone must be a maximum of 20 characters.

The Phone field showing as blank

URL

The value in the URL/web address field of a shopper's statement. The URL must be 13 characters or shorter.

The URL field showing as blank

Proxy Settings

If your system uses a proxy server to establish the connection between Magento and Converge, set API Uses Proxy to “Yes” and complete the Proxy Host and Proxy Port fields.


 

Next: Shopper View