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 |