Getting Started

If you're new here or a pro who just needs a refresher, the following topic provides an overview of Dex account structures, roles and permissions, common Dex terminology, and how to navigate inside the application. Let's get started!

Registering Your Account

Overview

To gain access to Dex, your Forte representative or organization administrator must invite you. This process initiates an enrollment email that walks you through the registration process and verifies your identity via a mobile phone verification code. Invite emails expire after eight days and automatically expire if you incorrectly enter your verification code more than five times.

The Registration Process

After your organization admin initiates an invite, you'll receive an email invitation. Your email address will be your username for logging into Dex and cannot be changed.

To complete the registration process, complete the following steps:

  1. Click the Accept Invitation button in the email. The Dex registration page displays.
  2. Complete the following mandatory fields:

Field

Description

First Name

The user's first name.

Last Name

The user's last name.

Password

A password that meets the following requirements:

1. A minimum of 8 characters
2. Cannot contain 3 consecutive, identical characters (e.g., 111, aaa, or @@@)
3. Includes at least 1 lowercase letter (e.g., a, b, c, d, etc.)
4. Includes at least 1 uppercase letter (e.g., A, B, C, D, etc.)
5. Includes at least 1 of the following special characters: !, @, #, $, %, ^, or &.
6. Must be different than your login name

Confirm Password

Enter the same Password again which is entered in Password field. Both passwords should match for authentication.

Show or Hide is available to view and hide the passwords.

3. After completing these fields, click the I'm not a robot reCAPTCHA challenge checkbox.

4. Click the I accept the Terms of use checkbox. To read Forte's Terms of Use, click the Terms of Use hyperlink to read them in a scrollable modal.

5. After completing the required fields, click the activated Register button. You are directed to the Add the extra security to your account page to enable the Two-factor authentication process.

6. Complete the following fields to enable Two - factor authentication.

 

Field

Description

Country

Country code assigned to the phone number.

Phone

Enter your valid landline or mobile phone number.

Ext

Enter the extension (if applicable)
This is an optional 5 digit field.

Select the method to

receive the code

Text Me (Mobile Only): Select this option if you want to receive the code in text on your mobile number.

Call Me: Select this option if you want to receive the code through an automated call either on a landline or mobile number.

7.Click the Send Code button. Dex sends you a unique six-digit code via SMS or a call. The code is valid for 10 minutes. If you fail to enter the code within the 10 minute time limit, you can select the option Resend Code to receive a new code.

Note: You can click BACK AND USE ANOTHER METHOD option to change the mode of code receipt

8.Enter the six-digit code in the Verification Code field and click the Verify and Enable 2FA button. After verifying your identity, the Dex welcome page displays with a modal instructing you to accept the invitation.

9.Click the Accept button. The Dex homepage for that organization displays.
Note: Every time a user logs into the dex, after entering the login credentials, the Two -factor authentication step is mandatory to login to dex.

Understanding The Dex Dashboard

The Dex dashboard provides you with a snapshot of your settled transactions over a specified amount of time. It also provides a graphical breakdown of each payment method used during this time period, the number of debit and credit transactions, and the total amount processed for each payment method and transaction type. To access the dashboard, click Home on the Dex menu. Three different performance charts display.

Sales Performance

The Sales Performance line chart displays the number of settled debit transactions over the period of time displayed in the Settled Date dropdown field. This time period defaults to the Last 7 days, but you can select any of the following options:

  1. Last 7 days
  2. Last 30 days
  3. Last 90 days
  4. Last 6 months
  5. Last 12 months

The chart changes as you select different time periods. NOTE: The chart for merchants who only perform credit transactions will be a flat line.

Payment Methods

The Payment Method pie chart displays what payment methods were used in the transactions over the given time period. It also provides the total number of debit transactions and the total amount processed for that time period. To see the total number of debit transactions and total amount processed for each payment method, simply hover over that payment method's segment in the pie chart. A pop-up displays showing the total amount processed and the number of transactions for that payment method.

Transaction Breakdown

The Transaction Breakdown pie chart displays the number of credit and debit transactions in a given time period. It also provides the total number of transactions and the total amount processed for that time period. To see the total number of transactions and the total amount processed for each transaction type, simply hover over that transaction type's segment in the pie chart. A pop-up displays showing the total amount processed and the number of transactions for that transaction type.

Understanding Dex Security Standards

Dex employs a number of security standards for user authentication and data security. This includes password complexity requirements, security browser cookies, two-factor authentication and IP Allow Lists.

