vimiBank

vimiBank is where every commission your staff earn accumulates, waits for management approval, and gets processed into payslips.

What is it?

vimiBank is vimigo's company payout ledger - the virtual bank that tracks every ringgit of commission your staff have earned but not yet received. When someone closes a sale, hits a goal, or wins a Lucky Wheel cash prize, the amount lands in vimiBank, waits as "Pending Payment", and stays there until an admin processes it into payroll.

The key idea is a three-stage lifecycle:

EARNED  →  PENDING PAYMENT  →  PAID OUT

• Earned - the employee is on track within an active interval (monthly target, weekly goal, quarterly campaign). The amount is a live projection that can still go up or down until the interval closes.
• Pending Payment - the interval has closed. The commission is finalised and waiting for management to approve the payout.
• Paid Out - an admin has run the payout wizard and confirmed the payment. The amount should now appear on the employee's payslip via your payroll vendor.

vimiBank does not move real money itself - it tracks obligations. The actual transfer of funds happens in your payroll system, which reads pending records from vimiBank (either via manual processing or a vendor integration).

vimiBank separates earnings into categories - Personal Payouts, Team Payouts A, Team Payouts B, and Goals Payout - each backed by a separate payout wizard. This separation lets you pay personal and team commissions on different schedules.

Quick Start

If you're setting up vimiBank for the first time, or running your first payout batch, follow this:

1. Go to "Payouts" from the admin side menu.
2. You'll see a card per payout type: "Personal Payouts", "Team Payouts A", "Team Payouts B", "Goals Payout". Each shows a "Total Pending" amount.
3. Click the type with the most pending amount - typically "Personal Payouts" for vimiSales commission.
4. Work through the three-step wizard: select months → select employees → confirm payout.
5. Confirm the batch. Staff get a "vimiBank Payout" push notification and the records move from "Pending Payment" to "Paid Out".

After this, run the same wizard for each payout type on your chosen schedule (usually monthly, aligned with payroll).

For Admins (Employer / HR / Manager)

How to run a personal payout batch (vimiSales)

Scenario: March has ended. All Personal Payouts with status "Pending Payment" need to be processed before this month's payslip run.

1. Go to "Payouts" in the admin side menu.
2. Click "Personal Payouts".
3. Step 1 - Select Month: the table lists each month with counts and amounts of pending/processed payouts. Tick March 2026. Click "View Selected Payouts".
4. Step 2 - Select Employees: every staff member with a pending March record shows in the table with columns "Name", "Payment Type", "Month Achieved", "Amount Pending", "Amount To Process". Tick the ones to include. Adjust "Amount To Process" for any partial payouts.
5. Step 3 - Confirm Payout: review the summary ("Total Payout", "Months Selected", "Departments Selected", "Status"). Optionally click "Print" or "Save As Draft".
6. Click "Confirm" when ready.

The system runs the payout job, records are marked "Paid Out", and affected employees receive a "vimiBank Payout" push notification.

How to run a team payout batch

Team payouts ("Team Payouts A" and "Team Payouts B") have an extra department selection step.

1. From "Payouts", click "Team Payouts A" (or "Team Payouts B").
2. Step 1: select the months.
3. Step 2: select one or more departments.
4. Step 3: select employees (filtered to your chosen departments) and confirm amounts.
5. Step 4: click "Confirm".

Bank A vs Bank B: Most companies use Bank A for the standard team commission tier and Bank B for bonus or long-service tiers. The two run independently so you can pay them at different times if your payroll cadence needs it.

How to run a goals payout batch

1. Click "Goals Payout" from the "Payouts" menu.
2. Step 1 - Select Month/Year: pick the month(s) with pending goal amounts.
3. Step 2 - Select Employees: each row shows the employee name, the goal setting name, the month, and the pending amount. Adjust "Amount To Process" if needed.
4. Step 3 - Confirm Payout: review the total and click "Confirm".

Staff receive a push notification as soon as the batch completes.

How to process a partial payout

Sometimes the company can only release part of a pending amount this cycle - cashflow, dispute review, or staggered payout policy.

