Get Public Recipients – Netcash Developers Documentation

Overview

GetPublicRecipients is a web service method allowing an external system to Request Public Beneficiaries / Recipients for creditor payments.

Input

From your application call:

Web service: https://ws.netcash.co.za/NIWS/NIWS_Validation.svc
Method: GetPublicRecipients with the account service key as a parameter.

Field	Explanation
Service Key	Account Service Key

Output

Failed requests will return one of the following codes.

Numeric Response	Description
100	Authentication failed. Ensure that the service key in the method call is correct
200	Web service error contact support@netcash.co.za

Successful requests will return

Field	Value
Country	A
Description	A
Reference Number	N

Examples

<a:Recipient>
  <a:Country>South Africa</a:Country>
  <a:Description>ABC SHOES</a:Description>
  <a:ReferenceNumber>1234567</a:ReferenceNumber>
</a:Recipient>

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 the 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.