Why is my debit batch failing or not processing? (NetCash / GoCardless)

Most Common Cause
A debit batch fails when one or more members are set to debit order as their payment method but do not have valid debit order details (bank account/mandate) recorded. NetCash cannot process these members and may block the entire batch.

Step-by-Step Resolution
1. Contact Octiv Support with the error message (e.g. "Attempt to read property universal_code on null").

1. The Octiv tech team will identify which members are set to debit order but have no debit details recorded.
2. Remove those members from the batch in NetCash.
3. Request payment from those members via an alternative method (payment link, EFT, cash) while they complete their debit mandate.
4. Re-submit the batch without those members.

Prevent Future Batch Failures — Configure NetCash Settings
To prevent a single member's missing details from blocking the entire batch in future:

1. Log in to NetCash.
2. Navigate to: Account Profile >> Net Connector >> Debit orders >> Edit
3. Enable "Ignore error" — ensures one failed member does not block the rest.
4. Enable "Auto Forward Date" — automatically moves the batch to the next working day if the batch date falls on a weekend or public holiday.
5. Confirm your email address is correct to receive error reports.

Debit Batch Timing — Weekends and Public Holidays
If a scheduled batch date falls on a weekend or public holiday (including Christmas), the batch may be rejected by banks. Always schedule debit batches on weekdays.

If a batch fails on a holiday, navigate to Billing >> Debit Batches >> [Failed Batch] >> Resubmit after the holiday.

The Regenerate Button — Important Warning
When you click Regenerate on a debit batch, the batch may appear to disappear — this is a display issue, not data loss. The batch is regenerating in the background.

⚠ Do NOT click Regenerate multiple times. Multiple clicks can create duplicate batch submissions and result in double-debits. Click once, wait 10–20 seconds, then refresh the page.

Member Not Appearing in Debit Batch
Only members with an active, billable package are included in debit batches. If a member is missing:

1. Check their Packages tab — confirm they have an active package with billing enabled.
2. If no package is assigned, assign the correct package.
3. Confirm the package has debit order billing configured (not cash/EFT).