Password Requirements

All Dex passwords must meet the following requirements:

  • A minimum of 8 characters
  • Cannot contain three consecutive, identical characters (e.g., 111, aaa, or @@@)
  • Includes at least 1 lowercase letter (e.g., a, b, c, d, etc.)
  • Includes at least 1 uppercase letter (e.g., A, B, C, D, etc.)
  • Includes at least 1 of the following special characters: !, @, #, $, %, ^, or &.
  • Must be different than the previous five passwords
  • Must be different than your username

Users must update their passwords every 60 days and log into Dex at least once every 90 days. Dex suspends users who have been inactive for 90 days or more. Once a user is suspended, only the Admin of the organization can restore his/her access.

Restoring User Access

Admins who want to restore a suspended user's access must complete the following steps:

  1. Navigate to your Organization's Details Screen by clicking Organizations on the Dex main menu.
  2. Click the Security tab.
  3. Under the Suspended Users section, click the Manage link.
  4. Dex displays all of your organization's suspended users on the Users Datagrid.
  5. Reactivate each user using one of two methods:
    • From the Users Datagrid, click > Reactivate.
    • Access the User's Details Screen and click Actions > Reactivate.
  6. A Reactivate User message displays asking you to confirm the action. Click the Reactivate button. Dex reactivates the user and restores his/her access.
  7. Repeat steps 5 and 6 for additional suspended users.

Browser Cookies

Browser cookies add another layer of security to login authentication. Cookies prevent unauthorized access to your Dex account even if your credentials become compromised. For new users, Dex will set up and store the cookie on the machine used for registration. Users must set up a browser cookie each time he/she logs into Dex using a new or unfamiliar non-public machine. Do not save cookies to public devices.

To set up a browser cookie on a new device, complete the followings steps:

  1. Access the Dex Login Page and log in using your credentials. Dex will redirect you to a code verification page with a message about your unrecognized device.
  2. Click the Send Code button. Dex sends you a six-digit verification code to your registered email (i.e., username).
  3. Enter the six-digit code in the provided text box. Dex gives you up to three attempts to enter the correct verification code.
  4. Click the This is a public or shared computer checkbox if you are accessing Dex from a non-private/personal device.
  5. Click the Verify Code button. Dex redirects you to your Home screen.

Two-factor Authentication

Two factor authentication in dex provides an extra layer of security by authenticating authenticates the validity of the dex user through a secondary factor when accessing dex or making updates from your My Profile screen. 

Upon entering your user login credentials you are directed to the Add extra security to your account screen where you can complete the process to enable the two-factor authentication.

Once you have enabled two-factor authentication, you will be required to receive and enter a code each time you login to dex.

IP Allow Lists

NOTE: Only Admins can enable and manage IP Allow Lists.

An IP Allow List is a service that gives you the ability to control access to Dex and limit that access to only trusted users. IP Allow Lists are lists of trusted IP addresses or IP address ranges from which users can access the Dex domain. Admin users at the Merchant, Partner, and Enterprise levels can create IP Allow Lists for their respective organizations. Once enabled, users can only access Dex from those approved IP addresses. If users attempt to log into Dex from non-allowed IP addresses, Dex displays their current IP address with a message advising them that the address must be added to the Allow List by their organization's admin.

To ensure you are notified of login attempts from non-allowed IP addresses or any updates to your IP Allow List, Dex automatically subscribes Merchant Admins, Enterprise Admins, and Partners to IP Allow List notifications when they accept their Dex invitation. You will receive these notifications for the following events:

  • Unauthorized Access
  • Allow List Updated
  • Allow List Deleted
  • Allow List Enabled
  • Allow List Disabled

    Enabling IP Allow Lists

    NOTE: IP Allow Lists must contain at least one IP address or IP address range to become fully enabled. For your convenience, the Manage IP Allow List Modal and the Dex login screen displays your IP address, so that you can quickly add it to the allow list to prevent lockout.

    To enable and create an IP Allow List, complete the following steps:

    1. Log into your Dex Home Organization and click Organizations in the Dex main menu.
    2. Click the row on which the desire organization displays. If needed, search for the organization by either Organization Name or Organization ID or use the Legal Name, Status, Parent ID, Tax ID, or Type filters to narrow down the list that displays on the Organizations Datagrid.
    3. From the Organization's Details screen, click the Security tab.
    4. Click the Manage link under IP Allow Lists. A Manage IP Allow List modal displays.
    5. Click the toggle (i.e., make it green) next to the Enable IP Allow List field. The IP Address and Name fields display.
    6. In the IP Address field, enter either a single IP address (e.g., 192.168.100.14) or a range of IP addresses using Classless Inter-Domain Routing (CIDR) notation (e.g., 192.168.100.0/24).
    7. In the Name field enter a 60-character or less name for the IP address or range of addresses.
    8. Click the Add button. The IP address is added to the save list that displays on the Manage IP Allow List modal.
    9. Repeat steps 6–8 for all the IP addresses and ranges you want to add to the Allow List.