1. Enter the payout wizard for the relevant type.
2. In Step 2 (Select Employees), find the employee's row.
3. Change "Amount To Process" to the partial amount (e.g. if pending is RM 500 and you want to pay RM 300 now, enter 300).
4. Select the employee and continue.
5. Confirm in Step 3.

The record status changes to "Partially Paid". The remaining balance stays in vimiBank as pending. Next cycle, run the same wizard again - the remaining amount will appear on that employee's row.

How to save a payout as a draft

When you're not ready to confirm a payout immediately (e.g. waiting for sign-off):

1. Complete the payout wizard up to Step 3 - Confirm Payout.
2. Click "Save As Draft" instead of "Confirm".
3. Confirm in the modal.

The draft is saved under your admin user and payout type. When you return to the same payout type card later, you'll see a "Resume Draft" state with the same selections pre-loaded. Two admins cannot work on the same draft simultaneously.

How to create a manual contribution (staging-only feature)

Some companies need to enter a payout that wasn't auto-generated - e.g. a special bonus, a correction, or a backdated entry. This is what "Manual Contribution Management" is for.

Status: This feature is currently on staging - coming to production in a future release. If you need it now, contact your vimigo VSP.

1. From "Payouts", click "Manual Contribution Management" → "Create Entry".
2. Fill in the form:
   • "vimiBank" - pick the payout type (Personal Payouts, Team Payouts A, Team Payouts B, or Goals Payout)
   • "Search staff name" - autocomplete the employee
   • "Month-Year" - which month this applies to
   • "Payout Amount" - amount in RM
   • "Remark" - required, explain why (e.g. Q1 discretionary bonus approved by director)
3. Click "Create Entry".

The record is created with status "Pending Payment" and a "Transfer Type" of "Manual Contribution" (distinguishable from auto-generated "Commission Payout" records). It appears in the relevant payout wizard for processing.

How to review the payout audit log

When a staff member disputes their payout history, the audit log is the source of truth.

1. From "Payouts", click "Manual Contribution Management" → "Audit Logs".
2. Filter by "Action" (Created / Edited / Deleted), "vimiBank" (payout type), "Staff" (name search), or "Action Date".
3. Click "Filter" to apply, "Reset" to clear.
4. The results table shows every change: "Date Time", "User", "vimiBank", "Payment Type", "Transfer Type", "Action", "By", "Remarks", "Amount Change".

For the change history of a single record, find the record in the payout table and click its "History" icon - the same columns show, filtered to just that record.

How to view payout history

To see every past payout batch your company has processed:

1. From "Payouts", click the "Payout History" card.
2. Use "From:" / "To:" date filters and the "Search" box to narrow results.
3. Click "Filter" to apply.
4. The table shows: "Payout Created Date", "Payout Type", "Payout By", employees selected, "Total Payout Amount", "Payout Complete", "Payout Pending", "Status".

How to export the Payout List report

1. Go to "Reports" → "Payout List".
2. Set "From Date" and "To Date".
3. Optionally filter by "Department", "Payment Type", or "Status".
4. Click "Filter".
5. Click "Export" (top-right) to download as Excel.

The export includes a "Staff ID" column (added 2026-04-20) to make payroll reconciliation easier.

For Employees

How to view your vimiBank wallet

1. Open the vimigo mobile app.
2. Navigate to your vimiBank wallet.
3. You see a summary of your totals:
   • "Total Balance" - sum of all Pending Payment across categories
   • "Earned" - live projections from currently-running intervals
   • Category breakdowns: "vimiSales", "vimiBank A", "vimiBank B", "vimiGoal"
4. Tap any category to drill down into monthly payout records.

Understanding your wallet

Why is my amount showing as "Earned" and not "Pending"?

