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

Pay Now UpdateSubscriptions is an online, synchronous web service allowing an external system to update the parameters of an existing subscription instruction and receive an immediate response.

A single request per web service call is permitted

Input

From your application call:

Field

 Explanation

M1

 Pay Now Service Key

P2

 Unique reference of the original invoice

M17

 Subscription cycle – number of subscription payments to be made
Must be > 0

M18

 Subscription frequency

1 Monthly
2 Weekly
3 Bi-weekly
4 Quarterly
5 Six monthly
6 Annually

M19

 Subscription start date CCYYMMDD

M20

 Subscription recurring amount
Must be > 0

Active

 True/False

Output

The service will return one of the following codes:

 

Response

 Description

000

 Success

100

 Authentication failed. Ensure that the service key in the method call is correct

200

 Web service error contact support@netcash.co.za

311

 Merchant reference not found. Ensure that the value in P2 refers to an existing subscription

313

 Invalid frequency.
Ensure that M18 contains one of the permitted values

314

 Invalid number of cycles.
M17 must be greater than 0

315

 Invalid subscription start date. Format is CCYYMMDD

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.