Managing the IP Allow List

Adding to the IP Allow List

To add to your IP Allow List, complete the following steps:

  1. Log into your Dex Home Organization and click Organizations in the Dex main menu.
  2. Click the row on which the desire organization displays. The Organization's Details screen displays.
  3. Click the Security tab on the Organization's Details screen.
  4. Click the Manage link under IP Allow List. A Manage IP Allow List modal displays.
  5. In the IP Address field enter either a single IP address (e.g., 192.168.100.14) or a range of IP addresses using Classless Inter-Domain Routing (CIDR) notation (e.g., 192.168.100.0/24).
  6. In the Name field enter a 60-character or less name for the IP address or range of addresses.
  7. Click the Add button. The IP address is added to the save list that displays on the Manage IP Allow List modal.
  8. Repeat steps 6–8 for all the IP addresses/ranges you want to add to the Allow List.

    Editing an Allowed IP Address

    To edit an IP address/range on your save list, access the Manage IP Allow List modal and complete the following steps:

    1. Find the desired address by scrolling through the list or searching for it by Name or IP Address in the Search field.
    2. Click the Edit icon that displays next to the IP address you want to modify. The text fields displaying the address values becomes editable.
    3. Add your updates to the IP Address or Name field and then click the Save icon. Dex returns you to the Manage IP Allow List modal.
    4. Repeat steps 1–3 for all the IP addresses/ranges you want to modify.

    Deleting an Allowed IP Address

    To delete an IP address/range from your save list, access the Manage IP Allow List modal and complete the following steps:

    1. Find the desired address by scrolling through the list or searching for it by Name or IP Address in the Search field.
    2. Click the Delete icon that displays next to the IP address you want to delete. A message displays asking you to confirm the deletion.
    3. Click the Delete button to confirm the deletion and return to the Manage IP Allow List modal.
    4. Repeat steps 1–3 for all the IP addresses/ranges you want to modify.
      Disabling IP Allow Lists

      If you no longer wish to enforce IP Allow Lists for Dex access, you can disable it from the Manage IP Allow List modal. If you later decide to re-enable it, your saved list of IP addresses/ranges automatically reactivates too. To disable IP Allow Lists for your organization, complete the following steps:

      1. Log into your Dex Home Organization and click Organizations in the Dex main menu.
      2. Click the row on which the desire organization displays. If needed, search for the organization by either Organization Name or Organization ID or use the Legal Name, Status, Parent ID, Tax ID, or Type filters to narrow down the list that displays on the Organizations Datagrid.
      3. From the Organization's Details screen, click the Security tab.
      4. Click the Manage link under IP Allow Lists. A Manage IP Allow List modal displays.
      5. Click the toggle (i.e., make it gray) next to the Enable or disable IP Allow List for your organization field. A message displays asking you to confirm that you want to disable this feature.
      6. Click the Disable button to confirm. Dex returns you to the Manage IP Allow List modal.

Creating a New Password

Dex enables you to easily change your password within the application without having to go through the identity verification process necessary when recovering a password. This is helpful for when you suspect your password may have been compromised or you've received a notification advising you to change your password. NOTE: To ensure the security of your data, Dex will prompt you to change your password every 60 days.

To update your Dex password, complete the following steps:

  1. Log into Dex using your current credentials.
  2. Click the User icon in the upper right corner, and select My Profile. Your Dex Profile Page displays.
  3. Click the Edit icon on your My Profile page.
  4. Complete the two- factor authentication (Extra Security Step required and Enter the Code) pages.
  5. Once you have completed the two-step authentication, you are directed to the Security pop-up where the Password section is expanded to enter your password.
  6. Enter your current password in the Current Password field.
  7. Enter a new password in the New Password and Confirm New Password fields. The new password must conform to the following requirements:
    • A minimum of 8 characters
    • Cannot contain three consecutive, identical characters (e.g., 111, aaa, or @@@)
    • Includes at least 1 lowercase letter (e.g., a, b, c, d, etc.)
    • Includes at least 1 uppercase letter (e.g., A, B, C, D, etc.)
    • Includes at least 1 of the following special characters: !, @, #, $, %, ^, or &.
    • Must be different than the previous five passwords
    • Must be different than your login name
  8. Click the CHANGE button. Dex returns you to the Edit Profile page.
  9. Click the X icon to exit the Edit Profile page and return to the My Profile page.

