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 TT1 synchronous is a web service that allows a remote system to submit a real-time DebiCheck authentication request to a recipient’s bank account.
Please note: Registered Mandate Services (RMS) is not available for TT1 DebiCheck Debit Orders
Technical Information
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: DebiCheckAuthenticate
- Service key: Debit order service key
- Timeout: Minimum timeout of 3 minutes. Please ensure that the client being used to invoke the webservice, is configured correctly in terms of timeout duration as well.
Input
Submit the following parameters.
| Field | Description |
| ServiceKey | Debit order service key issued by Netcash |
| AccountReference | Account reference |
| DebiCheckMandateTemplateId | DebiCheck authentication template identifier (EG: NCDCT000000001) |
| IsIdNumber |
0 = Passport or Business Registration number 1 = South African ID number |
| DebtorIdentification | Account holder identification number (ID/Passport number) |
| AccountName | Masterfile account name |
| BankAccountName | Account holders bank account name |
| BranchCode | Account holders branch code |
| BankAccountNumber | Account holders bank account number |
| BankAccountType | Account holders bank account type |
| MobileNumber | Account holders mobile number |
| EmailAddress | Account holders email address |
| CollectionAmount | Amount to be collected (Decimal EG: 10.00) |
| FirstCollectionDiffers |
0 = No 1 = Yes (First collection amount differs from the contract amount) |
| FirstCollectionAmount | Amount to be collected in first collection (Decimal EG: 10.00) |
| FirstCollectionDate | Date of collection (CCYYMMDD EG 20221207) |
| CollectionDayCode | Collection day code *See codes here |
Output
The service responds with 000 if the authentication request to the account was successful or with one of the error codes listed below:
| Numeric Response | Description |
|
000 |
Authentication request has successfully been submitted to bank |
|
100 |
Authentication failed. Invalid service key |
|
200 |
General service error. Contact support |
|
203 |
Failed |
|
325 |
Non real time debi check template |
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