Locations - Corporate
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.
Managing Bank Accounts for a Merchant Location
The Bank Accounts tab in Location Details provides a centralized view of all bank accounts associated with a merchant location. The updated interface improves visibility and management by displaying each bank account individually and identifying its intended use through category tags.
NOTE: Forte-owned bank accounts and billing bank accounts are protected by the corporate lock. Forte employees view these bank accounts, and only with appropriate permissions can manage them.
Each bank account associated with the merchant location is displayed on a separate card.
Each bank account card displays:
- Bank account information
- Category Tags indicating the purpose or usage of the bank account
- Nickname (if configured) to help distinguish between multiple bank accounts
- Edit icon (users with appropriate permissions only)
Users can hover over a Category Tag to view a tooltip describing the category.
NOTE: Only users with the appropriate permissions can view and use the Add Bank Account and Edit Bank Account actions.
Add a Bank Account
Users with the required permissions can add a new bank account from the Bank Accounts tab.
To add a bank account:
- Select the Add Bank Account icon.
- Complete the required information in each section.
- Provide the following Bank Account information:
Field | Status | Description |
Routing Number | Required | Enter the bank's transit routing number. After entering this value, Dex auto-populates the name of the bank in the Bank Name field. |
Account Number | Required | Enter the account number of the business checking or business savings account the merchant uses. |
Account Type | Required | Use the radio button to select whether this is a business Checking account or a business Savings account. |
First Name | Required | Enter the first name of the bank account holder. |
Last Name | Required | Enter the last name of the bank account holder. |
Business Name | Optional | Enter the business name associated with the bank account, if applicable. |
Bank Account Nickname | Optional | Enter a nickname to help identify the bank account. |
Charge Merchant a Change Fee | Optional | Select this option to charge the merchant the applicable fee for changing their bank account information. |
Comment | Optional | Enter additional information or notes about the bank account. |
Supporting documents | Optional | Upload any documents required to support the bank account addition or update. |
- Select one or more categories that will use this bank account.
If the selected categories are currently assigned to another bank account, they will be moved to the new bank account. - Select Save to create the bank account.
Edit a Bank Account
Users with the required permissions can modify an existing bank account.
To edit a bank account
- Select the Edit icon on the desired bank account card.
- Update the following information:
Field | Status | Description |
Routing Number | Required | Enter the bank's transit routing number. After entering this value, Dex auto-populates the name of the bank in the Bank Name field. |
Account Number | Read-only | View the account number of the business checking or business savings account the merchant uses. |
Account Type | Read-only | View the Account type, whether this is a business Checking account or a business Savings account. |
First Name | Required | Enter the first name of the bank account holder. |
Last Name | Required | Enter the last name of the bank account holder. |
Business Name | Optional | Enter the business name associated with the bank account, if applicable. |
Bank Account Nickname | Optional | Enter a nickname to help identify the bank account. |
Charge Merchant a Change Fee | Optional | Select this option to charge the merchant the applicable fee for changing their bank account information. |
Comment | Optional | Enter additional information or notes about the bank account. |
Supporting documents | Optional | Upload any documents required to support the bank account addition or update. |
- Select categories assigned to the bank account.
Categories can be moved from one bank account to another by updating the category assignments. - Select Save to apply the changes.
Save and Cancel
The Save button is enabled only after one or more fields have been modified.
When Save is selected:
- A confirmation dialog is displayed.
- Confirm the save request to apply the changes.
- The bank account is added or updated.
- The user is returned to the Bank Accounts tab.
- Selecting the X on the confirmation dialog closes the dialog and returns the user to the Add Bank Account or Edit Bank Account pane without saving.
The Cancel button is always available while adding or editing a bank account.
When Cancel is selected:
- A confirmation dialog is displayed.
- Select Leave Progress to discard all unsaved changes and return to the Bank Accounts tab.
- Select the X on the confirmation dialog to close the dialog and continue editing.
Work with Transaction Settings
The transaction settings tab is visible only to users with appropriate permissions on the Location’s Details Screen in Dex. This tab enables users to create custom fields to include in the transaction creation flow to obtain necessary information pertaining to the customer in upcoming transactions. In the transaction settings tab, users can change the label names, enable, disable or delete the custom fields and set the custom field as required or optional for the add new transaction and add new schedule transaction screen.
The configurable Custom Order Field labels are Order ID, Wallet ID, and data labels 1-4.
The configurable Custom Customer field labels are Email and Phone
To configure the label names, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it’s listed. The Location’s Detail screen displays.
- If not already selected, click the Transaction Settings tab.
- If you want to add additional Custom Order fields, click in the option ADD NEW FIELD + and a new line will be displayed.
Note: This action will be available on only for the Custom Order Fields. The maximum fields allowed is 4 fields (Data label 1-4) - In the new line change the Custom Label field will be enable and the label name will be available to be changed if needed.
Note: By default the label names are Data label 1, Data label 2, Data label 3, Data label 4. - Choose one option in the “Required” section: Required or Optional.
NOTE: by default the Optional will be selected. - The Discard option will cancel the configuration and the Save and Activate option will save the label name configuration and activate the label in Dex.
Toggle Status | |
Inactive (Disable sate) | The field is not enabled. |
Active (Green) | The field is Active and visible. |
Required Status | |
Required | The field will be mandatory for the user and will be displayed with * icon. |
Optional | The field is optional and not need to be filled in compulsorily. |
Editing a field
To edit an existing custom field in the transaction settings, complete the following steps:
1. Click Locations on the Dex Main Menu. The Locations screen displays.
2. Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
3. When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
4. If not already selected, click the Transaction Settings tab.
5. Click in the pencil icon
6. The Custom Label field will be enabled, and the label name will be available to be changed if needed.
7. Choose one option in the “Required” section: Required or Optional. Note :By default the Optional is selected.
8. The Discard option will cancel the configuration and the Save and Activate option will save the label name configuration and activate the label in Dex.
Search for a Location
The Locations Datagrid enables users with appropriate permissions to view the processing endpoints, or locations, that belong to an Organization. You can sort location records in ascending/descending order by Created Date or alphabetically by Location Name. To find a specific location, you can filter the displayed results by Status, States, Postal Code, and/or Services. You also can customize the number of items that display using the display dropdown in the bottom left corner.
To access the Locations Datagrid, click Locations from the Dex main menu. To view the details of a specific location without having to filter through a long list, enter one of the following values in the search bar:
- Location Name
- Location ID
Dex auto-populates the results datagrid as you type. Use the search filters described below to further refine your results.The following table provides a brief description of what each column displays on the Customers Datagrid:
Column | Description |
Location | The name and ID of the location. |
Status | The status of the location. Supported options include: Live |
Address | The physical address of the location. This includes the street address, city, state/province, and postal code. |
Contact | The name of the location's primary contact. |
Services | The type of transaction processing services offered by the location. Supported options include the following: eCheck |
Organization | The merchant organization to which the location belongs. |
Partner ID | The partner organization to which this location's merchant organization belongs. |
Created Date | The date when Forte created this location. |
Filtering the Location Datagrid
You can apply the following filters to customize the displayed location datagrid:
Filter | Description |
Status | The status of the location in Dex. The following values are supported: Live (default) |
States | The state(s) where the location does business. |
Postal Code | The postal code where the location does business. |
Services | The type of transaction processing services offered by the location. Supported options include the following: eCheck |
View Location Details
A Location's Details Screen enables users with appropriate permissions to view the details of a particular location. This information includes contact data, the type(s) of Forte transaction processing services this location offers, the merchant bank account where Forte funds the merchant for transactions, billing costs, and controller/owner information.
To view the details of a location, complete the following steps:
- Access the Locations Datagrid by clicking Locations in the Dex main menu.
- Search for the desired location record by Name or ID. You can also use the Status, States, Postal Code, and Services filters to narrow down the list of displayed results.
- When you find the desired location record, click the row on which the location's record displays. The Location's Detail Screen displays.
The following table describes what each data card on the Location's Details Screen displays:
Card/Tab | Description |
General | The status of the location. Supported values include the following:
|
The unique, string ID number of the location. | |
The unique, string ID number of the location's assigned transmitter. | |
The Doing Business As name of the location. | |
The physical address of the location. This includes the street address, city, state/province, and postal code. | |
The business phone number of the location. | |
The time zone of this location's physical address. Supported options include the following:
| |
The type of business this location maintains. For a full list of supported options, see Forte's Business Classification Codes. | |
The merchant organization to which this location belongs. | |
The partner organization to which this location's merchant organization belongs. | |
The date when Forte created the location. | |
The ID of this merchant's Forte application. This link accesses the Application's Details Screen. | |
Contact | The name, email, and phone number of this location's primary contact. |
Products and Services | A listing of all the transaction processing services this location provides and the add-on Forte services to which this location subscribes (e.g., Account Updater, Alternative Methods of Payment,IVR,PayPal, Validate/Validate+ and Authenticate verification services, BillPay, Secure Web Pay,Text to Pay, and Straight Through Processing). Clicking on a service's listing displays additional details about it, such as permissible SEC codes for eCheck transactions, location-specific ACH cutoff times, Services the card brands this location supports, debit and credit threshold limits, the conditions upon which a transaction will automatically decline with Validate+ and or Authenticate, the day of the month that Dex runs the Account Updater service, or the digital wallets enabled for a merchant. |
Bank Accounts | The merchant bank account(s) this location uses for Funding Debits, Funding Credits, Card Service Fees (e.g., Principal Only, Fee Only, Principal + Fee), and/or ACH Service Fees (e.g., Principal Only, Fee Only, Principal + Fee). |
Documents | This tab holds all attachments pertinent to this merchant location (e.g., a pdf copy of the original merchant application, rate plan, and merchant service agreement). Supported attachments include the following:
Only corporate users and Merchant Admins can view and upload documents. |
Billing | A detailed list of the agreed upon product costs for each merchant location. The codes listed here depend on your merchant location. View a list of product codes:
|
Controller/Owners | Displays the name and ownership percentage of all the owners for this location. Clicking on an owner displays more information about him/her, including contact information and personal identifying data. |
Transaction Settings | Visible only to users with appropriate permissions. Allows the ability to create and edit custom fields used in the add transaction modal and the add new schedule transaction modal. |
Billing | The billing details associated with a location, including a breakdown of product costs and billing options the merchant can choose (e.g., manual billing, statement printing, etc.). Only Forte employees, Merchant Admins, and Dispute Managers can view this tab. |
Edit Location Details
Users with the appropriate permissions have the ability to edit the general information of a location. This includes the Doing Business As (DBA) name and mailing address data. To edit the general details of a merchant location, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu.
- Search for the desired location by Name or ID or use the filters to narrow down the list of displayed locations. Once you've found the desired location, click the row on which it's listed.
- Click the Edit button in the location's general card. The Location Edit Modal displays.
- Make updates to the following fields:
Field | Description |
DBA Name | The Doing Business As or Display name of the location. This is the name Dex uses when you search for the location in the various modules. |
Street Address | The street number and name of the location's physical address. |
Street Address 2 | If necessary, the second line of the location's physical address (e.g., Suite 600, Apt 2B, etc.) |
Postal Code | The 5-digit ZIP or postal code of the location's physical address. When you enter a value into this field, Dex automatically populates the City and State/Province fields. |
City | The city of the location's physical address. Dex automatically populates this field when you enter a 5-digit ZIP code in the Postal Code field. |
State/Province | Use the dropdown to select the state or province of the location's physical address. Dex automatically populates this field when you enter a 5-digit ZIP code in the Postal Code field. |
Time Zone | The time zone of this location's physical address. This field affects when transactions captured by this location settle. Supported options include the following: Alaska Standard Time (AKST) |
- Click the Save button on the Location Edit Modal to save the changes and return to the Location’s Details Screen.
Work with eCheck Settings
Internal user's with the appropriate permission can view and update a merchant location's echeck settings, including hold days, SEC codes, debit limits, recollect options, and ODFI settings. These settings determine how and when merchants are funded and how they process ACH transactions.
Activating eCheck Services
Dex gives the Forte Enrollment Team the ability to activate and deactivate echeck services for a merchant location. This action automatically updates those same services in WebTools. To enable echeck services, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu. (Alternatively, you can access the merchant's organization and then navigate to the Locations Datagrid.)
- Search for the desired location by Name or ID or use the filters to narrow down the list of displayed locations. Once you've found the desired location, click the row on which it's listed. The Location's Details screen displays.
- If not already selected, click the Products and Services tab.
- Click the toggle that displays next to the eCheck Services listing to "On" (i.e., turn it green). An "Activate eCheck Services" message displays warning you that once activated, the merchant location will be able to process echeck transactions.
- Click the Activate button on the message. Dex returns you to the Location's Details Screen with the eCheck Services listed as "Inactive."
- To edit the settings, processor options, and auth stack for this merchant's ACH services, click the
that displays next to the toggle to access the Edit eCheck Services Modal. NOTE: If you're reactivating echeck services for a merchant, those previously defined settings will display in the Edit eCheck Services Modal.
Updating eCheck Settings
Only users with the Credit_Enrollment_1 role have the permissions to update eCheck settings. To access the tab, you must click the Corporate lock icon.
Hold Day Settings
Use the sliders on the Hold Days Debit, Hold Days Credit, and Hold Days Resubmit fields to select the number of hold days for debit, credit, and resubmit transactions. The standard hold time for ACH debit and credit transactions is four business banking days, to which Dex defaults when enrolling the merchants. Dex supports a maximum of 10 hold days for debit and credit hold days and a maximum of 14 hold days for resubmits. Merchants who want to reduce their hold time to less than four business days must complete a Faster Funding Request form and submit the required documentation.
Debit and Credit Limits
In the provided free-text fields, enter the limits for debit and credit echeck transactions:
- Per - The maximum dollar amount this merchant can charge for echeck debit transactions or the maximum dollar amount this merchant can disburse for echeck credit transactions. This amount limit cannot be higher than the Daily or Monthly limits.
- Daily - The total dollar amount this merchant can charge in a 24-hour period for echeck debit transactions or the total dollar amount this merchant can disburse in a 24-hour period for echeck credit transactions.
- Monthly - The total dollar amount this merchant can charge in a 1-month period for echeck debit transactions or the total dollar amount this merchant can disburse in a 1-month period for echeck credit transactions.
SEC Codes
Dex sets the default SEC Code values to WEB, TEL, PPD, and CCD for all merchants set up with ACH services. These values are reflected in both Dex and Webtools until the legacy applications are fully deprecated. For guidance on what SEC code should be assigned to a merchant location, see Working with SEC Settings. If the merchant needs to support additional SEC codes beyond the defaulted values, select them from the list. Selected codes display in blue.
The Entry Description Override value overrides whatever value the merchant originally sends in the Entry Class Code field when submitting the transaction. To set a value for the Entry Description Override field, use the dropdown menu to select the preferred SEC Code. NOTE: The values that display in the Entry Description Override field are populated from the list of selected SEC codes.
The Duplicate Transaction Timeout field displays the number of minutes merchants must wait before sending a transaction that has the same payment method and authorization amount as a previously submitted transaction. If sent within the timeout threshold, the second transaction will decline with a U10 Duplicate Transaction response code. To define a value for the Duplicate Transaction Timeout field enter the number of minutes in the free-text field. If no value is entered, Dex defaults this field to 5 minutes.
Updating Recollect Settings
The Recollect Options tab defines the merchant's settings for recollection attempts when echeck transactions are returned for non-sufficient (R01) or uncollected (R09) funds. These settings determine when and how many recollection attempts should be made for a returned transaction. The following settings can be updated:
Field | Description |
Recollect Attempts | Use the dropdown menu to select how many times Forte CSG should attempt to recollect the transaction. The maximum number of recollection attempts is 2. |
Alternate Payment | Toggle this field on (i.e., green) to define alternative payment options. A Method field for the alternate payment displays at the bottom of the Edit eCheck Services Modal. See the Method field description for more information on available options. |
Method | Use the dropdown menu for Attempt 1, Attempt 2, and/or Alternate Payment to select the method or recollection. Supported options include the following: Immediate - The transaction will be re-presented on the day it is returned. |
Updating Processor Information
Only users with the ODFI_update permission (i.e., Credit_Enrollment_I role) can update a merchant's ODFI information and ACH cut-off time from the Location Details screen. Assigning the correct ODFI to the merchant's location ensures the merchant receives his/her funding on time and without incident. To update ODFI settings, navigate to the Edit eCheck Services Modal (see above) and complete the following steps:
- Click the Processor tab and then the Corporate Only icon. The ODFI selection dropdown displays.
- Use the dropdown menu of the ODFI field to select the correct institution.
- If required, enter the institution's NACHA ID in the Nacha ID free-text field.
- Use the dropdown menu of the ACH Cut-Off Time field to select the appropriate cutoff time (in Central Standard Time) for the merchants ACH transactions. Most ACH merchants have a cutoff time at approximately 6:30PM CST Monday through Friday (except on bank holidays).
- Click the Save button to return to the Location Details screen.
Updating the Authorizer Stack
The Auth Order tab of the Edit eCheck Services Modal gives permissioned corporate users the ability to define and modify the authorizers for ACH transactions. These Authorizers can include both internal databases and third-party vendors to authenticate a customer and minimize the risk inherent in echeck transactions. To update, define, or modify the auth stack, navigate to the Edit eCheck Services Modal (see above) and complete the following steps:
- Click the AuthOrder tab and then the Corporate Only icon. A list of available authorizers displays.
- Click the toggle (i.e., turn it green) next to each authorizer to enable the service for the merchant location. The following service/vendors are available:
- AOA - Account Owner Authorization is a service that leverages a national database of current financial data to authenticate the ownership, signatory, and status of an account by checking the business name, address, and Tax ID associated with Demand Deposit Accounts (DDA).
- Account Owner Authentication - Ownership Check Only - a service that leverages account owner data to confirm the account is valid and in good standing and authenticate the identity of the account owner or authorized user (for WFMS only).
- Internal ACH Processing - Forte uses our own proprietary TRN Blacklist, Checksum, and Known Bad Accounts databases to ensure the transaction is not linked to a known bad account or routing number and that the account number was properly submitted and passes a check digit validation.
- SPS - The SPS configuration encompasses multiple verification services and checks for risk items like young accounts. NOTE: All Validate+ configurations must include either SPS or PPS. Merchants can customize their Validate+ configuration on their Location's Details Screen.Test Authorizer - This enables merchants to fully test their ACH configurations via a testing authorizer service.
- PPS - The PPS system runs multiple verification checks that analyzes the customer's account for risk items such as the number of NSFs associated with the account. NOTE: All Validate+ configurations must include either SPS or PPS. Merchants can customize their Validate+ configuration on their Location's Details Screen.
- Drag and drop the authorizers in your preferred order. Only enabled options can be moved.
- Click the Save button to return to the Location's Details Screen.
Deactivating eCheck Services
To deactivate a merchant's echeck processing abilities, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu. (Alternatively, you can access the merchant's organization and then navigate to the Locations Datagrid.)
- Search for the desired location by Name or ID or use the filters to narrow down the list of displayed locations. Once you've found the desired location, click the row on which it's listed. The Location's Details screen displays.
- If not already selected, click the Products and Services tab.
- Click the toggle that displays next to the eCheck Services listing to "Off" (i.e., turn it gray). A "Deactivate eCheck Services" message displays warning you that once deactivated, the merchant location will not be able to process echeck transactions.
- Click the Deactivate button on the message. Dex returns you to the Location's Details Screen with the eCheck Services listed as "Inactive." NOTE: If or when you decide to reactivate echeck services for a merchant, all the previously defined settings will reactivate as well.
Work with Card Settings
User's with the appropriate permissions can view and modify the Address Verification Services (AVS) and Card Verification Value (CVV) settings of a merchant's account from the Location's Details Screen in Dex. Obtaining an AVS match and requiring CVV values reduces credit card fraud—especially for card-not-present merchants—and greatly reduces the merchant's risk of chargebacks and fraud dispute liability. CVV matches provide a quick method of customer identification and card verification for card-not-present transactions. The AVS system compares the ZIP or Postal Code provided by the customer to the ZIP or Postal Code of the customer billing address on file with the credit card issuer. In Dex, you can view and configure whether or not to require CVV values and configure your AVS settings to either warn you or decline the transaction in the event of a ZIP code mismatch.
Viewing CVV Settings
To view the CVV settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the
on the Card Services row. Details about the merchant's credit card services display.
- Look for the Card Verification Value (CVV) field. This is the field applicable to CVV checks. The value in this field indicates whether CVV submission is Optional or Required.
- Click the
on the Card Services row to close it.
Editing CVV Settings
To edit the CVV settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the Edit icon that displays on the Card Services row. The Edit Card Services Modal displays.
- Click the CVV tab. The Card Verification Value (CVV) field displays.
- Select whether you want to make this value Required or Optional for customers by selecting the applicable radio button.
- Click the Save button to update the settings and return to the Location's Details screen.
Viewing a Merchant's AVS Settings
To view the AVS settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the
on the Card Services row. Details about the merchant's credit card services display.
- Look for the Postal Code and Postal Code Mismatch fields. These are the fields applicable to AVS checks. The values in these fields indicate whether you want to make the Postal Code field Required or Optional, and whether you want Forte to Warn you of a mismatch, to automatically Decline the transaction, or to not perform the AVS check at all (i.e., Don't Check).
- Click the
on the Card Services row to close it.
Editing a Merchant's AVS Settings
NOTE: Only Merchant and Enterprise Admins can edit AVS settings.
To edit the AVS settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the Edit icon that displays on the Card Services row. The Edit Card Services modal displays.
- Under the Postal Code field, select whether you want to make this field Required or Optional for transactions. If you select Optional, the only Postal Code Mismatch options available are Don't Check or Warn.
- Under the Postal Code Mismatch field, select one of the following actions you want Forte to do in the event of a mismatch:
- Warn
- Decline
- Don't Check - Default
- Click the Save button to update your settings and return to the Location's Details screen.
Working with PayPal settings
A new resource for PayPal has been created for users with appropriate permissions to view and manage PayPal settings of a Merchants account from the Location Details screen in Dex. See Users > Understanding Roles for more information.
Generating the PayPal Onboarding Link
Users with the following roles have been granted the permissions to generate the onboarding link for the merchant and see a show/hide button in the PayPal card section to view the entire PayPal Merchant ID once the onboarding status displays as ‘Active’ in Dex: Base Implementation, Credit Enrollment_I and Credit Enrollment_Supervisor.
To generate the PayPal onboarding link for a merchant, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays..
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click Generate a PayPal Onboarding Link to Start button.
- The Merchant Location Onboarding link will be displayed, and the status will remain ‘Inactive’.
-
If the Partner/Portfolio PayPal Onboarding Notification has been set up, the Notification will be sent to the Merchant for the Merchant to begin their Onboarding process.
-
If the Partner/Portfolio Onboarding Notifications have not been set up, the Onboarding link will be displayed for the Merchant to access Dex and begin their Onboarding process.
-
If the Merchant does not have access to Dex, the Onboarding link can be copied and sent to the Merchant, if required.
Viewing the PayPal Settings
To view the PayPal settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
-
If not already selected, click the Products and Services tab.
-
The Merchant Location Onboarding link will be displayed and one of the following Statuses will be displayed:
Status | Message |
Inactive | Onboarding Inactive: Merchant Onboarding link has been Generated for the Onboarding process to begin. Click the link to start the Onboarding process for your PayPal Merchant Account |
Pending PayPal Merchant ID | Onboarding Pending: Merchant has completed the Forte/PayPal Onboarding process. Connection process pending PayPal Merchant ID |
Error Connection to PayPal | Onboarding Error: Merchant Onboarding has an error during the onboarding process. Click the link to try again. |
Active | Onboarding Active: Merchant Onboarding has been completed and the Merchant account can begin processing PayPal transactions. |
6. Click the copy icon of the Merchants PayPal Onboarding to share with the Merchant location, if required.
PayPal Mass Onboarding
To create a request for PayPal Mass Onboarding for a Parter/Portfolio, complete the following steps:
-
Create a Mass Enablement XLSX supported file required for enablement. The enablement file must include the Partner/Portfolio and Merchants information. (Location_ID, PAYP and PAYM Pricing)
-
Create an FD ticket requesting PayPal to be enabled and the Onboarding link(s) to be created from the attached Mass Onboarding Enablement supported file
- Assign the FD ticket to the Data Miners team.
-
DTM team will process the file
-
Verification Checks will be performed automatically to qualify each Merchants location for PayPal.
-
The PayPal Fee Codes (PAYP and PAYM) will be added to the Merchants location billing table.
-
A unique Onboarding link is created in Dex on the Merchants location > Products and Services tab. The Onboarding link will have a 1-year expiry.
-
DTM team will create and return the enablement file to the requester (Sales Rep/AM). The return file will include the original request of Merchant Location IDs, the PayPal Per Transaction Fee, the PayPal Monthly Fee, any error messages, if the Merchant did not qualify and a copy of the Merchants unique Onboarding link.
-
The requester can determine if the copy of the onboarding link(s) need to be shared with the Partner.
Disabling PayPal Services
To disable PayPal settings for a merchant, complete the following steps:
-
Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
-
Navigate to the PayPal card section & slide the toggle to the ‘Off’ position. The toggle will turn grey, and the PayPal Merchant Account Information will be hidden from the PayPal card section.
-
A PayPal deactivate date will be captured in the Merchant Processing Config table.
-
The PayPal Status will be displayed as ‘Inactive’
Work with Forte Verify Settings
Working with Validate/Validate+ Settings
User's with the appropriate permissions can view and modify the bank account status verification settings of a merchant's account from the Location's Details Screen in Dex. Merchants can customize how much risk they're willing to accept when performing echeck transactions by defining the response to Validate and Validate+'s preauthorization checks.
Using proprietary methods, Validate and Validate+ check EFT accounts for the following characteristics:
- Has the account been reported as closed?
- Has the account issued a stop payment within the last 30 days?
- Has the account had one or more Non-Sufficient Funds (NSF) transactions with the last 90 year?
- Has the account had 3 or more NSF transactions with the last 90 days or 5 or more NSF transactions in the last year?
- Does the account accept debit activity?
Validate and Validate+ Merchants can then determine whether or not to approve a transaction based upon these characteristics and define those settings in Dex.
Viewing Validate/Validate+ Settings
To view the Validate/Validate+ settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the down arrow next to Verification Services. The following account options and currently defined transaction responses display for Bank Account Status Verification:
Validate Plus:- Young Accounts -The account verified has been in good standing for 90 days or less.
- Valid but Unknown accounts-The account provided has the right format but has not been seen before in Verification databases.
- Account Closed - The account provided was reported as closed.
- Stop Payment - The account provided has issued a stop payment within the last 30 days.
- Non-Sufficient Funds (NSF) - The account provided had 1 or more NSF transactions within the last year.
- Excessive Non-Sufficient Funds (NSF) - The account provided has had 3 or more NSF transactions within the last 90 days or at least 5 NSF transactions within the last year.
- No Debits - The account provided does not accept debit activity.
Validate:- Young Accounts - The account verified is in good standing for 90 days or less.
- Account Not Found - The account could not be verified. This could be a non-existent account and/or the issuing bank is not participating in the verification service
- Click the up arrow in the Verification Services box to close it.
Editing Validate+ Settings
To edit the Validate+ settings of a merchant location, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations screen displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- If not already selected, click the Products and Services tab.
- Click the Edit button that displays on the Bank Account Status Verification Services row. The Validate or Validate+ Settings modal displays.
- Click either the Approve or Decline radio buttons next to the following options. These buttons define whether Forte should automatically decline transactions for accounts that meet the preauthorization criteria.
Validate Plus:- Young Accounts -The account verified has been in good standing for 90 days or less.
- Valid but Unknown accounts-The account provided has the right format but has not been seen before in Verification databases.
- Account Closed - The account provided was reported as closed.
- Stop Payment - The account provided has issued a stop payment within the last 30 days.
- Non-Sufficient Funds (NSF) - The account provided had 1 or more NSF transactions within the last year.
- Excessive Non-Sufficient Funds (NSF) - The account provided has had 3 or more NSF transactions within the last 90 days or at least 5 NSF transactions within the last year.
- No Debits - The account provided does not accept debit activity.
Validate:- Young Accounts - The account verified is in good standing for 90 days or less.
- Account Not Found - The account could not be verified. This could be a non-existent account and/or the issuing bank is not participating in the verification service.
- Click the Save button to update the settings and return to the Location's Details screen.
Bank Account Owner Verification
Working with Authenticate
Bank Account Owner Verification Service (Authenticate) allows Forte’s customers (merchants and partners) to verify the ownership of bank accounts prior to sending money to the customer's account. The service verifies if the given person/business (identified by the First/Last name or Business Name) is the owner of a given bank account and is separate from the Bank Account Status Verification service.
Enabling Authenticate
User's with the appropriate permissions can activate Bank Account Owner Verification - Authenticate services.
To enable Bank Account Owner / Authenticate
-
Click Locations on the Dex Main Menu. The Locations screen displays.
-
Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
-
When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
-
If not already selected, click the Products and Services tab.
-
Click the down arrow next to Verification Services.
-
Click on the toggle in the Bank Account Owner Verification – Authenticate section and select Activate when prompted.
Note: If the merchant is not boarded to Early Warning, the toggle will not turn green.
-
Click on the link to board the merchant to Early Warning in WebTools.
Note: If the merchant is already boarded to Early Warning then the service will automatically be enabled and boarding to Early Warning is not necessary.
-
Board the merchant to Early Warning.
Once the merchant is boarded to early warning and Forte receives a file back from Early Warning indicating that the merchant has been successfully boarded the toggle will turn green and the service is activated.
If Onboarding Fails the enrollment team will correct the error and begin the enablement process again.
Viewing Authenticate Status
To view the Authenticate status of a merchant location, complete the following steps:
-
Click Locations on the Dex Main Menu. The Locations screen displays.
-
Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
-
When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
-
If not already selected, click the Products and Services tab.
-
Click the down arrow next to Verification Services. The status of the Bank Account Owner Verification - Authenticate service will be displayed. As the service moves through the Early Warning boarding process the following statuses will be displayed will be displayed:
Status | Message |
Pending | Onboarding Pending: Merchant has been queued for onboarding. |
Pending | Onboarding Pending: File(s) have been sent to Early Warning for onboarding. |
Active | Onboarded Successfully: Authenticate has been enabled for the merchant. |
Inactive | Onboarding Failed: Due to an enrollment error, we couldn’t onboard the merchant. |
Inactive | Onboarding Failed: Due to a validation error, we couldn’t onboard the merchant. |
Viewing Authenticate Status
To view the Authenticate status of a merchant location, complete the following steps:
-
Click Locations on the Dex Main Menu. The Locations screen displays.
-
Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
-
When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
-
If not already selected, click the Products and Services tab.
-
Click the down arrow next to Verification Services. The status of the Bank Account Owner Verification - Authenticate service will be displayed.
Status | Message |
Inactive | Service is not enabled |
Pending | Service is in the process of being enabled |
Active | Service is Active |
Work with Account Updater Settings
NOTE: Only Forte's Enrollment Team can enable/disable or update Account Updater settings.
Forte's Account Updater service gives merchants the ability to prevent interruptions to their recurring transactions by automatically updating cardholder account information for Visa, MasterCard, and Discover credit cards that may have been replaced or reported lost or stolen. The Account Updater service works by exchanging electronic credit card account updates through a batch FTP process with existing account databases that are maintained by the card associations. This keeps declines to a minimum and ensures a more stable cash flow for merchants. Currently, only WorldPay by FIS (i.e., Vantiv) and Wells Fargo merchants can subscribe to the Account Updater service.
Enable Account Updater
To enable Account Updater services for a merchant, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Details screen displays.
- If not already selected, click the Products and Services tab.
- Click the toggle next to the Account Updater listing. An Account Updater Settings modal displays.
- Select one of the following processors:
- Wells Fargo
- Vantiv
- Enter the monthly run date in the Day to Run field.
- Click the Save button. Dex returns you to the Location's Details screen.
Updating the Run Date for Account Updater
Forte recommends running the Account Updater service 4–5 days before any scheduled transactions. Merchants/partners can modify the run day to coincide with changes to their billing schedules; however, Forte requires at least four days to ensure all the systems supporting Account Updater services capture the change (i.e., a merchant who set his or her run date to the 15th of the month and then calls on June 14th wanting to change the day will not get his or her day changed until July). Account Updater defaults the run day to the 15th of every month. To update this value, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Details screen displays.
- If not already selected, click the Products and Services tab.
- Click the
that displays next to the enabled Account Updater toggle. The Account Updater Settings modal displays.
- Enter the day you want Account Updater to run in the Day to Run field.
- Click the Save button to return to the Location's Details Screen.
Account Updater Billing
Account Updater uses two billing codes for invoicing merchants. One is a flat monthly fee for using the service (AUM) and the other is a per-item fee for each update Forte receives (AUI).
The following table lists the response codes Forte receives from Vantiv and Wells Fargo’s Account Updater services. The billable codes are charged to the merchant as an item under the AUI billing code.
Response Code | Description | Card Type | Processor | Forte AU Code | Billable? |
UPDATE | Update Data Provided | Any | Wells Fargo | New | Y |
EXPIRY | Expiration Date Changed | Any | Wells Fargo | Expiry | Y |
CONTAC | Account Closed or Contact Cardholder | Any | Wells Fargo | Closed | Y |
**04NS | Invalid Account Number Length | Any | Wells Fargo | N | |
**05NS | Bad Card Type Code | Any | Wells Fargo | N | |
**06NS | Bad Check Digit Value | Any | Wells Fargo | N | |
**11NS | Non-Numeric Account Number | Any | Wells Fargo | N | |
**12NS | Invalid Expiration Date | Any | Wells Fargo | N | |
**19NS | Merchant Not Registered | Any | Wells Fargo | N | |
UPDATE | Match Made: Update Data Provided | MasterCard | Vantiv | New | Y |
A | Match Made: New Account Number | VISA | Vantiv | New | Y |
A | Account Number Change: Issuer Has Replaced Cardholder Account | Discover | Vantiv | New | Y |
EXPIRY | Match Made: Expiration Date Changed | MasterCard | Vantiv | Expiry | Y |
E | Match Made: Expiration Date Changed | VISA | Vantiv | Expiry | Y |
E | Expiration Date Update: Issuer Updated Expiration Date | Discover | Vantiv | Expiry | Y |
O | Override: Issuer Corrected a Previous Update | Discover | Vantiv | Updated | Y |
Q | Contact Cardholder Advice: Cardholder Has Withheld Updates | Discover | Vantiv | Updated | Y |
CONTAC | Match Made: Closed Account | MasterCard | Vantiv | Closed | Y |
C | Match Made: Closed Account | VISA | Vantiv | Closed | Y |
C | Closed Account: Issuer Closed Cardholder Account | Discover | Vantiv | Closed | Y |
15 | Card Account Number Not Valid | Discover | Vantiv | Closed | Y |
16 | Expiration Date Not Numeric | Discover | Vantiv | Closed | Y |
27 | Undefined Error | Discover | Vantiv | Closed | Y |
N | No Match: Non-Participating BIN | VISA | Vantiv | N | |
P | No Match: Participating BIN | VISA | Vantiv | N | |
Q | Match Made: Contact Cardholder | VISA | Vantiv | N | |
101 | Error: Non-Numeric Account Number | MasterCard | Vantiv | N | |
102 | Error: Bad Check Digit for Account Number | MasterCard | Vantiv | N | |
103 | Error: Invalid Expiration Date | MasterCard | Vantiv | N | |
104 | Error: Merchant Not Registered | MasterCard | Vantiv | N |
Work with Secure Web Pay Settings
NOTE: Only Admins can view or edit a location's Secure Web Pay (SWP) settings.
To prevent toggling between two different products for merchant settings, we've added Virtual Terminal features to Dex. This gives you the ability to set up and maintain your organization settings from one product. In addition to creating legacy credentials and updating card settings, you can now also set up, view, and update your SWP settings. These settings apply to both the Checkout and Embedded (Capture and Charge Templates) versions of SWP.
Disabling/Enabling SWP
If you no longer need SWP, you can easily disable (or enable) it by completing the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu.
- Enter the location's name or ID in the search field, or use the Status, States, Postal Code, Services, or PayFac Profile ID to narrow down the displayed list of locations.
- After locating the desired location, click the row on which it displays. The Location's Details Screen displays.
- If not already selected, click the Products and Services tab and scroll down to the Secure Web Pay (SWP) row.
- Click the toggle to disable (or enable) SWP. If successful, Dex displays a success message.
Viewing and Testing SWP Settings
To view a your SWP settings, complete the following steps.
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu.
- Enter the location's name or ID in the search field, or use the Status, States, Postal Code, Services, or PayFac Profile ID to narrow down the displayed list of locations.
- After locating the desired location, click the row on which it displays. The Location's Details Screen displays.
- If not already selected, click the Products and Services tab and scroll down to the Secure Web Pay (SWP) row.
- Click the View Code link. A View Code modal displays with the full HTML code of your SWP setup. From the View Code modal, you can copy the code by clicking the Copy button or view/test the code by clicking the Test Code button. After clicking the Test Code button, Dex automatically opens a sandbox browser window with a Pay Now button and its corresponding payment form.
- To return to the Location's Details Screen, click Cancel on the View Code modal.
Updating SWP Settings
To update your SWP settings, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu.
- Enter the location's name or ID in the search field, or use the Status, States, Postal Code, Services, or PayFac Profile ID to narrow down the displayed list of locations.
- After locating the desired location, click the row on which it displays. The Location's Details Screen displays.
- If not already selected, click the Products and Services tab and scroll down to the Secure Web Pay (SWP) row.
- Click the
to open the Secure Web Pay Settings modal.
- To update your contact information and payment settings, select the Main tab and edit the following fields:
Field | Description |
Company Name | The Doing Business As (DBA) name of your business. |
Your customer service email address. | |
Phone | Your customer service phone number |
Fax | Your customer service fax number, if applicable. |
Street Address | The first line of the street address of your physical business address. |
Street Address 2 | If necessary, the second line of the street address of your physical business address. |
Postal Code | The postal/ZIP code of your physical business address. |
City | The city of your physical business address. Dex auto-populates this field when you enter a value into the Postal Code field. |
State/Province | The state or province of your physical business address. Dex auto-populates this field when you enter a value into the Postal Code field. |
Accept Unsigned Transactions? | If you use the HTML integration method for SWP Checkout, select Yes. If you use the transaction signing integration method of SWP Checkout or the SWP Embedded Charge or Capture Templates in your desktop applications, select No. |
eCheck | To accept echeck transactions, toggle this field on (i.e., green). |
Transaction Types | Select what types of echeck transactions you want SWP to support by clicking the checkboxes next to the following options: Debit |
Credit Card | To accept credit card transactions, toggle this field on (i.e., green). |
Transaction Types | Select what types of credit card transactions you want SWP to support by clicking the checkboxes next to the following options: Debit |
Card Types | Select the type of card brands your organization supports from the following options: VISA |
Accept Scheduled Transactions? | If you want to allow customers to create schedules and make recurring payments, select Yes. If you do not want to support schedules or you're using the SWP Embedded Charge or Capture Templates, select No. |
B: To update the UI and Return Page URLs of SWP, click the Style tab and edit the following fields:
Field | Description |
Main Logo | Click the Browse button of the logo image box to open a File Explorer window and select the logo image that will display on the SWP payment form. Logo images must be in .jpg format and should be 900px x 100px. |
Side Image | Click the Browse button of the side image box to open a File Explorer window and select an industry- or brand-specific image to display on your payment form. Side images must be in .jpg format and should be 150px x 150px. |
Return Page URLs | Enter up to 10 different return page URLs. After the customer completes a transaction, SWP returns him/her to this return page. If the merchant does not provide a return page URL, Forte redirects the customer to a confirmation page. |
C: To update the Billing Fields of SWP, click the Billing tab and edit the following fields:
Field | Description |
Bill To Instructions | Enter a message that will instruct your customers on what billing information they must submit with their transactions (e.g., "Complete the required fields"). |
Bill To Fields | Click the radio buttons next to the following fields to define whether you want to make the field Required, Optional, or Hidden when collecting billing information from your customers: Company Name |
D: To edit the Shipping fields of SWP, click the Shipping tab and update the following fields:
Field | Description |
Ship To Instructions | Enter a message that will instruct your customers on what shipping information they must submit with their transactions (e.g., "Complete the required fields"). If Ship To instructions are unnecessary, leave this field blank. |
Ship To Fields | Click the radio buttons next to the following fields to define whether you want to make the field Required, Optional, or Hidden when collecting shipping information from your customers: Name |
E: To edit the payment/order instructions or update the order fields specific to your business, click the Order/Payment tab and update the following fields:
Field | Description |
Payment Instructions | Enter a message that will instruct or inform your customers of relevant payment information. If payment instructions are unnecessary, leave this field blank. |
Order Instructions | Enter a message that will instruct or inform your customers of relevant order information (e.g., "Orders made before 3PM CST will ship out same day"). If order instructions are unnecessary, leave this field blank. |
Consumer Order ID | The merchant-defined invoice or order number of the transaction. From the Option dropdown, select whether you want this field to be Required, Optional, or Hidden on the SWP Payment Form. Using the Format dropdown, select the acceptable format for this field using the predefined options or a custom option you create with the Validation Builder. Enter the customer-friendly label that will display on the SWP Payment Form in the Description field. |
Wallet ID | A merchant-defined description or reference ID related to the transaction. From the Option dropdown, select whether you want this field to be Required, Optional, or Hidden on the SWP Payment Form. Using the Format dropdown, select the acceptable format for this field using the predefined options or a custom option you create with the Validation Builder. Enter the customer-friendly label that will display on the SWP Payment Form in the Description field. |
Xdata 1 | Up to four lines of additional merchant data associated with a transaction or schedule of transactions. From the Option dropdown, select whether you want each field to be Required, Optional, or Hidden on the SWP Payment Form. Using the Format dropdown, select the acceptable format for each field using the predefined options or a custom option you create with the Validation Builder. Enter the customer-friendly label that will display on the SWP Payment Form in the Description field. |
Xdata 2 | |
Xdata 3 | |
Xdata 4 |
- Click the Save button to save your updates and return to your Location’s Details Screen.
Adding Custom Validations to Order Fields
The Validation Builder gives you the ability to add input text validators to the Order fields on the Secure Web Pay Settings modal. Make your validators by choosing a template with a pre-defined format that you can customize or create a unique validator according to your own requirements. Once you create and save a validator, you can assign it to the Consumer Order ID, Wallet ID, or Xdata1–4 fields by selecting it from the Format dropdown on the Order/Payment tab.
To create a customer validator for the Order fields, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations in the Dex main menu.
- Enter the location's name or ID in the search field, or use the Status, States, Postal Code, Services, or PayFac Profile ID to narrow down the displayed list of locations.
- After locating the desired location, click the row on which it displays. The Location's Details Screen displays.
- If not already selected, click the Products and Services tab and scroll down to the Secure Web Pay (SWP) row.
- Click the
to open the Secure Web Pay Settings modal.
- Click the Order/Payment tab and scroll to the bottom of the modal.
- Click the Validation Builder link that displays above the Order fields. A Validation Builder slider displays.
- If you'd like to use a template for your validator, use the dropdown menu in the Template field to select a pre-defined template. You can choose from a variety of date validators, a phone number validator, or a URL validator. Dex automatically populates the Type, Name, Error Message, and Definition fields based on your template selection. Use the Type radio buttons and free-text Name, Error Message, and Definition fields to customize the template. After testing the template, click the Add to List button.
- To create a unique validator, select the desired syntax from the Type radio buttons: String, Date, Regular Expression. Add an easily identifiable label to it in the Name field and type out the error message that will display in the Error Message field. Add the validator's string, date, or regular expression syntax pattern that SWP will use to match to input text. For help with Regular Expression Definitions, see Microsoft's Regular Expression Language Quick Reference, which is also referenced on the slider modal. After testing the validator, click the Add to List button.
- Click the Close button on the Validation Builder slider to return to the Secure Web Pay Settings modal.
- Find the order field to which you want to apply the validator. Use the dropdown menu in the Format field to select the desired validator.
- Click the Save button to save your SWP Payment Form settings.
Migrate Unassigned Locations
NOTE: The following topic applies only to Forte users with specific permissions and details how to migrate unassigned merchant locations into new or existing Dex organizations.
Finding Unassigned Locations
To quickly find unassigned merchant locations, complete the following steps:
- Select the applicable account in the account search and click Locations in the Dex main menu. The Locations Datagrid displays.
- Click the Show Unassigned checkbox next to the search filters. Dex displays the unassigned locations. From here, you can search for the desired location by Location Name or filter the displayed list by Location ID, Status(i.e., Live or Deleted), State, or Postal Code.
Assigning Locations to an Existing Organization
Once you've located the desired location, complete the following steps to add it to an existing account:
- From the Locations Datagrid, click
> Migrate. NOTE: Only one location at a time can be migrated to an organization. The Migrate Locations Screen displays.
- If this location shares the same Tax ID/Fed ID with an existing organization(s), then select the radio button next to the applicable organization and click the Migrate button. NOTE: Do not create a new Organization ID for locations that have the same Tax ID/Fed ID as existing organizations under the same partner.
- Click the Done button to return to the Locations Datagrid.
Assigning Locations to a New Organization
For locations that do not have the same Tax ID/Fed ID, the option to add them to existing locations is disabled. To create a new Organization ID for the location, complete the following steps:
- From the Locations Datagrid, click
> Migrate. NOTE: Only one location at a time can be migrated to an organization. The Migrate Locations Screen displays.
- Dex auto-selects the Create New Organization radio button, so all you have to do is click the Migrate button. Dex creates a new Organization and Organization ID based on the name of the location. This new organization has the same Tax ID/Fed ID as the location.
- Click the Done button to return to the Locations Datagrid.
Regenerate Legacy Credentials
Dex works not only with newer products like Forte Checkout and the REST API, but also Forte's legacy products like the Advanced Gateway Interface and Virtual Terminal. Rather than navigating between products to create and regenerate processing and web service credentials, we've given Merchant and Enterprise Organization Admins the ability to create and manage credentials for legacy products and integrations. These credentials include the Real-Time Password required for merchants using the following products
- Advanced Gateway Interface
- Forte Mobile App
As well as the API Login ID and Secure Transaction Key required for merchants using the following products:
- SOAP web services
- Secure Web Pay
- Forte.js
- Forte Checkout v1
Creating Credentials
To create any of these credentials, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Details screen displays.
- Click the Credentials tab.
- Click the Generate link under the credential you want to create. The credential displays in the applicable field.
- Click the Copy link to copy the value to your computer's clipboard.
Regenerate Credentials
To regenerate any of these credentials, complete the following steps:
- Click Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter Location Name or Location ID in the Search field or use the Status, States, Postal Code, or Services filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- Click the Credentials tab.
- Click the Regenerate link under the credential you want to regenerate. A Regenerate Modal displays asking you to confirm that you want to regenerate the credential.
- Click the Regenerate button on the Regenerate Modal. Dex returns you to the Location's Detail Screen with the newly generated credential displayed under the applicable field.
- Click the Copy link to copy the value to your computer's clipboard.
- Remember to update your product integrations with the new value to avoid errors.
Regenerate FTP Passwords
The Forte Enrollment Team, Merchant Admins and Developers can regenerate their FTP passwords if it becomes compromised or forgotten. Merchants must have existing FTP credentials, including a username that consists of a transmitter ID preceded by the letter U (e.g., U12345).
To regenerate your password, complete the following steps:
- Navigate to the Locations Datagrid by clicking Locations on the Dex Main Menu. The Locations Datagrid displays.
- Enter the Location Name or Location ID in the Search field or use the Status, States, Postal Code, Services, or PayFac Profile ID filters to narrow down the list of locations.
- When you find the desired merchant location, click the row on which it's listed. The Location's Detail screen displays.
- Click the Credentials tab.
- Click the Regenerate link under the FTP Password field. A Regenerate FTP Password modal displays.
- Select the Yes, I understand and wish to regenerate it checkbox to activate the Regenerate button.
- Click the Regenerate button. Dex returns you to the Location's Details Screen and displays the regenerated FTP password credential under the FTP Password field.
- Click the Copy link to copy the value to your computer's clipboard. To ensure continued service, update any software integrations or point-of-sale terminals that use FTP credentials to transmit files to Forte.
Understanding AOA Services
Early Warning's Account Ownership Authentication (AOA) services enable CSG Forte to confirm the identity of an account owner and the status of the account by comparing it to Early Warning's National Shared Database resource. Early Warning participants maintain the National Shared Database by contributing the following information daily:
-
Draftable and non-draftable account status updates
-
Stop payment records
-
Outgoing returns of the participant's own accounts
-
Transit and return information on the accounts of non-participating institutions
-
Account owner elements, such as name, address, and Social Security number (provided on a weekly basis)
AOA Versions
Currently Forte uses the AOA service as part of our merchant underwriting process; however, in the future, Forte will leverage the AOA service to enhance our Validate/Validate+ offering for merchants. This includes giving merchants the ability to customize their risk threshold by adjusting their AOA configuration's scoring system. Forte offers three versions of AOA:
-
AOA Only - Forte authenticates only the account owner's information.
-
AOA + Status - Forte authenticates the account owner's information and confirms the account is valid and in good standing for a transaction.
-
AOA Status Only - Forte confirms only that the account is valid and in good standing for a transaction (e.g., not closed, NSF, etc.).
The following table displays what information is provided with each version:
AOA Version | Data |
AOA Status Only | Is account open? |
AOA Only | Gives Forte merchants the ability to validate the following elements of a bank account record: Account Names (First + Last/Business) |
AOA + Status | Provides all of the data from both the Status Only and AOA Only versions. |
Scoring AOA Requests
The AOA service provides an overall score that measures how closely the request data matches the information in Early Warning's National Shared Database. The service derives the score not only from exact matches, but also from name variations, abbreviations, phonetic encoding and other proprietary matching algorithms. When specific data elements are not provided in the request or are not included in the database record, the score adjusts so that only the remaining data elements are included in the calculation.
For each individual data element, the AOA service uses the following response system:
-
Y = The submitted data closely or exactly matches the database.
-
C = The submitted data conditionally (partially) matches the database (e.g., If a submitted request for a name element was "Kathy Waren Hwkins" and the database record was "Katharine Warren Hawkins," the AOA service would return a C response).
-
N = The submitted data does not match the database.
-
U = No identifying data is available in the database for the provided account.
For the overall score, the AOA service use the responses for the individual data elements and combines them into a numerical score. Early Warning provides the following overall score thresholds for definite, conditional, and no match recommendations for the transaction:
-
Y = 81 and above
-
C = inclusive between 75 and 80
-
N = less than 75
Validate/Validate+ uses this overall numeric score in its decisioning logic. The following table maps how Early Warning's overall score affects the responses provided in Validate/Validate+. For information on Validate/Validate+ P codes, see the Validate/Validate+ Integration Guides. For a Transaction Response Code reference, see Transaction Codes.
Overall Match Score | pg_preauth_result | pg_preauth_description | pg_response_description | decline_advice | pg_response_code | pg_response_type |
0-74 | NEG | P15: High Risk | Declined | P15: High Risk | U80 | D |
75-80 | POS | P73: Medium Risk Approval | Approved | P71: Low Risk Approval | A01 | A |
81-100 | POS | P70: Validated | Approved | P70: Validated | A01 | A |
The value in the pg_preauth_result field is what ultimately determines whether the transaction should be approved or declined. Typically only the NEG response will trigger a decline; however, POS and UNK responses may be declined for other reasons. If a transaction is declined, Validate/Validate+ will include the pg_preauth_neg_report field in the response. This field contains the negative database responses and negative report details from Early Warning.
that displays next to the toggle to access the Edit eCheck Services Modal. NOTE: If you're reactivating echeck services for a merchant, those previously defined settings will display in the Edit eCheck Services Modal.
on the Card Services row. Details about the merchant's credit card services display.
on the Card Services row to close it.
to open the Secure Web Pay Settings modal.
> Migrate. NOTE: Only one location at a time can be migrated to an organization. The Migrate Locations Screen displays.