After changing your password, Dex sends a "Password Changed" confirmation message to your email.

Recovering Your Password

Everyone forgets their password sometimes. Luckily, Dex provides you with an easy method for changing your password and recovering access to your data. You'll need the email address you used during the Dex registration process. If you don't have access to your registration email address, contact Forte Customer Service at 866-290-5400.

If you can't remember your password, complete the following steps:

  1. Click the Forgot password? link on the Dex Login page. Dex displays the Forgot Your Password page.
  2. Enter the email you used to register for Dex in the provided field.
  3. Select the I'm not a robot reCaptcha challenge checklist to prove you're human.
  4. Click the Next button. The Extra Security Page displays.
  5. Select the Method to receive the verification code and click on Send Code. Dex sends you a unique, six-digit verification code and directs you to the Enter the Code page.
  6. Enter the code in the provided fields and click the Verify button. If you didn't receive the code, click the Resend Code to initiate the creation of a new code. After verifying your code, the Create your new Password page displays.
  7. Enter your new password in the data fields. Dex passwords must meet the following requirements:
    1. A minimum of 8 characters
    2. Cannot contain three consecutive, identical characters (e.g., 111, aaa, or @@@)
    3. Includes at least 1 lowercase letter (e.g., a, b, c, d, etc.)
    4. Includes at least 1 uppercase letter (e.g., A, B, C, D, etc.)
    5. Includes at least 1 of the following special characters: !, @, #, $, %, ^, or &.
    6. Must be different than the previous five passwords
    7. Must be different than your login name
  8. After creating and entering your new password, click the Save button. Dex returns you to the Dex Login Page where you can enter your username and new password to access your data. For security purposes, Dex also sends a "Password Changed" confirmation message to your email.

Switch Environments

Testing in Sandbox

Once you accept your Dex invitation, you have access to your organization in both the Live and Sandbox environments in Dex. Your access to resources in the Live environment are constricted by your assigned role; however, in the Sandbox environment, you have full Merchant Admin permissions.

Dex makes switching between Live and Sandbox quick and easy, so you can efficiently test Dex without having to log out and log back into the different environments. To switch environments in Dex, access the user icon in the upper right corner of Dex and select Switch to Sandbox. The Sandbox environment displays with a banner at the top of the Dex window and the Dex menu options display in white.

If you'd like to load demo data into your Dex Sandbox organization, see Loading Demo Data. This data includes sample user, customer, schedule, funding, dispute, and transaction data that you can use for testing.

Download Data

Exporting Data

Dex's download function enables merchants with the appropriate permissions to export thousands of records to a .csv or .xlsx file that can then be stored on a local computer or imported into other applications for storage or processing. Only data from the following datagrids can be exported—not detailed information:

  1. Transactions (see the section below for exporting from the transaction data grid)
  2. Disputes
  3. Funding
  4. Customers
  5. Schedules
  6. Organizations
  7. Locations
  8. AutoPay (for BillPay merchants)

Refund / Credit / Unfunded transactions will be displayed as a negative value (e.g. -$10.00) for the following fields:

  1. Amount
  2. Principal
  3. Service fee
  4. Tax Amount

Void transactions will be displayed as a zero value (e.g. $0.00) for the following fields:

  1. Amount
  2. Principal
  3. Service fee
  4. Tax Amount

To export data, complete the following steps:

  1. Access the appropriate datagrid by clicking the option from the Dex main menu.
  2. If desired, use the filters and the Expand Datagrid button () to customize the list of data you want to download.
  3. Click the Download button () in the upper right corner of the datagrid (next to the Sort By dropdown). The file begins to download and Dex displays a message indicating the real-time status(es) of the download. If the file contains less than 10,000 records, Dex will immediately start processing the query and display a message when complete. If the file contains more than 10,000 records (for schedules, more than 1,000), Dex will display a "Processing" status message and then begin processing the query in the background (i.e., asynchronously). Click the Got It button to dismiss the message. NOTE: Dex can only process downloads with less than 500,000 records. If you receive an error message, filter the query to reduce the number of records.
  4. After processing, Dex displays a message indicating the generated file is ready for downloading. Click on the Downloads tab of the datagrid to access the file(s). These files display for 48hrs.

