Hire Purchase Portal

Hire Purchase Portal
1Your Details
2Vehicle Details
3Finance Details
4Your Quote

Your Details

+263
1Personal Details
2Income Details
3Vehicle & Finance
4Financial Details
5Review & Submit

HP Application β€” no quote selected

1. APPLICANT TYPE 2. PERSONAL INFORMATION
Your photo *
3. IDENTITY VERIFICATION
Upload a certified copy of your National ID. The certification must be valid and not more than 3 months old.
Drag & drop file here
or Browse Files
Accepted formats: PDF, JPG, PNG  |  Max size: 10 MB
Upload a clear copy of your driver's licence.
Drag & drop file here
or Browse Files
Accepted formats: PDF, JPG, PNG  |  Max size: 10 MB
Additional licence & tax details
Very large files? Email them to your IFS branch quoting your application number.
4. CONTACT DETAILS
Use for:
Use for:
5. RESIDENTIAL INFORMATION
Current address
Proof of Residence *
Upload one of the following: Utility Bill, Lease Agreement, Bank Statement, Employer Letter, or other accepted proof of residence.
Drag & drop file here
or Browse Files
Accepted formats: PDF, JPG, PNG  |  Max size: 10 MB
Previous addresses
Defaults to 0 (no previous address). Enter how many previous addresses you have had.
6. NEXT OF KIN

Pipeline β€” Quotes, Applications & Granted Agreements






Quote NoDeal NoDateName PhoneVehiclePriceMonthly StatusActions
All saved quotes and applications live here in the portal's shared database β€” this is your follow-up list. QUOTED = has not applied yet (chase by email/WhatsApp/call). View opens the full quote for checking/printing; Approve (MD/FM/Admin) grants the hire purchase, assigns a Deal number and locks the schedule for receipting and journals.

Receipting

The payment credits the client account. Anything already due or overdue is settled on the spot (oldest first); the rest is held as credit and applied automatically as future instalments fall due. The cashier does not allocate to instalments.
Pick a payment type, find the client (for account payments), enter the amount and post. A printable receipt opens and a copy is sent to the client.

Reports & Exports

Invoice 1: vehicle + total finance charges Β· Invoice 2: upfront costs β€” for manual import now, API later.
Default Notice: statutory demand under the Hire-Purchase Act [Chapter 14:09] for a facility in arrears.


One PDF per facility, one combined print run β€” for branch-wide or province client statement mailouts.

  

Recovery & Repossession

HP-Act-compliant recovery worklist for facilities on the book. Buckets are driven by days past due (DPD) on the schedule.

Loading…

πŸ’¬ AI Assist β€” help desk

Ask AI Assist how to use the system, or look up a live record β€” a deal by reference, an account's arrears or next payment, or a portfolio total. Every figure is read from the account itself, and lookups follow your access. Powered by Claude when an API key is set (Settings β†’ Email/WhatsApp/SMS & AI); otherwise AI Assist answers from the built-in guide.
Try: "how do I create a quote" Β· "arrears on <reference>" Β· "how many accounts are in arrears" Β· "which deals are awaiting handover".

Quick start

  1. Quote β€” Get a Quote β†’ client, vehicle, price & term β†’ Save. The instalment shows on the right.
  2. Apply β€” Apply carries the quote in β†’ complete the sections β†’ Review & Submit (the client gets a one-time code).
  3. Approve β€” Pipeline β†’ open the deal; it moves up the approval chain to the MD.
  4. Offer & sign β€” View Letter of Offer β†’ client signs on the tablet β†’ handover once paid & released.
  5. Receipt β€” Receipting β†’ capture payments against instalments.
  6. Recovery β€” Recovery β†’ work overdue accounts, send HP-Act letters, manage repossession.

About

Loading…

Guides & manuals

For everyday users
For administrators
For developers
Open in a new tab; printable. All guides live in the Guides folder of your install. (browse all)

