17th October 2023

Query transactions using different categorisation versions

Categorisation Versions

This release allows partners to query the open banking transactions based on different categorisation versions. This enables D•One to upgrade and release new versions of the categorisation service without forcing our partners to upgrade. Each partner has a default version of the categorisation engine which is set as a partner configuration by D•One. When a new version of categorisation is wanted by partners D•One can change the default version.

Partners can also specify the version within the following requests:

• GET /v1/users/{userId}/transactions
  using an optional query parameter categorisationVersion
• GET /v1/users/{userId}/accounts/{accountId}/transactions
  using an optional query parameter categorisationVersion
• GET /v1/reports/{reportId}
  upon creation of the report with D•One

The categorisation version used will be returned within the response bodies.

Categorisation Version 41.0.0

As part of this release, partners can now gain access to categorisation version 41.0.0. This included the following upgrades:

Salary and Income Identification

Improvements in salary identification using/aiming at areas such as:

• Keywords to indicate salary such as salary, wages, payroll.
• Regularity of income based on weekly/biweekly/4weekly/monthly payroll frequencies
• Large UK employers
• Umbrella Companies
• Payroll Software

Instances where salaries were incorrectly categorised as refunds have now been reversed.

PayPal

Those identified as withdrawals/transfers/direct debits to/from paypal accounts will now be tagged as PayPal/Paypal account.

Also fixed rules that were still assigning the Entertainment, tv, media tag instead of the General Retail tag for those that appear to be purchases.

Refunds

Significant improvements in refund categorisation, now being tagged based on criteria for each Retail-based purpose tag.

• Purpose tag matches the existing initial debit transaction.
• Previously only card-based credit transactions were categorised as refunds.

Personal Loan and Loan Funds Improvements

Tidying up of both categories. Previously repayments and funds, debits and credits, were mixed within both tags.

• Loan repayments, including refunds and reversed payments sit under Personal Loan.
  • NB. Bounced Direct Debits will appear under Returned Payments
• Loan funds should be inclusively credits.
  • Loan funds tag replaces Unsecured loan funds

Tag Hierarchy

• Removal of deprecated purpose tags
• Unsecured loan funds tag replaced with new Loan funds Tag
• Buy Now Pay Later upgraded from Detailed to Concise Level
  • This is so it can be visible as a sub-category on the Web Portal
• Cash upgraded from Concise to Broad
  • Purpose will always be unclear so not necessarily ‘Enjoyment’ (previous broad tag)

Other

• Improvements to Monzo account tagging, notably merchants with common names.
• Temu tagging improvements.