TDS User Guide

TDS User Guide

What is TDS?

TDS is one of the main deposit protection scheme in the UK https://www.tenancydepositscheme.com/. Using it from COHO will use their custodial scheme, and is free of charge.


Setting up TDS

The set-up of the integration between TDS and your COHO account happens in the Onboarding panel settings. The settings are accessible by clicking on the cog at the top-right of the panel of the main dashboard.



Set-up for agents

You already have a TDS account

You should email TDS api_enquiries@tenancydepositscheme.com and ask them for your API keys.

You don’t have a TDS account

Go to the TDS website registering https://custodial.tenancydepositscheme.com/register/?group=step1 and create an account for the custodial scheme. Once the account is created, you should email TDS api_enquiries@tenancydepositscheme.com and ask them for your API keys.

Once you have your API keys

Once you receive your API credentials by email, go to the onboarding settings, within the “TDS - Deposit Registration” section, and click on the button “Add TDS Credentials”. You will be able to input your API details here, and submit the form.


If TDS don't give you API credentials

No worries, read below the landlord section.


Set up for Landlords

For landlords, the set-up is a bit different. First off, if you already have API credentials, refer to the above steps.

You don’t need credentials

Though usually TDS doesn’t give API credentials to the landlords, so we will host your account as a branch of our COHO TDS head-office.

This means you don’t have to fill-up any form to start registering a deposit, but make sure that you’re setup as the owner of the properties you have in COHO, within the Property Ownership panel of each property. That way we can detect that you can register a deposit without credentials.

Create user

Once the first deposit is registered, if you want access to the TDS branch we created for you, you can go to the Onboarding Settings and click on “Create User”. Once done, TDS will email you so that you can setup your account and have access to the TDS dashboard.

Note that this is not required because everything is doable from COHO, but it’s an option that exist if you need it.




Registering a deposit

Once a tenancy has been set as requiring a deposit, we will show you in the tenancy page the Deposit Management panel, and inside it a very visible TDS section with a pink button “Register deposit”.

You will be able to find this same TDS module on the onboarding view, within the Move-in monies view, once the move-in monies are paid.


Once you have clicked on the Register deposit button, it will take around 10-15 minutes for us to get the confirmation back from TDS.

Since it takes some time to get back the confirmation, we will create an action for you to do it once we have it, so that you can launch the registration process and come back to it once we got the confirmation.


Paying TDS

Once we get back the registration confirmation from TDS, we will provide you with the TDS bank account details and the reference to include in your payment.

Once you pay them, you can mark the deposit as paid, so that if we don’t get any answer within a week, we raise an alert about this payment by creating an action.


Receiving payment confirmation

TDS usually takes 3-5 working days to give us a payment confirmation. Once we do get the payment confirmation, we will get back a Deposit Protection Certificate from TDS. We will bundle it with the TDS prescribed information and TDS leaflet, and create a new Deposit Information record for it, which we will send for acknowledgement to the tenant.

The tenant will receive an email and a push notification saying: “Please review the attached deposit certificate, and return it signed at your earliest convenience. By doing so, you agree to the terms of the deposit certificate."

If you receive a notification from TDS themselves but nothing is showing on COHO, you can click on the button “Get latest status” in the TDS section and we will get back the protection certificate and kick-off the tenant notification procedure.

If you’re using the TDS deposit section within the onboarding view, you can also find all of this information within the Deposit Management panel of the tenancy/room.

Also, we log history items of category Deposit Management during the process, that you can find them in the Audit Log panel of the tenancy.


    • Related Articles

    • GoCardless User Guide

      Introduction COHO has an integration with GoCardless. GoCardless is a payment processing platform, which allows you to automate payment collection. This guide won’t go into the details of how to use GoCardless, it will focus on the integration ...
    • Graphical User Interface

      COHO has been created to be as easy to use as possible. When you log into your account, you default to the main organization page. Organization Level This page has very top level information that includes all properties and all tenants. From your ...
    • COHO Quick Start Guide

      COHO Quick Start Guide You have signed up to COHO or you’re ready to sign up to COHO and you want a little guidance on where to start. Here we have a short guide for getting productive on COHO and other things you should consider. Add a property This ...
    • Miscellaneous Items

      In this section we will explore the miscellaneous items that don’t specifically fit into previous sections. User Settings Your personal user settings can be accessed by clicking the drop down box on your profile: Settings: To navigate to your ...
    • Onboarding

      The Onboarding panel in COHO has been designed as an easy to follow 6 step process. When you’re ready to begin a new onboarding of a new tenant you can navigate to the Onboarding panel and click ‘Onboard new applicant’. Onboarding a new tenant can ...