Currently set to Index
Currently set to Follow
  1. Home
  2. /
  3. Inbound Payments
  4. /
  5. Pay Now Solutions
  6. /
  7. Subscription Update service

Overview

PayNow UpdateSubscriptions is an online, synchronous web service that allows an external system to update the parameters of an existing subscription instruction and receive an immediate response. This service permits only a single request per web service call.

Web Service Methods

The list of Netcash web service methods can be found here

QuickStart Guides

We have developed some Quick Start Guides to help you understand this service and to help you get started.

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.

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 numeric code.

 

Numeric 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

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 © 2021 Netcash (PTY) Ltd