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:
- Web service: https://ws.netcash.co.za/PayNow/PayNow.svc
- Method: RequestCreditCardRefund
- Service Key: Pay Now
Single Item Input
Submit the following parameters.
*Denotes Mandatory Fields
| Parameter | Account 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:
- The transaction ID is the Netcash transaction ID of the original Pay Now transaction to be refunded.
- 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.
- Only Pay Now service Keys will be accepted.
- The refund will then be displayed on the Merchant frontend.
- 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 Code | Description |
|---|---|
| 000 | Success |
| 100 | Authentication failed (Pay Now service key is invalid) |
| 200 | General error (contact Support) |
| 202 | Not found (Transaction Id not found in data warehouse) |
| 316 | Invalid amount (Amount must be a decimal with comma Rand/Cents separator) |
| 330 | Duplicate (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

