Skip to content

Connecting a payment account (PayFast, Paystack, Paysoft)

In short: Open Settings > Integrations, click the PayFast card, choose Live (real donations), enter your Merchant ID, Merchant Key and Passphrase, and click Save & verify. The card shows Connected when PayFast accepts the details. A passphrase is required. For debit orders, click the Paysoft card and enter the Client code and Client name Paysoft gave you.

Overview

Online donations are paid into your own merchant account, not ActiveDonor's. You connect that account once, then choose it on each donation form. ActiveDonor supports:

Provider Used for Card shows
PayFast Once-off card donations and monthly card donations Once-off donations, Recurring card payments
Paystack Once-off card donations Once-off donations
Paysoft Monthly debit orders Debit orders

Before you start

You'll need:

  • The Manage Settings permission.
  • A PayFast or Paystack merchant account in your organisation's name, or a Paysoft client code for debit orders.
  • For PayFast: a passphrase set in your PayFast dashboard (under Settings > Integration on PayFast). ActiveDonor can't verify the account without it.

Where to find payment accounts

  1. Click the cog icon (top right) and choose Settings.
  2. Click Integrations in the settings menu.
  3. Under Available integrations, each payment provider has a card with a status:
  4. 🟢 Connected: verified and ready.
  5. 🟡 Needs attention: saved but not verified, or switched off.
  6. ⚪ Not connected: nothing saved yet.

Connecting PayFast

Step 1: Open the PayFast card

Click the PayFast card. A window opens.

Step 2: Choose the mode

Set Mode to Sandbox (testing) while you test, or Live (real donations) when you're ready to take real money.

Step 3: Enter your details

  • Account name (optional): a friendly name shown in the form builder.
  • Merchant ID
  • Merchant Key
  • Passphrase

The Notify URL is shown for reference. ActiveDonor sends it to PayFast with every payment, so you don't need to copy it anywhere.

Step 4: Save and verify

Click Save & verify. ActiveDonor checks the details with PayFast. On success you'll see "PayFast account verified and saved (live mode)." (or sandbox mode).

If PayFast rejects the details, the account is still saved so you don't lose your typing, but it is disabled and can't be used on forms until it verifies.

💡 Tip: Saved keys are never shown again. The secret fields say "Saved — leave blank to keep". Leave them empty to keep what's stored, or type new values to replace them.

Connecting Paystack

Click the Paystack card, choose the Mode, enter your Secret key (use test keys in Sandbox mode) and click Save & verify. Copy the Webhook URL shown in the window into your Paystack dashboard under Settings > API Keys & Webhooks, so Paystack can tell ActiveDonor about payments.

Connecting Paysoft (debit orders)

Click the Paysoft card and enter:

  • Client code and Client name: from your Paysoft agreement.
  • Receipt delay: 5 days, 6 days (default) or 7 days. This is how many days after the debit order date ActiveDonor waits before creating the receipt, to allow for bank rejections.

Click Save. ActiveDonor checks the details with Paysoft and shows "Paysoft settings successfully saved." The same settings are also on Settings > Receipts under the Debit Orders tab. See Paysoft debit orders and mandates.

Sandbox vs Live

  • Sandbox (testing) uses PayFast's or Paystack's test system. No real money moves, but each completed test payment still creates a receipt in ActiveDonor. Void test receipts when you're done (see Editing or deleting a receipt).
  • Live (real donations) takes real money. Switch to Live and click Save & verify again before you share your forms.

What this does not do

  • ActiveDonor never holds your money. Payments settle into your own merchant account.
  • It does not process refunds. Refund a donor in your PayFast or Paystack dashboard, then void the receipt in ActiveDonor.
  • One account per provider. To switch between Sandbox and Live, change Mode and save again.

Field reference

Field Required? Notes
Mode Yes Sandbox (testing) or Live (real donations).
Account name No Up to 100 characters.
Merchant ID (PayFast) Yes
Merchant Key (PayFast) Yes on first save Blank later keeps the saved key.
Passphrase (PayFast) Yes on first save Must match your PayFast dashboard.
Secret key (Paystack) Yes on first save Blank later keeps the saved key.
Client code (Paysoft) Yes Up to 50 characters.
Client name (Paysoft) Yes Up to 100 characters.
Receipt delay (Paysoft) Yes 5, 6 or 7 days.

Common issues & solutions

What you see What it means How to fix it
"PayFast account saved but DISABLED — verification failed: Merchant ID and passphrase are required to verify a PayFast account." The Merchant ID or Passphrase is missing. Set a passphrase in your PayFast dashboard, enter it here, and click Save & verify.
"PayFast account saved but DISABLED — verification failed: PayFast rejected these credentials (HTTP 401). Check the merchant ID and passphrase — sandbox accounts need a passphrase set on sandbox.payfast.co.za." The details don't match PayFast, or a Sandbox account has no passphrase. Check the Merchant ID and Passphrase. For Sandbox, set a passphrase on sandbox.payfast.co.za. Check the Mode matches the account.
"PayFast account saved but DISABLED — verification failed: PayFast could not be reached: ..." PayFast didn't respond. Wait a few minutes and click Save & verify again.
"Failed to re-authenticate with Paysoft. Please check your credentials and try again." Paysoft didn't accept the client details. Check your Client code with Paysoft and save again.
The PayFast card says Needs attention. The account is saved but not verified or not enabled. Open the card and click Save & verify.

FAQ

Do I need my own PayFast account? Yes. Donations go into your organisation's own PayFast (or Paystack) account. ActiveDonor doesn't collect money on your behalf.

Why is a passphrase required? ActiveDonor uses it to prove the account is yours and to check that each payment notice really came from PayFast. Set one in your PayFast dashboard first.

Where do I put the Notify URL? Nowhere. ActiveDonor sends it to PayFast automatically with each payment.

I switched to Live but my form still uses the test account. There is one PayFast account per organisation. After changing Mode to Live, click Save & verify, then check the form's Payment account in the form builder.