Elavon Payments

Set-up and installation

The first step in setting up your WooCommerce-powered online store is to install WordPress and the WooCommerce plugin itself. Before doing so, make sure to check your hosting environment.

Requirements for WordPress:

  • PHP version 7.2 or greater
  • MySQL version 5.6 or greater OR MariaDB version 10.0 or greater
  • WordPress memory limit of 128 MB or greater
  • HTTPS support

Instructions to install WooCommerce: https://docs.woocommerce.com/document/installing-uninstalling-woocommerce/

Once the online store is ready, you will then need the following information from Elavon’s Helpdesk to get started – these details will be communicated via e-mail to the lead contact on the account – usually within 24-48 hours of the application being approved:

  • Processor Account ID
  • Merchant Alias
  • Public Key
  • Secret Key

There is one way to install the Elavon Payments WooCommerce Plugin:

  1. Visit the relevant page in the WooCommerce Extensions store for ‘Elavon Payments’
  2. Click ‘Add to Store’ from the Product page
  3. Once added, enter the URL of the store where you’d like to install the extension
  4. The extension will then be successfully installed within a few seconds
  5. Login to your WordPress backend.
  6. Select the Plugins tab on the sidebar underneath WooCommerce.
  7. Navigate down to ‘WooCommerce Elavon Converge EU Gateway’
  8. Ensure that the plugin is activated and installed

Upgrade from a Previous Version

If there is a previous version of the plugin already installed, you should deactivate and uninstall it before you proceed with installing a new version.

  1. Login to your WordPress Admin Panel.
  2. Click the Plugins tab.
  3. Scroll down to the WooCommerce Elavon Converge EU Gateway plugin and click Deactivate.
  1. After successful deactivation, click Delete.

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

  1. Login to the WooCommerce Admin Panel.
  2. Navigate to Settings | Payments.
  3. Select the Elavon Converge EU Gateway to see the options available for configuration.
  1. Configure the options below:

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

Environment – This option allows you to switch between sandbox and production environments. Enable Sandbox to send transactions to your Elavon Converge EU Gateway “Test/UAT” Account. Enable Production to send transactions to your “Live Production” Account. Note that the credentials for each environment are different.

Title – This option allows you to enter a specific title, this will be displayed as the payment method title which the customer will see during the checkout process. By default, the title is set to Elavon Converge EU Gateway.

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, but as a best practice, do not enable this unless you are having issues with the plugin.

Processor Account Id – The Processor Account Id is a unique ID that is used to identify merchants when connecting to Converge. The ID will be provided by the Elavon Converge Helpdesk.

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 Alias – The Merchant Alias is a unique ID that acts as a username for authentication. The ID will be provided by your Elavon Converge Helpdesk.

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

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

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 has been submitted. This can be completed via the WooCommerce orders screen. By default, this is 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 WooCommerce payment page (uses javascript to show a pop-up window which appears seamlessly, keeping customers on your site for payment).
  • Enable HPP if you would like to redirect the customer directly to the hosted payment page on Elavon servers from the WooCommerce checkout page. (Cardholder information is collected securely and not stored on merchant server).

Enable Saved Payment Methods – By default, this option is disabled. This needs to be checked 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).

License Code – This value for this field is provided by Converge and should be sent with each transaction. Note that his field is optional and can be left blank.

