Overview
The Proof of Payment method allows the remote system to request a Salary Payment Notification or Creditor Payment Notification as a base64 encoded string.
Technical Information
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: RetrieveProofOfPayment
- Service key: Salary or Creditor Payments service key
Input
Submit the following parameters.
Call this method to retrieve a creditor payment notification:
- Web service: https://ws.netcash.co.za/NIWS/niws_nif.svc
- Method: RetrieveProofOfPayment
- Service key: Creditor payment service key or Salary payment service key
- Structure: Salary or Creditor Payments service key,TransactionId
* both service key and transactionId are mandatory
Examples
Netcash receives the pdf file as a Base64 encoded string for a Creditor or Salary payment request and returns it to the remote system.
Request
<RetrieveProofOfPayment> <MethodParameters> <ServiceKey>8B635F21-XXXX-XXXX-XXXX-49F192E96ABA</ServiceKey> <TransactionId>272598123</TransactionId> </MethodParameters> </RetrieveProofOfPayment>
Response
<RetrieveProofOfPayment> <MethodParameters> <RetrieveProofOfPaymentResponse> <ErrorCode>000</ErrorCode> <ProofOfPaymentPDF>JVBERi0xLjXXXcOHw6zCj8KiCjEgMCBvYmoKPDwv………………..0MXXXXiUlRU9GDQo=</ProofOfPaymentPDF> </RetrieveProofOfPaymentResponse> </MethodParameters> </RetrieveProofOfPayment>
Error codes
Error code | Description |
000 | Success |
100 | Authentication Failed |
200 | General error |
202 | Transaction not found |
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 the Testing section for more details. If you require any integration assistance contact our technical support team