Currently set to Index
Currently set to Follow

Overview

The ReleaseFunds method is an online, synchronous web service that allows an external system to request a payment from the merchant’s Netcash account into the bank account configured against the merchant account.

The calling system can opt to release a user-specified amount or to release all available funds as calculated on the date selected in the web service call.

  • Only valid banking days between Monday and Friday may be selected.
  • Dates may not be in the past.
  • Requests for release of funds on the current day must be submitted before 14h30 on the valid banking day.

The service returns a numeric response where 000 indicates a successful request.

Any other value represents a failed request.

NOTE: Existing entries in the Netcash payment queue can be manually edited by logging onto your merchant account on the Netcash website.

To access the NIWS_NIF endpoint you require a Netcash Account Service Key.

Service keys are issued to merchants and must be validated and stored in the NetConnector setup of your application

Programmers Guide

To start, refer our Programmers guide for more detail on how to apply the required methodology in this document.
Please ensure that the settings for Developers are correctly set before you proceed with the implementation below specification.

Access

The web service entry point can be accessed via: https://ws.netcash.co.za/niws/niws_nif.svc

Method

Method name Usage
ReleaseFunds Inserts an entry into the payment queue for the release funds function

Input

Parameter Instruction
Service Key Account Service Key
Date Format CCYYMMDD – this is the date on which the funds should be released
Amount Amount in cents (no decimal point)
0 = release all available funds
{amount} = release only this Amount

Output

Code Description
000 SUCCESS – Release funds request logged
100 FAILURE – Authentication failed
101 FAILURE – The date format supplied is invalid
102 FAILURE – Invalid date supplied
103 FAILURE – Invalid amount supplied
200 FAILURE – Web service error contact support@netcash.co.za

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.

Version 2020.1

Copyright © 2020 Netcash (PTY) Ltd