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 cancel authentication is a web service which allows a remote system to submit a cancellation against an existing DebiCheck authentication that is within an ‘Accepted’ state.
Technical Information
- From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: DebiCheckCancelAuthentication
- Service key: Debit order service key
Important
A new record must exist in the Debit Order master file where the Account Reference does not already exist. DebiCkeck Authentication cancellation can only be processed if the Debit Order master file entry exists.
Input
Submit the following parameters, all parameters are mandatory.
| Field | Description |
| Service key | Debit order service key issued by Netcash |
| Contract Reference | DebiCheck contract reference (EG: NC000000000001) |
| Reason Code | Reason for the cancellation request (Select from web service ENUM options) |
Reason Codes
Submit any of the following mandatory reason codes.
| Field | Description |
| AGMT | Agent in payment workflow is incorrect |
| CURR | Incorrect currency |
| CUST | Requested by customer |
| CUTA | Investigation request received no remediation |
| DUPL | Duplicate payment |
| FRAD | Fraudulent origin |
| UPAY | Payment not justified |
| FRTR | Tracking recalled as mandate canceled |
Output
The service responds with 000 if the Cancellation request was successful or with one of the error codes listed below:
| Numeric Response | Description |
| 000 | Cancellation request successfully submitted to bank |
| 100 | Authentication failed. Invalid service key |
| 202 | Authentication not found for this account |
| 326 | Authentication not in valid state |
| 200 | General service error. Contact support |
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