eFAWATEERcom Integration with Zoho Books in Jordan, A 2026 Setup & Reconciliation Guide

Back to all articles

eFAWATEERcom is Jordan's national electronic bill presentment and payment (EBPP) platform, operated by Madfooatcom and licensed by the Central Bank of Jordan. From utility bills to government fees, GST payments and SME B2B invoices, billions of JOD flow through it every year. This guide walks Amman, Irbid and Aqaba finance teams through a proper eFAWATEERcom ↔ Zoho Books integration, biller onboarding, JoMoPay/Madfooatcom collection, MEPS bank routing, automated settlement reconciliation and audit trail.

Why eFAWATEERcom is the payments backbone in Jordan

• National EBPP, practically every utility, government fee, ISTD payment and a growing share of B2C billing in Jordan routes through eFAWATEERcom.
• Operated by Madfooatcom, licensed and supervised by the Central Bank of Jordan (CBJ).
• Bank-agnostic, every Jordanian bank (Arab Bank, Housing Bank, Cairo Amman Bank, Bank of Jordan, Jordan Kuwait Bank, Capital Bank, etc.) connects through MEPS (Middle East Payment Services) and JoMoPay.
• Multi-channel, internet banking, mobile banking, JoMoPay wallets, ATM, bank branches.
• Settlement, eFAWATEERcom settles to the biller's Jordanian bank account through MEPS rails, typically T+1 net of fees.

Step 1, Which eFAWATEERcom mode is right for you

Three common ways Jordanian businesses connect eFAWATEERcom to Zoho Books:

• Direct biller integration, best for high-volume billers (utilities, telecoms, large SaaS, government contractors); requires a Madfooatcom biller agreement and API setup; we build the connector in Zoho Creator + Deluge.
• Sub-biller via bank, your house bank (Arab Bank / Housing Bank / Cairo Amman Bank etc.) sponsors you as a sub-biller; faster onboarding for SMEs.
• Payment-gateway aggregators, Tap Payments, Madfu, MEPS Pay and similar can bundle eFAWATEERcom alongside cards and JoMoPay wallets.

Step 2, Configuring the biller in Zoho Books

1. In Madfooatcom merchant portal, generate the biller code and production API credentials.
2. In Zoho Books → Settings → Integrations → Custom Payment Gateways, register eFAWATEERcom as a payment method with the biller code, API key and webhook secret.
3. Map the eFAWATEERcom collection account (JOD) under Settings → Chart of Accounts.
4. Add a Pay via eFAWATEERcom instruction block on the invoice template, biller code + invoice reference number the customer types into internet/mobile banking.

Step 3, Invoice flow & customer payment journey

• Zoho Books generates the invoice with a unique Bill Number matching the customer-side reference.
• Customer logs into their bank app (or JoMoPay wallet), searches for the biller, enters the bill number and pays.
• Madfooatcom sends a webhook to Zoho Books → invoice auto-marked Paid → eFAWATEERcom liability cleared → bank reconciliation receives the net settlement next day.
• Net effect: zero manual entry. AR ageing updates in real time.

Step 4, Automated settlement reconciliation

This is the part that breaks most non-Shyphan setups. Three things have to match every settlement cycle:

1. eFAWATEERcom / Madfooatcom settlement report (CSV from the biller portal), gross collection, fees, net settled, MEPS routing.
2. Bank statement from your Jordanian bank, the net deposit hitting your operating account.
3. Zoho Books, invoices marked paid + the bank deposit transaction.

We build a Zoho Creator app that imports the daily eFAWATEERcom settlement CSV, matches it against bank-feed transactions in Zoho Books, and flags discrepancies. Finance teams spend 10 minutes a week instead of 2 days a month.

Step 5, Recording eFAWATEERcom fees correctly

• eFAWATEERcom fees are typically a small JOD flat amount per transaction plus a percentage, exact numbers per the latest Madfooatcom commercial schedule.
• In Zoho Books we set up a 'Payment Gateway Fees' expense account and configure the integration to split each settlement: Invoice paid (gross) − fees (expense) = net cash received.
• Result: P&L shows true revenue + actual gateway cost; reconciliation is line-by-line, not summary-level.
• For GST: gateway fees may carry their own 16% input GST, captured automatically via the supplier bill from Madfooatcom.

Step 6, Refunds, reversals & disputes

• Reversals initiated in Madfooatcom get reflected in the daily settlement report.
• Zoho Creator app posts a Credit Note in Zoho Books with the gateway-fee adjustment.
• Disputes (less common with bank-rail eFAWATEERcom than with international cards) go into a queue with full evidence trail for the bank/Madfooatcom.
• AML-relevant transactions (high-value or unusual patterns) get auto-flagged for compliance review.

Step 7, CBJ / Madfooatcom audit trail

For licensed Jordanian billers and aggregators under CBJ payment-services oversight:

• Transaction-level audit log in Zoho, every state change tracked with user, timestamp and IP.
• AML transaction monitoring rules built in Zoho Creator, flag suspicious patterns (rapid multiple refunds, unusual geo / device).
• Monthly CBJ / Madfooatcom return template generated from Zoho Analytics.
• Annual external auditor pack, settlement reports, reconciliation logs, dispute history exported in one click.

Common eFAWATEERcom,Zoho integration mistakes

• Recording gross instead of net, invoice shows paid at JOD 100 but only JOD 99 hit the bank; AR doesn't reconcile.
• No settlement-level matching, invoices are paid individually, settlement is batched; without matching logic, the bank account never reconciles.
• Manual fee entry, finance posts fees as a lump sum once a month instead of per-transaction; loses traceability.
• No refund handling, credit notes posted manually; never tied back to the original eFAWATEERcom transaction ID.
• Plain webhook without signature verification, security risk; we always verify the Madfooatcom webhook HMAC signature.

How an eFAWATEERcom,Zoho Books rollout looks for a Jordanian SME

1. Week 1, Discovery + Madfooatcom biller / sub-biller review + JOD chart of accounts review.
2. Week 2, Zoho Books config, Madfooatcom API connection, invoice template with Pay via eFAWATEERcom block.
3. Week 3, Zoho Creator settlement-reconciliation app build + bank-feed wiring with MEPS.
4. Week 4, Refund / dispute workflow, fee account mapping, CBJ return template.
5. Week 5, UAT in production with real transactions, training, go-live.

Typical cost in Jordan: JOD 1,500, 4,200 depending on scope and CBJ-licensed status.