Gateways
Netcash Debit Orders
Recurring bank debit orders (NIF batches, e-mandates) and automated account reconciliation from Netcash merchant statements.
Recurring bank debit orders (NIF batches, e-mandates) and automated account reconciliation from Netcash merchant statements.
At a glance#
| Type | netcash |
| Countries | South Africa |
| Currencies | ZAR |
| Capabilities | Debit ordersStatement reconciliation |
| Gateway docs | api.netcash.co.za/ |
Configuration fields#
Enter these in the dashboard under Settings → Payment providers → Netcash Debit Orders. Secret fields are encrypted at rest and masked after saving; leave a secret blank when editing to keep the stored value.
| Field | Type | Notes |
|---|---|---|
| Debit order service keyrequired debitOrderServiceKey | Secret | Netcash > Account profile > NetConnector > Debit orders |
| Account service keyrequired accountServiceKey | Secret | Used for merchant statements (reconciliation) |
| Software vendor key softwareVendorKey | Text | Leave as default unless Netcash issued you an ISV key |
| Debit instruction instruction | Choice | Options: Two-day (submit 2 business days before action date); Same-day (submit before cut-off on action date) Default: |
| Batch look-ahead (days) batchLookaheadDays | Number | Batch mandates due within this many days Default: |
| Mark collected after (days) settleDays | Number | Accepted entries become 'complete' this many days after the action date unless an unpaid arrives Default: |
| Auto-authorise batches via API autoAuthorise | Checkbox | Only if enabled on your Netcash profile; otherwise authorise in the Netcash portal Default: |
| Mandate postback secret postbackSecret | Secret | Append ?secret=<value> to the mandate postback URL configured in Netcash |
Every provider also has Enabled, Sandbox / test mode switches.
Notification URL#
https://app.centrapoint.co.za/api/webhooks/netcash?provider={providerId}Copy the exact URL, with your provider ID filled in, from Settings → Payment providers.
- Debit orders do not use the payment notification URL. Batches, upload reports and merchant statements are exchanged with Netcash's NIWS web service using your service keys.
- Mandate status postbacks use a separate URL: in Netcash (Debit orders → Mandate postback URL) set /api/netcash/mandate-postback?provider=<providerId>&secret=<Mandate postback secret>. Copy it from Settings → Payment providers.
How notifications are verified#
- Batch and statement data is requested from Netcash by CentraPoint over NIWS (authenticated by your service keys), rather than accepted from inbound calls.
- Netcash does not sign mandate postbacks, so the Mandate postback secret is mandatory: postbacks without the matching secret are rejected with 403.
- The amount and currency must match the transaction before it can be marked complete.
Going live#
- Test with sandbox credentials and Sandbox / test mode on, and confirm the notification appears as processed in the Webhook log.
- Replace the credentials with live ones and switch off Sandbox / test mode.
- Update any URL or secret configured in the gateway's portal for the live environment.
- Make a small live payment and confirm it with the Transactions API.