CentraPoint

Gateways

Netcash Pay Now

South African cards, Instant EFT, bank EFT and retail payments via Netcash Pay Now hosted checkout.

On this page

South African cards, Instant EFT, bank EFT and retail payments via Netcash Pay Now hosted checkout.

At a glance#

Netcash Pay Now summary
Typenetcash_paynow
CountriesSouth Africa
CurrenciesZAR
CapabilitiesHosted checkoutRecurring (gateway subscriptions)On-demand status verification
Gateway docsapi.netcash.co.za/inbound-payments/pay-now/pay-now-ecommerce/

Checkout experience#

Auto-submitted HTML form POST to Netcash Pay Now (paynow.netcash.co.za).

Configuration fields#

Enter these in the dashboard under Settings → Payment providers → Netcash Pay Now. Secret fields are encrypted at rest and masked after saving; leave a secret blank when editing to keep the stored value.

Netcash Pay Now configuration fields
FieldTypeNotes
Pay Now service keyrequired
serviceKey
Secret

Netcash portal > Account Profile > NetConnector > Pay Now

Software vendor key
vendorKey
Text

Leave blank to use Netcash's default vendor key

Offer budget (card instalment) option
budget
Checkbox

Default: false

Notify secret
notifySecret
Secret

Pay Now does not sign notifications and takes its Notify/Accept/Decline/Redirect URLs from the Netcash portal, not from each request. Generated automatically when left blank; the Notify URL on the gateway card already includes it. Sandbox mode has no separate URL: put the Pay Now service in Test Mode in the portal instead.

Account service key (reconciliation)
accountServiceKey
Secret

Option group Account reconciliation. Optional. Netcash > Account profile > NetConnector > Account service. Enables daily reconciliation of this Netcash account's statement (collections, fees, refunds, payouts, settlements). Providers sharing one Netcash account can use the same key: the statement is pulled once.

Legacy passthrough: reference prefix
passthroughPrefix
Text

Optional. While migrating, payments whose Reference starts with this (e.g. OLD) and that CentraPoint didn't create are handed back to your old integration.

Legacy passthrough: notify URL (https)
passthroughNotifyUrl
Text

Raw Netcash notify body is forwarded here, with retries. Your system must verify it with Netcash.

Legacy passthrough: return URL (https)
passthroughReturnUrl
Text

Payers returning with a legacy reference are redirected here with TransactionAccepted, Reason and Reference.

Recurring card payments (automatic monthly / quarterly / 6-monthly / annual card subscriptions)
recurringCards
Checkbox

Option group Recurring card payments. Netcash must enable card subscriptions on this Pay Now service. Renewals arrive on this gateway's Notify URL: no extra URLs are needed. Switching this off stops new card subscriptions only; subscriptions Netcash already bills keep renewing.

Default: true

Statement postback secret
statementPostbackSecret
Secret

Option group Account reconciliation. Netcash does not sign statement postbacks. Generated automatically when left blank; the Statement postback URL on the gateway card already includes it. A new secret means pasting the new URL into the Netcash portal.

Every provider also has Enabled, Sandbox / test mode and Default checkout method switches.

Notification URL#

Notification URL
https://app.centrapoint.co.za/api/webhooks/netcash_paynow/notify/{providerId}/{notifySecret}

Copy the exact URL, with your provider ID filled in, from Settings → Payment providers.

  • Pay Now does not accept per-request return or notify URLs. Every Netcash gateway card in Settings > Payment gateways lists four default URLs to paste into the Pay Now service in the Netcash portal: Notify (already contains the auto-generated notify secret), Accept, Decline and Redirect.
  • Accept, Decline and Redirect (/api/webhooks/netcash_paynow/{accept|decline|redirect}/<id>) send the payer straight back to your own platform: the payment link or checkout returnUrl, else the default return URL under Settings > Payment gateways > Payer redirect, with ?reference=&status= added (status=pending while the payment is not confirmed yet: confirm it through the API or webhooks). Without one, payers land on the CentraPoint status page.
  • The four URLs hold no "?": Netcash adds "?" and the payment reference to Accept and Decline and does not support URLs with a query of their own. URLs of the older ?provider= form already in the Netcash portal keep working.
  • There is no separate sandbox URL: put the Pay Now service into Test Mode in the Netcash portal instead.
  • Recurring card payments need no extra URLs: card subscriptions use the same service key, notify secret and the same four URLs, and Netcash sends every later collection to the same Notify URL, where CentraPoint records it as a renewal. URLs of the retired Netcash Recurring Card module (/api/webhooks/netcash_recurring/...) that are already in the portal keep working.
  • Account reconciliation: with the Account service key set, the gateway card also shows a Statement postback URL. In the Netcash portal open Account profile → NetConnector (Connected services) → Account service, tick postback and paste the URL: when Netcash signals a new statement, CentraPoint fetches it from Netcash at once. The nightly statement fetch stays on as the fallback. Netcash keeps one postback URL per account: for gateways that share an Account service key, paste the URL of any one of them.

How notifications are verified#

  • Pay Now notifications are not signed. CentraPoint checks the optional shared secret in the URL (constant-time comparison).
  • Every notification is re-queried with the Pay Now Transaction Status Check before it is trusted.
  • Statement postbacks are not signed either: they are accepted only with the secret in the Statement postback URL (constant-time comparison), and nothing posted is reconciled: the statement is always fetched from Netcash first. A posted statement Netcash does not confirm is shown for review only.
  • The amount and currency must match the transaction before it can be marked complete.

Going live#

  1. Test with sandbox credentials and Sandbox / test mode on, and confirm the notification appears as processed in the Webhook log.
  2. Replace the credentials with live ones and switch off Sandbox / test mode.
  3. Update any URL or secret configured in the gateway's portal for the live environment.
  4. Make a small live payment and confirm it with the Transactions API.