Overview
ID Validations is a web service that uses an algorithm the ID number of an employee, debtor or creditor. Any software that allows for the capture of bank account details should implement this web service as it is critical for the success of other Netcash services requiring bank details such as ID number, verification, bank codes or payments. This service does NOT verify (See ID Verification) that the ID number is active or belong to the employee, debtor or creditor.
This service is to be used on input of data into the application to ensure that the Banking details supplied are valid. It is recommended that Universal Branch Code processing is used for the validation to be effective
Technical Information
NIWS_Validation is an online, synchronous web service which allows an external system to request a validation and receive an immediate response.
NB! This service permits a single request per web service call. For bulk file requests click here
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/niws_validation.svc
- Method: ValidateID
- Service key: Account service key
Input
Submit the following parameters.
| Service key | Account service key issued by Netcash |
|---|---|
| ID number | Must be 13 digits |
Output
You will receive the following numeric code which you need to replace with the description in your application.
| Numeric Response | Description |
|---|---|
| 0 | Identity number valid |
| 1 | Id number too long |
| 2 | Id number too short |
| 3 | Id number failed check digit validation |
| 100 | Authentication failed |
| 200 | Web service error contact support@netcash.co.za |
Netcash brand guidelines
Please refer to the Netcash brand guidelines here when using any logos, images, icons, labels, descriptions, and references to Netcash in your software.
Testing
See the Testing section for more details. If you require any integration assistance contact our technical support team