---
schema_version: "1"
id: 71b81ad4dca4b6142a44f54d801e48ef2f7db1a0eab760513f3a4772fa938600
title: Configure Elavon Terminal for Payments
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_cms_hardware_config_elavon_terminal_payments.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_config_elavon_terminal_payments.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f2a31203976606103fb821fab14ff0af3c6f93a64191f22d9c8b62e5382c41be
description: Set up Elavon Terminals to use with the Point of Sale (POS) app. The Elavon card reader terminals can process payments using Ingenico Move 5000, Lane 7000, and Link 2500 Elavon card reader terminals.
products:
  - Commerce
release: "264"
---
# Configure Elavon Terminal for Payments

Set up Elavon Terminals to use with the Point of Sale (POS) app. The Elavon card reader terminals can process payments using Ingenico Move 5000, Lane 7000, and Link 2500 Elavon card reader terminals.

## Prerequisites

- Modern POS App Build: 5.9.1 and later
- Platform Support: iPhone & iPad
- Offline Support: no

## Set up Point of Sale CMS for Elavon Terminal Use

Configure the Point of Sale CMS settings so you can use Evalon Terminals with the Retail Cloud Point of Sale (POS) app.

### Set App Config Settings

Turn on Elavon as a supported payment reader in your app configs.

1. Go to **Apps** and edit the app config.
2. Go to **Modules > Peripherals > Card Readers**.
3. Under **Supported Card Readers For Store Associate Checkout**, check "**Elavon**".
4. Under **Default Card Reader**, select "**Elavon**".
5. Save your changes.

### Set Payment Gateway Settings

Create a payment gateway for Elavon.

1. Go to **Integrations > Payment Gateways**.
2. Select **Create** in the upper right corner.
3. Under **Payment Gateway**, select "**Elavon**".
4. Configure the rest of the fields by referring to the table:

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
              <colgroup>
                <col style="width:50%">
                <col style="width:50%">
              </colgroup>
              <thead class="slds-text-title_caps ">
                <tr class="">
                  <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d230912e224">Setting</th>
                  <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d230912e227">Description</th>
                </tr>
              </thead>
              <tbody>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">General Settings</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Environment*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Select the type of account for this configuration</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Fulfillment Type*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Select "Default" if you want to create this configuration for a POS app to perform
                    transactions</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Store ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Select "Default" for all stores or a specific store</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Payment Method*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Select the payment method for this configuration</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">Merchant Configuration</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Default Device ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">
                    <p>Enter your Elavon Terminal ID. Note that this setting can be overridden with the
                      (optional) register-level settings in <span class="menucascade"><strong class="uicontrol">Store Management &gt; Registers</strong></span> by editing a particular register entry:</p>
                    <ul>
                      <li>Under <span class="menucascade"><strong class="uicontrol">Card Reader &gt; Model</strong></span>, set the model to "<span class="menucascade"><strong class="uicontrol">Elavon</strong></span>"</li>

                      <li>Under <span class="menucascade"><strong class="uicontrol">Card Reader &gt; Terminal ID</strong></span>, set the <span class="menucascade"><strong class="uicontrol">Terminal ID</strong></span> to the register-specific setting</li>

                    </ul>
                  </td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">URL Base*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Enter your Elavon's Gateway URL</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Merchant Organization ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Enter your Elavon's Location Name </td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Services</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Select the services supported for this configuration</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">Terminal Configuration</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Terminal Gateway ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Enter your Elavon Chain Code </td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Terminal Request Timeout Interval In Seconds</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Time interval determines how long the POS will wait for a response from the terminal
                    for payment. The recommended time is 150 seconds.</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">Payment Status</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Payment Status Check API Timeout In Seconds</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">The payment status check API timeout. The minimum interval is five seconds, and it
                    can be adjusted up to 150 seconds based on the store's network quality. Setting the
                    interval too short won’t give the terminal sufficient time to process and respond. </td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">Other Settings</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Has Cart Summary On Payment Terminal</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Turn on to show the cart summary on the payment terminal</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e224 d230912e227 ">Manual Payment Settings</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e224 ">Manual Credit Card Entry On Terminal</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e227 ">Turn on to permit manual credit card entry on the payment terminal</td>

                </tr>
              </tbody>
            </table>

