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 Billing is an option allowing parameters to be sent to Netcash via a Web Service in a batch file upload using ‘NIWS_NIF’ creating multiple Pay Now footers. The Netcash web service will then return a footer string with payment options and store the data in the Netcash system for use with Pay Now payments.

Also see:

Single line item service

This web service allows a user to submit a previously tokenised card for card-not-present credit card payments.

Technical Information

This is an online, synchronous web service. This service permits only a single request per web service call.

From your application call:

Single Item Input

Submit the following parameters.

 

Service key Account service key issued by Netcash
M1 This would be your merchant Service Key
M2 Software Vendor Code
M15 Credit Card Vault Token
Amount The amount of the invoice
P2 Unique reference for this invoice
P3 Invoice Description
M9 Email of the person you are invoicing
M4 Extra data field 1
M5 Extra data field 2
M6 Extra data field 3
M10 Additional return string data
M11 Mobile number
M12 Send SMS (Boolean) – M11 must contain valid data if this field is set to true
M13 Send Email (Boolean) – M9 must contain valid data if this field is set to true
SendPushNotification True / False (Boolean)
Budget  True / False (Boolean)

 

Only PayNow service Keys will be accepted.
M15 (card vault token) must refer to token that belongs to the associated account.

Response

The response return will contain 3 values:

Error Code Description
100 Authentication failed
103 Invalid software vendor key
200 General error
301 Duplicate Merchant Reference
317 Invalid Merchant Reference
324 Invalid Merchant Description
000 Successful

 

Status = When ErrorCode is 000 (Successful), this will contain the status of the Live MOTO request:

Status Description
0 Declined
1 Accepted
2 Not Done

 

All other ErrorCode values will have Status = 2 (Not Done)

Field Description
RequestTrace A trace value for the transaction auth.

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.