Your current interval (e.g. this month's sales target) is still active. The amount is a live projection - it will change as your results change. When the interval ends, the system converts it to "Pending Payment" automatically.

Why hasn't my Pending amount been paid out?

Your employer runs payout batches manually - typically aligned with payroll. The amount moves to "Paid Out" when they process the matching payout type through the wizard. If it's been more than a full payroll cycle, follow up with HR.

Can I see where each payout came from?

Yes. Tap any Earned record and it links to the source vimiGoal or vimiSales setting that generated it, so you can see your current progress.

Settings & Configuration

Setting	What it does	Default	Where
"Personal Payouts" module	Shows/hides the Personal Payouts card	On for SaaS	Company module settings
"Team Payouts A" / "Team Payouts B" modules	Shows/hides team payout cards	On if teams are used	Company module settings
"Goals Payout" module	Shows/hides the Goals Payout card	On if vimiGoal is used	Company module settings
Vendor API integration	External payroll vendor access	Off	Configured by vimigo support
"Manual Contribution Management" (staging)	Admin-created payout entries with audit logs	Staging-only	Release TBC

These module flags are typically configured by vimigo support during onboarding. Contact support if you need to enable or disable a payout type.

Payout statuses

Status	Meaning
"Open"	Interval just closed - record exists but not yet queued
"Pending Payment"	Queued and waiting for admin to process
"Paid Out"	Fully processed - should appear on payslip
"Partially Paid"	Part paid; remainder still pending
"Split to Others"	Amount transferred to another employee's record
"Earned"	Live projection (mobile display only - not stored)

Payout type summary

Admin payout card	What it covers
"Personal Payouts"	Personal sales commission (vimiSales 2.0 + MTD)
"Team Payouts A"	Team commission - standard tier
"Team Payouts B"	Team commission - bonus / long-service tier
"Goals Payout"	vimiGoal commission payouts

FAQ

Q: An employee says their bank amount is wrong.

A: Check their records under "Payouts" → their name. Compare against the source module (vimiSales / vimiGoal / vimiTeam). Remember that "Earned" is a real-time projection that moves as results change - it only stabilises when the interval closes.

Q: An employee shows "Earned" but not "Pending" - is that a bug?

A: No. "Earned" means the interval is still active. When the interval closes (usually at month-end), the system automatically converts it to "Pending Payment". No manual action needed.

Q: A manager can't see their team members' bank data.

A: The manager must have permissions set up to view those employees as a team hierarchy. Check that team structure is configured correctly - if it's not, the manager will only see their own wallet.

Q: A payout record has been stuck in "Pending" for weeks. What happened?

A: Management has not yet processed it through the wizard. Go to "Payouts" → select the matching payout type → find the pending record → run the wizard.

Q: I can't delete a payout record. Why?

A: Deletion is only allowed when the paid amount is exactly RM 0.00. If any amount has been partially paid, you must first edit the remaining amount down (or reverse the paid portion) before deletion becomes possible. Deletion is staging-only today.

Q: The "Earned" amount changes day by day. Is that normal?

A: Yes. Earned is computed in real time from your staff's current sales and goal progress. It will stabilise to a final figure only when the interval closes.

Q: We processed a payout but the employee's payslip doesn't reflect it. What's wrong?

A: vimiBank marks the record as "Paid Out" in the system, but the actual transfer to payslip depends on your external payroll system. Confirm your payroll vendor has received and processed the record - if you use the vendor API, check that vendor_status is 4 (processed successfully).

Q: How do I pay a bonus that isn't tied to any commission?

A: Use "Manual Contribution Management" (staging-only for now). Create an entry, pick the payout type that best fits, add a remark explaining the reason, and it will appear in the relevant wizard for processing.

Q: How does vimiBank relate to EWF?

A: vimiBank holds commission earnings (tied to sales, goals, and team targets). EWF holds welfare benefit allocations (Education, Travel, Food, etc.). Different modules, different money, different flows - they don't overlap.

Related Guides

• vimiGoal - closed goal intervals create vimiBank goal payout records
• vimiSales - personal commission feeds "Personal Payouts"
• vimiTeam - team commission feeds "Team Payouts A" and "Team Payouts B"
• Diamond - separate virtual currency; not part of vimiBank
• Lucky Wheel - bank cash prizes feed vimiBank as commission records
• EWF - welfare wallets, separate from vimiBank
• vimiBadge - Mark payout milestones with badges.