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.

*Denotes Mandatory Fields

Service keyAccount service key issued by Netcash
M1*Pay Now Service Key
M2*Software Vendor Key
M15*Credit Card Vault Token
Amount*Amount of the invoice
P2*Unique reference for this invoice
P3*Invoice Description
M9*Email address of the person you are invoicing
M4Extra data field 1
M5Extra data field 2
M6Extra data field 3
M10Additional return string data
M11Mobile number
M12Send SMS (Boolean) – M11 must contain valid data if this field is set to true
M13Send Email (Boolean) – M9 must contain valid data if this field is set to true
SendPushNotificationTrue / 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:

338Invalid Email Address

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

 

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

StatusDescription
0Declined
1Accepted
2Not Done

 

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

FieldDescription
RequestTraceA 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.