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
The DebiCheck Trace web service method allows a remote system to trace the status of a DebiCheck Authentication.
The remote system submits the Authentication contract reference, and the service returns the current status of the authentication.
This web service method relates to the Debit Order service only.
Technical Information
RequestPresentatioDebiCheckAuthenticationCurrentStatus is an online, synchronous web service that returns the current status for a given Contract reference.
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: DebiCheckAuthenticationCurrentStatus
Input
Submit the following parameters.
| Field | Description |
| Service key | Debit Order service key issued by Netcash |
| ContractReference | The unique contract reference for the authentication (Format is NC000000000000) |
Output
The service returns a response containing the result and any error code:
| Response | Description |
| CancellationReason | Reason for cancellation or NULL |
| ContractReference | Contract reference submitted in the request |
| DateCancelled | CCYYMMDD or NULL |
| Status | The current status of the authentication |
| UpdateDate | Date of the latest update to the authentication |
| Error code | See table below |
Error Codes
| Numeric Response | Description |
| 100 | Authentication failed |
| 202 | Contract reference not found |
Example
<DebiCheckAuthenticationCurrentStatus>
<MethodParameters>
<DebiCheckAuthenticationCurrentStatusResponse>
<CancellationReason isNull="true" />
<ContractReference>NC000000004724</ContractReference>
<DateCancelled isNull="true" />
<Status>Rejected</Status>
<UpdateDate>20230116</UpdateDate>
<ErrorCode>000</ErrorCode>
</DebiCheckAuthenticationCurrentStatusResponse>
</MethodParameters>
</DebiCheckAuthenticationCurrentStatus>
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