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:

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

Netcash may provide example/sample/demo ‘code snippets’ and/or external links in this Technical Document. Such are for guidance purposes only and may not function on every developer’s system/s. Netcash disclaims any and all liability for the usage of guidance resources provided -and you as the Developer; must accept full responsibility for the usage of such. While every possible effort has been taken to ensure compatibility across multiple system configurations, the contents of this document cannot be guaranteed to work on all systems, with all operating systems -and/or with all system configuration/s.