January 2023
The release notes for January 2023 are organized as follows:
Release Overview
2023-01 provides several new features and significant improvements to the Forth system.
FORTH Rebranding Update
As you know, DebtPayPro and Debt Pay Gateway combined into one company, named Forth™. As part of this effort, we have created a Transition Guide (Click HERE) to help guide you with updates to URLs, and Contact Information. This transition was effective on Monday, January 9th, 2023.
What's New
Servicing Client Summary Tab on Contact Dashboard
This new feature was developed to provide Sales Affiliates, that submit to a Servicing Company, the ability to see client transaction-related information (live customer progress) as it lives on the Servicing Company account. This new tab will live on the Contact's client dashboard and there will be reporting available for all data points on this new Summary tab. The live data available for reporting includes several topics, including the number of cleared drafts, the number of Non-Sufficient Funds (NSF's) instances, the Last Draft date, amount and status, the Next Draft date and amount, a Settlement Summary, and a Full transaction ledger minus the actual available balance.
Additions of Features associated with Lender Submission
Several improvements, associated with a pending Lender Submission Process, were developed and released in the month of January. These three improvements are listed below:
New User Type
- We introduced a new User Type called "Service Account". This is a different kind of user, one that cannot be logged into, that is not present on billing reports nor is it a paid seat. This was introduced to facilitate machine-to-machine API connections while avoiding the complications of billing and access. Administrators can create Service Account users for companies in order to utilize them for setting API keys for various integrations and other API-related items.
A new Auth Type for webhooks
- We introduced a new authentication type for webhooks called "HMAC". HMAC or hash-based message authentication code is a set of headers that are added to a webhook to secure it in transit from an origin to a destination system (IETF RFC 2104) HMAC protocols are used by leading organizations such as Github, Microsoft, etc to sign webhooks to ensure authenticity in transmission. More details can be found here and here.
API Key Management Page
- We introduced a new API Key Management page to be implemented to maintain the User data for which credentials are issued. Using this API Key Management page, User credentials can be generated from the user list shown. The current Create API Key section will be modified to add a selection for “Credential Type”. This will contain two options: “User Credentials” or “Service Account Credentials”.
What's Improved
Updated Data Validation for Debts Table
Previously, Forth stored account numbers and other similar account numbers as encrypted values in the database. For the Managed Data Cloud (MDC) views, we attempt to decrypt them and show the values as displayed in the interface. We experienced problems decrypting, causing errors. This modification adds input validation so that clients cannot enter invalid information for that field to prevent future issues.
Modified RAM Integration with a New "Voided" status
Previously, we performed transaction status synchronization with the RAM integration for “REFUND”, ”RETURN” and “POSTED”. This update adds a new transaction status for “VOIDED” similar to “REFUND” on the Forth CRM side.
Add Conditions to Prevent Debt Deletion on Data Source
Currently, there is no check that the client is not enrolled and the debt is not settled. To improve the integrity and safety of your data, we implemented conditions to prevent the deletion of settled debt.
This modification prevents the deletion of debt via Data Source Update if a debt is still settled. "&delete_debts=1" is a valid parameter to pass to the data source upon updating a contact record. This will now be used to delete and replace debts.
De-Duplication Enhancement for Enrolled and/or Not Enrolled
This modification created an option for the existing De-Duplication (Dedupe) feature to have the ability to select whether to look at enrolled or not enrolled contacts. This modification added a new dropdown selection in the data source setup page for “De-Dupe Type” These options are now "All Contacts", "Enrolled" and "Not Enrolled".
The benefit of this modification is expanding the functionality of our data sources tool to allow for more control over how duplicate records are managed in the system.
API Updates
Added Debt Updates Logging via API
This modification was instituted so that debts that have been added or modified via the API reflect in the client’s history. The History event user will be listed as the user that the API token is associated with in that company. In addition, the History event will read exactly the same as if a user manually updates or adds debt information.
February 2023
The release notes for February 2023 are organized as follows:
-
What’s New (12)
- Added Creditor Current Payment to Servicing Tab for Affiliate Accounts
- Added New Triggers and Enrollment Settings
- Added Data Source Logging
- Added a New Settlement Commitment Tag
- Added a New Tag for the Number of Consecutive Returns
- Added Document Packages into Trigger Conditions
- Added Not Enrolled Debt Tags
- Added Administrative Control for Users' Notification Settings
- Added a NewLine Loan Integration
- Added Two-Factor Authentication
- Added a Debt Field to Debt Reports
- Additions of Features associated with Lender Submission
- What’s Improved (5)
- API Updates (2)
Release Overview
2023-02 provides several new features and significant improvements to the Forth system.
What's New
Added Creditor Current Payment to Servicing Tab for Affiliate Accounts
With this new feature, the Servicing Tab on the affiliate's account would reflect the creditor's current payment in the "Creditors" section. This was developed to have the creditor's current payment reflected on the servicing tab as this will help with retention. This shows the creditor's individual current payments as well as the total current payments (just like on the debts tab). This was needed on the servicing tab so that a client may remove or add debt after the file is submitted to the servicing company and there isn't a way for the affiliate to know.
Added New Triggers and Enrollment Settings
Currently, the status change on the first payment clearing/returning only looks at the first payment of a program. For clients who have triggers tied to a first payment clearing or returning this was misleading as the first payment that clears or returns may not be the first numerical payment in the program.
This new feature introduced a new enrollment event for the first instance of a return or cleared payment and clarified how the first numerical payment that fails or clears is distinct from the first instance. This feature also gives clients more options in their messaging around first payments clearing or returning vs the first instance of those events
Added Data Source Logging
Users are currently unable to see the results of posting in via a data source. This data should be retained temporarily and presented to the user for debugging purposes. Additionally, adding "_debug=true" to the end of the data source URL now toggles this feature on or off.
Added a New Settlement Commitment Tag
Clients have debts that are settled with open settlement payments. This new tag {SETT_COMMIT} provides the ability to reflect the settlement commitment, pulled from the sum of all open settlement payments on the schedule) for a given customer on an email template, sms template, or document template. This feature then generates the client’s settlement commitment upon rendering the template.
Added a New Field and Tag for the Number of Consecutive Returns
This new feature creates a new field on contact lists called “Number of Consecutive NSF Payments", providing the ability to represent the number of consecutive NSF payments on a client's schedule in an email via a new tag titled {NUM_CONSECUTIVE_NSFS}. Additionally, it provides a new filtering capability for clients on a list by the number of consecutive returns.
Added Document Packages into Trigger Conditions
Document templates currently have limited to no functionality in conjunction with our triggers system. Just like we have events for when a document gets sent via Clixsign, we would like to enable the same functionality for document templates. This new feature will expand our automation capabilities and allow clients to further automate their processes. This would further align document package capabilities to individual template experience in triggers, as well as enable more notifications and automation around document packages. The trigger event names are "Document Package Complete", "Document Package Declined", "Document Package Status Event", and "Document Package Email is Opened".
Added Not Enrolled Debt Tags
This new feature provides the ability to display accounts that are not enrolled in a program separate from accounts the consumer is enrolling in the program. This would be reflected as the same table for enrolled debts just showing the un-enrolled as well. This feature is enabled by creating a new tag that generates a tag similar to the {CreditorList} tag. These new tags are {CreditorListUnenrolledOriginal} which uses original_debt_amount and {CreditorListUnenrolled} which uses current_amount.
This feature helps your sales team ensure they are not leaving out any qualified debts for enrollment.
Added Administrative Control for Users' Notification Settings
Currently, only an individual User can update their system alerts for contact opens my emails. This new feature provides the capability to control whether or not users receive system notifications without having to log in as them and modify their "my settings" page. This would enhance administrative functionality around system notifications.
Added a NewLine Loan Integration
NewLine Loan offers debt settlement program loans for consolidating debt. With this new integration, NewLine is now a program option available to clients to pay off their debt. The NewLine integration is used after a client has already been enrolled in a program and wants a loan to pay off that program.
This feature relies on the Forth client being enrolled in the NewLine Loan program (confirm with Forth Sales if you have any questions).
Added Two-Factor Authentication
This effort makes updates and standardizations to the two-factor authentication (2FA) experience by providing enhanced security controls, better administration, and improved organization.
This enhancement creates a new “Access Control” Settings Page, found at the controlling company level (the highest level company within an account). Once enabled at the account level, specific companies can have 2FA functionality enforced on them.
Added a Debt Field to Debt Reports
This new feature added the Debt field "PAPERWORK RECEIVED DATE" as an available field for Debt Reports.
Additions of Features associated with Lender Submission
Several improvements, associated with a pending Lender Submission Process, were developed and released in the month of February. These three improvements are listed below:
Lender Submission Setup Page
- We introduced a new Lender Submission page. This page is accessible by a new tab named "Submissions" under the lender details view. This new tab will contain several different controls, including "Submission Methods" where you can select either Email or API.
Logging
- This new element of the lender submission process allows for logging of the entire Lender submission process with specific identification. Logs will also be maintained for API submission similar to email submission.
CTX API Lender Endpoints
- We added the capability to add a Lender Onboarding process API using OAuth. This adds a new API call for submission to GET Submission Details, GET Submission Statuses, as well as Update Submission Status.
What's Improved
Standardized Debt Updates Logging Rules
This modification provides standardized, expectable behavior for History tab logging of debt adding, removing, or updating. It only logs debts that are being updated or removed when the Edit Debts page is saved. These saved changes are then logged into the History Tab.
Modified Enforcement of Required Fields on External Forms
Formerly, External Forms could be configured to have required fields. However, when the forms are sent to end users, those required fields are not actually required to be filled in to complete the form. This modification introduced enforcement for all fields in the external form that have been designated as required. This feature now ensures that External Form submissions require all fields input to be completed.
Modified the Viewability of the Balance Forecast Chart in the Settlement Scheduler
This modification added a setting under the Settlement settings → General settings section to hide or show the Balance Forecast Chart within the Settlement Scheduler.
Modified MAVIS Review Reasons
This modification strengthens the MAVIS Automated Review Process. When an unknown programming/scan error occurs with MAVIS, the manual review reason should now be "Scan Error". When an unsupported document is uploaded the review reason should now be "Unsupported Document".
Comprehensive Updates to Contact Notes and Alerts
This extensive modification to the Contact Notes and Alerts user interface and features improves the user experience within our CRM. enhancing the visibility of alerts and empowering users to find the important information they seek (note type, creation date, date last updated, etc.).
We added several additional search criteria to speed up the search for existing notes about your customers. You can now search by Note Type, the User who created the Note, the timeframe that the Note was created, as well as sorting by the most recent or oldest Note.
You also told us that you wanted a more modern Alerts experience, with greater options to customize different alerts by priority and allow for an automatic expiration date for your alerts. We took your suggestions and enhanced our “Alerts” feature as well. You can assign Alert Type (priority level), and expiration date if desired.
API Updates
Add Endpoint to Update ACH Returns
Automated Clearing House (ACH) payments processed through NACHA files for CTX clients require manually updating returned payments. This is very time-consuming and for clients that have ~250 transactions daily to update, this saves tremendous time and money. The current solution will allow updating returned payments by hitting a data source endpoint.
Add ForthCRM API Command to sort Contact Notes
Formerly, in trying to get the more recently inserted notes from contacts through the API, it was noticed that the instructions for retrieving such notes did not have that option. In some cases, contacts may have more than 100 notes and the API was restricted to show only the first 100. This update provides an API command that will sort the results from the newest to the oldest.
March 2023
The release notes for March 2023 are organized as follows:
Release Overview
2023-03 provides several new features and significant improvements to Forth.
What's New
Xactus 360 Migration
As you're aware, our integration partner Xactus ended their relationship with MCL at the end of February. In order to support the transition from the MCL platform to Xactus 360, we have deployed the following new features:
- Added Xactus 360 to the Credit Parsing Tool
- Added {CREDIT_UTILIZATION}, {CREDIT_TOTALLIABILITY} and {CREDIT_SCOREFACTORS} functionality for Xactus360 (CRM-I-888/866)
- Add Applicant and Co-Applicant Credit Pulls with Xactus360 (CRM-I-688)
- Add Endpoint to Pull Credit from Xactus360 Service (see API Updates section at the end of this release)
Added Xactus 360 to the Credit Parsing Tool
The credit pull parsing tool (script editor) is something a lot of clients use to filter out creditors or trade lines that they do not want entering the system. This addition enables the Parsing Tool to be used with the xactus platform as it has with others like MCL.
Added {CREDIT_UTILIZATION}, {CREDIT_TOTALLIABILITY} and {CREDIT_SCOREFACTORS} functionality for Xactus360
This modification updates the Xactus360 Integration to capture fields relevant to existing tags for credit utilization and credit score factors.
Add Applicant and Co-Applicant Credit Pulls with Xactus360
Formerly, joint credit pulls were not functioning in conjunction with the Xactus360 integration. With this modification, we added support for this feature so that both applicants and co-applicant's can have their credit pulled jointly.
Added New Field to Debt Reports
This feature added a field for the number of Accounts Unsettled from the enrollments reports page to be available on the Debt reports on the Creditors tab.
Added a Delete Button on the Edit Triggers Page
Formerly, when deleting a trigger we had to find the trigger, edit it to make sure we want to delete it, then go back to the main page just to click the delete button instead of doing it from the page we're already on. This new feature adds a delete button to the edit triggers page. This will reduce the need for users to jump between pages to manage the triggers that they are editing.
Document Package 2.0
This past month, we released a comprehensive update to our Document Package feature within the Forth CRM. This comprehensive update includes the following improvements:
- Document Package Splitting
- Document Packages Searchability
- Copy/Duplicate a Template for a Package
Package Splitting
Packages often have multiple pieces that need to be sent to different parties. The new Document Package Splitting feature allows our system to seamlessly split packages that are already signed through Clixsign into individual PDFs. These PDFs can now be downloaded (see image below), composed of the individual documents that comprise the package. These individual PDFs from the package will have the Clixsign certificate appended to them.
This feature eliminates the need for customers to leave the system to extract a document from a package and will reduce friction when uploading documents to third parties or other integrations that require specified documents pulled from a package.
Search for Document Packages
This new feature provides the ability to search for saved Document Packages more efficiently than before. Before this, a user had to spend precious time scrolling through a list of packages to find a particular document.
This feature improves the usability of the Documents module by adding Search functionality by Document Package name or package ID field.
Copy/Duplicate a template for Document Packages
This exciting new feature provides the ability to duplicate an existing document package. All document templates part of the original package are copied to a new package. This new time-saving feature allows administrators to clone similar packages with a single click, instead of starting from scratch each time.
Added New Triggers and Enrollment Settings: First Payment Cleared and First Payment Return (CRM-I-598)
Until now, the status change upon first payment clearing/returning only looked at payment transaction #1 of the program. For clients who have triggers tied to a first payment clearing or returning, this may be misleading as the first payment that clears or returns may not be the first numerical payment in the program. As such, we introduced a new enrollment event for the first instance of clear or nsf payment and clarified how the first numerical payment that fails or clears is distinct from the first instance.
What's Improved
Modified the Balance Amortization Calculator
Forth made some performance improvements to the balance amortization calculator. The updates were focused on increasing the speed of balance and amortization calculations within the settlements interface and laying the groundwork for exciting new mass payment management features that are on the horizon, to help make servicing easier and more efficient.
Changes are purely in backend algorithms, and there are no changes to the user interface or any modules within the system.
Modified Moneveo Access Integration
Monevo is streamlining its hosted experience from individual branded domains to a single domain that is driven by the campaign code to show any client-specific branding. As a result, our integration with them now requires us to always use the same base URL - app.monevo.us/apply - in all instances of the app link getting sent to the customer.
This update benefits the user by streamlining the Monevo Access integration by standardizing the base URL and by providing a more uniform client experience across all customers using Moneveo Access.
Added Suspension Date to Database User Table
With this modification, Managed Data Cloud users now may easily retrieve a user's suspension history. Formerly, the only way to find the date/time a user was suspended was by searching the system log, which is time-consuming and inefficient. The system now stores the date and time of the user's last suspension in the database user table. This information is updated whenever the user is suspended or re-suspended, and includes the user ID of the person who suspended the user.
By storing the suspension history in the database user table, administrators can quickly access the necessary information without having to search through system logs. This will save time and improve the overall user management process.
Modified the Pull Credit Report Interface
This modification enhances the "Pull Credit Report" button by adding a dropdown menu. This will enable users to select their preferred credit pull provider. It improves the user experience for credit pull providers by providing a modular, user-friendly, and easy-to-use interface for requesting and retrieving credit reports.
Additional Updates to Contact Notes and Alerts
Since deploying a major update to the Contact Notes and Alerts user interface, we received several requests for further enhancements.
- Increasing the Page Size for Notes
- Updating Note Template Search Dropdown Menu
- Make Templates of Excluded Note Types Unavailable
Increasing the Page Size for Notes
Until now, the maximum page size for notes in our application is 10 notes per page. This modification increased this limit to 50 notes per page to provide more flexibility and accommodate users who need to view more notes at once.
Updating Note Template Search Dropdown Menu
Formerly, the note template dropdown appeared to be a searchable field when there are fewer than 10 templates when it is actually now a dropdown menu. This modification updates the dropdown field so that it reflects as a dropdown menu and not a search field.
Make Templates of Excluded Note Types Unavailable
Note templates created with note types that are “excluded” as valid note types a user can select are displaying as available regardless of the note type’s exclusion status. This leads to a situation where note types that a business has elected to exclude from use can still be applied by a note template. This leads to an adverse situation where the business is saving notes with a type that they do not wish to have users save which can impact reporting or operational activities.
Updated the Settlement Return Process
This modification updated the settlement return process by creating a connection between the original transaction processed and the offsetting transaction so that the debits and reversal tied to the deposit can be linked and viewed.
The goals for this modification include keeping the cleared date and the original transaction so that the reporting doesn’t change; offsetting the reversal with a new transaction so that the original transaction will still be a withdrawal of funds from the account; and ensuring that the new transaction offsets the original transaction and also shows that it is tied to the original transaction. All of this provides greater clarity and transparency for our clients.
API Updates
Add Endpoint to Pull Credit from Xactus360 Service
This update allows a client to add an API endpoint to the existing system that can pull credit information from the Xactus360 service so that the Client can pull a credit report on an enrolled contact. The pulled credit information will be retrieved based on the unique identifier Social Security Number.
April 2023
The release notes for April 2023 are organized as follows:
Release Overview
2023-04 provides several new features and significant improvements to Forth.
What's New
Saving Settlement Offers - Now Allow Negative Balances
This new feature enables a client the ability to better govern their settlement workflow!
Introducing "Save Negative Settlements" - a new role permission that allows you to save negative settlement offers in any status, or complete an offer, even when funds are not available. We understand that sometimes settlements need to be completed urgently, and negotiations between creditors and DSRPs can be time-sensitive. That's why we developed this feature to help you manage your settlement process more efficiently.
To enable this feature, log in to the CRM, click the "Admin" tab, and select "Roles" from the Navigation Bar. Scroll down to the Settlements section and click "Save Negative Settlements".
X9 File Creator for Checks
This new feature generates an X9 file format for all the checks to return in a file. The Image Cash Letter (X9) format is a Raster file format developed by the Accredited Standards Committee X9 Inc and supported by the MAVRO (imaging) X9 Viewer.
The file format is used in electronic banking systems to represent checks as images in files. Each file can contain a number of checks, each check having two images: one for the front side and one for the back side. The file also contains information about each check and the whole Cash Letter. For more information, refer to https://www.checkimagecentral.org/check-information and download the technical report X9.100-187.
Non-Truncated Status Names in Trigger Conditions
This new feature will now display the full names of file types, stages, and statuses without truncation when selecting them for use in trigger conditions. This ensures that the correct item is selected and improves the accuracy and reliability of our trigger conditions. The former trigger conditions truncated the names of statuses when selecting them for use in the condition. This can cause confusion and errors in the triggers, especially with multiple items with similar names but different suffixes.
Allowing Blank SSN Credit Pulls via Xactus 360
Xactus does not support the last 4 numbers of a social security number (SSN) as a viable method to pull credit. They can do an SSN absent pull if the date of birth is present, but our system formerly prevented that. This update allows customers to pull credit if an SSN is not present.
New Xactus 360 Debt Type Mappings
Xactus had additional debt/loan types that we did not have code to map internally to their respective debt types for. This update adds support for the additional types and maps them to our system debt types in Forth CRM.
New Role Permission to Restrict Original Debt Balance
You requested the capability to lock the original debt balance of a debt upon enrollment. We added a new role permission for “Edit Original Debt Post Enrollment” in the enrollments section of Roles, to select which roles can modify this field after the contact has been enrolled into the program. Since original debt never changes, a user should not be able to modify it any further especially after a client is enrolled in the program. This new feature enables the ability to lock fields post-enrollment.
What's Improved
"Edit Triggers" Permission Now Tied to New Trigger Interface
The former triggers system’s setting to control access was tied to a now deprecated triggers interface/experience. With this update, we standardized permissions to use the most up-to-date version of the triggers system and updated that permission to point to the ability to update and edit the triggers interface.
When enabled, the user who is in the modified role will have access to view, modify, and update triggers in the system from the triggers listing page.
Client Portal Password Reset Function - Replaceable Tags Now Functional
Previously, when client portal users attempted to reset their password from the client portal itself, any {tags} included in the email template would not properly pull the data from the contact. We have updated this functionality, so now whether a CRM user resets a client portal user's password on the contact dashboard, or the client portal user themselves resets the password on the portal, the following replaceable tags will function properly:
{FULLNAME}
{DATE}
{ID}
{ASSIGNED_SERVICINGCOMPANY_LOGO}
{ASSIGNED_SERVICINGCOMPANY_PHONE}.
{ASSIGNED_SERVICINGCOMPANY_NAME}
{ASSIGNED_SERVICINGCOMPANY_ADDRESS}
{ASSIGNED_SERVICINGCOMPANY_CITY}
{ASSIGNED_SERVICINGCOMPANY_STATE},
{ASSIGNED_SERVICINGCOMPANY_ZIP}
{ASSIGNED_SERVICINGCOMPANY_EMAIL}
{ASSIGNED_SERVICINGCOMPANY_PHONE}
{ASSIGNED_SERVICINGCOMPANY_FAX}
Enrollment Details Page Alerts
The objective of this requirement is to update the Enrollment details page alert to match the functionality of the updated dashboard alerts recently implemented across the Forth system.
API Updates
Budget Fields to the Century API
The Century client wanted to add all the budget fields under Monthly Income and Monthly Expense on the budget setup page in their account. In addition, the client also wanted three fields to be added to the Century integration - sACCOUNTHOLDER, sACCOUNTTYPE, and sBALANCEDATE.
The main goal of adding all budget fields under Monthly Income and Monthly Expense on the budget setup page was to:
- Provide the client with a more comprehensive view of their income and expenses. This will help them to better track their spending and make informed financial decisions.
Provide increased transparency and accountability: By adding all budget fields and new fields for Century integration, the client now has greater transparency and accountability regarding their finances. This makes it easier for the client to monitor their financial progress and hold themselves accountable for their financial decisions.
Advance Custom Fields in Response for GET Advance By ID Endpoint
Object custom fields are currently supported to add custom fields to the Advances object. This allows users to attribute custom values to advances and fill them in as they complete advance offers in the system. Formerly, the API did not support the ability to view these fields if they are present in the advance. This update enables greater visibility into Advance attributes via the API and enables further customization of fields that are present on the API based on unique custom fields in the user’s account.
Limit Lender to Lender Endpoints
We added an additional setting to the "Service" type user setup on the edit user page in the CRM to specify via a new checkbox whether or not they are an API Lender. If you select this new checkbox, it only allows access to two specific submission endpoints and is forbidden from using others.
There were concerns that lenders using the endpoints designed for them in the submissions project would have been able to see/extract other information with their API keys from the client’s system. With this change, we can now better secure API keys and restrict access based on the user type and additional parameters of the user in the system that the key is tied to.
New Credit America Integration - ProgramStartDate field
New Credit America asked us to change the value of the parameter ProgramStartDate we send them. We used to send the first payment date and they requested this should be updated to the clients' enrolled date in the CRM. This modification updates the API Parameter to be aligned with the partner’s expectation for that field. In addition, the Enrolled date gets set upon a client enrolling or re-enrolling in the program.
All System and Custom Advance Fields Now Available for Lender Submission via API
This now enables Brokers to include and submit all critical information stored at the Advance level, including system and custom advance fields when submitting deals to Lenders. This will improve the accuracy and completeness of the information provided to Lenders needed to process the deals ensuring that the additional advance level fields are mapped correctly to the Lender's required fields and validated against system requirements.
May 2023
The release notes for May 2023 are organized as follows:
Release Overview
2023-05 provides several new features and significant improvements to Forth.
What's New
CheckFlo Integration
We added CheckFlo functionality by creating a new user interface (UI) to integrate with CheckFlo API endpoints which now allows the upload of check payments to their platform from the Forth Pay CRM.
API Updates
API Contact Search by Field Endpoint
The existing search endpoint allowed searching for contacts in the database based on a specific type (Enrolled, Settlement, All) and a term that matches any searchable field in the UI. This update enhanced the search functionality by providing the option to search by a specific field. This was achieved by improving the existing API contact search endpoint by adding a new parameter named "field" in addition to the existing "type" and "term" parameters.
Contact Stage and Status API
This update allows clients to retrieve a Contact's Stage and Status values and to update that Stage and Status via the API to improve reporting and business workflows.
This update utilizes the specific ID for each Contact Stage and Status in a particular account, which will be passed as integer values for the "stage" and "status" parameters. Also, a new Contact GET endpoint will be created and added to the existing API documentation to retrieve all available Contact Stage and Status values.
Update to the "Update Debt Record by ID" API Endpoint
This update now allows users to update the charge-off date (i.e., when a creditor wrote off a debt) in the format of YYYY-MM-DD when updating a debt record. This allows users to keep accurate records through the "Update Debt Record by ID" API endpoint.
If a valid charge-off date is provided, the API will update the charge-off date for the creditor associated with the specified debt ID.
If the debt ID does not exist, the API returns a 404 not found error response. If the API can not update the charge-off date due to system errors, it issues a 500 internal server error response.
June 2023
These Release Notes for June 2023 list several new features and improvements, and are organized as follows:
- What’s New (2)
- What’s Improved (1)
-
API Updates (9)
- Get All Advance Status Endpoint
- Set Advance Status/Fund Advance
- Delete Advance
- Locking and Unlocking of Advance Pricing
- Update "Contact" API Endpoint to Allow Budget Fields to be Passed
- Enable/Disable ACH Drafting via the API
- API Status Change for Calls
- Get Call Dispositions Endpoint
- API Content Type Headers
What's New
Loan Funded Notice to Clients for Forth Pay Gateway
This new feature created a daily email notification system for DRSP agents and Client administrators when a "Balance Transfer" transaction type is applied to a consumer account for Forth Pay. This helps ensure immediate notification once a funded loan, returned Forth Pay settlements, and wires are applied to consumer accounts.
This feature utilizes a "Send Email Notification” button on the "Mass Balance Transfers" page that automatically sends an email submission (which includes the Client ID, Client Name, Balance Transfer Amount, and a Memo line) for all balance transactions at the end of the day when the "Save" button is clicked.
Loanosity DCL Integration
Loanosity DCL offers debt settlement program loans for consolidating debt. With this new integration, Loanosity DCL is now a program option available to clients to pay off their debt. The Loanosity DCL integration is used after a client has already been enrolled in a program and wants a loan to pay off that program.
NOTE: You must be enrolled in the Loanosity DCL program to use this integration. Click HERE for more information on this integration.
What's Improved
Forth Pay Account Agreement Field Reordering
The objective of this modification was to provide a better user experience within the "Bank Account" tab of the contact dashboard, by re-ordering bank account fields so users can easily and clearly enter a consumer's bank account information.
The prior field order was confusing and mistakes were common when inputting bank account information. The fields have now been re-ordered and in some cases renamed. This update also makes all fields required to be saved, so an application cannot be submitted (via the "Save Bank" button) with missing information.
The information input here by the user pulls in and populates the appropriate tags in the ForthPay Custodial account agreement.
API Updates
Get All Advance Statuses Endpoint
This new feature enables a user to see all available advance statuses on a given account. This allows the user to better understand what statuses exist on the account and be able to update advances to new statuses based on the statuses available. In addition, Advance statuses that are added will now appear on subsequent API requests.
This was enabled by creating a new endpoint that now allows someone to access all advance statuses that have been configured on the account under "Advance Settings" https://login.setforth.com/index.php?module=advances&page=settings
Set Advance Status/Fund Advance
This new feature created a new API endpoint that enables a user to set and update the Advance status via the API and fund the advance if the correct status is passed based on the funded status from Advance settings > Rules/Permissions. This allows the user to control the Advance status flow without the need to be in the user interface (UI).
Delete Advance
This new feature expands your API capability to allow for the DELETE method to be used when specifying an advance. We added the “DELETE” method to be usable on the advance endpoint and to control how advances can be deleted as to whether or not they have been funded in the system.
This feature will not work with advances that are already funded or currently drafting payments.
Locking and Unlocking of Advance Pricing
This feature provides users the ability to lock and/or unlock pricing at the API level for an Advance. This feature assumes that an advance exists in the system already, that a valid ID is passed, and that the Advance ID is being maintained by the user updating at the API level. This feature created an endpoint for the API.
Update "Contact" API Endpoint to Allow Budget Fields to be Passed
This update to the "Contact" API endpoint now enables clients to pass budget fields when creating and updating contacts through the API endpoints, enhancing their budget tracking and reporting capabilities. It also enables clients to retrieve the list of budget fields (via a new budget field listing endpoint) available for their account to better track and report budget-related information for each contact, customized for unique budgets per account. Overall, this update provides a more tailored budget management experience for clients.
Enable/Disable ACH Drafting via the API
This feature allows a customer to set the ACH auto-draft status via the API. This would allow the customer to control whether or not an advance should be drafted automatically without needing to enable it in the UI. This was implemented by creating a new API endpoint for enabling and disabling the advance auto-draft status. If an advance has not been funded, the system does not allow an automatic draft to be enabled.
API Status Change for Calls
This feature updates the call disposition to contact status mapping functionality as well as validates and returns the appropriate call_result based on the call_disposition value as part of the response. The changes include removing the "status_change" and "call_result" parameters from the POST request body, and logging and including the call_result in the response object.
This feature changes the way call dispositions work. We added a new endpoint to map call dispositions so as to copy the functionality, currently available in the UI, over to the API. Now you can map a disposition to a status change, and then set that disposition using the API.
Get Call Dispositions Endpoint
This feature provides users with a convenient way to retrieve call dispositions, considering exclusions based on Account ID. It created a new API endpoint to retrieve call dispositions for both system and custom types. This enables the user to retrieve comprehensive information about call outcomes and customize dispositions based on specific requirements while excluding certain system call dispositions for a given Account ID. All dispositions are returned in a structured JSON format, clearing and separating system and custom dispositions.
API Content Type Headers
This security feature implements a new header with the value of nosniff onto all API responses. This will enhance the security of the Forth CRM API by mitigating the risks associated with MIME-type confusion attacks.
This feature sets the X-Content-Type-Options header with a value of nosniff to disable MIME sniffing by browsers and user agents, and ensures that the implementation does not override the header with a different value or conflict with existing headers.
July 2023
These Release Notes for July 2023 list several new features and improvements, and are organized as follows:
- What’s New (1)
- What’s Improved (3)
-
API Updates (8)
- Transaction Types & Subtypes API Endpoints
- Get all Advance Assignments Endpoint
- Get Transactions Endpoint To Allow Transaction Status Filtering
- Bank Account Details Integration via API
- Get Paused Value via API
- Update Debt Record by ID to allow Bulk Updates
- Update Contact Return Value via API
- Get Enrollment Details via the API
What's New
Lending USA Fresh Start Loan (FSL) Program
This new feature provides an integration for the Lending USA Fresh Start Loan (FSL) program. This integration for LUSA FSL is incredibly simple to use. With this integration, you can easily create applications for contacts within the Forth CRM, which can then be found in LUSA’s powerful merchant portal to complete their process.
What's Improved
Forth Pay Account Agreement Field Reordering
This update to the Loanosity Debt Settlement Loan (DSL) program will allow users to resubmit a contact to Loanosity from the very beginning if the original submission enters the "Declined" or "Withdrawn" status. This will allow CRM users to conveniently start over from the beginning of the loan application process, empowering them to rectify any previous submission errors and increase the odds of approval for their loan application. Additionally, this feature eliminates the need for CRM users to reach out to Forth Support via support ticket to submit a new application for Loanosity DSL if a contact's application was declined or withdrawn.
Automatic Population of Account Type
With this update, the account type field will automatically populate the account type on Forth Pay documents (such as the Forth Pay Bank Change Request document and the Risk Return document). This will eliminate the need for the consumer to manually select the account type on these documents. The account type field will automatically populate using the {ACCTTYPE} tag and may be used in other documents as you see fit.
Duplicate Management User Interface
In addition to making the user interface (UI) more intuitive, with tools such as additional dropdown menu options for filtering, the Duplicate Management page now accommodates multiple companies being added by adding a new setting for “Check across companies”. This is presented as a company selection box where the companies that moved over are the companies the system will check duplicates against for the company the user is modifying the settings for. Other updates related to this updated interface include disabling the “save changes” button while the save is happening or if the user unselects all search fields, as well as not refreshing the entire page when a company is saved or deleted.
API Updates
Transaction Types & Subtypes API Endpoints
With this update, a user is now enabled with the ability to grab all transaction types and subtypes via the API. We created an endpoint for both transaction types and one for transaction subtypes.
Get all Advance Assignments Endpoint
With this update, a user can retrieve all advance assignment options available as defined by settings so that they can understand which assignments exist and what they can assign to an advance on other API calls. This was enabled by creating a new API endpoint under “Advances” to retrieve all advance assignments available on an account.
Get Transactions Endpoint To Allow Transaction Status Filtering
With this update, the CRM user is now able to retrieve transactions from the CTX “Get Transactions” endpoint based on transaction statuses, to access relevant data via the API.
This update enhances this particular endpoint to allow users to filter transactions within an advance based on specific transaction statuses and provides users with greater control and flexibility in accessing relevant transaction data via the API.
Bank Account Details Integration via API
This new feature enables the ability to retrieve banking information via the FORTH CRM API. This can be used in conjunction with third-party applications. We created a new GET API endpoint to retrieve the bank account name stored on the contact record. This display of bank account information only displays the last four (4) digits of the account number for security purposes.
Get Paused Value via API
This update to the “Contacts” API improves the functionality of the API by implementing a new feature that allows users to retrieve the paused value (true or false) for contacts. This will provide users with the ability to programmatically access the paused status of contacts within the Forth CRM system.
Update Debt Record by ID to allow Bulk Updates
This update provides the ability to bulk update debts in the CRM via the API. This would then allow for multiple debts to be updated on a single API request. This updates the “debts” endpoint to support updating multiple debts on a PUT request where the user passes an array of debt objects with the debt ID present of the debts they wish to update.
Update Contact Return Value via API
This update enables the return of a customer record that was submitted via the API. It adds an endpoint to return a contact’s file. With this feature, the system can only return a file that is currently submitted. If attempting to return a file that is not submitted, an error message will be generated.
Get Enrollment Details via the API
This feature provides the ability via a new API endpoint to get all transactions available on a contact record. This will permit the creation of third-party custom applications to display current transaction details (in a read-only format) retrieved via the Forth API, from a customer’s record.
August 2023
These Release Notes for August 2023 list several new features and improvements, and are organized as follows:
This month’s Release Notes are focused on the great work performed by our Forth Development and Quality Assurance Teams to enhance your user journey. Get ready to elevate your CRM Experience with Forth!
What's New
Field-Level Suppression for the Debts Fields
This new feature allows administrative users to control which debt fields certain users or user groups have access to when adding or editing a debt in the system. It was built to expand the existing functionality around field-level permissions to include the debts feature in the system. With this feature, we have added debt information to the field-level permissions via a new "Debts" section that enables the selection of an individual debt field to be enabled or suppressed as editable via a checkbox. This applies to system-provided fields and custom fields defined for the account.
User Lockout Enforcement
In line with NIST 800-63, this new feature improves our security with a user lockout function based on the number of invalid attempts made by that user. This prevents malicious or forced attempts in your system and protects the data housed within your account. If the user has ten (10) consecutive invalid attempts, the system will lock out the user for 30 minutes.
During this 30-minute window, no one can take action to unlock, as the user is not locked out, but rather in a “cooling” off state. After this expires, the user is able to log in again and gets 10 more consecutive attempts. If the user fails these 10 attempts as well, then the user is locked out and can ONLY be unlocked by an admin, via a one-time use temporary password sent to the user. The system will also now track invalid user login attempts for all users logging into the Forth platform.
What's Improved
Process Refunds of Dropped Forth Pay Clients
Until now, you were required to contact Forth Pay if you need to reverse fees or process a refund to a consumer after cancellation. This update offers a solution to our Forth Pay clients that provides greater control over refund processing. We introduced the capability to schedule advances and refunds yourself for a dropped or canceled Forth Pay client. This feature reduces the need for re-enrollment or Forth Pay intervention. With this solution, you may initiate these refunds only when a client has been canceled from the program, you can only schedule client refunds and no other transaction types, and you can only schedule ACH Credit refunds to the account on record, nor do you have the ability to update the banking information before scheduling a client refund.
Stronger Forth CRM Password Requirements
This update strengthens the already robust password requirements within Forth CRM, to better ensure the overall security of your account. This update helps minimize the risk of unauthorized access and potential data breaches and provides clear prompts via validation messages and a feedback loop. The updates have been performed to exceed new security guidance from NIST and the federal government’s information security standards.
Customer Name Field on the Decisions Page for Unmatched Transactions
This update makes it easier for users to identify unmatched transactions on the Settlement Decisions page, without the user having to read the comments.
Description Box for API Generation
This update provides the ability to set a description for each set of API credentials that are generated in the CRM. This feature added a description box with a maximum limit of 250 characters to the API Key generation window on the REST API page. This description will now appear in the table of credentials once it has been saved, as a new column in the table. This solution improves clarity for users in terms of what keys are used for by letting them set their own description for each credential set.
Update Fee in the Loanosity DSL Calculation
Previously, the Loanosity DSL integration only factored in earned performance fees (EPFs) that are in the “FEE1” slot. With this update, we have adjusted the integration to calculate any fee that has a fee type = percent, is deferred, and is active. This allows a DRSP to use this integration, regardless of what fee slot they utilize for EPF.
API Updates
Create Advance via API
This update provides the ability to create an advance on a contact via the API. It adds an endpoint, and a POST request to this new endpoint, with the Contact ID present. Upon advance creation, the advance will now go into the status that is already defined. Click HERE to access this setting.
Any updates to the advance via API will be done with a PUT request on the advance endpoint referencing the ID of the advance created in this way.
Set Commissions and Advance Assignments via API
With this update, a user now has the ability to set commissions and advance assignments via the API. It allows the user to leverage the API to assign advance commissions and assignments. These updates assume that the advances being updated in this way have NOT been funded. This is enabled by creating a new API endpoint that uses a PUT request to update an advance by its ID within the Centrex API.
Send an Email to Contacts
This new feature enables clients to send emails to contacts through the API to easily communicate and allow attachments of uploaded files and files within the CRM to the email. This feature has been enabled by adding a new send email endpoint to the Forth CRM API, supporting the POST method with FormData. There is a maximum attachment size on the email of 20MB. This was done to stay below the maximum known threshold of many email clients around 25MB. These attachments must be one of the following content/MIME types to be accepted: jpeg', png', pdf, zip, gzip, msword, pjpeg, csv, 'text/plain', and msexcel'. NOTE: The Forth CRM does not currently perform real-time antivirus scanning of attachments.
Clixsign & Generated Document Types in Lender Submission API
This new feature enables lenders to identify and categorize documents attached to submissions via the API. It allows the lender to see the document types and Clixsign parameters for documents within the Centrex CRM when pulling submissions via the Get Submission Details API Endpoint. This will allow the programmatic identification of documents included as part of a submission for automated underwriting and decision purposes. This solution utilizes the existing "Get Submission Response" API endpoint. This option is applicable for PDF & HTML documents. This document type tracking feature is only available for documents generated or Clixsigns sent after November 2022. No tracking info exists before this time and it cannot be recreated. The document type value must correspond to the document type set at the individual template level.
Contact Enrollment Value via API
This feature allows a user to enroll a contact via the Forth API. This feature facilitates an enrollment flow in an automated capacity. Our solution was to create an API endpoint that enrolls customers into the Forth system (subject to Enrollment settings). In addition to enabling contact enrollment via API, this solution enforces parity to enrollment flow at the CRM UI, as well as enables clients to automate their enrollment flow via the usage of 3rd party applications. All saved plan/compensation template/banking data is unaffected just as you would expect manually enrolling via the UI.
Create Note API Response
This new feature returns the Note ID in the API response of the "Create Note" endpoint. The Note is also now visible in the CRM under the Contact Dashboard. This allows the user to know the Note ID after a Note is created via API.
September 2023
This month’s Release Notes are focused on the great work performed by our Forth Development and Quality Assurance Teams to enhance your user journey. Get ready to elevate your CRM Experience with Forth!
What's New (6)
Let Forth Take Care of Your Compensation Templates
This new optional feature offers a simplification of the management of compensation templates, including creation and design, by FORTH agents. Leave your comp templates in our hands and prevent client users from accidentally editing or deleting them. This feature has been released as a disabled add-on, so if you prefer to manage your compensation templates as you have been, you can!
Create Deliverability Windows for SMS
This new feature provides the ability to set delivery windows for a user's SMS campaigns. This will allow the user to further customize when the SMS campaigns are sent and then define a delivery deadline. This will help ensure company compliance with industry-standard rules around communication. In addition, this will better enable clients to control the messaging and when those messages can be delivered and prevent situations where DSRP consumers get notified after hours.
Interface to Update Policy Group for GCS Contacts
This new feature provides the user the ability to change the selected GCS policy group in a post-enrollment capacity. On the enrollment details screen, a new dropdown option has been added titled "GCS Policy Group". From this dropdown, the user would select from all available policy groups that are tied to the credentials saved for the company the user/contact is assigned to. When selecting a new policy group; the policy group that Forth uses locally with that contact is updated.
Enhanced Password Requirements
With this new feature, admins can facilitate their users to maintain strong passwords to ensure the overall security of accounts. It helps ensure that password requirements are clear, understandable, and enforced in a standardized manner across the system. This will minimize the risk of unauthorized access and potential data breaches, and ensure users understand the password requirements, and clear prompts are provided via validation messages/feedback loop. These requirements include a new minimum (12) and maximum (20) for password characters (superseding recommendations of NIST 800-63b). Passwords now must have all of the following: One uppercase letter, one lowercase letter, one numeric digit, and One special character (e.g., !, @, #, $, %, ^, &, *). Emojis and non-ASCII characters are not allowed.
Adding a Trigger Event for Debts Updated
This new feature allows clients to create a trigger event named 'Debt Updated,' allowing them to set conditions based on 'Debt Status.' This will enable them to receive notifications whenever the Debt Status field is updated, informing them of important changes. As a result of this feature, clients will now have the ability to select "Debt Updated" (replacing Debt Made Legal) from the "Event Name" drop-down menu while setting up trigger events, utilizing the existing fields in the system for the initial implementation of the "Debt Updated" trigger event. Finally, this feature streamlines the process by using "Debt Status" as the key field for the trigger condition. The Debt Updated trigger event won't be triggered for API updates and Credit Pull updates; it's solely intended for manual updates within the Forth CRM.
Prevent Users from Deleting Contacts that have Advances
This new feature provides the ability to prevent a user from deleting a contact that has a FUNDED advance(s) in the system. However, if a contact has no advances that have been funded still be able to delete that contact and all associated advances deleted as well. This will help improve overall coherence in the system as advances associated with deleted contacts will no longer show up in the advances tab and cause confusion as they cannot be accessed due to the contact it is tied to being deleted. It also helps prevent scenarios in which contacts whose advances have been funded in the system can be deleted - which helps achieve overall better data integrity.
What's Improved (6)
Add ForthPay return reason & Gateway hold status to the Servicing tab
This update to Forth Pay adds a view of a payment return reason. This information is useful in recapturing NSFs, which is a common task to ensure full payout for submissions. With this update, the Forth Pay return reason is now displayed in the transaction table within the servicing tab. This update also added a "Gateway Hold Status and Reason" that now allows affiliates to more easily complete the steps required to release the hold. This helps facilitate full payouts.
Update Memo Description for Earned Performance Fee Type
This update adds the phrase "Earned Fee" in the memo description line for all transactions with the type Earned Performance Fee to indicate that the fee is associated with the respective creditor's name. The updated memo description will now be displayed correctly in the system interface and in any generated reports or statements. The goal of this feature is to provide clarity and understanding for the fee transaction. An example of the new memo format would be: "Earned Fee- CREDITOR NAME".
Request Release Button Control
This update improves transparency and efficiency when applying the Request Release function within the CRM. When you click this new color-coded “Request Release” button, you now greatly reduce the chance of producing duplicate Forth helpdesk tickets, causing less confusion and saving you valuable time.
The “Request Release” button will be automatically disabled immediately, and then turn red after it has been clicked, or a client is enrolled into the program for the first time.
The “Request Release” button will be enabled again immediately once a Forth Pay agent acts on the account, after 24 hours from the initial click. or 24 hours after the button is disabled after enrollment. This will help reduce the creation of duplicate help tickets. As a bonus, when the button is disabled, a user-friendly tooltip will appear, keeping the user informed. It will read, “The button will be enabled after a Forth Pay agent acts on the account or 24 hours have passed since the initial click.”
Faster Loading of Edit Settlements Page
The settlements page, available from the “Contacts” module/tab, currently loads settlement check images directly. This inherently slows down the settlements page and the user experience.
By presenting links to the check images rather than loading them all at once, the DSRP settlement page of a contact now loads more efficiently. In addition, the implementation of links does not compromise the accuracy of settlement check information, and will still allow users to access the images as needed.
Standardizing Two Decimal Points for Key Percentage Fields
With this new feature, the Forth system has been updated to remove rounding and to accommodate two decimal places precision (i.e., changes in how percentage figures are displayed to include two decimal places). This update affects specific fields in the CRM, namely the 'Settlement %', 'Original Amount in percentage', 'Current Amount in Percentage', 'Verified Amount in Percentage', 'Percentage of Current', 'Percentage of Original', and 'Percentage of Verified' and sets them to be accurate to two decimal places. This enhancement will align them precisely with the 'Offer %' for more consistency and accuracy in business decision-making.
Update Credit Bureau Connection (CBC) Integration
The CBC Integration needed to be refreshed to support a few changes in XML node structure. As a result of this refresh, a Credit parsing tool was implemented, and PDF generation was improved.
API Updates (2)
Add Creditor Reference Information to Create and Update Settlement Offers Endpoint
This new feature adds the ability to include Creditor Reference Information when creating and updating settlement offers for settlement payments by Check. This will allow users to provide additional reference information related to the creditor, DRSP (Debt Relief Service Provider), and any special instructions for the settlement offer. The changes will be applied to the existing API endpoints for POST and PUT. This addition will not only enhance the settlement offers API endpoints to include the Creditor Reference Information, but will also improve the user experience by providing a way to capture and manage additional reference details.
Add Time in Status to Get Contact by ID API Endpoint
This new feature updates our contacts endpoint on the API to retrieve the time in the status field. Additionally, it updates our workflow endpoint upon GET to return full status history. The goal of this feature is to enable the retrieval of how long a client has been in a certain status & enable clients to better keep track of their customer base. This feature will now report in such that the newest/most recent status change in the history reflects first in the feed.
October 2023
What's New (1)
Allow Clixsign Requests to be sent to Linked Sponsor Contacts
This new feature allows the sending of Clixsign requests to a linked sponsor contact from the original contact account so that the linked sponsor can collaborate with the contact they are sponsoring and electronically sign on important documents. "Sponsor" has been added as a signer type (allowing users to select it for any assigned signer slot (1-9)), available in the dropdown menu option. In addition, the system now pre-populates the sponsor's information, i.e., Name and Email from the program sponsor field when selected from the dropdown. Such Clixsign documents are now displayed on both the original contact and the sponsor’s contact dashboard. This new feature was released to enhance collaboration and document management within the CRM application, as well as to streamline and improve the signing process by requesting signatures from sponsor contacts and improving workflow efficiency.
What's Improved (5)
Creditor Selection for SMS
This update facilitates the use of individual creditor information with the SMS feature. With this update, the Forth system allows the pre-filling of a designated creditor’s information using creditor-specific tags for SMS templates. This enables broader capabilities with our SMS feature and allows us to send specific creditor/settlement-related updates to the customer.
We added a new dropdown menu option within the ‘SMS’ subtab of the contact dashboard (accessible via the Contacts tab) to select a creditor (see the image below).
You may type in a creditor’s name and the option will auto-fill (see left below) or use the dropdown to make your selection (see right side of the image below). This new dropdown organizes the options as enrolled creditors listed at the top and unenrolled creditors after that for easier searching, and each listing includes the creditor name followed by the Creditor ID.
When a creditor is selected, any template that gets loaded from this point forward and contains the correct tags will populate that creditor’s information.
Lastly, making a creditor selection within this new process now appears in the History / SMS log.
Settlement Rebalance after Reversal Transaction
This new feature enhances Forth Pay accuracy in rebalancing settlements following Unauthorized Return/Reversal transactions. In addition, we noticed that settlement payment transactions remained in a Pending status instead of being updated to Low Balance if and when the Unauthorized Return caused a consumer's dedicated account to have insufficient funds for the said transaction(s). This refinement ensures that settlement payments are correctly matched on the Decisions page, avoiding accidental payments when funds within Forth Pay are insufficient.
The changes included backend coding and script updates, updates to existing queries to extend how far back we search for pending settlement transactions, and a new automatic trigger of a low balance payment to be visible in a settlement transaction.
Update CFT Integration to Retrieve Client Escalations
This new feature offers a real-time view of CFTPay escalation reasons directly from the Forth CRM dashboard, This requirement outlines the integration of the escalations API with CFT based on the provided API documentation. The aim is to efficiently retrieve and store escalation details and subsequently display these details on specific pages of the platform, including the Enrollment Details page and the Client Dashboard, to make informed decisions and act accordingly without switching between platforms.
Required Address Entry for Settlement Payments via Check
We performed an update to our system that streamlines your settlement payment process. With this update, the Forth system displays the mandatory address fields (address 1, city, state, and zip code) in the payment information section when the user selects a check, check overnight, or check 2nd day as the settlement payment method.
If any mandatory address fields (indicated via asterisk) are left incomplete, the system will prevent the settlement offer from being saved and will display an error, highlighting the field(s) that need attention.
To rectify this, the field in question will be highlighted with an exclamation mark indicating that it is necessary to fill in the field. When all mandatory address fields are filled out, the settlement offer will be saved with the entered address information. The system saves the now-completed address information with the settlement offer data for future reference and reporting purposes.
Benefits of this update include the elimination of the hassle of settlement payment checks being returned due to incomplete or missing address information, the accurate and timely receipt of settlement payments (boosting client satisfaction and trust), and the improvement of the efficiency and accuracy of the settlement payment process.
Update CREDITSCORE tag to Work with Xactus360
With this new feature, the Forth system has been updated to allow the {CREDITSCORE} tag used to render the credit score saved on a credit pull from the Xactus360 integration. This update enables proper tagging functionality to allow clients to populate the credit score on document, email, or SMS templates. If multiple scores are present, the highest score will be chosen.
API Updates (4)
Publish Contact Lists Endpoint
This new feature adds the ability to pull contact lists from the system. We published our lists endpoint so that clients can export a list of contacts by list ID and get the contacts they need for their relevant campaign. This enables the contact lists endpoint to be visible on the FORTH API documentation and enables service-type users to interact with this endpoint.
Multiple Schedules for a Specific Settlement Offer via API
This update was made as part of an overall Marketing Automation Project for our clients to help drive value.
This feature allows the retrieval of the Amortization Schedule, Settlement Schedule, and EPF Schedule for a specific settlement offer through the {{settlement_offers/{id}}} endpoint. This enhancement will provide a more comprehensive view of each settlement offer. This feature enhances the current endpoint to return additional schedule information for each settlement offer and improves the efficiency of our backend system by combining two endpoints into one. When a GET request is made, the server should respond with the appropriate schedules.
Modify, Create, and Update Debt API Endpoints to Accept ECOA Values
This feature allows the passing of standardized ECOA codes to the Forth CRM API to create and update debts in the CRM. This modification to the “Create Debt Record” and the “Update Debt Record” endpoints will allow users to standardize the passing of fields between systems and reconcile and sync data between them. In addition, this feature will accept ECOA standardized values for debt ownership (i.e. Who’s Debt), as well as be able to create and update debts with the ECOA values.
Add Permissions for Service Users Accessing API Endpoints
This new feature is another enhancement to your API management experience! This enhancement gives you granular control over which API endpoints your automations and integrations can access. These capabilities enable you to apply security best practices and limit how much data can be accessed by a specific party. This allows you to restrict access to API keys generated using various credentials sets, limiting what third parties using those keys have access to and further enhancing CRM security. In other words, you can control who can access what on the API. Benefits of this feature include the broadening of security capabilities around your API, restricting API keys to certain endpoints, and improving overall governance of API access by CRM users and administrators.
NOTE: This feature is available only for service user API keys
A dropdown menu can now select those credentials generated and tied to a service user. The listing of available API endpoints is grouped by their object type (advances, authorizations, calls, etc.), with checkboxes available to allow or block access (see example page below).
When an endpoint is enabled for a particular credential set, external services using that credential set may interact with the chosen endpoint. When disabled, the system returns an Invalid Access error, indicating that those credentials do not have proper access.
November 2023
What's New (6)
User Interface to Control Client Refund Type
This new feature provides an easier and cleaner user experience over Client Refund Types. Now, you no longer have to scroll through options to select a refund subtype that applies to you. The Client Refund Subtype dropdown menu will now ONLY offer the refund payment options configured for your client.
NOTE: This update only impacts clients that utilize Forth Pay and does not affect any other gateways.
The following client refund transaction subtypes (which now default to “ACH Credit”) are available:
ACH Credit
Bank Wire
Check
Check 2nd Day
Check Overnight
Replace Debts After Credit Pull
This new feature controls system behavior around debt handling after credit is pulled to merge or delete existing debt information. You will now find a brand-new Credit Pulls section on the Debt Settings page, accessible via the Admin tab. When you activate the checkbox provided in this section, your system will automatically eliminate outdated contact debt data and replace it with the most current information from credit reports, but only for new unenrolled contacts.
We also updated our credit pull process to account for this new setting (which is turned off by default). If enabled, the system checks that the contact has no enrollment date. If there is no enrollment date, the system deletes all debt information and re-inserts data from the credit report.
Finally, we rebranded the Add/Edit Debt Status permission to Modify Debt Settings.
NOTE: This feature is designed for contacts who have never been enrolled in a debt settlement program and requires that credit is pulled through Forth CRM using one of our credit pull integration providers.
Forth DataHub
Introducing Forth DataHub, the ultimate tool to enhance your data exploration within the Forth ecosystem. Developed in partnership with Secoda, Forth DataHub is your AI-powered companion to the Forth Managed Data Cloud (MDC), tailored towards efficient documentation, cataloging, and seamless data object discovery.
DataHub empowers you to delve deeper into the core system objects, such as contacts, debts, offers, transactions, and more. With its user-friendly interface, you can easily navigate tables, common queries, frequently asked questions and other valuable resources. We also removed the old Entity Relationship Diagram (ERD) as DataHub provides a more intuitive, comprehensive, and powerful solution.
Benefits of Forth DataHub include gaining insights into the structure of key system objects required to build performance reporting; easily searching and referencing data objects including all metadata and object properties; and with a large collection of frequently asked questions, saving you from the hassle of opening tickets and searching the list in case the community has already answered your query.
Allow DRSP to Process Refunds for Dropped Forth Pay Clients
Traditionally, you have been required to contact Forth Pay if you need to reverse fees or process a refund to a consumer after cancellation. Never again!
We developed a solution to this challenge that provides greater control over refund processing. We introduced the capability to schedule advances and refunds yourself for a dropped or canceled Forth Pay client. This feature speeds up refund processing time and reduces the need for re-enrollment or Forth Pay intervention.
With this solution, you may initiate these refunds only when a client has been canceled from the program, you can only schedule client refunds and no other transaction types, and you can only schedule ACH Credit refunds to the account on record, nor do you have the ability to update the banking information before scheduling a client refund.
Processing a Refund Payment for Dropped Clients starts with selecting a Canceled client via the Enrollments Tab, and selecting “Refund Payment” (see red highlight in the image below).
NOTE: This update only applies to Forth Pay Clients using the Forth CRM who have dropped from the program and have an Account Closure & Balance Refund Request Form in place.
In addition, these pre-approved client refund options are readily available via a Sub-Type dropdown menu on the Transactions page.
Loanosity DSL Updates
Several improvements were made to the Loanosity DSL Integration. These include:
Transmit Gateway Information - This update to the Loanosity DSL integration significantly expands the eligibility of consumers that can be submitted via the integration. We revamped the mappings page for the Loanosity DSL integration, introducing a dedicated section for payment gateway settings. There are now mappings for the following payment gateways: FORTH Pay, RAM, CFT Pay, and GCS. This new feature is designed to allow DRSPs to submit contacts that are enrolled in the gateways that are supported by Loanosity, where previously, only FORTH Pay Gateway contacts were able to be submitted to Loanosity DSL via the integration. Each payment gateway section now includes mappings for key fields associated with FORTH Pay, RAM, CFT Pay, and GCS. These fields are Routing Number, Account Number, and Dedicated Account Number
Sending Payment Frequency - We updated the integration to send the payment frequency of the program to Loanosity DSL as part of the enrollment process. This will be done by sending payment frequency saved on the enrollment plan.
Add Settled Balances - We added the settled account balances (not the calculated balances) of enrolled debts to the API transmission between FORTH and Loanosity DSL
Add Client Savings) - We updated the Loanosity DSL integration to include the client escrow account balance that is currently saved in the API transmissions/requests that get sent to Loanosity.
Settlement Offer Tags via Webhooks
Formerly, when DSRPs attempted to webhook settlement offer details and map it to the client's notes, the information came over as the tags. This new feature updates the "Settlement Status Change" event trigger to support the transmission of fully rendered settlement offer details into a readable text format via webhook which can be used to update affiliate accounts of the offer details.
Upon any settlement status change, the system now initiates the webhook in which the system now transmits settlement offer details where placeholder tags are replaced with actual client data.
This feature streamlines the communication of settlement offer details between the CRM system and external affiliates or integrated systems; reduces data processing requirements for recipients by ensuring webhooks transmit fully rendered information; and enhances data accuracy and efficiency in updates communicated through webhooks.
What's Improved (6)
Push Estimated / Requested Loan Amount with the New Credit America (NCA) Integration
With this update, the NCA integration now includes a mappings page in the integration settings to map the EstimatedLoanAmount field in the NCA API to a CRM custom field. The estimated loan amount value is then transmitted based on the custom field it is mapped to. This lets a customer map their internal value for the estimated loan amount. Ultimately this allows the NCA integration to include the estimated loan amount value in the application request that is sent. When transmitting the EstimatedLoanAmount field to NCA it sends in the correct format (any price/dollar fields are converted to numeric).
New Source for Revolving Credit Limit in Xactus360
This improvement (available for all Xactus 360 customers) updates a specific field related to the revolving credit limit in the XML received from Xactus360. This changes the mapping for this field from the PORTCBL field to the RevolvingCreditLineUsed field attribute for the revolving credit limit mapping. This new value will be expressed as a percentage in the score models section of the Contact Dashboard.
Note: No previous customers will be updated as part of this change, only new credit pulls going forward.
Email Lender Submission with Multiple "To" Addresses
For Centrex Business Finance Accounts - Until now, when you submitted an advance via email to a lender that had multiple submission contacts, the system sent separate emails to the contacts. With this update, the system now sends a single email, so multiple representatives at the lender organization can view and respond to submissions in the same email thread.
Move Process Date and Process Next Business Day with Supervest
For Centrex Business Finance Accounts that use Supervest, we are moving transactions to the next business day and also processing transactions one day in advance. This change updates a transaction’s process date that is being created for Supervest from today to the next business day. In addition, it updates the back-end logic for processing transactions to process transactions from today to the next business day.
Add SAVE Plan for Student Loan Accounts
With this update, Forth now offers the “Saving on a Valuable Education (SAVE) plan for student loan accounts. The SAVE Plan is the newest income-driven repayment (IDR) plan offered by the U.S. Department of Education. This plan will replace the existing “Revised Pay As You Earn" (REPAYE) Plan. We updated the “Retrieve Loans and Programs” page of the system to add SAVE as a new student loan repayment plan option within Forth’s student loan calculator.
In addition, a modification was made to our Student Loan Calculator in the background to account for updated poverty line percentage values used in the SAVE plan (compared to the existing REPAYE plan).
API Updates (1)
Pausing a Contact via API
This new feature adds the ability to pause a client via the API which would pause all payments from being initiated from that client. We created a new endpoint to update a contact to the ‘paused’ state in the system. When a contact is paused in this fashion their payments will not process just as if they were paused manually via UI and the UI will reflect the paused state. Contacts may also be un-paused at the UI when paused from the API.
December 2023
What's New (6)
Credit Card Data Displaying on the Advance Page
This new feature addresses credit card data displayed on the Advance page. Merchant Cash Advances typically “re-pay” with ACH payments, which is the way 99% of Centrex Business Account users use the system, however, certain clients, collect “re-payments” via credit card transactions. For those accounts, CC payments are created daily by the system and processed like any other card payment. Formerly, the user needed to navigate back to the contact record to fill in the credit card form. We added a view for this under the “Funding Info” tab. modules/advances/view-funding.php. This should toggle on/off based on the “Repayment Method” selection.
Ytel Phone System Updates
Ytel to Get Contacts with Tasks in “X” Status
This new feature adds the ability to filter tasks on the task reports by contact status in addition to the other filters on the page. It adds "Contact Status" as a contact company filter to the query on the task reports page, which will enable further reporting and workflow capabilities with our task page
https://login.forthcrm.com/index.php?module=stats&page=task. It now displays as a multi-select dropdown option sorted by the file types enabled on the account and then the stage/status within that file type.
Ytel User Role
This new feature supports our mutual clients with Ytel and standardizes the Ytel setup process by providing a standardized user role with all permissions enabled they need to perform their setup activities using both FORTH CRM and the Ytel platform. This new Ytel user role will not be a billed user role nor will contacts with this user role be able to be logged into from a super admin/admin user from the edit user page in the CRM.
Settlement Voided Reason Reporting
This new feature provides settlement voided reason reporting within the settlement settings user interface. Previously, when voiding a settlement there was no option to provide a reason as to why the settlement has voided. Adding this ability allows additional reports to be created based on the reason why a settlement was voided. This enables broader reporting around settlements and enables the ability to customize voided reasons for the settlement.
Clixsign Documents to be Copied via Webhook
This new feature allows a user to transmit completed Clixsign documents via the tags system/webhooks from an affiliate to a backend, and have the underlying files copy between accounts. We added a new tag {CLIXSIGN_DOC_IDS}, which is a comma-separated list of document IDs to be transmitted, eg: {1538896, 1538892}. The system will now recognize these IDs and copy the completed Clixsign PDFs from the webhook origin account to the destination account. The PDFs will show up under the uploaded docs tab. No Clixsign metadata will be transferred in this process and only a PDF(s) will be received. The selected document will then be accessible in the destination account on the uploaded docs tab.
What's Improved (2)
Cancellation Page Refunds Bypass Gateway Hold
We made a crucial update to our system that enhances the security and efficiency of refund processing for consumers. In our continuous efforts to provide you with the best service, we have identified and addressed a potential loophole in the refund process. Specifically, we implemented a solution to prevent non-approved refunds from being processed when a consumer is on a Forth Pay Gateway Hold. Benefits include:
- Enhanced Gateway Hold Security: Refunds for consumers on a Gateway Hold will only be processed after hold requirements are met and released.
- Exclusion from NACHA Batch Process: Client refund transactions designated as "ACH Credit" will no longer be picked up by the daily batch process when the Hold Reason is "Banking Information Changed."
- Improved Process for Dropped Client Refunds: If a consumer is on a process hold of "Banking Information Changed" and the client is dropped by the DRSP, the hold reason will not change until a Forth Pay agent reviews the consumer authorization and updates the hold to "Dropped by DRSP." This ensures a seamless process for client refunds.
CRM Controls for Return Codes
This update adds four ACH Client Debit Return codes for consumers on a gateway hold for Invalid Bank Accounts and Returned Payment Holds. The initial piece of this update involves the following two return codes:
- R15 (Beneficiary / Account Holder Deceased)
- R20 (Non-Transaction Account)
Previously, Forth Pay put the consumer on gateway hold with “Invalid Bank Account” for the following ACH Client Debit Return from the bank: 'R02', 'R03', 'R04', or 'R16'. With these updates, R15 and R20 return codes will now place the consumer’s account on hold with the reason - Invalid Bank.
The second portion of this update involves the following two return codes:
- R08 (Payment Stopped)
- R09 (Uncollected Funds)
Previously, Forth Pay put the consumer on gateway hold with “Returned Payments Hold” for when consecutive ACH Client Debit Returned as 'R01'. With this update, the system will place the consumer on hold after three consecutive attempts with the same code or a combination of these codes, with the reason - Returned Payments Hold. To make this transition smoother, we ask DRSPs to familiarize themselves with these specific return codes mentioned above that place their consumers into the Hold status.
API Updates (3)
Paginated Contact List via API
This new feature introduced a new contact lists endpoint that supports the ability to retrieve a paginated list of contacts from the FORTH system. Specifically, this feature enables 3rd party systems to pull list data in a paginated format, which enables further automation capabilities for clients who wish to build more of their processes on top of the FORTH API. This new endpoint will be limited to 100 contacts returning at a single time. This feature also applies to the CTX API.
API User Selection Dropdown
This update allows users to see the service user's information for context when generating API keys for them on the REST API page in the Admin tab. In other words, it allows the user to know which user ID credentials are being generated. This feature modifies the “Select a User” dropdown on the REST API admin page to show additional information. The same information is shown for both service and standard users, and the use of the feature assumes the client has the Forth CRM API addon enabled and has access to the REST API page.
Settlement Offers for a Contact via API
This feature allows the CRM user to retrieve all settlement offers associated with a contact based on a specific Debt ID. This simplifies the process of accessing settlement offers for a contact. When a valid Debt ID is provided, the system now returns all associated settlement offers. and enhance API integration efficiency by reducing the dependency on pre-known offer IDs. Enhancing this aspect of the CRM system should significantly improve user satisfaction as well as system efficiency.