Administrator / technical

  • Install β€” one pip line + Tesseract for OCR (INSTALL_AND_SETUP.txt).
  • 2FA β€” mandatory for staff; the QR needs the segno library (2FA_SETUP_NOTE.txt).
  • Messaging β€” set SMTP / WhatsApp / SMS in Settings to enable real sending.
  • AI Assist β€” add an Anthropic API key in Settings to power AI Assist with Claude.
  • Backups β€” keep a nightly copy of the database. A transactions-only clear (keeping settings) is run by the database administrator using the supplied SQL script.

Back office

Operations hub β€” facility tasks, collections, accounting exports and messaging in one place.

Loading…

Facility back-office tasks

Restructure / Settlement, the final disbursement Release sign-off, the Vehicle Handover Sheet, the Statutory invoice (ZWG), Confirm Supplier Paid and Vehicle Service Tracking are handled here.

1 Find the contract
or enter the deal number directly
2 Choose a task

Operations

Collections & reminders

Accounting exports (Klipboard / Palladium)

Compliance & audit

Penalty finance charge

Rate, grace period and on/off switch are in Settings β†’ β€œPenalty finance charge on overdue accounts”. Charged automatically once a day; use the button below to run it on demand (e.g. after changing the rate).
Loading…

Users & Roles

UsernameNameRole EmailStatusActions

Add user

New users get a one-time invite code; the invite email opens in your mail app. On first login they enter the code as their password and are forced to set their own. In the hosted version, invite and login-alert emails send automatically.

Login activity

WhenUserEvent
Every login and key action is recorded here. The hosted version also emails the Administrator a notification on each staff login.

My Security β€” Two-factor authentication

Two-factor adds a 6-digit code from an app (e.g. Zoho OneAuth) at login.
Settings / Company Profile
Business

Company Profile β€” your business details & logo

These details brand every document your customers receive (quotations, receipts, applications, contracts, statements). The ECB logo stays on the portal and manuals only.

Receiving bank accounts (printed on every contract)

Add all the company accounts customers may pay into. These appear on the agreement.

Mobile money options


Business

Rates (push to all users) β€” Admin & MD only

IFS selling price & cost-of-credit cap
The markup is applied to the entered dealer price to give the IFS selling price β€” the price of the vehicle to all buyers (cash and finance alike), not a finance-only charge. Every quote discloses the effective all-in cost of credit and is checked against the cap below.
RBZ mid-rate is entered manually here (and per quote on the quote screen). There is no automatic daily fetch. Each change to the rate above is recorded in the auditable register below β€” who set it, when and the rate used.
RBZ / ZWG mid-rate register
Loading…
Business

Financed amount limits

A quote outside these limits is flagged on the quote screen. End-users (not logged in) use the public maximum; logged-in staff use the staff maximum (0 means unlimited).
Business

Credit & guarantor

Applications outside this age range are a hard stop on the public application (the Personal Details step and submit are both blocked).
During Preliminary Vetting the sales officer enters the FCB/CRB rating. If it is below this minimum, the application is flagged as requiring a guarantor: the guarantor section then appears on the application form (on reopen) and guarantor details/documents are required before hand-off to Credit Analysis. When the v7 credit score returns Amber (REVIEW), the cure follows the policy above: with require guarantor = Yes the client is sent a guarantor link and the deal is held; with No, the amber deal proceeds to Credit Analysis with an audit note for the Credit Manager β€” it is not treated as a pass. The additional-deposit cure engages only when the guarantor cure is off: on an amber score the system computes the smallest deposit top-up that would lift the score to green, emails/SMSs the client a link to agree to it, and holds the deal; once they confirm, it drops back to the Sales Officer to re-quote and recompute β€” the hold clears when the amber does. If no deposit can clear the amber, the deal proceeds with the same audit note.
Business

Industry risk classifier

Classify each Employer Industry as Low-risk or High-risk β€” this drives the Industry factor in the v7 credit score. Add your own industries; every industry listed here also becomes selectable in the Employer Industry dropdown on the application form. Nothing is hardcoded.
Update, Add and Remove each save and push to clients immediately.
Business

Income Nature β€” stability classifier

