Home Nodes Netcash Inbound Payments Batch Upload

Netcash Inbound Payments Batch Upload

Use Netcash Inbound Payments Batch Upload to send debit order batch files to Netcash, request upload reports, work with e-Mandates, and run DebiCheck authentications - all without leaving the Flowgear Console.

Revision History

1.0.0.0 Initial release

Properties

Connection

Type: Connection Input
The Netcash Connection you want to use for the inbound batch upload. For this Node, you only need to provide the AccountNumber, AccountServiceKey, and DebitOrderServiceKey in the Connection properties.

AccountNumber
Type: String Input
Your Netcash Account number - number starts with "5" and is N11.

AccountServiceKey
Type: String Input
Your Netcash Account Service Key. Access on Netcash by navigating to "Account Profile → NetConnector → Account Service".

DebitOrderServiceKey
Type: String Input
Your Netcash Debit Order Service Key. Access on Netcash by navigating to "Account Profile → NetConnector → Debit Orders".

VaultServiceKey
Type: String Input
Your Netcash PCI Vault. This is required only if you intend to create Transaction records that contain clients that use Credit Cards as their payment method. Access on Netcash by navigating to "Account Profile → NetConnector → PCI Vauly Key". Ensure that the "Postback Url" is set to http://merchant.netcash.co.za/Default.aspx?test=1&bla=2.

Action

Type: List Input
Action that represents the currently chosen sample.

  • StandardUploadAndRequest / StandardUpload
  • CompactUploadAndRequest / CompactUpload
  • EMandateUploadAndRequest / EMandateUpload
  • EMandateUpdateUploadAndRequest / EMandateUpdateUpload
  • EMandateDataRequestAndRetrieve / EMandateDataRequest / EMandateDataRetrieve
  • EMandatePDFUploadAndRequestAndRetrieve / EMandatePDFUpload / EMandatePDFRetrieve
  • DebiCheckUploadAndRequest / DebiCheckUpload
  • DebiCheckGetParticipatingBanks
  • DebiCheckAuthenticationUploadAndRequest / DebiCheckAuthenticationUpload
  • DebiCheckAuthenticationAmend
  • DebiCheckAuthenticationCancel
  • DebiCheckAuthenticationRetrieveStatus
  • UploadReportRequest

Instruction

Type: List Input
Sets the Netcash instruction that the batch header (H) carries, when applicable.

  • None
  • Update
  • SameDay
  • TwoDay
  • CompactSameDay
  • CompactTwoDay
  • Mandates
  • MandateToMasterfile
  • RequestMandatePDF
  • DebiCheck
  • DebiCheckAuthentication

BatchName

Type: String Input
A friendly name for your batch being uploaded; it appears in Upload Reports and status lookups.

ProposedActionDate

Type: String Input
The proposed acion date in CCYYMMDD. For e-Mandates, this should be set to today's date.

KeyAndTransactionRecords

Type: JSON Input
The rows that form your K (key) and T (transaction) records as JSON. The node converts your JSON to the tab-delimited format that Netcash expects (H/K/T/F). Use the provided sample for each action to see the minimum mandatory columns for that flow.

Response

Type: JSON Output
The result from Netcash (upload report, file token, or actual requested file) in JSON.

Using the Node

1. Create the Connection

  1. In the Flowgear Console, click Connections.
  2. Add a new Connection of type Netcash Inbound Payments Batch Upload.
  3. Enter the AccountNumber, AccountServiceKey, and DebiOrderServiceKey from your Netcash Account.
  4. If you intend to work with clients that use their Credit Card for payment, enter the VaultServiceKey from your Netcash Account. In addition, ensure that under PCI Vault Key, the "Postback Url" is set to http://merchant.netcash.co.za/Default.aspx?test=1&bla=2.
  5. Save your Connection.

2. Test your Connection

  1. Navigate to your new Netcash Connection.
  2. Click Test.
  3. Flowgear will attempt a test API call to a generic Netcash endpoint to ensure your credentials are valid.

If the test is successful (✓), your credentials are valid.
If it fails (✗), the test will return an error message, and you may need to re-authorise the Connection. If this problem persists, please contact support for assistance.

3. Select a Sample

Select a sample to automatically set up the Node for your desired operation. This will set Instruction correctly, as well as provide you with an example KeyAndTransactionRecords to work from.

You can choose from the following:

You can upload and request the Upload Report in one go (UploadAndRequest) or run them as separate steps (Upload then Request). You have complete control over how you use this Node.

One particular point of flexibility is which columns you can include in your file upload. The minimum mandatory columns for an operation is given for you in each sample's KeyAndTransactionRecords value.
However, Netcash provides many optional and helper columns that you can choose to leverage, which can all be viewed on the Netcash API Legend Page.

Remarks

  • If you plan to have clients that will be debited/mandated via their Credit Card, ensure that you provide their raw Credit Card number. This will be securely processed, but is necessary in order to tokenise and ensure that our processing is PCI compliant.

See Also