Back Office Configuration

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

  1. Login to the OpenCart Admin Panel.

  2. Go to Extensions | Extensions | Payments.

  3. Tick Edit Elavon Converge EU Gateway Payment Settings

    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.

Enable/Disable droplist field shown with No or Yes options

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.

The Environment droplist field shown with Sandbox or Production options

Title

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

Title text field shown with Elavon Converge EU Gateway as the default entry

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.

Debug Log droplist field shown with Yes or No options

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.

Process Account Id text field shown as blank

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.

Merchant Name text field shown as disabled because the value is automatically received

Merchant Alias

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

Merchant Alias text field shown as blank

Public key

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

Public Key text field shown as blank

Secret key

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

Secret Key text field shown as blank

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 OpenCart orders screen.

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

Payment Action droplist field shown with Authorize and Delayed Capture or Authorize and Immediate Capture as options

Integration Option

Enable Lightbox if you would like to display the Elavon Converge EU Gateway hosted payments page as a pop-up on the OpenCart 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 OpenCart checkout page. (Cardholder information is collected securely and not stored on merchant server).

Integration Option droplist field with HPP (PCI SAQ A) or Lightbox (PCI SAQ A) options

Enable Saved Payment Methods

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 droplist field with No or Yes options

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 Code text field shown 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.

Name text field shown as blank

Phone

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

Phone text field shown as blank

URL

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

URL text field shown as blank

Proxy Setting

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

 

Next: Shopper View