Exporting Data From the Transaction Data Grid

The export and download option from the Transactions DataGrid enables merchant users with appropriate permissions to customize the transactions DataGrid download. Merchant users have the ability to add and delete fields to include in the download and arrange the order of the fields in the download file.

To export data, complete the following steps:

  1. Access the transactions data grid by clicking the option from the Dex main menu.

  2. If desired, use the filters and the Expand Datagrid button () to customize the list of data you want to download.

  3. Click the Download button () in the upper right corner of the datagrid (next to the Sort By dropdown).

  4. Select the fields in the download transaction template to include in the transaction download.

    To reset the Download Transaction File modal to the default settings, click on “Clear All Fields” in the top left corner and then clicking on “Reset to Default”

    The following fields are defaulted in the template:

Field

Description

Transaction ID

A 36-character code that uniquely identifies the transaction.

Received Date

The date when of the transaction received (e.g., March 31, 2018 04:23 PM). If the location has not designated a timezone, Dex defaults to Pacific Standard Time (PST).

Received time

The time when of the transaction received (e.g., March 31, 2018 04:23 PM). If the location has not designated a timezone, Dex defaults to Pacific Standard Time (PST).

Status

The status of the transaction. The following values are supported:

In Progress - The transaction was received and is awaiting origination (echecks) or settlement (credit cards). If authorized, this field also displays the Status, Response, Return, and/or Settlement Code that returned with the response.

Completed - The transaction was funded to or from the merchant's bank account.

Failed - The transaction was declined, rejected, voided, or failed verification for reasons detailed in the Status, Response, Return, and/or Settlement Code that returned with the response.

Customer ID

The Company Name or First and Last Name of the customer associated with this transaction. If applicable, this field also includes the merchant-specified Consumer ID.

Bill To First Name

The customer's first name.

Bill To Last Name

The customer's last name.

Company Name

The name of the customer's company.

Wallet ID

A merchant-defined description or reference ID related to the transaction.

Order ID

If supplied, the merchant-defined Order Number and Reference ID included with the transaction. These parameters can include anything from invoice IDs, ticket numbers, or P.O. Box numbers.

Amount

Displays the transaction amount, only the number(s) and/or decimal point.

Action

Dex supports the following transaction types:

Debit/Sale

Auth

Refund/Credit

Force/External Auth

Verify

Balance Inquiry

NOTE: The Auth action also displays either a D or C to indicate if the transaction was a Debit or Credit.

Method

The card brand used for this transaction. This parameter displays the logo of the following supported card brands:

American Express

Discover

MasterCard

Visa

Diners

JCB

Last 4

The last four digits of the customer's credit card

Authorization Info

Displays the authorization result. If the transaction was approved, this column displays the Authorization Number and the Approval Code. If the transaction was declined, an "Auth Decline" message displays. If the authorization is still in progress, the column remains blank.

Source

The terminal hardware, software, or integration method used to connect to Forte.

Location ID

The ID of the merchant location that processed the transaction.

Wallet Type

The Alternative Method of Payment used. i.e. Apple Pay, Google Pay, Samsung Pay, Pay Pal

Location Name

The name of the merchant location that processed the transaction.

At Merchant Level will be displayed by default:

Bank Account Verification

Displays the P-codes associated with a Validate Plus transaction. The following options display:

P10 – No Match

P15 – High Risk

P20 – Negative Reports

P21 – No Negative Reports

P23 – Invalid Account/ABA Number

P40 – No Negative Information

P41 – Negative Information

P50 – No Information

P60 - Match

P70 - Validated

P71 – Low Risk Approval

P73 – Medium-Risk Approval

P75 – Conditional Match

P80 – Vendor Busy

P90 – Preauthorization Vendor Unavailable

P91 - Preauthorization Vendor Error

P92 - Preauthorization Server Unavailable

P93 – Error P94 – Invalid Routing Number

P94 – Invalid Account Number

P95 - Bad Account

Principal (At Merchant Level)

The authorized amount of a transaction, which includes taxes (if applicable) but not service fees.

Service Fee (At Merchant Level)

The service/convenience fee for the transaction. Service fees are either a percentage of the principal or a set amount.

5. Select Additional Columns to add to the download from the Add a New Column option. The additional fields available to add are:

Field

Discription

Debit or Credit

Type of the card used on the transaction - Debit (D) or Credit (C)

