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 is a secure online payment service that can be integrated to receive payments. We offer 3D secure Credit Card payments via Mastercard, Visa, American Express, and Diners Club, Instant EFT, Bank EFT and Retail payments. Our Scan to Pay feature allows multiple wallets and banking applications to scan a single QR code for payment.

Also see:

Single line item service

This web service allows a user to submit a single credit card transaction refund.

For the bulk refund method click here

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

ParameterAccount service key issued by Netcash
M1*Pay Now Service Key
TransactionId*Netcash transaction ID of the original Pay Now transaction to be refunded
Amount*Amount (decimal) EG: 2,00 with a comma as the decimal

IMPORTANT:

  1. The transaction ID is the Netcash transaction ID of the original Pay Now transaction to be refunded.
  2. You may refund a partial amount or full amount value for the transaction, but the refund amount may not exceed the original transaction value on the Netcash Statement.
  3. Only Pay Now service Keys will be accepted.
  4. The refund will then be displayed on the Merchant frontend.
    1. The refund must be authorised on the Merchant frontend before it is processed.

Response

Here is the HTML table version:
Here is your table sorted in ascending order by error code (000 → 330):

Error CodeDescription
000Success
100Authentication failed (Pay Now service key is invalid)
200General error (contact Support)
202Not found (Transaction Id not found in data warehouse)
316Invalid amount (Amount must be a decimal with comma Rand/Cents separator)
330Duplicate (Refund request already exists for this transaction Id)

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.