WooCommerce Elavon Converge

Overview ↑ Back to top

WooCommerce Elavon Converge lets your customers pay for orders with a credit card or eCheck directly on your WooCommerce store or via Checkout.js for additional security. This gateway supports tokenization for full support of WooCommerce Subscriptions and WooCommerce Pre-Orders, in addition to letting your customers save their credit cards for easier checkout.

Elavon Converge is only available for merchants in the United States and Canada.

Requirements ↑ Back to top

  • WooCommerce 3.5+
  • WordPress 5.2+
  • PHP 7.0+ (you can find this under WooCommerce > Status)
  • An SSL certificate
  • An active Elavon account. Contact Elavon to open an account.

⚠️ There are also some additional requirements related to your Elavon merchant account:

  • Your Elavon account must be set up for eCommerce, not only Phone / Catalog. Contact your merchant representative for assistance.
  • Your Elavon account must be set up to support SSL. Contact your merchant representative for assistance.
  • Elavon requires that your store have a “Shipping Policy” page.
  • In your Elavon account, ensure that only fields sent to Elavon by this plugin are required. You don’t have to require these fields, but you must not require fields that the plugin does not send.
  • If you intend to use the following features, they must first be enabled in your Elavon account by contacting your Elavon representative:
    • Use tokenization to support Subscriptions, Pre-Orders, and saved payment methods. Ask your representative about any other account settings that are required to support tokenization to ensure it’s fully supported by your merchant account.
    • Allow payment authorizations instead of immediately capturing payment.
    • Process refunds in WooCommerce.
    • Accept eCheck payments.
    • Support multi-currency transactions.
  • If you intend to use Checkout.js for improved PCI compliance, you must complete a few additional requirements:
    • Call Elavon support at 1-800-377-3962 | option 2 | option 2, and ask to whitelist your URL and IP address and set your API user with permission to post a session token request. You’ll need your account ID handy! Make sure to ask about any other settings you’ll need to take care of for Checkout.js.

Installation ↑ Back to top

  1. Ensure your store meets the plugin requirements.
  2. Download the extension from your WooCommerce dashboard.
  3. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded.
  4. Click Install Now and then Activate.
  5. Click Configure and read the next section to learn how to set up the plugin.

Getting started ↑ Back to top

Follow the steps below to find the credentials required to connect your site to Elavon:

  1. Login to your Converge account.
  2. Go to Employees and select the employee with the name “apiUser”.
  3. Navigating to the Employees tab and selecting the API employee in the Elavon control panel.

  4. On this page, you can find the Account ID in the top-right corner, the User ID in the User Information section, and the PIN by clicking Show PIN.
  5. Finding credentials required for plugin in Elavon control panel.

  6. Copy these credentials to paste in the plugin settings.
Note: You may have additional steps to complete based on the gateway features you want to use! Click here to review the plugin requirements.

Credit card settings ↑ Back to top

