Skip to content

Paysoft debit orders and mandates

In short: Donors sign up on your Debit Order form, their bank account is checked, and a signed mandate is emailed to them and to you. Paysoft then debits them monthly on their chosen day, and ActiveDonor creates each receipt automatically a few days after the debit (the Receipt delay, 5 to 7 days) unless the bank rejects it. Your Paysoft Client code must be saved under Settings > Integrations first.

Overview

Paysoft (Paysoft Impact) collects monthly debit orders from your donors' bank accounts. ActiveDonor handles the sign-up form, the mandate, and the receipts, so you don't capture debit order donations by hand. Debit orders appear under Receipts > Recurring in batches marked Auto-receipted by Paysoft.

Before you start

You'll need:

  • A Paysoft agreement and your Client code and Client name, saved on the Paysoft card under Settings > Integrations (see Connecting a payment account (PayFast, Paystack, Paysoft)).
  • An active Debit Order form with a project, receipt method and receipt type (see Creating donation forms).
  • The Manage Receipts permission to manage debit orders.

How a donor signs up

The Debit Order form takes the donor through four steps. The form explains: "A monthly debit order from your bank account, processed by Paysoft. Nothing is taken today, and you can cancel at any time."

  1. The donor chooses a project (if the form offers more than one) and a monthly amount (minimum R10).
  2. They choose whether they're giving as an individual or an organisation and enter their details, plus their tax details if they want a Section 18A certificate.
  3. They enter their bank details and the Debit day. ActiveDonor checks the account with Paysoft when they submit.
  4. They read the Debit order terms, tick to authorise the debit, and submit.

ActiveDonor then creates the donor (or matches an existing one), creates the recurring donation, registers it with Paysoft and emails the mandate (a PDF of the signed authorisation).

Who receives the mandate

The mandate PDF is emailed to:

  • the donor;
  • your organisation's account email address;
  • Paysoft Impact;
  • ActiveDonor.

The donor sees "Your signed mandate is on its way to your email."

How debit orders are receipted

  1. Paysoft debits the donor on the debit day.
  2. Paysoft reports the result to ActiveDonor.
  3. If the debit isn't rejected, ActiveDonor creates the receipt after the Receipt delay (5, 6 or 7 days after the debit date, set on the Paysoft card). The wait allows time for bank rejections.
  4. The receipt is emailed if automatic receipt sending is on.

If the bank rejects the debit, the debit order's status changes to Rejected and no receipt is created for that debit.

You can't tick Paysoft donors in a batch to issue receipts by hand. The batch is marked Auto-receipted by Paysoft.

If registration with Paysoft fails

Sometimes a sign-up can't be registered with Paysoft straight away. When that happens:

  • the donor sees "We have your details, but we could not set up the debit order automatically. Nothing has been deducted — the charity will confirm with you before any payment is taken.";
  • the recurring donation is kept with the status Declined or Unregistered;
  • a Review reminder is created for you: "Debit order signup could not be registered with Paysoft (commitment {number}) — retry or contact the donor";
  • no mandate is emailed.

To retry, open the donation under Receipts > Recurring, click Edit, correct anything that's wrong and save. Saving tries the Paysoft registration again.

Adding a debit order yourself

To capture a debit order you've arranged with a donor on paper, click Add Recurring on the Recurring page, fill in the details, click Add Bank Details, enter the bank account and set Vendor to Paysoft. See Recurring donations.

Changing, pausing or cancelling a debit order

Find the donor's row in the batch under Receipts > Recurring.

  • Change the amount, debit day or dates: click Edit, change the details and save. The change is sent to Paysoft.
  • Pause: click Edit, set Status to Inactive and save. Set it back to Active to resume. A debit that would have fallen during the pause is skipped.
  • Cancel: click the Delete (bin) icon and enter a reason. Paysoft stops the debit order. The record and past receipts are kept. A cancelled debit order can't be restarted; the donor must sign up again.

⚠️ Important: Debit orders imported without a Paysoft ID can't be changed or cancelled from ActiveDonor. You'll see "This debit order has no Paysoft ID on record, so it cannot be cancelled from here. Cancel it with Paysoft directly, then set it to Inactive." Amount and date changes on these are left unchanged, with the note "Paysoft could not be updated (no Paysoft ID on record), so amount, debit day and dates were left unchanged."

Viewing bank details

Open a Paysoft debit order with Edit. The Edit Recurring window shows the Account number, Branch code, Bank name and Service code on record.

What this does not do

  • It does not retry a rejected debit automatically. Contact the donor if a debit is rejected.
  • It does not let you download the mandate from ActiveDonor. Use the copy emailed to your organisation.
  • It does not restart a cancelled debit order.

Common issues & solutions

What you see What it means How to fix it
Donor sees "We could not verify your bank account right now. Please try again shortly." Paysoft's bank check was unavailable. Ask the donor to try again later.
Donor sees "Please check your bank details." The bank account didn't pass the check. Ask the donor to confirm their account number, account type and bank.
A debit order shows Rejected. The bank rejected the last debit. No receipt was created. Contact the donor. When their account is sorted, set the status back to Active.
A Review reminder "Debit order signup could not be registered with Paysoft..." The sign-up wasn't registered with Paysoft. Open the donation, click Edit, check the details and save to retry.
"Failed to update recurring commitment for {donor}" Paysoft didn't accept the change. Check the details and try again, or contact Paysoft.
"Failed to re-authenticate with Paysoft. Please check your credentials and try again." Your Paysoft client details weren't accepted. Check your Client code with Paysoft and save again.

FAQ

When is the receipt created for a debit order? 5, 6 or 7 days after the debit date, depending on your Receipt delay setting. The default is 6 days.

Where is the mandate? It's emailed as a PDF to the donor and to your organisation's account email when the donor signs up.

Can a donor cancel their own debit order? Donors contact you or Paysoft to cancel. You cancel it in ActiveDonor with the Delete icon, which stops it at Paysoft.

What's the minimum debit order? R10 a month.