Map each Nature of Income option to an income-stability band (Stable or Irregular) β€” this drives the Income Stability factor in the v7 credit score (the points each band earns are set in the Scoring Engine editor). Tag each option for Employed, Self-employed or Both; it becomes selectable in the matching Nature of Income dropdown on the application form. Anything not listed here is treated as unmapped and flagged rather than scored. Nothing is hardcoded.
Update, Add and Remove each save and push to clients immediately.
Business

Scoring Engine β€” v7 model editor

Retune the Invarium 5-Cs credit model: segment & factor weights, the points each rating band earns, the decision bands (grade thresholds), and the hard knock-out rules. Changes are saved as an override and take effect on the next score/recompute. Every save is kept as a numbered version with a summary of what changed — you can restore any earlier version (including the built-in v7 default) from the history at the bottom of this panel. Weight groups should each total 1.00 (shown live).
Loading…
Business

Penalty finance charge on overdue accounts

Charged automatically at end-of-day, daily, on top of the normal finance charge, on any instalment still overdue once the grace period has lapsed. Posted to a penalty ledger per facility, emailed to Accounts and exported as XML for Klipboard posting β€” see Back Office β†’ Penalty finance charge.
Business

Vehicle service follow-up

The financed vehicle must be serviced every interval below. The system reminds the assigned sales officer by email to confirm with the client that the vehicle has been serviced, for as long as the facility is on the book β€” see the Vehicle Service Tracking panel on each Hire Purchase facility.
Business

Business rules

Insurance providers

The list the Insurance Officer (and vehicle-handover capture) picks from. Choose one as the default β€” it is pre-selected on the Insurance section.
Controls the row of Finance/Admin/Establishment/ZINARA/ZBC/Life-cover pills on the customer Finance step of the quote. Staff always see the full breakdown on the pipeline.
Insurance, tracking, ZINARA and ZBC are confirmed after approval and verified on the electronic vehicle handover sheet β€” not at approval.
Business

Hire Purchase Terms & Conditions

Shown to applicants when they click the "Hire Purchase Terms & Conditions" link on the declaration step. Leave blank to use the built-in default wording.
Business

Document Templates β€” Contract & Offer Letter

Customise the wording of the two documents a client signs. Leave any box blank to use the built-in default wording. Figures, dates, names and the payment schedule are always filled in automatically β€” only the surrounding wording is editable here.

Hire Purchase Agreement (the full contract)

This is the complete on-screen/printable agreement signed at Handover. Use the placeholders below anywhere in the text β€” each is replaced with the real value when the contract is opened for a specific deal.
Available placeholders (click to expand)
{{SELLER_NAME_UPPER}} {{SELLER_SHORT}} {{SELLER_REG}} {{SELLER_ADDR}} {{SELLER_REP}} {{SELLER_REP_UPPER}} β€” your company
{{BUYER_NAME}} {{BUYER_ID}} {{BUYER_ADDR}} β€” the client
{{START}} {{END}} {{TERM}} {{PLACE}} {{SDATE}} β€” dates & term
{{CASH}} {{DEPOSIT}} {{BALANCE}} {{FINCHG}} {{TOTALHP}} {{MONTHLY}} {{NINST}} β€” figures
{{UPFRONT_BLOCK}} {{RECURRING_BLOCK}} {{SCHEDULE}} {{ACC_BLOCK}} β€” auto-built tables (upfront costs, recurring charges, payment schedule, banking details)
{{MAKE}} {{MODEL}} {{YEAR}} {{COLOUR}} {{BODY}} {{VIN}} {{ENGINE}} {{ODO}} β€” vehicle
{{SIG_SELLER}} {{SIG_BUYER}} {{SIG_W1}} {{SIG_W2}} β€” signature images (or a blank line if unsigned)

Letter of Offer β€” wording

The Letter of Offer PDF is mostly computed figures (deposit, instalment, schedule) and can't be freely rewritten, but these two narrative lines can be. {ASSET} and {AMOUNT} are filled in automatically where used.
When off, granting a facility does not email the client. Open the facility and use Send Offer once you have checked the offer.
Business

Vehicle registration / excise (once-off on signing)

Pre-owned uses the ZIMRA special-excise grid by age & engine capacity; new vehicles use the flat figure. All editable.

Business

Dealerships & Suppliers β€” vehicle price lists & codes

