Getting Started
Hi there! Welcome to Dex, Forte's latest and greatest payments application. With Dex, you can view, create, and manage all your transaction data—including customers, payment methods, addresses, and schedules—in one convenient place. You can also view and maintain your merchant account, keep track of your funding entries, resolve disputed transactions, and generate API credentials to connect Dex with your third-party applications.
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:
- Click the Accept Invitation button in the email. The Dex registration page displays.
- 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: - A minimum of 8 characters |
Confirm Password | Enter the same Password again which is entered in Password field. Both passwords should match for authentication. |
Show/Hide is available to view and hide the passwords.
- After completing these fields, click the I’m not a robot reCAPTCHA challenge checkbox.
- 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.
- 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.
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) |
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. |
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
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.
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 Partner Dashboard
The Partner Organization Home page is enhanced with new widgets, charts and download options to our Partners, which provides in depth insights into the performance of their Portfolios. Widgets and Charts include all Active and Retired Portfolios, with the ability to filter on one or more Portfolios. All data within the Charts and Widgets will default to a time of ‘This Month’ and it can be changed to different time periods from various options provided.
To access the Partner Dashboard, select a Partner Organization in dex and click Home on the Dex menu.
Filtering or Searching for a Portfolio
You can filter and search for all Active and Retired Portfolios under the Partner Organization. Fifteen portfolios are displayed which includes Active and Retired Portfolios and specific Portfolios can be searched by entering the Portfolio name or ID, use the following filters to search a Portfolio. Fifteen portfolios are displayed when selecting the drop-down arrow to filter for specific Portfolios. The Portfolio name or ID can be used to search and view additional Portfolios within the Partner Organization.
Field | Description |
Portfolio Name | The Portfolio Name is the DBA ‘Doing Business As’ Name of the Business |
Portfolio ID | The unique, string ID number to identify the Portfolio under the Partner organization. |
Headline section with Key Data about Portfolios
This section displays data based on the Portfolio filter which provides a summary of all or selected portfolios within the Partner Organization.
Gross Sales
Displays the Total Transaction Sales volume from the beginning of the current month to the end of the previous business day. The value includes Settled or Funded transactions, Credits or Refunds issued, Disputes Lost, and Won. If no portfolios are selected in the portfolio filter, the Gross Sales value will include all portfolios associated to the partner organization.
Transaction Count
Displays the volume of transactions for ACH, Card from the first of the month to end of the previous business day. The transaction count will increase when an ACH or Card has been Settled or Funded. The Transaction Count value will include all portfolios associated to the Partner Organization.
Last Commission Paid
Displays the last commission amount last paydate for the Partner Organization for all or the selected portfolio(s).
Commission to be Paid
Displays the estimated commission amount ‘to be paid’ to the Partner Organization for the previous months activity and includes the estimated paydate. If no portfolios have been selected in the portfolio filter, the Commission to be paid value will include all portfolios associated to the Partner Organization.
Commission Accrued
Displays the estimated accrued commission amount to be paid at a future date to the Partner Organization for activity in the current month for all or selected portfolio(s). Accruals are not updated on a nightly basis. A date is provided to reflect the date that the accruals have been calculated through.
Note: See Dashboard & Chart Widget Permissions for more information on who will have visibility to ‘Commissions’ information.
Widgets and Charts
The following section covers the time period frequency and details about charts and widgets on Partner dashboard.
Time Period Frequency for data displayed in Widgets and Charts
Each chart or widget is designed with specific Time Periods to choose from, for data to be displayed. Not all Time Periods listed below are available for each chart or widget.
Note: The default Time Period for each chart or widget is set to ‘This Month’ and Time Period Days are considered between 12:00:00 AM PST and 11:59:59 PM PST.
Time Period | Frequency | Days Considered |
Yesterday | Previous day | |
Last 7 days | Daily | Current Day - 1 through Current Day – 7 |
Last 30 days | Daily | Current Day - 1 through Current Day – 30 |
Last 60 days | Monthly | Current Day - 1 through Current Day – 60 |
Last 90 days | Monthly | Current Day - 1 through Current Day – 90 |
Last 180 days | Monthly | Current Day - 1 through Current Day – 180 |
Last One Year | Monthly | Current Day -1 through Current Day – 365/366 |
This Week | Daily | The first day (Sunday) of the current week through Current Day - 1 |
This Month | Daily | The first day of the current month through Current Day - 1 |
This Quarter | Monthly | The first day of the current quarter (Jan 1, April 1, July 1 or Oct 1) through Current Day - 1 |
The Following Charts and Widgets are present on the Partner Dashboard:
|
Chart or Widget |
Description |
|
Commissions Paid |
Displays a view of Commissions Paid over the last 12 months. |
|
Transaction $ Volume |
Enables Partner to assess the performance of the organization portfolios for the selected period. (blue bars) and other being the sum of credits (red bar)settled transactions posted from Sunday 12:00:00 AM PST to Saturday 11:59:59 PM PST for the selected Time Period. |
|
New Locations Processing |
Provides the Partner the ability to view the Total Number of New Locations that are added to their Organization Portfolio and have begun processing transactions. |
|
Transaction by Count |
Partners can view the settled transactions by the method of payment being used for the selected period of time. |
|
Top 10 High Volume Merchants |
Provides the Partner a view of the Top 10 High Volume Merchants (displayed in descending order) transactions that are settled based off the time period selection. • Data in the chart is displayed with Merchant DBA name, Location ID and Percentage and Total Dollar amount. The Total Dollar Volume amount displayed in the chart is a comparison of settled transactions between the current $ Volume and previous $ Volume for the time period selected. |
|
Application Status |
Provides Partner information on the Status of Merchant Applications received for the Organization. |
|
Application Status |
Provides Partner information on the Status of Merchant Applications received for the Organization. |
Note: Provision to download the entire chart as an excel file (.xlsx) is available for the Partners. Please click the download icon 
located on the right corner of the chart.
Currently Top 10 High Volume Merchants and Application Status charts do not have the provision of download.
Downloading Chart or Widget Data
Dex provides Partners with the ability to download data for specific charts or widgets located on the Partner Dashboard. The download data includes a breakdown of key metrics that gives the Partner information related to their Organization and the Portfolio(s) within their Organization.A download icon is available with the option to download the provided information into an .xlsx file format based on the Time Period Selection.
To download data, perform the following steps:
1. Navigate to the Partner Dashboard by clicking Home module in Dex main menu.
2. Navigate to the Chart or Widget on the Partner Dashboard and select the respective ‘Time Period’ from the drop down for the data display.
3. Click the Download icon to download your file.
4. A toaster message is displayed on the screen to show the progress of the Download action.
5. After the File is Ready, the Downloaded file is available to be viewed or saved to your operating system in a .xlsx file format in Microsoft Excel.
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, 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:
- Navigate to your Organization's Details Screen by clicking Organizations on the Dex main menu.
- Click the Security tab.
- Under the Suspended Users section, click the Manage link.
- Dex displays all of your organization's suspended users on the Users Datagrid.
- Reactivate each user using one of two methods:
- From the Users Datagrid, click
> Reactivate. - Access the User's Details Screen and click Actions > Reactivate.
- From the Users Datagrid, click
- A Reactivate User message displays asking you to confirm the action. Click the Reactivate button. Dex reactivates the user and restores his/her access.
- 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:
- 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.
- Click the Send Code button. Dex sends you a six-digit verification code to your registered email (i.e., username).
- Enter the six-digit code in the provided text box. Dex gives you up to three attempts to enter the correct verification code.
- Click the This is a public or shared computer checkbox if you are accessing Dex from a non-private/personal device.
- 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:
- Log into your Dex Home Organization and click Organizations in the Dex main menu.
- 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.
- From the Organization's Details screen, click the Security tab.
- Click the Manage link under IP Allow Lists. A Manage IP Allow List modal displays.
- Click the toggle (i.e., make it green) next to the Enable IP Allow List field. The IP Address and Name fields display.
- 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).
- In the Name field enter a 60-character or less name for the IP address or range of addresses.
- Click the Add button. The IP address is added to the save list that displays on the Manage IP Allow List modal.
- Repeat steps 6–8 for all the IP addresses/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:
- Log into your Dex Home Organization and click Organizations in the Dex main menu.
- Click the row on which the desire organization displays. The Organization's Details screen displays.
- Click the Security tab on the Organization's Details screen.
- Click the Manage link under IP Allow List. A Manage IP Allow List modal displays.
- 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).
- In the Name field enter a 60-character or less name for the IP address or range of addresses.
- Click the Add button. The IP address is added to the save list that displays on the Manage IP Allow List modal.
- 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:
- Find the desired address by scrolling through the list or searching for it by Name or IP Address in the Search field.
- Click the Edit icon that displays next to the IP address you want to modify. The text fields displaying the address values becomes editable.
- 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.
- 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:
- Find the desired address by scrolling through the list or searching for it by Name or IP Address in the Search field.
- Click the Delete icon that displays next to the IP address you want to delete. A message displays asking you to confirm the deletion.
- Click the Delete button to confirm the deletion and return to the Manage IP Allow List modal.
- 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:
- Log into your Dex Home Organization and click Organizations in the Dex main menu.
- 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.
- From the Organization's Details screen, click the Security tab.
- Click the Manage link under IP Allow Lists. A Manage IP Allow List modal displays.
- 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.
- 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:
- Log into Dex using your current credentials.
- Click on the User icon in the upper right corner, and select My Profile. Your Dex Profile Page displays.
- Click the Actions dropdown and select Change Password. The Change Password Screen displays.
- Enter your current password in the Current Password field.
- 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
- Click the Save button. Dex returns you to your Dex Homepage.
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:
- Click the Forgot password? link on the Dex Login page. Dex displays the Forgot Your Password page.
- Enter the email you used to register for Dex in the provided field.
- Select the I'm not a robot reCaptcha challenge checklist to prove you're human.
- Click the Send Code button. The Forgot Password Confirmation Page displays.
- Dex sends you an email with a unique, six-digit verification code. Enter this code in the provided field.
- Click the Verify Code button. If you didn't receive the code, click the Resend Code link to initiate another text message. After verifying your code, the Reset Password page displays.
- Enter your new password in the data fields. 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 login name
- 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.
Search for a Home Account
Accessing a Home Organization
If you need to access a merchant organization and don't want to scroll through a long list, you can simplify the process by searching for the merchant or partner's home organization using the Home Organization Search field located in the upper left corner of any Dex screen.
To search for an organization, complete the following steps:
- Click the Down Arrow next to the Home Organization Search field. A search dropdown displays.
- In the Search Organizations free-text field, enter the name or ID of the organization. If you don't know the name or ID of the organization, you can also search for the organization using one of the following supported options:
- Location ID
- DBA Name (full/partial/contained)
- Fed ID
- Bank Account Name
- Email (full)
- Phone Number (digits only)
- Portfolio ID
- Contact Name
- As you begin to type, Dex begins populating and displaying scrollable list of search results that contain the given data.
- Scroll through the list of organizations in the search results and click on the organization you want to access. Dex opens the Dex Homepage for that organization.
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 Enterprise Admin permissions for Enterprise Organizations. Users invited to Partner organizations receive ISV - Support 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:
- Transactions (see the section below for exporting from the transaction data grid)
- Disputes
- Funding
- Customers
- Schedules
- Organizations
- Locations
- AutoPay (for BillPay merchants)
- Applications
Refund / Credit / Unfunded transactions will be displayed as a negative value (e.g. -$10.00) for the following fields:
-
Amount
-
Principal
-
Service fee
-
Tax Amount
Void transactions will be displayed as a zero value (e.g. $0.00) for the following fields:
-
Amount
-
Principal
-
Service fee
-
Tax Amount
To export data, complete the following steps:
- Access the appropriate datagrid by clicking the option from the Dex main menu.
- If desired, use the filters and the Expand Datagrid button (
) to customize the list of data you want to download. - 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. - 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:
-
Access the transactions data grid by clicking the option from the Dex main menu.
-
If desired, use the filters and the Expand Datagrid button (
) to customize the list of data you want to download. -
Click the Download button (
) in the upper right corner of the datagrid (next to the Sort By dropdown). -
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 | Description |
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 To 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 |
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. |
PayPal Order ID | The PayPal transaction Order ID number. |
PayPal Account | The Customer PayPal email account . |
Delete any fields not needed in the download file by clicking on the delete icon
to the right of the field.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.Select the format of the file, CSV or XLSX, using the format option at the bottom of the modal.
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.
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.
After select the format click on Download
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:
-
Access the transactions data grid by clicking the option from the Dex main menu.
-
If desired, use the filters and the Expand Datagrid button (
) to customize the list of data to download. -
Click the Download button
-
Click on Download and Save
-
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:
-
Access the transactions data grid by clicking the option from the Dex main menu.
-
If desired, use the filters and the Expand Datagrid button (
) to customize the list of data you want to download. -
Click the Download button (
) in the upper right corner of the datagrid (next to the Sort By dropdown) -
Click on Select a Template
-
Click on the selected "Template"
-
The template will be loaded on the download transaction modal
-
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 -
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
-
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:
-
Access the transactions data grid by clicking the option from the Dex main menu.
-
If desired, use the filters and the Expand Datagrid button (
) to customize the list of data you want to download. -
Click the Download button (
) in the upper right corner of the datagrid (next to the Sort By dropdown) -
Go to the up-right corner option: Select a template, a list of saved templates will be presented.
-
Click on the 3 dots at the end of the template to be deleted.
-
Click on Delete Template
-
Confirm the action by clicking on Delete
-
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:
- Switch to the Sandbox environment from Live.
- Click the Refresh Data button in the upper-right corner of Dex. The Refresh Data modal displays.
- 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.
- Click the Refresh button. If successful, Dex returns you the Dex homepage and displays a success message.
Managing Two Factor authentication
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.
Remember this Device for 24 hours option during login
1. For a particular device and browser combination, once the user enters the security code and selects ‘Remember Me’ then it will get activated for 24 hours irrespective of the user logging in and logging out any number of times.
2. If the user chooses a different device and/or browser then DEX will recognize it as a new device/browser and ask the user to ‘Remember Me’. Once done a new 24-hour countdown will start for the same.