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:

Input

Submit the following parameters.

Call this method to retrieve a creditor payment notification:

  • Web servicehttps://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

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.