Currently set to Index
Currently set to Follow

Overview

GetPaymentLimits method is an online, synchronous web service method which allows an external system to request the current Payment line and batch limits configured against the merchant’s Netcash account.

The GetDebitLimits method is similar but returns the current Debit order line and daily limits.

The Service Key submitted determines the service limits returned.

To access the NIWS_NIF endpoint you require a valid, active Netcash 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
GetPaymentLimits Returns the line and batch limits for Creditors or Salaries depending on the service key submitted
GetDebitLimits Returns the line and daily limits for Debit orders

Method – Request Salary or Creditor payment limits (GetPaymentLimits)

Input

Parameter Instruction
Service Key Salary Payments -or Creditor Payments Service Key

 

Output

The response is returned as XML
The limits returned in the response are determined by the service key submitted
Salary payments service key will return the limits for salary batches
Creditor payments service key will return the limits for creditor batches

<LimitResponse>
 <Limits >
  <LineLimit> {N11 value} </LineLimit >
  <BatchLimit > {N11 value} </BatchLimit >
 </Limits >
 <Errors>
  <ErrorCode></ErrorCode>
 </Errors>
</LimitResponse>


Error codes

Code Description
100 FAILURE – Authentication failed
200 FAILURE – Web service error contact support@netcash.co.za
300 The service key supplied is not supported by this service

Method – Request Debit order limits (GetDebitLimits)

Input

Parameter Instruction
Service Key Debit Order Service Key

 

Output

The response is returned as XML

<LimitResponse>
 <Limits >
  <LineLimit> {N11 value} </LineLimit >
  <BatchLimit > {N11 value} </BatchLimit >
 </Limits >
 <Errors>
  <ErrorCode></ErrorCode>
 </Errors>
</LimitResponse>


Error codes

Code Description
100 FAILURE – Authentication failed
200 FAILURE – Web service error contact support@netcash.co.za
300 The service key supplied is not supported by this service

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