_\*An asterisk (\*) indicates a required field_

### Configure Order Number Range Settings

1. Go to **Advanced > Order Number Range Config**.
2. Select **Create** and select "**Payment Transaction ID Policy**".
3. Configure the rest of the fields by referring to the table:

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
              <colgroup>
                <col style="width:50%">
                <col style="width:50%">
              </colgroup>
              <thead class="slds-text-title_caps ">
                <tr class="">
                  <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d230912e503">Setting</th>
                  <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d230912e506">Description</th>
                </tr>
              </thead>
              <tbody>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e503 d230912e506 ">General Information</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Operating Mode*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">Noneditable field. Verify this is set to "<span class="menucascade"><strong class="uicontrol">Online</strong></span>"</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Entity Type*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">Noneditable field. Verify this is set to "<span class="menucascade"><strong class="uicontrol">PAYMENT_TRANSACTION_ID</strong></span>"</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e503 d230912e506 ">Number Configuration</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Prefix</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">Verify this field is left empty</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Starting Order Number*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">The starting number for Elavon transactions. We recommend setting the starting value
                    as <span class="menucascade"><strong class="uicontrol">0000001</strong></span>. </td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d230912e503 d230912e506 ">Store and Device-Specific Configuration</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Store ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">Set this to "<span class="menucascade"><strong class="uicontrol">DEFAULT</strong></span>"</td>

                </tr>
                <tr class="">
                  <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e503 ">Payment Device ID*</td>

                  <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d230912e506 ">Set this to "<span class="menucascade"><strong class="uicontrol">DEFAULT</strong></span>". If there are multiple device IDs available for the merchant, create <span class="menucascade"><strong class="uicontrol">PAYMENT_TRANSACTION_ID</strong></span> for each device ID</td>

                </tr>
              </tbody>
            </table>

_\*An asterisk (\*) indicates a required field_

## View POS App Flow with Elavon Terminals

Understand how the Elavon Terminal functions together with the Point of Sale (POS) app.

Connect to Elavon Terminal on POS Device Manager Screen

Elavon Terminals can be connected using Wi-Fi (Move 5000, Link 2500) as well as wired Ethernet (Lane 7000). It's necessary for the terminal and the iPad (POS register) to be on the same network to establish communication.

### Add and Connect to a Terminal

The terminal is added to the device manager screen by selecting "**Add Terminal**" under the Terminal section.![The Add Terminal option under the Terminal heading in the POS app.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_pos_add_term.png)

