Registering mandates
Mandates that are registered with BankTech to record a billing series from which collections can be generated either by automation or by manual entry, file upload or by generating the collections manually. Mandates are identified by their 'mandateidentification' which is simply the unique reference used with BankTech. Mandates can be registered in 2 ways:
POST: /mandates/bulk/register
This will register a basic mandate suitable for EFT or NAEDO instruments.
Rate limit: 1 per second
Payload size: 1,000 mandates
POST: /mandates/bulk/dc/register
This will register a DebiCheck mandate suitable for DebiCheck, EFT or NAEDO instruments.
Rate limit: 1 per second
Payload size: 1,000 DebiCheck mandates
Registering DebiCheck mandates is generally superior to registering basic mandates as they provide more flexibility to use all collection instruments.
You are not required to provide a DebiCheck authentication key when registering DebiCheck mandates, these can be obtained later by authenticating a registered mandates or by conducting this authentication through your own authentication solution. In that case, you can register a DebiCheck mandate with the authentication key you obtained that way or amend the registered mandate to include it.
DebiCheck collections cannot be run against any DebiCheck mandates that do not have a valid authentication key. Collections will be scheduled by automation, but they will fail to process.
Last updated
Was this helpful?