Skip to main content

Online Payments (PayFast)

In one sentence: PayFast lets your customers pay their invoices online with a single click from their Customer Zone — no phone calls, no bank details to look up, no waiting.


What Is PayFast?​

PayFast is South Africa's leading payment gateway. When integrated with ServCraft, it adds a Pay Now button to every invoice in the Customer Zone. Customers can pay instantly using:

  • Credit or debit card (Visa, Mastercard)
  • EFT (electronic funds transfer)
  • Instant EFT (direct from their bank app)
  • Mobicred (buy now, pay later)

Payment is processed securely on PayFast's servers — ServCraft never sees the customer's card details.

Geographic note: PayFast processes payments in South African Rand (ZAR) only. If your customers pay in other currencies, PayFast is not suitable.


How It Works (Customer's Perspective)​

  1. Customer receives their invoice by email
  2. Customer clicks the link to view their invoice in the Customer Zone
  3. Customer sees the invoice with its Amount Due, any payments already received, and a Pay Now button
  4. Customer clicks Pay Now → redirected to PayFast checkout
  5. Customer selects their payment method and completes payment
  6. Customer is redirected back to ServCraft with a confirmation
  7. Invoice status updates to Paid (if fully settled)

The whole process takes 2–3 minutes.


How It Works (Business Perspective)​

You don't have to do anything when a customer pays via PayFast. The process is fully automatic:

  1. Customer completes payment on PayFast
  2. PayFast sends a notification to ServCraft (called an ITN — Instant Transaction Notification)
  3. ServCraft creates a payment record linked to the invoice, with the PayFast payment ID and any PayFast fee recorded on it
  4. Amount Due on the invoice decreases
  5. Invoice status updates to Paid when that single payment is at least the full invoice total. A payment that settles only the remaining balance reduces Amount Due to zero but leaves the invoice Unpaid, so staff must then mark it as Paid (see Troubleshooting below)

Staff action required: None — monitor your invoice list as usual, and paid invoices will appear there.


Setting Up PayFast​

PayFast setup is a one-time configuration by an administrator.

What You Need​

  • An active PayFast merchant account (if you don't have one, there is a Sign up link on the setup page that takes you to PayFast's registration)
  • Your Merchant ID (found in the left corner of your PayFast dashboard)

That's it — only the Merchant ID is required to activate.

Setup Steps​

  1. In ServCraft, go to Settings → Payment Gateway (the PayFast page)
  2. Enter your Merchant ID
  3. Click Activate PayFast
  4. A success message confirms the integration is live

From this point, the Pay Now button appears on invoices in the Customer Zone automatically.


Which Invoices Show the Pay Now Button?​

The Pay Now button appears in the Customer Zone when:

  • PayFast integration is active
  • The invoice status is Unpaid or Overdue
  • The invoice still has an amount due
  • The customer is viewing the invoice in the Customer Zone

The button does not appear on:

  • Draft invoices
  • Paid invoices
  • Cancelled invoices

Partial Payments via PayFast​

Customers cannot choose their own amount in the PayFast flow. The Pay Now button requests the Amount Due, which is the invoice total less any payments already recorded against it, so a customer who has part-paid is asked for the balance only. The Pay Now button disappears once nothing is due.

The invoice is marked Paid automatically only when a single PayFast payment is at least the full invoice total. When a customer pays just the remaining balance, the payment is recorded and Amount Due falls to zero, but the invoice stays Unpaid until a staff member marks it as Paid.


The Customer Zone invoice list shows the customer's Unpaid, Overdue and Paid invoices only. Drafts and Cancelled invoices are never shown. An open invoice shows the invoice details, the items, the totals, any payments received and the banking details when the store or company has them. The customer can print it or leave a comment from the same page.

The mobile app can show a Payment QR Code for an Unpaid or Overdue invoice when a payment gateway is connected for the company. Scanning it opens the invoice in the Customer Zone and takes the customer straight to PayFast.

For the full Customer Zone description, see Customer Zone.


Fees​

PayFast charges a transaction fee per payment (typically a percentage plus a fixed fee — check payfast.co.za for current rates). This fee is deducted from the amount that reaches your bank account.

ServCraft does not add any fees on top of PayFast's charges. The customer always sees and pays the full invoice amount — the fee is absorbed by your business (or you can build it into your pricing).


Security​

  • Payment happens on PayFast: The customer is redirected to PayFast's secure checkout to pay — card details are processed exclusively on PayFast's PCI-compliant servers, and ServCraft never has access to card numbers.
  • HTTPS only: All communication between ServCraft and PayFast is encrypted.
  • Traceability: Every payment notification from PayFast carries the PayFast payment ID and a digital signature, which ServCraft stores with the payment record for reconciliation and auditing.

Troubleshooting​

"The Pay Now button isn't appearing on the invoice"​

Check that:

  1. PayFast is set up and activated in Settings → Payment Gateway
  2. The invoice status is Unpaid or Overdue (not Draft or Paid)
  3. The invoice is being viewed in the Customer Zone (not the staff portal)

"A customer says their payment went through but the invoice still shows as Unpaid"​

This happens when the customer paid only the remaining balance of a part-paid invoice, and it can also happen if the ITN notification was delayed or failed to process. Check:

  1. Look at the invoice's payment list — if a PayFast payment appears but the invoice wasn't marked Paid, click Mark as Paid manually
  2. Log into your PayFast merchant dashboard to confirm the transaction was successful
  3. If the payment appears in PayFast but not in ServCraft, contact ServCraft support

"We want to deactivate PayFast"​

Go to Settings → Payment Gateway → click Deactivate PayFast and confirm. The Pay Now button will no longer be offered on invoices.

"We want to reactivate PayFast after deactivating it"​

Go to Settings → Payment Gateway, check your Merchant ID is filled in, and click Reactivate PayFast.


Common Questions​

"Does PayFast work outside South Africa?"​

No. PayFast processes ZAR payments only and is designed for South African businesses. International clients would need to pay by EFT or card through another gateway.

"What happens to the PayFast fee — does it show in ServCraft?"​

The payment in ServCraft records the gross amount the customer paid, and the PayFast fee is stored on the payment record as well. The fee is deducted by PayFast before the money reaches your bank, so you'll see the net amount in your bank statement. Your accountant will need to account for the fee difference separately.