Zoho Books payment integration: getting collections into your books
A Zoho Books payment integration guide for South African businesses: what to sync, how to map VAT and fees, and how to keep gateway payouts reconciled.
- Published
- Reading time
- 6 min read
- By
- CentraPoint Team
On this page
- Zoho Books in South Africa: what you get out of the box
- Step 1: decide where invoices are created
- Step 2: map accounts, VAT and items
- Step 3: understand how settlements work
- Step 4: handle the awkward cases
- Step 5: test, then monitor
- Signs your Zoho Books payment integration needs attention
- How CentraPoint helps
- Frequently asked questions
A Zoho Books payment integration automatically records the payments you collect (by card, instant EFT, debit order or manual EFT) against the right invoices in Zoho Books, together with gateway fees and refunds. Done properly, your Zoho Books bank reconciliation becomes a matter of confirming matches rather than detective work, and your VAT201 is built from complete, accurate sales data.
Below is a practical walkthrough for South African businesses, including a worked example of a gateway settlement.
Zoho Books in South Africa: what you get out of the box
Zoho launched a VAT-ready South African edition of Zoho Books, with VAT treatments for contacts and items and a VAT201 return report aligned to SARS specifications (as of September 2026). Zoho also offers companion apps such as Zoho Invoice and Zoho Billing, and a range of payment gateway connectors; check Zoho's site for which gateways are currently supported in South Africa.
For many small businesses that's enough. You start to need a separate integration when:
- you collect through more than one gateway, or through gateways Zoho doesn't connect to directly;
- you run Netcash debit orders and need unpaids handled properly;
- you bill subscriptions with trials, coupons and dunning logic that lives in another system;
- customers pay by manual EFT and you want those payments matched from bank statements rather than captured by hand.
Step 1: decide where invoices are created
This is the most important decision, and it has two sensible answers:
| Approach | Invoices created in | Payments flow | Best for |
|---|---|---|---|
| Books-first | Zoho Books | Gateway payments are recorded back into Books | Service businesses with once-off invoices and a single gateway |
| Billing-first | A billing or collections platform | Invoices and payments sync to Books | Subscriptions, debit orders, multiple gateways, high volume |
Avoid a hybrid where both systems raise invoices for the same customer. You'll end up with duplicate receivables and a debtors report nobody trusts.
Step 2: map accounts, VAT and items
Before switching on any sync, agree the mapping with your accountant:
- Income accounts per product line or subscription plan.
- VAT treatment for each item: standard-rated at 15%, zero-rated or exempt. Confirm whether your prices are captured inclusive or exclusive of VAT, because the integration must send the same basis Zoho Books expects.
- A gateway clearing account (a bank-type or current asset account) that receives customer payments before the gateway settles to your real bank account.
- A merchant fees expense account, with the right VAT treatment for the fees your gateway charges (check the gateway's tax invoice).
- Customer matching rules, ideally by a unique customer ID or email address rather than by name.
If you're unsure which invoice fields you need for VAT, see our guide to VAT invoice requirements in South Africa.
Step 3: understand how settlements work
Gateways rarely pay you one transaction at a time. They batch payments, deduct fees and settle a net amount. Your integration needs to break that single deposit back into its parts.
Worked example (illustrative figures)
On a Tuesday, your gateway settles R23,517.40 to your business account. Behind that deposit:
| Item | Amount |
|---|---|
| 18 customer payments (gross) | R24,150.00 |
| Transaction fees | -R550.20 |
| One refund processed that day | -R82.40 |
| Net settlement | R23,517.40 |
In Zoho Books this should appear as 18 payments applied to 18 invoices (via the clearing account), one fee expense of R550.20, one refund or credit note of R82.40, and a transfer of R23,517.40 from clearing to the bank. When the bank feed shows R23,517.40, it matches the transfer exactly, and the clearing account is back at zero.
If your integration only posts the R23,517.40 as "sales", you've understated revenue, missed an expense and left 18 invoices open.
Step 4: handle the awkward cases
Debit order unpaids
A debit order can be returned unpaid after you've already recorded it as collected. The integration must reverse the payment on that specific invoice so the customer shows as owing again, and ideally trigger your follow-up process. Read more on debit order action dates and public holidays, which affect when unpaids arrive.
Partial payments and overpayments
EFT customers often pay a rounded amount or combine invoices. Your rules should allow allocating one payment across several invoices and holding overpayments as customer credit.
Refunds and chargebacks
Record the refund against the original invoice with a credit note so that both revenue and output VAT are reduced in the correct period.
Step 5: test, then monitor
- Run the sync for one week of historical transactions.
- Reconcile the bank account in Zoho Books for that week.
- Check the clearing account balance is zero after each settlement.
- Review the aged receivables report for invoices that should be paid but aren't.
- Only then enable ongoing sync, and schedule a weekly exception review.
Signs your Zoho Books payment integration needs attention
- The gateway clearing account has a growing balance.
- Customers receive reminders for invoices they've already paid.
- VAT output on the VAT201 doesn't match your billing system's sales report.
- Your team keeps creating "suspense" entries for unidentified deposits.
How CentraPoint helps
CentraPoint handles the billing-first approach: VAT-aware invoices, subscriptions with trials and dunning, payment links and hosted checkout, collected through gateways you contract with directly (PayFast, Paystack, Peach Payments, Ozow, Yoco, Netcash debit orders, manual EFT and more). Statement import auto-matches collections, unpaids, fees and payouts, and unmatched lines go to an exception queue. Accounting integrations include Zoho Books, Xero, QuickBooks and Sage. The invoices documentation explains the invoicing side, and pricing lists the plans.
Frequently asked questions
Does Zoho Books support South African VAT?
Yes. Zoho offers a South African edition of Zoho Books with VAT treatments and a VAT201 return report, as of September 2026. Check Zoho's South African site for current plan features.
Should I raise invoices in Zoho Books or in my billing system?
Pick one. If you only bill once-off invoices through one gateway, Zoho Books can be enough; for subscriptions, debit orders or several gateways, raise invoices in the billing system and sync them to Books.
Why doesn't my gateway deposit match my invoices?
Gateways settle a net amount after fees and refunds, often for many payments at once. Record the gross payments, fees and refunds separately through a clearing account so the net deposit matches.
How often should payments sync to Zoho Books?
Daily or near real time is ideal for payments, with a weekly review of exceptions. What matters most is that every settlement is fully matched before month-end.
- #zoho books
- #accounting
- #integrations
- #vat