Tax Amount

Displays the transaction tax amount, only the number(s) and/or decimal point

Account Code

The accounting code entered for procurement cards

Account Type

The account type - Checking or Savings account.

Attempt Number

Number of attempts to execute the transaction

AVS Method

Address Verification Services method used

AVS Result

The result of the Address Verification Service check. The following values are supported: Match Partial Match No Match System Unavailable Invalid Not Supported

Batch Reference Code

The funding entry’s identification number

Data Label 1

Merchant custom-defined fields defined in VT

Data Label 2

Merchant custom-defined fields defined in VT

Data Label 3

Merchant custom-defined fields defined in VT

Data Label 4

Merchant custom-defined fields defined in VT

Bill to City

The city of the customer's billing address

Bill To eMail

The customer's email address

Bill To Postal Code

The zip or postal code of the customer's billing address

Bill To State

The state of the customer's billing address

Bill To Street Line 1

The first line of the customer's billing address

Bill To Street Line 2

The second line of the customer's billing address

Bill To Telephone

The customer's phone number

Cardholder Name

The customer's cardholder name

Check Number

The check number of the check.

Customer Fax

The customer's Fax phone number

CVV Method

Card Verification Value method

CVV Result

The result of the Card Verification Value check. The following values are supported: Match No Match Error (Unrecognized or Unknown Response) Invalid or Null Not Processed Service Not Supported Issuer Unable to Process No Response

Entered By

The name or API key of the user that created this transaction.

SEC Code

The SEC code associated with the transaction. The following values are supported: ARC CCD CIE CTX POP POS PPD RCK TEL WEB For descriptions of these codes, see Using ACH and SEC Return Codes topic on Forte's Developer Documentation site.

Entry Description

Details pertaining to the funding entry that can be overwritten by the merchant after the funds are in the merchant's bank account.

File Reference Code

File Reference Code

Freight Amount

The amount paid to a carrier company for the transportation of goods from the point of origin to an agreed location.

IP Address

The IP Address from where the merchant/partner submitted the transaction.

Item Description

A brief description of the schedule or service.

Line Items

Detailed descriptions regarding the customer and the transaction, such as: Customer Name,Customer Id,Bill Number,Unique Bill Id,Payment Amount,Late Fee Fixed

Origination Date

The date on which the funds of the transaction go to the originating depository financial institution.

Preauth Code

Preauth Code Received related to the transaction

Preauth Description

Preauth Description received related to the transaction

Preauth Negative Report

Describes why the transaction was declined due to a pre-authorization (Forte Verify) result.

Preauth Result

The result of the customer pre-authorization

Proc Card

Procurement Card

Response Code

This field displays the response and settlement codes for rejected transactions.

Insufficient Fund - R01 - The balance is not sufficient to cover the value of the transaction.

Account Closed - R02 - A previously open account has been closed.

No Account - R03 - The account is closed or doesn't match the name submitted.

Invalid Account Number - R04 - The account number structure is invalid.

Pre-Note Not Recieved - R05 - Pre-notification was not received.

Returned per ODFI - R06 - ODFI has requested RDFI to return this item.

Authorization Revoked - R07 - Account holder has revoked the company's authorization.

Payment Stopped - R08 - Account holder has stopped payment on this single transaction.

Uncollected Funds - R09 - Balance is sufficient, but can't be released until uncollected items are collected.

No Authorization - R10 - Account holder advises that the transaction is not authorized.

Check Safekeeping Return - R11 - Return of a check safekeeping entry return.

Branch Sold - R12 - The account is at a branch that was sold to another financial institution.

RDFI Not Qualified - R13 - RDFI not qualified to participate.

Deceased - R14 - The account holder is deceased.

Beneficiary Deceased - R15 - The beneficiary entitled to benefits is deceased.

Account Frozen - R16 - Funds are unavailable due to action by RDFI or other legal action.

Non-Transaction Account - R20 - Policies/regulations restrict activity to this account.

Payment Refused - R23 - The account holder refuses the transaction because the amount is inaccurate for another legal reason.

Duplicate Entry - R24 - The transaction appears to be a duplicate item.

Mandatory Error - R26 - The transaction is missing data from a mandatory field.

Invalid TRN - R28 - The Transit Routing Number is invalid.

Corporate Not Authorized - R29 - The corporate receiver has notified RDFI that the Corp entry is not authorized.

ODFI Permits Late Return - R31 - RDFI rejected an entry that the ODFI had accepted (applies to CCD and CTX only)

