- Home
- /
- Value added services
- /
- Funds Auto Release
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.
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
Version 2020.1
Copyright © 2022 Netcash (PTY) Ltd