Dynamic Descriptor Settings – The options under this section affect what appears on your customer’s credit card statement.

  • Name – The value in the business name field of a customer’s statement. Company name/DBA section and the product descriptor will contain an * in between. The name must be a max of 25 characters.
  • Phone – The value in the phone number field of a customer’s statement. The phone must be a maximum of 20 characters.
  • URL – The value in the URL/web address field of a customer’s statement. The URL must be 13 characters or shorter.
  • Proxy Setting – If your system uses a proxy server to establish the connection between WooCommerce and Converge, set API Uses Proxy to “Yes” and complete the Proxy Host and Proxy Port fields.

    Shopper View

    The following is an overview of the main features in the daily usage of the WooCommerce Converge plugin.

    Placing an Order

    To create a new Authorization Only transaction using Elavon Converge EU Gateway plugin, make sure that the Payment Action is set to Authorize and Delayed Capture, along with other options:

    • Enabled/Disable = Checked; Environment = Sandbox (in case of test transaction); Processor Account ID, Merchant Alias, Public Key, Secret Key = valid data provided by Converge
    • Payment Action = Authorize and Delayed Capture

    To create a new Sale transaction, only the Payment Action option should be changed:

    • Enabled/Disable = Checked; Environment = Sandbox (in case of test transaction); Processor Account ID, Merchant Alias, Public Key, Secret Key = valid data provided by Converge
    • Payment Action = Authorize and Immediate Capture

    The payment procedure is similar for guests and logged in users. To initiate a payment via Converge:

    1. Access the Checkout page from the WooCommerce store view.
    2. Populate the Billing and Shipping Addresses.
    3. Select the Elavon Converge EU Gateway as a payment method
    4. Click Place Order.

    Payment via Hosted Payments Page (HPP)

    If HPP is selected in the configuration page, the HPP opens once the user selects Elavon Converge EU and places the order.


    The actual HPP screen may vary depending on the options enabled in Converge. To configure the HPP, refer to the Hosted Payments section.

    From this page, two options are available:

    • Cancel Payment
    • Pay

    HPP – Cancel Payment

    If the user selects Cancel, the payment and the order are cancelled, and the user is redirected to the shopping cart. If needed, the user can then initiate a new order with the same products.

    HPP – Checkout

    To continue with the order:

    1. Enter the card details (number, expiry date, and security code) plus an e-mail address to receive an instant receipt notificaton
    2. Click Pay Now.

    Two possible outcomes can happen after you click Pay:

    • Payment is Declined
    • Payment is Accepted

    HPP Checkout – Declined

    When your payment is declined, you will be redirected to WooCommerce from where you can try to pay for the order again.

    HPP Checkout – Accepted

    When a payment is accepted, the user is redirected to WooCommerce where the details for the order are displayed.

    Payment via Lightbox

    If Lightbox is selected in the configuration page, the checkout page will be the same as if HPP was selected. If you continue, a new page displays containing information about the order (number, date, total and payment method) and the option to “Pay with Converge”.

    Selecting Pay with Converge opens the pop-up where you can enter the card details and pay.

    Similar to payment with HPP, the payment can be accepted or declined, and the behaviour in each case is the same.

    Stored Shopper

    For the logged-in users that select the option Save for later use on the checkout page, the details are saved in Converge. If a user changes the details (name, address) and creates a new order using the Save for later use option, the profile is also updated in Converge.

    Stored Card

    Add Card

    Logged in users have additional options to store credit cards used for payment on HPP so that it can be used for future payments without leaving the WooCommerce store. In order to do this, you need an active account created in the WooCommerce store and to be logged in before reaching the checkout page. After doing that, on the checkout page, there is an additional option to store card for later use.

    Once you make a successful payment with this option selected, the card used to process payment in both Converge and WooCommerce is saved.

    To view cards stored in WooCommerce, you should navigate to the following screen: WooCommerce Store (Logged In) -> My Account -> Payment methods.

    Delete Card

    You have an option to delete a stored card directly from WooCommerce. Click Delete next to the card to delete it from Converge. If the merchant deletes a card from Converge, synchronization with WooCommerce does not exist so the user is still able to see the card in WooCommerce with an option to delete it manually themselves.

    Edit Card

    You have an option to edit the Expiry Date and the Card Code for a stored card. Click Edit next to the card.

    Add Payment Method

    You have an option to add a stored card directly from the Payment Methods section. Click Add payment method under the list of stored cards.

    Pay with Stored Card

    Once the card is stored, you can use it to initiate a payment. To do that, perform the same steps for HPP payment for the logged-in user until the checkout page. The stored cards will be visible in the Payment Method section and you can select one of them to pay for the next order.

    Once you click the Place Order button, an API call to Converge will be made in the background, and depending on the response, you will get one of the following:

    • Error message – in case the payment is declined by Converge.
    • Newly created order number – in case the payment is accepted by Converge.

    Merchant View

    As a merchant, you are able to perform additional actions on transactions that have been already created directly from the WooCommerce Admin page.


    Merchants who choose to authorize only at checkout (Authorize and Delayed Settlement) can capture their orders for a fixed period of time after the initial authorization.

    1. Navigate to WooCommerce | Orders.
    2. Click the order you want to capture.


    You should be able to void a sale transaction if the transaction is in the correct state (Authorized or Captured).

    1. Navigate to WooCommerce | Orders.
    2. Select the order you want to void.
    3. When you click on Void button in WooCommerce, this transaction will be voided in Converge and the status of the order in WooCommerce will be Cancelled.

    Refund – Full and Partial

    You should be able to partially or fully refund a transaction if the Converge status is CapturedSettled, or SettlementDelayed.

    1. Navigate to WooCommerce | Orders.
    2. Select the order you want to refund.
    3. Click the grey Refund button to start.
    4. Specify the refund amount.
    5. Add refund notes in the Reason for refund field. This is optional.
    6. Click Refund £X via Elavon Converge EU Gateway, where X is the amount to be refunded (updates automatically).


    For full refunds, the amount should be equal to the total available to refund amount. For partial refunds, the amount should be smaller than the entire amount.

    In the Order Items, there will be a note that will be added to inform you that a refund has been processed. If a refund has been completed for the entire order, the order status will be automatically changed to Refunded.


    Subscriptions have different functionalities depending on who the viewer is. For more information, read through the guides for each view.

    Subscriptions – Merchant View

    As a merchant, you can define which products allow subscriptions, view and edit subscription records, and create an order with subscription products.

    Product Configuration

    If subscriptions are enabled, you can create a subscription product. Go to WooCommerce > Products and create a new product or edit the product you want to turn into a subscription. Select Converge subscription or Converge variable subscription as the product type.

    Set the terms for the subscription, including the following:

    • Subscription Price
    • Introductory Rate (optional)
    • Billing Frequency (daily, weekly, monthly, early)
    • Ending

    The Converge variable subscription product type is similar to Variable product. Each variation in a Converge variable subscription contains the options for subscriptions: Subscription Price, Introductory Rate, Billing Frequency, and Ending.

    View and Edit Subscriptions

    As a merchant, you can view the list of subscriptions under WooCommerce > Converge Subscriptions.

    If you select one of the subscriptions, you can view more details and edit it.

    If the WooCommerce status is not synchronized with the Converge status of a subscription, you will be notified to update it.

    If the status allows, you can cancel the subscription.

    Renewal orders are manually created. Check the transaction history and create orders for the transactions that have this option.

    Subscriptions – Customer View

    As a customer, you can purchase one or more subscription products. Once your order has been created, you can view and manage your subscriptions.

    Placing an Order with Subscription Products

    You can select products with subscriptions from the store and add them to the cart. After choosing a subscription product, the details can be reviewed by opening the shopping cart.

    The initial order will contain the list of related Converge subscriptions.

    View and edit subscriptions

    Customers can view their subscriptions by navigating to the following screen:

    WooCommerce Store > My Account > Converge Subscriptions.

    After selecting a subscription, you can view the details about the status, products, and related orders. Also, if the status allows, you can change the payment method or cancel the subscription.