Invalid Company ID - R50 - The OwnerCompany ID field is not valid.

Invalid Transaction Date - R56 - The date specified is invalid.

Stale Date - R57 - The transaction is too old for processing.

Over Limit - R95 - This transaction is over your authorized limit.

Account On Hold - R96 - The company account is on hold.

RDFI Does Not Participate - R97 - RDFI does not allow this type of transaction.

Invalid Password - R98 - The password supplied was invalid.

Declined Unpaid Item - R99 - This account or ID has been declined due to unpaid items.

Response Description

The transaction response values:

Approved

Declined

Response Type

Preauth Result Type, will be displayed with the following results as example (in bold):

A = APPROVED

B = BUSINESS NAME MATCH

D = PREAUTH DECLINE

E = AUTH ERROR

M = FIRST & LAST NAME MATCH

P = PARTIAL MATCH

N = NO MATCH

O = OVERALL MATCH

Routing Transit Number

The TRN or routing number of the bank. This value is typically the first number listed at the bottom of the check. This field is required.

Settlement Date

Settlement date for the customer transaction

Settlement Response Code

Settlement Response Code related to the customer transaction

Settlement Response Code Description

Settlement Code Description related to the customer transaction

Ship To Address

Shipping Address Line 1

Ship Address 2

Shipping Address Line 2

Ship To City

Ship To City

Ship To Name

Ship To Customer Name

Ship To Postal Code

Ship To Postal Code

Ship To State

Ship To State

Bank Account Verification

Displays the P-codes associated with a Validate Plus transaction. The following options display:

P10 – No Match

P15 – High Risk

P20 – Negative Reports

P21 – No Negative Reports

P23 – Invalid Account/ABA Number

P40 – No Negative Information

P41 – Negative Information

P50 – No Information

P60 - Match

P70 - Validated

P71 – Low Risk Approval

P73 – Medium-Risk Approval

P75 – Conditional Match

P80 – Vendor Busy

P90 – Preauthorization Vendor Unavailable

P91 - Preauthorization Vendor Error

P92 - Preauthorization Server Unavailable

P93 – Error P94 – Invalid Routing Number

P94 – Invalid Account Number

P95 - Bad Account

Dispute ID

The unique, Vantiv-defined number that identifies the dispute.

Dispute Status

Indicates where the dispute is in the dispute lifecycle. Dispute status values are:

Accepted
Documents Needed
Exception
Expired
Fultilled
Lost
Pending
Recalled
Reviewing
Won

Principal (At Merchant Level)

The authorized amount of a transaction, which includes taxes (if applicable) but not service fees.

Service Fee (At Merchant Level)

The service/convenience fee for the transaction. Service fees are either a percentage of the principal or a set amount.

6. Delete any fields not needed in the download file by clicking on the delete icon  to the right of the field.

7. To change the field positions, use the six dots  to the left of the field name to drag and drop the field into the desired position in the list.

8. Select the format of the file, CSV or XLSX, using the format option at the bottom of the modal.

9. Select “Include Transaction Summary” to include a summary tab in the download file (xlsx format must be selected to select the summary option). When “Include Transaction Summary” is selected, a separate tab that summarizes the transaction data in the file will be included in the download. The summary option can be saved in the templates.

10. Click on the Download icon to download the file. The file begins to download and Dex displays a message indicating the real-time status(es) of the download. If the file contains less than 10,000 records, Dex will immediately start processing the query and display a message when complete. If the file contains more than 10,000 records (for schedules, more than 1,000), Dex will display a "Processing" status message and then begin processing the query in the background (i.e., asynchronously). Click the Got It button to dismiss the message. NOTE: Dex can only process downloads with less than 500,000 records. If you receive an error message, filter the query to reduce the number of records.

Note: If no updates are made in the Download Transaction File modal and the Download icon is clicked, the download file will only include the defaulted fields.

11. After select the format click on Download

12. After processing, Dex displays a message indicating the generated file is ready for downloading. Click on the Downloads tab of the datagrid to access the file(s). These files display for 48hrs.

Exporting and Saving a Template

Dex enables users with appropriate permissions to save a template with pre-selected fields. Templates are saved at a merchant org level. Each user with permissions to download from the transaction data grid can save a total of 10 templates per merchant org.