You can configure the following settings for the Elavon Converge credit card gateway:

  • Enable / Disable: Allow customers to use this gateway to checkout.
  • Title: The name shown for the payment during checkout and on the Order Received page.
  • Description: The text shown under the gateway’s title during checkout. Limited HTML is allowed.
  • Card Verification (CSC): Require customers to enter their card security codes when checking out. This can be useful if you have requirements in your Elavon account for CV2 verification.
    • Saved Card Verification: Display the Card Security Code field when customers are paying with a saved credit card.
  • Transaction Type: Controls how transactions are submitted to Elavon. Select “Charge” to automatically capture payments. If you select “Authorization”, you must manually capture and settle payments in your Elavon control panel or on the WooCommerce orders screen after the transaction has been submitted. Your Elavon account must allow “Authorize Only” transactions to use the “Authorization” setting. Click here to read more about capturing transactions.
    • Charge Virtual-Only Orders: If Transaction Type is set to “Authorization”, enable this to automatically capture charges for orders with only virtual products. For downloadable products, this will grant downloads access right away.
    • Capture Paid Orders: If Transaction Type is set to “Authorization”, enable this to automatically capture charges when orders move to a paid status.
  • Accepted Card Logos: Determines which card logos are displayed during checkout. This has no impact on which cards are accepted by your merchant account.
  • Tokenization: Let customers save their payment methods for future use at checkout. This is required for Subscriptions or Pre-Orders. This must be enabled in your Elavon account before you can support tokenization in WooCommerce. Click here to read more about saving payment methods.
  • Detailed Decline Messages: Display detailed messages to customers to provide reasoning for declines instead of a generic error message when possible. Click here to read more about detailed decline messages.
  • Debug Mode: Enable when you’re having issues processing transactions. You can choose to log API requests directly on the checkout page, save them to the WooCommerce > Status > Logs page, or both. As a best practice, please do not enable this setting unless you’re having issues with the plugin.
  • Environment: Switch between “Demo” and “Production” credentials. Set to “Demo” to send transactions to an Elavon demo account for setup / troubleshooting. Ask your Elavon representative for test credit card numbers to use in demo mode.
  • Share connection settings: If using the credit card and eCheck gateways, select this setting to share credentials between the gateways so you don’t have to enter them twice.
  • Account ID: Follow the steps above to retrieve your account ID.
  • User ID: Follow the steps above to retrieve your user ID.
  • PIN: Follow the steps above to retrieve your PIN.
  • Checkout.js: Enable to send payments over Elavon’s servers, reducing your site’s PCI compliance burden. Click here to review the requirements for Checkout.js.
  • Multi-Currency: Enable process transactions in a currency other than your terminal currency for Visa and Mastercard only. Multi-currency must be enabled in your Elavon account before you can support it in WooCommerce. Click here to read more about multi-currency.
    • Merchant Terminal Currency: If Multi-Currency is enabled, select your terminal currency so the plugin knows when to use multi-currency versus running the transaction normally.

eCheck settings ↑ Back to top

You can configure the following settings for the Elavon Converge eCheck gateway:

  • Enable / Disable: Allow customers to use this gateway to checkout. Your Elavon account must have eChecks enabled to enable this payment method.
  • Title: The name shown for the payment during checkout and on the Order Received page.
  • Description: The text shown under the gateway’s title during checkout. Limited HTML is allowed.
  • Detailed Decline Messages: Display detailed messages to customers to provide reasoning for declines instead of a generic error message when possible. Click here to read more about detailed decline messages.
  • Debug Mode: Enable when you’re having issues processing transactions. You can choose to log API requests directly on the checkout page, save them to the WooCommerce > Status > Logs page, or both. As a best practice, please do not enable this setting unless you’re having issues with the plugin.
  • Environment: Switch between “Demo” and “Production” credentials. Set to “Demo” to send transactions to an Elavon demo account for setup / troubleshooting.
  • Share connection settings: If using the credit card and eCheck gateways, select this setting to share credentials between the gateways so you don’t have to enter them twice. We strongly recommend enabling this if you’re using both gateways!
  • Authorization Terms: Enter an authorization message that your customers will see at checkout. You can optionally use {order_total} to insert the total order value in the message.

Managing orders ↑ Back to top

As a site administrator, you can use the WooCommerce Elavon Converge gateway to manually capture charges and automatically refund/void transactions as needed.

Capture charges ↑ Back to top

⚠️ Your Elavon account must allow payment authorizations to capture charges through this process. Contact your Elavon representative for assistance.

If the Transaction Type setting is set to “Authorization”, you can manually capture these payments from the WooCommerce Orders page. Click here to read more about capturing charges.

Note: If your Transaction Type setting is set to “Charge”, you can’t use the Capture button.

Automatic refunds ↑ Back to top

⚠️ Your Elavon account must allow refunds in WooCommerce to support automated refunds. Contact your Elavon representative for assistance.

You can process credit card refunds directly in WooCommerce without needing to log into your Elavon account. Click here to read more about issuing automatic refunds from WooCommerce.

Note: Automated refunds aren’t supported for eChecks.

Void transactions ↑ Back to top

You can void transactions directly in WooCommerce in the following circumstances:

  • If your Transaction Type setting is set to “Authorization”, you can void when the transaction has been authorized but not yet captured.
  • If your Transaction Type setting is set to “Charge”, you can void when the transaction has not yet been settled (e.g. funds haven’t been transferred from the customer’s account to your Elavon account).

Elavon does not accept partial voids. If a transaction is no longer eligible to be voided, you must refund the order. Click here to read more about voiding transactions in WooCommerce.

Gateway features ↑ Back to top