To do this, enter the IP address of the terminal. You can find the IP address by first selecting **0** and then pressing the **green O** on the Elavon pin pad and entering the admin password.![The Add Terminal window where you enter the terminal's IP Address](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_add_elavon_term_pos.png)

After you select "**add**," the terminal is added, and a connection is established instantly.![The Elavon terminal added and showing in the Terminal section of the POS app app.rt\_cms\_](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_added_terminal_elavon_pos.png)

### Verify Connectivity

The info icon next to the terminal can be used to view the IP address of the terminal and to run diagnostics to check the connectivity between the terminal and the PS POS App. If you select "**Run Diagnostics**", the app establishes a connection and confirms it. If the connection fails, the app shows a connection failure message along with the reason for the failure.![The Run Diagnostics option for the IP Address of the terminal that you connected to the POS app.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_ip_address.png)

Next is a screenshot depicting a successful connection:![A Connection Success message in the POS App for the terminal that you entered.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_term_ip_connected.png)

### Payment Using Card Option on Cart Screen

The **Credit Card** option on the **Split Cart** screen allows you to start a payment for the order using the connected Elavon terminal. If there's no Elavon terminal connected for payment, the POS app permits you to go to Device Manager to add a new terminal. If there's no Elavon terminal connected for payment, the POS app permits you to go to the device manager screen to add a new terminal. If there's no Elavon terminal connected for payment, the POS app permits you to go to the device manager screen to add a new terminal.

The terminal prompts for card insertion or swiping, processes the payment, and provides **APPROVED/DECLINED** messages based on the success of the transaction. An approved payment in the Elavon terminal shows the **Thank You** screen on the app, while a declined payment is followed by the app showing the details of the issue in a popup.

Next are some screenshots for the same:

![The Present Your Card popup in the POS App](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_pay_using_card_screen.png)![The Thank You screen for an approved transaction in the POS app.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_payment_approved_elavon_pos.png)

### Card Payment in Multitender screen

Cards are one of the payment options available on the **Multitender** screen. Users can use multiple payment cards for their transactions and also have the option to combine card payments with other tender options.

Next are some screenshots demonstrating this process:

![Adding a credit card payment amounf in the Add Card window on the POS app app.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_pos_add_card.png)![The Present Your Card popup in the POS App](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_pay_using_card_screen.png)![The Payment Summary screen in the POS App](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_pos_app_pay_summary.png)![The Thank You screen for an approved transaction in the POS app.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_payment_approved_elavon_pos.png)

### Elavon/Fusebox Dashboard Terminal Configuration

The **Location Name**, **Chain Code**, and **terminal ID** are the key parameters to set up the payment gateway configuration for Elavon in CMS. This will be created and provided by the Elavon support team during the initial setup.

### Elavon/Fusebox Dashboard Transaction History

You can view the transaction history by using the **Transaction Management** option in the Elavon portal. To find a specific order's payment, you can use the search option in transaction management and enter the order number in the user-defined field 1. Additionally, you can view the transactions from the last 24 hours by using the "**24-HOUR TRANSACTION SUMMARY**" dashboard on the home screen.

Transaction Management Left Hamburger Menu![The Fusebox screen showing the Elavon Global Gateway](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_transaction_mgmt_menu.png)

Transaction Search Option![The Transaction Search Option in the Transaction List section of the Elavon Global Gateway](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_transaction_search.png)

Transaction Search By Order ID in User-Defined Field 1![Searching for a transaction by order ID in the Transaction Search section.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_search_order_id_elavon.png)

24-Hour Transaction Summary in Home Screen![THe Elavon Global Gateway shoing a list of transactions in the past 24 hours.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_elavon_transaction_summary.png)

## View Known Issues and Limitations

Understand common issues that you sometimes encounter if configuring or using Elavon Terminals with Point of Sale.

### Simultaneous Payment Attempts from Multiple Registers to the Same Terminal

If many registers try to process payments through the same terminal at the same time, the transactions fail. Users are notified with one of these errors.

- "Transaction Declined. Reason: \*SLR Busy"
- "Connection terminated by the host. If there is an ongoing transaction on the terminal, cancel it by pressing the red X button."

To resolve the issue, close the error message by tapping "**OK**" on each register.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png)

Note For configurations where multiple registers share the same terminal, verify only one register processes a payment at a time.

### Connectivity Issues Locking Terminal in 'Processing' State

Offline mode and the "Store and Forward" (SAF) feature supported by Elavon aren't available in Modern POS. Due to this limitation, if network connectivity is lost, the terminal can remain in a "processing" state. To recover, cancel the transaction and retry.

See: [View Features Supported by Elavon](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_features_supported_elavon.htm&release=264.0.0&type=5 "Stay informed about transaction payment capture, offline support, and other key functionalities of Elavon features and how they interact with Point of Sale.")

### Sale Can't Be Initiated After 5-Minute Delay

In Simplify Version 2.02.x or earlier, waiting more than 5 minutes can prevent initiating a sale on the terminal. To resolve this, update to the latest version by using the steps under "Update Simplify Version" in the [Elavon - Onboarding & Troubleshooting](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_onboard_troubleshoot_elavon.htm&release=264.0.0&type=5 "Configure your Elavon terminal to work with Point of Sale for secure payment acceptance, whether in-store or online.").

To check your current Simplify version, press "**0**" on the terminal.

### Getting "Transaction declined Reason: CALL AUTH CENTER" error during payment

Check with Elavon team, if the gateway is in "backup" mode and declining the dollar amount.