Before you start
Please download the suggested API integration process flow document and use it as a reference when developing.
Kindly adhere to the Netcash brand guidelines when developing.
Programmers Guide
Refer to our Programmers guide for more detail on how to apply the required methodology in this document.
Ensure that the settings for developers are adhered to before you proceed with your implementation.
Web Service Methods
The list of Netcash web service methods can be found here.
Quick Start Guides
Quick Start Guides will help you understand this service and get you started.
Overview
DebiCheck list of participating banks is a web service which allows a remote system to request a list of all banks which offer the DebiCheck service.
Technical Information
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_Validation.svc
- Method: GetDebiCheckParticipatingBanks
- Service key: Account service key
Input
Submit the following parameters.
Field | Description |
Service key | Account service key issued by Netcash |
Output
The service responds with error code 000 and an XML list of bank names if the request to display the list of participating banks was successful.
If the request was unsuccessful, the service will respond with one of the error codes listed below:
Numeric Response | Description |
000 |
Successful |
100 |
Authentication failed. Invalid service key |
200 |
General service error. Contact support |
XML response example
<BankListResponse> <BankList> <BankName>ABSA</BankName> <BankName>CAPITEC BANK</BankName> <BankName>FIRST NATIONAL BANK</BankName> <BankName>NEDBANK</BankName> <BankName>STANDARD BANK</BankName> <BankName>MERCANTILE BANK</BankName> </BankList> <Errors> <ErrorCode>000</ErrorCode> </Errors> </BankListResponse>
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 Testing section for more details. If you require any integration assistance contact our technical support team