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 servicehttps://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

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.