TDS Custodial Integration
Street connects directly to the TDS Custodial deposit scheme, so you can register deposits with TDS straight from Street without re-entering the details in the TDS portal. Street also keeps the deposit's status up to date and lets you send repayment requests to TDS at the end of the tenancy.
Note - This integration is for TDS Custodial deposits only. It can't be used for deposits protected with TDS Insured.
What the Integration Does
Registers deposits with TDS automatically
Adds the registration number, registration date and deposit certificate to the deposit once TDS confirms it
Checks the deposits you already hold against TDS when you connect
Keeps the deposit's status up to date with TDS
Lets you send a repayment request, with itemised deductions, to TDS at the end of the tenancy
Shows when TDS has published a dispute decision
Before You Connect
You'll need an active TDS Custodial membership, and the following details from TDS:
API key - email api_enquiries@tenancydepositscheme.com with your membership number and TDS will reply with your key.
Member ID and Branch ID - these can be found in the TDS portal. The Branch ID is your TDS branch identifier, not a Street branch.
TDS Custodial must also be set up in Street as a custodial deposit scheme. For more information, see our Accounting (Settings) help article.
Note - To open the Integrations page you'll need a role with the 'Allow this user to manage company integrations.' permission, and to connect a deposit scheme you'll need the 'Allow this user to manage company general settings.' permission. For more information, see our Roles and Permissions help article.
Connecting TDS Custodial
Go to Settings (the cog icon in the top right corner of your screen) and scroll down to Account Administration > Integrations.
Click 'TDS Deposits'.
Open the 'Configuration' tab and click 'Add deposit scheme'.
Choose the deposit scheme from the drop-down, enter your API key, Member ID and Branch ID, and save.
Note - There is a separate Integrations page for calendar syncing. If you only see the Calendar Integration, make sure you're on the Integrations page under Account Administration, right at the bottom of your settings.
Street checks your details with TDS before connecting. If they can't be verified, check they've been entered correctly and try again.
Once connected, Street checks the deposits you already hold on that scheme against TDS and emails you when it's done. Any deposits that need attention show a warning icon next to their status on the Deposits table, such as 'Not found on TDS' or 'Missing registration number'.
You can use the 'Scheme issues' filter on the Deposits table to find them. To recheck a deposit TDS doesn't recognise, correct the registration number on the deposit and save it. If some deposits couldn't be checked, click 'Retry sync' from the three dots next to the connected scheme.
Tip! - If you have more than one TDS account (for example, one per branch), set each one up as its own deposit scheme in Street and connect them separately. Deposits are registered using the connection for the scheme selected on the deposit.
Each connected scheme shows on the integration page with its last sync time. From the three dots you can 'Retry sync' or 'Delete' the connection. If you delete a connection, you'll need to re-enter the details to connect it again.
Registering a Deposit
Add the deposit to the tenancy as normal, choosing the connected TDS Custodial scheme. For more information, see our Adding a Deposit help article.
Once the deposit has been received, Street sends the details to TDS automatically and the deposit shows as 'Registration pending'. The deposit card will show 'Registration details will appear here once confirmed by the scheme.'
Once TDS confirms the registration, the registration number, registration date and deposit certificate are added to the deposit automatically. Street checks with TDS regularly, so this can take a little while to appear.
Note - Registering the deposit doesn't pay it. You'll still need to pay the deposit to TDS directly. For further support on this, you would need to contact the TDS directly.
If registration fails
If TDS can't register the deposit, the deposit card will show 'Failed to register' and 'Deposit not registered', with details of what needs updating. Once you've corrected the details, click 'Retry registration'. If TDS rejected your connection details, click 'Open integration settings' to check them.
Common things to check:
The tenancy has a tenant marked as the lead tenant.
The property is in England or Wales. TDS Custodial can't be used for properties elsewhere.
Note - Once a deposit is registered through the integration, the registration number and registration date are managed by TDS and can't be edited in Street, and the deposit amount can't be changed once received. Any amendments or top-ups need to be made in the TDS portal.
End of Tenancy
At the end of the tenancy, click 'Add repayment request' on the deposit card. Enter the proposed split of the deposit, and click 'Add deduction' to itemise any deductions by category: Cleaning, Rent arrears, Damage, Redecoration, Gardening or Other.
The request is sent to TDS and the deposit will show as 'Repayment requested', with the date it was requested. The tenant needs to accept the repayment request through TDS before the funds are released, even if the full amount is going to them.
If the tenant disputes the request, the dispute is handled by TDS. Once TDS publishes its decision, you'll see 'Dispute decision' marked as 'Published' on the deposit card, and you can use the 'Dispute decision published' filter on the Deposits table to find these. Record the final split by clicking 'Add deposit outcome'.
Once TDS has released the funds, click 'Close Deposit' to close it in Street. Deposits aren't closed automatically.
Note - Dispute stages and adjudication progress aren't shown in Street and can be followed in the TDS portal. If TDS refuses the repayment request, finish the repayment in the TDS portal and then close the deposit in Street.
If a Tenancy Doesn't Go Ahead
Deleting a deposit in Street doesn't cancel it with TDS. If the deposit has been registered but not paid, TDS will remove it automatically after 30 days. If TDS has already received the funds, you'll need to raise a repayment request in the TDS portal.
Street is constantly being updated. This can mean that some of these articles become slightly out of date. If you spot something that looks a little bit different to your Street account, please let us know on the live chat so we can get it updated!