Bug fix to surface the correct min_pay_am_interest_cents value on the final statement of a paid off account.
Canopy Release Notes
New features and fixes will be reported here.
API
Improvement
12 days ago
Today, our system only allows you to define interest policy for your borrowers at a template (a.k.a. Product) level. The interest policy governs the amount of interest accrued on a borrower’s account (using that policy template, a.k.a. Product).
Previously, the only way to define it was via providing a predefined calculation method (
interest_calc_method) in your POST …/products request. Some of the accepted values include monthly_ending_bal_360, cycle_start_365 etc. Read more hereUnderneath, there is a formula:
Now, however, we added new fields which allow you to tweak individual configurations that make up that calculation method:
interest_accrual_interval- Interval that specifies when interest is calculated and accrued on the account. E.g.1 day,7 days,1 week,1 monthetc.
interest_calc_balance_type- Target balance (Principal in the formula) to be used when calculating interest accrual relative to the cycle. E.g.STARTING,ENDING,AVERAGE
interest_year_length- The number of days a year has in the interest calculation formula. E.g.360,365
You can fill in the corresponding fields within
product_lifecycle_policies.interest_policies.AND
you should ALSO specify your own label/ Name for that interest calculation method under
interest_calc_method. e.g. “My_new_calculation_method”. That’s a terrible example, but feel free to name it the way you like!CanopyOS
Improvement
12 days ago
Now it is easier for customers using Multi-Loan products to visually tell apart Restructured and Active Loans on the Account view inside Canopy OS.
The two Loan status cards will be represented by the following designs:
Plus, once you click on a restructured Loan card, you will have a link to show the new Loan (post-restructuring) inside the Transaction Detail drawer.
API
Improvement
19 days ago
Payment Reversals (or payment failure) in Canopy increase an account’s balance in two ways:
- Reintroduced balances: The payment being reversed paid down some portion of interest, fees, and principal balances. This balance needs to be reintroduced by the reversal.
- Retroactive balances: If the payment never occurred, overall interest and fees for the account may need to be higher. For example:
- If the balance should have been higher, the borrower may need to have accrued more daily interest than they actually did
- If the borrower’s payment helped them avoid a late fee, that payment’s failure means the late fee would have been assessed.
This release helps you granularize a payment reversal to understand how it breaks down to each of those categories:
- Both when observing a
statementand when observing apaymentorpayment_reversalline item.
See below for detailed changes to the API:
To improve visibility of retro-active events in our system (payment reversals in particular), we have added additional fields at the individual transaction (
line_item) and a tallied-up cycle (statement) levels. Both of those should give you a reversal breakdown (SPLITS) by balance types (PRINCIPAL, INTEREST, FEE), and whether that balance is re-introduced (existed before the payment and its subsequent reversal) or newly-introduced (net new balance as a result of the reversal).
At the
line_item level (GET /line_item/{line_item_id}), we’ve added a new object called line_item_relationship_summary! It includes the following values:- payment_parent_id
- splits_principal_cents
- splits_interest_cents
- splits_fees_cents
- original_payment_amount_cents
- newly_introduced_fees_cents
- newly_introduced_interest_cents
- payment_credit_balance_cents
Check out this section on the Transaction/Line_item level of the Retroactive-event processing Guide for more details, and the 200 Response to our GET
/line_item/{line_item_id} for exact field definitions.At the
statement level (GET /statements/{statement_id}), within the cycle_summary object you will get tallied up values of balances (INTEREST, FEE, PRINCIPAL) as a result of ALL reversals that cycle:- cycle_payment_reversal_interest_cents
- cycle_payment_reversal_interest_split_cents
- cycle_total_payment_reversal_interest_cents
- cycle_payment_reversal_fees_cents
- cycle_payment_reversal_fees_split_cents
- cycle_total_payment_reversal_fees_cents
- cycle_payment_reversal_principal_split_cents
- cycle_reversal_split_cents
All of that in addition to individual line item detail (
line_item_relationship_summary) within an array of objects (line_items) for that cycle!Check out this section on the Cycle/Statement level of the Retroactive-event processing Guide for more details, and the 200 Response to our GET
/statements/{statement_id} for exact field definitions.CanopyOS
Fix
26 days ago
For Users of Canopy’s Finance Request Workflow:
A bug occurred that caused users in timezones behind the product timezone to observe mismatched values for “Requested Outlay Date” on the “Request Details card” compared to the “Modify Request Details form”. This bug made it possible for “Requested Outlay Date” to be inadvertently changed, as the incorrect value in the form field would be propagated to the database when the form was saved.
This bug has been fixed and users should observe the same date for “Requested Outlay Date” in all cases, regardless of their local timezone.
Improvement
DataDirect
1 month ago
We heard from you that it was difficult to understand our tables and columns in DataDirect, hence we invested into creating a Data Dictionary.
Now you should be able to navigate to each table, see the column name, type and definition.
Would like to find every table that has the column you have in mind? You can use the search bar to find every instance!
CanopyOS
1 month ago
The colors and other style details of text and other components in CanopyOS have been updated. Functionality remains unchanged.
API
Improvement
1 month ago
As a quality-of-life improvement, you should be now able to filter the
GET {account_id}/line_items response by:line_item_type- to show different kinds of transactions on a specified account. can be one of the following:- CHARGE
- PAYMENT
- CREDIT_OFFSET
- DEBIT_OFFSET
- MANUAL_FEE
line_item_status- to show all transactions of the selected status:- AUTHORIZED
- DECLINED
- INVALID
- OFFSET
- PENDING
- POSTED
- PROCESSING
- RETRO_VALID
- REVERSED
- ROLLED
- SETTLED
- SPLIT_INVALID
- SPLIT_VALID
- VALID
- VOID
effective_at_beforeandeffective_at_after- to see all transactions processed by our system within the time constraints (inclusive).- Both query parameters expect a timestamp input. e.g. 2020-04-21T00:00:00+00:00
max_original_amount_centsandmin_original_amount_cents- to see all transactions with original amounts within absolute monetary value constraints (in cents).- Expects whole numbers (integer)
API
Improvement
1 month ago
As a quality-of-life improvement, you should be now able to filter the
GET /Customers response by:customer_type- can be eitherpersonorbusiness
business_ein- EIN of the business, expected input format inNN-NNNNNNN.- as part of the
search_parametersquery parameter
Some other filters that had been available prior to this release, and could help you get results of Business customers faster/ more efficiently via
search_parameters query parameter:doing_business_as- The DBA name of the Business
business_legal_name- The legal name of the Business
Improvement
DataDirect
1 month ago
As part of our effort to rename
Delinquency_report table into a more-aptly-named Past_due_report within DataDirect, we have added an identical Past_due_report table.You can read more on the reasoning behind the name change in our documentation https://docs.canopyservicing.com/docs/delinquency.
Both tables are going to be available until the end of November, to give you enough time to update your scripts and ingest Past_due_report table going forward.
Delinquency_report table in DataDirect is getting deprecated on December 13th.Product
Improvement
1 month ago
Canopy will add a new table to store all accounts recurring fee data with the appropriate relationship linking them back to the accounts table (relationship one to many - one account to many recurring fees linked by foreign key ‘account_id’ in accounts_recurring_fees)
New table added:accounts_recurring_fees
columns:
- account_id uuid
- external_account_id text
- organization_id number
- recurring_fee_interval interval
- recurring_fee_amount_cents int
- initial_delay_offset interval
- is_fee_interval_floored boolean
- recurring_fee_label text
CanopyOS
Improvement
2 months ago
Connect now presents a tutorial page to help a user get started on their first visit.
Improvement
API
2 months ago
The field
credit_balance_cents has been added to the line item detail. In the Get Individual Line Item API request, you can now see how much each line item contributes to an account's credit balance.CanopyOS
Improvement
2 months ago
Added an enhanced loading interstitial while previewing Payments and Payment Reversals in CanopyOS
CanopyOS
Feature
2 months ago
LoanLab now supports simulating restructuring a loan for an account! Loan restructuring provides various options of changing an existing loan's behavior. Learn more about Loan Restructuring in Canopy's system here.
Try it out by using the new Restructure Loan option from the action menu in LoanLab!
3 months ago
Per notice that has been communicated with customers, Canopy is introducing a change to the handling of credit balances that occur primarily as a result of payments that exceed the total balance of an account.
Going forward, when a new line item is created, the system will automatically check for an existing credit balance on the account and pour the credit balance towards the new charge line item. If the credit balance fully covers the new line item amount, no interest will be applied.
In cases where the credit balance does not fully cover the charge, the system will apply interest to the remaining balance of the charge after the credit balance has been applied.
beta
Feature
3 months ago
We’re Excited To Launch Our New Preview System!!
Canopy’s new Preview capabilities are launching into Beta! Preview is supported for the Payment Creation, Payment Reversal, and Loan Creation API Endpoints.
Operations in the system of record are complex; often, a single operation results in many changes. For example, a single borrower payment alters balances, minimum payment obligations, amortization schedules, and more. The Preview API allows you to fully visualize all changes to the computational state of a borrower account prior to executing the operation.
Try it out in CanopyOS!
In CanopyOS, the Preview capabilities are now available in the Payment and Payment Reversal drawers.
While accessing the payment and reversal drawers, a new "Preview" button allows the operator to see what changes would occur to the account, new line items, allocation details, and even an updated amortization schedule where relevant.
These previews have no effect on the state of the account and can help operators make changes with confidence before committing to important account actions.
Using The Preview API
When the preview header is provided on a request for a supported API endpoint, a URL to the Preview endpoint with a fully formatted request will be returned. This endpoint returns all computationally relevant differences on the account from the operation being previewed.
This allows you to increase borrower transparency - for example, helping your borrowers understand the impact of payments they are considering making.
Preview helps operators and borrowers alike make good decisions and communicate effectively about the impact of changes they make before taking final action on an immutable ledger.
For further detail on the feature, check out the guide in our documentation.
Beta
We currently consider the Preview feature as a Beta release - we would love feedback from your team! Please reach out to your account representative if you’re interested in providing feedback. Before a full-featured launch, we’d like to better understand:
- The situations in which you preview operations on an account
- The information you’re aiming to learn from Previews
- Any designs or experiences you’re interested in embedding in your borrower-facing applications to increase borrower transparency
- Any unsupported operations for which you are interested in Previewing Activity
beta
Product
3 months ago
We’re excited to announce the launch of our newest product, Canopy Connect!
Connect is a user friendly workflow builder that allows users to integrate Canopy with the other systems that power their lending program and automate manual processes.
Click on Connect in the menu of your CanopyOS UAT environment to learn more!
3 months ago
We added a new enum to the
promo_min_pay_type called INTEREST_AND_PERCENT_PRINCIPAL_V2. This new min pay type formula will combine all unpaid balance, newly accrued interest within the cycle, newly accrued fees within the cycle, and an allocated percentage of the principle.Borrower Portal
Fix
3 months ago
Previously, the dashboard view for Borrower Portal included upcoming payments for closed accounts in the Upcoming Payment list as well as summing them into the “Payments Due This Month” amount.
Now, these payments are correctly excluded.
CanopyOS
Fix
Improvement
3 months ago
This release includes a number of minor CanopyOS improvements:
- In the “Account Detail” view, secondary customers of an account were incorrectly marked as “P” for primary. Now, all related customers should have the correct role.
- When submitting the “Account Status Change” form after changing the account status, sometimes the user would be unable to submit the form without changing the account substatus as well. This has been corrected.
- Sorting of rows in the “Interest Rate drawer” on the “Account Detail” view could be non-deterministic, causing the ordering to change on successive renders. This issue has been corrected.
- The “Admin” menu in the top bar has been moved to the left navigation.
CanopyOS
Fix
4 months ago
A bug in our release Aug 22, 2023 caused installment cards for embedded loans on the “Account Detail” view in CanopyOS to intermittently re-order, as well as amortization schedules for embedded loans to be incorrectly ordered.
A hotfix for this bug has been deploy: the ordering of installment cards and loan amortization schedules should now be fixed.
CanopyOS
Improvement
4 months ago
Formerly, in the App Keys view in CanopyOS, there was a poor user experience when attempting to add application keys when:
- Organization is already at the maximum number of application keys
- Application key name has invalid characters
Now, we properly disable app key creation when the organization is at the maximum number of keys, and user should correctly observe form validation errors when entering an invalid application key name.
CanopyOS
Fix
4 months ago
Previously, the statement detail view in LoanLab incorrectly displayed the statement’s minimum payment due for the “Previous Statement Min Pay” field due to mismapped fields in the frontend.
This error has been corrected.
CanopyOS
Improvement
4 months ago
The design of the card component for embedded installment loans on the Account Detail view of CanopyOS has been improved.
CanopyOS
Improvement
4 months ago
Previously, the Account Status Change form drawer available through the Manage menu in the Account Detail view did not have a notes field, unlike most of the other similar drawers. This meant that a user would potentially have to go through form submission twice: once to change the status, and once to add a note explaining the status change.
Now, Account Status Change form contains a note field which includes the context of which statuses the account changed from and to.
Improvement
Fix
4 months ago
We are enhancing the way we support account statuses by allowing any account in a closed status (regardless of sub status) to continue to stop all cycle related activity (statement generation, reoccurring fees, new charges) while now supporting payment activity (payments, refunds, credits, offsets). Payments will also following payment pouring logic for applicable line items.
CanopyOS
Improvement
4 months ago
Formerly, the product detail card in the account detail view of CanopyOS did not display any recurring fees for the account product.
These fees will now appear on the product detail card correctly.
CanopyOS
Fix
4 months ago
Formerly, CanopyOS did not properly apply the product timezone in transaction detail drawers. In some cases, this resulted in a mismatch of dates between the “Transaction History” list and their respective transaction detail drawers.
This issue has been resolved, and all dates should now match between both views.
CanopyOS
Feature
4 months ago
Formerly, simulated accounts in LoanLab would simply inherit their promotional policies from the selected product.
Now, it is possible to override those policies at the account level through the LoanLab UI.
CanopyOS
Improvement
4 months ago
Formerly, there was no way for a CanopyOS user to know the date on which an unpaid account will become delinquent.
Now this detail is available in the Upcoming Payment card of the account detail view.
CanopyOS
Fix
4 months ago
Formerly, in some cases, after changing the “Requested Outlay Date” field in the “Modify Finance Request” form, and saving changes, an edge case caused timezone offsets to be applied incorrectly when the record was updated in the database, causing the “Requested Outlay Date” field to shift by one day.
This edge case has been identified and is now correctly handled, ensuring users should always observe the same “Requested Outlay Date” value after they save the form.
CanopyOS
4 months ago
The design of the global loader component in CanopyOS has been refreshed.
Feature
Improvement
4 months ago
Support for multiple webhook URLs
- Canopy now allows sending webhook notifications to multiple URLs. This is useful if you need multiple systems to act on the activity and changes that happen within Canopy.
- You can now also limit which webhook events get sent to a particular URL. For example, if you only wanted to receive webhook notifications for account creation events, you can limit that through our new filter property.
- For more details on this change, please see our Docs.
- Updates to the Canopy roadmap can be reviewed here.
Other changes
- Improving the performance of retroactive engine
- Updates to reconciliation reporting for money movement customers
CanopyOS
Fix
5 months ago
Formerly, amortization schedule would display “paid” amounts in red if that payment had not been satisfied in full, regardless of current date.
Now, amortization schedule only displays “paid” amounts in red if the payment was not paid in full on time.
Product
Improvement
5 months ago
In order to improve the stability and enable faster development of new features, we’ve made a few infrastructure changes to DataDirect.
There are no changes to the customer experience or core functionality, however, the changes require new connection credentials to be created.
1. Access our existing endpoint to retrieve new credentials via GET
…/organization/data_direct2. Then, update your database client/ data warehouse/ data lake with those access credentials. That’s all!
You can see an example response (i.e. credentials) and more inside our documentation.
CanopyOS
Fix
5 months ago
Previously, in some instances, when rapidly clicked, CanopyOS pagination components could incorrectly paginate into negative page numbers.
An additional safeguard has been added to ensure this can no longer occur.
Improvement
5 months ago
- Improvements to retro handler to increase reliability of reversals
- Improvements to DataDirect platform stability to allow for greater reliability for larger lending programs
- Improvements to platform stability to ensure uptime during hot fixes and releases
CanopyOS
Fix
5 months ago
Previously, snackbar notifications at top of screen could become stuck in some scenarios and not dismiss properly.
Snackbar notifications now more reliably dismiss, and can be manually dismissed by clicking the notification.
CanopyOS
Fix
5 months ago
Previously, because the merchant notes form default value was not populated from the API, a merchant with note would have its note overwritten with an empty value when submitting the “edit merchant” form.
Now, the “edit merchant” form should correctly populate the existing merchant note as the default value, allowing it to be edited, and ensuring it is not overwritten with empty values.
CanopyOS
Fix
5 months ago
Previously, in the account detail view, when a drawer was opened by clicking an item in the “Manage” dropdown, in some cases the dropdown items would remain clickable while the drawer was open. This caused unintended behavior that could result in opening other drawers while interacting with the current drawer.
An additional safeguard has been added to ensure this does not occur.
CanopyOS
Improvement
Fix
5 months ago
Previously, installment accounts in LoanLab had a fixed number of cycles (defaulting to the term of the loan). Two changes have been made:
- The default number of cycles has been increased to the term of the loan + 1, as no payment is expected the first cycle. This additional cycle enables LoanLab scenarios with strict repayment and observing final statement with $0.00 balance.
- The “Add a Cycle” button, formerly present only for revolving accounts, is now present on the timeline for installment accounts as well. This enables the user to create scenarios where borrower underpays (which will result in creation of an additional cycle).
6 months ago
- Canopy has behaviorally changed handling of payment failures throughout the system to leverage our V2 Retroactive engine and to make the nature of behavior consistent with the reversal of settled payments.
- All Impacted users have received full notice around these impacts and coordinated with the Accounts team.
6 months ago
- Increased validation and monitoring of Canopy’s event system through internal tooling
- Infrastructure changes
- Additional automations related to Metro2 reporting through Bloom to account for Use of Retroactive Engine V2 in Payment Failures
6 months ago
- Enablement work for SafeGuard
- Technical infrastructure improvements for system of record (non-user impacting)
- Technical infrastructure enhancements for DataDirect (non-user impacting)
- Performance improvements for event processing
- Fix - Merchant Data inclusion for charges in DataDirect
- Pending Payment refactor in test environments (impacted clients notified directly based on product usage patterns)
beta
CanopyOS
Improvement
6 months ago
LoanLab now allows you to search for the product you’d like to use for your simulation account.
beta
CanopyOS
Feature
6 months ago
You can now test autopay behavior on an account through LoanLab!
This feature is useful for answering questions such as:
- What is the exact date and time that autopay will trigger?
- How much will autopay trigger for in different scenarios?
- Will autopay trigger at all given other transaction events on the account?
Check out the demo:
beta
Feature
CanopyOS
6 months ago
LoanLab now supports the ability to simulate the behavior of an account when strict payment is enabled.
The new setting can be found in the Advanced Details section of the Account Setup screen.
Strict payment turned on will limit min pay reduction to only payments. Refunds and debit offsets will not reduce min pay when off. This setting is often useful for consumer products at risk of refund fraud.
CanopyOS
Fix
6 months ago
Previously, in LoanLab simulations, a bug with initial null values being coerced to false resulted in amortization schedules always appearing as if minimum payments due had not been met. Amortization schedules in LoanLab simulations should now correctly reflect payment activity on the simulated account.
CanopyOS
Improvement
7 months ago
Previously, CanopyOS did not provide insight into which payment was reversed. Now, once a reversal has processed, users will observe a reversed tag in the Transaction History list on the reversed payment.
Improvement
API
7 months ago
Improvements to our how our API verifies authentication tokens—expect to see faster response times across the product.
CanopyOS
Fix
7 months ago
Previously, current interest rate in SCRA drawer was wrong in some scenarios. The current interest rate shown is now correctly sourced from from account.summary.interest_rate_percent.
CanopyOS
Fix
7 months ago
Previously, min pay principal amount in statements for revolving accounts was being sourced from the incorrect attribute and thus would be appear as
-. Now it is correctly sourced from min_pay_details.min_pay_revolving_principal_centsCanopyOS
Improvement
7 months ago
Previously detail statistics for revolving accounts included a redundant minimum due amount:
Now, detail statistics for revolving accounts shows in its place the total interest, sourced from account.summary.interest_balance_cents:
Borrower Portal
Fix
7 months ago
Previously, if user paginated forward on the Upcoming Payments list view, and then applied a filter, pagination parameters were not cleared.
This resulted in unexpected UI state where user appeared to be on a page greater than 1, but usually observed an empty list.
Now, when applying filters, pagination is reset and user will observe first page of new result set correctly.
Borrower Portal
Fix
7 months ago
Previously, Upcoming Payments list view included payments for accounts in all statuses including
CLOSED. This caused confusion as these payments are no longer expected to be made.By default, this view now applies a filter that excludes accounts in
CLOSED status. See new account_status filter for more details.
Borrower Portal
Feature
7 months ago
Added a new filter for Upcoming Payments list view and backing API to enable filtering results by account_overview.account_status.
Borrower Portal
Improvement
7 months ago
New account_status filter on Upcoming Payments list view is now applied to CSV download results as well.
beta
8 months ago
While LoanLab continues to be in beta, we are continuously working to iterate and improve it.
A few enhancements and fixes we’ve recently released:
- Action Timeline Enhancements:
- Your Action Timeline view in LoanLab will now automatically expand the Cycle that has your last played Action.
- Fixes to improve the performance of Action playing.
- Welcome Page: We’ve enhanced the Welcome Page to give better clarity and instruction on how to use LoanLab
- Additional Recurring Fee Interval options.
- Additional transaction status options.
- A number of miscellaneous bug fixes.
Noticed a bug? Want to request a feature? Want to let us know you’re enjoying the tool?
Tell us about it here →
beta
Product
8 months ago
INNOVATE. SIMULATE. OPERATE.
LoanLab is powerful loan simulation platform that empowers you to experiment, validate, and optimize your credit and lending programs with confidence. Simulate the entire lifecycle of a loan, test different policies and actions, and observe real-time effects.
LoanLab can be found in the CanopyOS menu of your UAT environment.
Improvement
9 months ago
A number of additional fields that were previously only available through our API are now also available through DataDirect as well. All available fields can be found in the DataDirect Getting Started Guide.
Improvement
9 months ago
DataDirect has added a new Refresh History Table to assist you in identifying the date and time of the last refresh of a particular table. This will also let you know the exact time at which a tables’ data is representative of.
beta
Improvement
9 months ago
Past Due Assessments on Failed Payments
When a payment is initiated before a due date, but fails after the due date, all past due assessments can now be applied. This reduces fraud risk and guards against borrowers making a payment they know will fail in order to stay in the grace period, avoid fees, or avoid delinquency.
beta
Feature
10 months ago
You can now safely modify the terms of a loan while preserving the history of loan activity. This supports a variety of use-cases depending on your loan agreement with your borrower. This allows you to enhance your lending programs to give borrowers more flexibility over their repayments, and adjust the structure of your loans to meet the changing needs of your borrowers.
v1
Improvement
10 months ago
You can now optionally configure installment loans to limit their interest generation to the loan duration.
v1
Improvement
10 months ago
Canopy's webhooks that previously fired only in real-world time, can now fire in response to testing accounts using Controlled Processing.
Fix
10 months ago
We are happy to restore automatic hourly refreshes for DataDirect users who have experienced once-per-day refreshes for the last week.
v1
Feature
10 months ago
Canopy has added the capability to charge interest on installment products (loans) using the average daily ending balance of the loan. Interest is calculated by multiplying the daily periodic interest rate by the mean ending balance of the loan across all days in the cycle in question.
Feature
10 months ago
Fine-grained transaction details from Galileo authorizations & adjustments are now present in Canopy line_item metadata for users of the Canopy Galileo issuer-processor integration.
Improvement
10 months ago
For users of the Canopy Lithic Integration, Canopy is now prepared for Lithic’s published breaking changes taking effect on February 8th, 2023. No action is needed on your part.
Improvement
10 months ago
Within the Canopy Lithic Integration, expired authorizations now sync Canopy line item statuses to
VOID.Improvement
10 months ago
Canopy has an
allocation feature that may be applied to balance offsets to designate that the offset can be applied to a specific balance bucket (fees, interest, principal, or deferred interest). Previously, when applying an offset with an allocation, subsequently querying the offset did not let you know which balance bucket the offset was applied to. The allocation parameter is now included in the response, so you can see which balance bucket an offset was applied to!Improvement
10 months ago
You should now expect improved performance when querying Line Item history for accounts, even if they have many line items.
beta
Feature
10 months ago
You can now react to changes in an account’s calculations — any activity that changes a computed value for an account will automatically get sent to your subscribed webhook URL.
Powered by Notaku