To start, please refer our programmer’s guide for more detail on how to apply the required methodology.
A web service that uses an algorithm to validate 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 Sage Pay services requiring bank details such as ID number, bank account verification, bank codes or payments. This service does NOT verify that the individual is alive or that the ID number belongs to the individual.
This service is to be used on input of data of data into the application to ensure that the ID number supplied is valid.
Click here for the quick start guides for:
- Account Service
- Sage Pay system permissions
NIWS_Validation is an online, synchronous web service which allows an external system to request a validation and receive an immediate response. This service permits only a single request per web service call.
From your application call:
- Web service: https://ws.sagepay.co.za/NIWS/niws_validation.svc
- Method: ValidateID
- Service key: Account service key
Submit the following parameters.
|Service key||Account service key issued by Sage Pay|
|ID number||Must be 13 digits|
You will receive the following numeric code which you need to replace with the description in your application.
|0||Identity number valid|
|1||Id number too long|
|2||Id number too short|
|3||Id number failed check digit validation|
|200||Web service error contact firstname.lastname@example.org|
Version 1/2014 last updated 1 Feb 2014