Maintain the dealers / suppliers you source vehicles from, each supplier's vehicle price list, and the stock / vehicle codes. Vehicles added here appear in the “Dealership / supplier” picker on the quote screen and auto-fill the price and code.
People & Access

Staff session security

Staff are signed out automatically after this many minutes of no activity (no mouse, keyboard, or screen taps) β€” to stop a logged-in screen being left open and unattended.

Customer AI Assist β€” verified session

After a customer verifies with a one-time code on the public assistant, their secure session lasts this long. It ends at the absolute limit, or sooner after inactivity.
People & Access

Approval Process β€” levels, positions & limits

A facility needs sign-off from every level up to the band its amount falls into. Rename a position to your own title; it stays linked to a built-in role that controls permissions. "Notify" levels are emailed on grant but don't gate.

People & Access

Roles β€” rename & create

Rename any existing role, or create your own roles and choose exactly what each one can do. Custom roles appear immediately in the Add User and Edit User role lists. Approval-chain positions are still configured under Approval Process above.

People & Access

Password policy

Item/account codes are used on the invoice and journal CSV exports so they import cleanly into Klipboard (Palladium); the same mapping will drive the API integration.
Data & Lookups

Klipboard / Palladium mapping (for exports & future API)

Data & Lookups

Account codes

Data & Lookups

Towns & Provinces β€” address lookup

The town β†’ province list used to auto-fill Province on the quote and application. Edit the provinces (one per line), add towns, and reclassify a town by changing its province. A town not on this list still works β€” the applicant can type it and Province falls back to "Other".
Messaging

Email (SMTP) & WhatsApp β€” set up sending

Enter these once and the system writes its own config file β€” no editing files by hand. Until completed, messages wait safely in the Outbox.
SMS uses a generic form-POST gateway: it sends to and message (plus sender / apikey if set). Most Zimbabwean bulk-SMS providers accept this.
Add an Anthropic API key to power the AI Assist help desk with Claude. Without a key, AI Assist still answers from the built-in guide.

Messaging

FCB Credit Bureau β€” subscriber credentials

Credentials for the Financial Clearing Bureau individual search. Held server-side only (never sent back to the browser). Once set and enabled, staff can run an applicant bureau check from the Processing screen. Company search is not yet available.
The base URL only needs changing to point at a sandbox. Leave blank to use the live FCB endpoint.

Messaging

Reminders & messaging

Choose which channels carry reminders and when they go out. Messages are queued to the Outbox and sent by the channels configured above. Placeholders: {fn} {sn} {company} {deal} {amount} {due} {code} {dpd}.

Messaging

Notifications β€” enable / disable sending

Turn whole channels on or off, and switch individual notification points on or off. Anything left on continues to send (to the Outbox, then out via the channels configured above). A disabled item is simply skipped β€” the rest of the workflow is unaffected.
When on, the system flushes the Outbox on a timer while the server is running, so notifications go out without pressing "Send queued".

Display

Footer

Text shown in the footer on every screen, next to the ECB International badge (bottom-right).
Display

Quick estimate calculator

Choose which sections appear in the Quick Estimate calculator on the quote screen. The summary cards (monthly payment, on-signing, financed, first due) always show.
Display

Completed quote display (Your Quote screen)

Choose which sections appear on the client's Your Quote screen when a quote is completed. The summary cards (monthly payment, on-signing, financed, first due), the Your Quote document and the Get-my-quote / Apply actions always show.
Cost of credit: when a selling-price markup is active, hiding this panel still keeps the headline effective all-in rate and the cap notice on screen β€” only the detailed rows collapse β€” so the finance cost is never concealed inside the price. With no markup, Hide removes the panel entirely.

SOFTWARE REGISTRATION

IFS Hire Purchase Portal

Licence keys and enforcement are designed but not yet active (see LICENSING_DESIGN.md). This screen displays registration details only. Β© ECB International 2026 Β· support@ecbinternational.biz Β· +263 242 744 608 Β· 11 Earls Road, Alexandria Park, Belgravia, Harare, Zimbabwe.
© 2026 ECB
ECB International
Β© 2026 ECB