To Save a download template, complete the following steps:

  1. Access the transactions data grid by clicking the option from the Dex main menu.

  2. If desired, use the filters and the Expand Datagrid button () to customize the list of data to download.

  3. Click the Download button

  4. Click on Download and Save

  5. Enter the template name and click Save.

    Note: If the user reaches the maximum of 10 templates Dex will display a warning message:

    “You’ve reached the maximum number of templates allowed. Please consider deleting existing templates that are not used so you can create and save the ones needed.”

Working with a Saved Template

To select a saved template, complete the following steps:

  1. Access the transactions data grid by clicking the option from the Dex main menu.

  2. If desired, use the filters and the Expand Datagrid button ( ) to customize the list of data you want to download.

  3. Click the Download button () in the upper right corner of the datagrid (next to the Sort By dropdown)

  4. Click on Select a Template

  5. Click on the selected "Template"

  6. The template will be loaded on the download transaction modal

  7. Users have the option to:
    • Select Download to download the data with the filter selections that have been saved to the template
    • Select Download and Save to save the same template with a different name
    • Update the template and select Download and Save to save updates to the existing template
    • Update the template and select Save as a New Template to download and Save the updates to a new template

  8. Selecting Download will begin the download process

    Selecting Download and Save or Downland and Save as a New Template will begin the download process and prompt the user to name and save the template

  9. Click Save and the template will be saved

    Note: If the user reaches the maximum of 10 templates Dex will display a warning message:

    “You’ve reached the maximum number of templates allowed. Please consider deleting existing templates that are not used so you can create and save the ones needed.”

Selecting a Template

To select a template saved complete the following steps:

1. Access the transactions data grid by clicking the option from the Dex main menu.

2. If desired, use the filters and the Expand Datagrid button ( ) to customize the list of data you want to download.

3. Click the Download button ( ) in the upper right corner of the datagrid (next to the Sort By dropdown)

4. Click on SELECT A TEMPLATE in the Download Transaction File modal. A list of saved templates will be presented

6. Click on the chosen "Template"

7. The selected template will be loaded on the first download screen

8. If any updates are made to the selected template, an option to save as a new template is available.

9. Clicking on the Save as a new template, initiates the download and prompts the user to name the template.

10. After filling in the name, click SAVE and the template will be saved

Note: If the user reaches the maximum of 10 templates Dex will display a warning message:

“You’ve reached the maximum number of templates allowed. Please consider deleting existing templates that are not used so you can create and save the ones needed.”

Deleting a Template

To delete a saved template complete the following steps:

  1. Access the transactions data grid by clicking the option from the Dex main menu.

  2. If desired, use the filters and the Expand Datagrid button ( ) to customize the list of data you want to download.

  3. Click the Download button ( ) in the upper right corner of the datagrid (next to the Sort By dropdown)

  4. Go to the up-right corner option: Select a template, a list of saved templates will be presented.

  5. Click on the 3 dots at the end of the template to be deleted.

  6. Click on Delete Template

  7. Confirm the action by clicking on Delete

  8. Template is deleted

Load Sample Test Data

Loading Demo Data

To help you test Dex's capabilities, we've created a file of dummy data that you can load to your Dex organization in the Sandbox environment. This data contains sample user, customer, schedule, funding, dispute, and transaction data that you can use for testing.

To load sample test data to a Dex organization, complete the following steps:

  1. Switch to the Sandbox environment from Live.
  2. Click the Refresh Data button in the upper-right corner of Dex. The Refresh Data modal displays.
  3. Use the Location dropdown menu to select the location where you want Dex to load the dummy data. Changes to existing demo data will be lost. Any users, customers, transactions, or schedules you've created independent of the provided demo data will not be lost during the data refresh.
  4. Click the Refresh button. If successful, Dex returns you the Dex homepage and displays a success message.

Managing your Two - factor authentication phone number

Your My Profile page provides the ability to change the phone number that you use receive your two-factor authentication.

To update your phone number to receive your two-factor authentication code from your My Profile page,perform following steps:

1. Navigate to My profile in dex, and click on the  Edit icon .

2. You are directed to the Edit Profile pop up modal, click the Edit icon next to Two-factor Authentication.

3. The Two-factor Authentication section expands, enter the country code, phone number and extension (if needed) of the phone number you wish to use to receive your verification code. Select the method to receive your code and click Send Code.

4. You are directed to the Enter the Code screen, enter the code you received and click Verify.

5. Upon verification, a message is displayed that your user profile is updated and you are directed to the edit profile screen.

6. Click the X to exit the Edit Profile screen and return to My Profile.

7. For security purposes, dex sends a Phone Number Update confirmation message to your email.

On this page