Your customers can take advantage of the following features when your site uses WooCommerce Elavon Converge.

Saving payment methods ↑ Back to top

⚠️ Your Elavon account must support tokenization to allow customers to save payments or support Subscriptions / Pre-Orders. Contact your Elavon representative for assistance.

Customers can save payment methods during the checkout process or from their My Account area. This lets them quickly select payment details during future checkouts and also lets your site support Subscriptions and Pre-Orders.

Notes:

Multi-currency support ↑ Back to top

Version 2.0+ supports multi-currency via Elavon, which lets merchants run transactions in currencies other than their terminal’s base currency. This ensures your customers won’t incur foreign transaction fees when making purchases on your store, and then Elavon will convert to your account currency after processing.

Please note the the following requirements to use multi-currency:

  • You must have multi-currency enabled for your Elavon account before you can use this feature in WooCommerce. Contact your Elavon representative for assistance. If you try to run transactions when this feature isn’t enable on your Elavon account, you may see the following error at checkout: Transaction currency not allowed for this terminal.
  • Multi-currency is only available for VIsa and Mastercard transactions. If the plugin detects the order is using multi-currency, only these card icons will be displayed at checkout.
  • If your shop base currency is not USD or CAD, multi-currency support is required. The Elavon payment gateway won’t show at checkout until this is enabled, as Elavon only provides accounts in USD or CAD.
Note: WooCommerce Elavon Converge does not include currency switching functionality – there are a number of plugins that support this feature, but we recommend Aelia’s Currency Switcher for WooCommerce, which works with this plugin and is tested with most WooCommerce extensions.

Enhanced checkout form ↑ Back to top

Elavon Converge supports an enhanced checkout form that improves the checkout experience on mobile and desktop devices. Click here to read about the enhanced payment form. You can also enable Checkout.js to process transactions securely on a hosted payment page. Customers will appear to remain on your site, but their payment details will never touch your site’s servers, supporting SAQ-A compliance levels.

Frequently asked questions ↑ Back to top

Q: What level of PCI compliance does this plugin provide?
A: By default, the payment form for this plugin is hosted directly on your site, which provides an SAQ-D compliance level. This means that your server and entire site environment need to be certified by an outside source. If you use Checkout.js, the payment form is hosted by Elavon, which provides SAQ-A compliance. Click here to read more about Checkout.js requirements.


Q: Can I capture a higher amount than was authorized, like a restaurant?
A: Elavon, along with many other ecommerce payment processors, can’t do this for card-not-present transactions, such as online payments. You may only capture up to the value of what was authorized.

Troubleshooting ↑ Back to top

Decoding error messages ↑ Back to top

[4009] Required Field Not Supplied

This indicates that you’ve required a field in your Elavon account that the plugin cannot include. Click here to view a list of all fields that WooCommerce Elavon Converge will send, and please check your merchant account to ensure fields that don’t appear on this list are not required.

Tokenization Request Failed: [4014] Not Permitted – This terminal or user id is not permitted to process this transaction type

This indicates that your Elavon account is not set up to support tokenization / saving payments. Please contact your Elavon representative to fix this.

PIN Invalid [4015] THe PIN supplied in the authorization request is invalid.

This may be due to your PIN number being entered incorrectly in the plugin settings. Click here for instructions on finding your PIN. If that doesn’t resolve the issue, please contact your Elavon representative or technical support to ensure your account is enabled for eCommerce, not just Phone / Catalog.

HTTP POST transactions are not allowed for this account.

This means your Elavon account does not have SSL support enabled. Please contact your Elavon representative for assistance.

An error has occurred, please try again or try an alternative form of payment

This generic error message could be receive in a few different circumstances, such as:

Other issues ↑ Back to top

Having a different problem? Follow these steps to make sure everything is setup correctly before posting a support request:

  • Please ensure that your site meets the plugin requirements — please pay special attention to the special Elavon requirements!
  • Check the FAQs to see if they address your question.
  • Confirm that your credentials are correct.
  • Enable the Debug Mode setting and review the errors codes/messages provided by Elavon. If the error code indicates an issue with the plugin, please contact support and include the logs to help us troubleshoot.

Questions & support

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Please check out our troubleshooting tips and frequently asked questions for common issues or contact support via the help desk if you need more help.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top