Before you start
Make sure the following conditions are met before opening a new application.- The member is ACTIVE. You cannot draft a loan for a suspended, inactive, or deceased member. Reactivate the member first.
- The member’s KYC status allows it. You can draft an application for any member except one whose KYC is UNVERIFIED or FAILED, so a member who is still in progress or in manual review can be drafted. To submit, though, the member’s KYC must be exactly VERIFIED. A drafted application for an in-progress or manual-review member is blocked at submission until verification completes.
- You have the Credit Officer role. You need permission to create and submit loan applications. Contact your Administrator if you are unsure about your role.
Steps to create and submit an application
1
Go to Loans, then New application
From the main navigation, select Loans, then click New application in the top-right corner of the loans list.
2
Search for and select the member
Type the member’s name or member account number into the member search field. Select the correct member from the results. The member’s basic details pre-fill the Applicant Information section. Encrypted identifiers like the TRN are not part of this loan member search.
3
Select the loan type
Choose the loan type. The dropdown lists the loan types your credit union has defined, and the visible names are configurable by your credit union. Each one maps to one of four fixed archetypes that drive the behaviour: Unsecured, Cash secured, Motor vehicle (AUTO), or Real estate (MORTGAGE). The loan type determines which form sections appear. See Loan Types for a full breakdown.
The loan type is locked once the application is submitted. If you select the wrong type, you must abandon the draft and start a new application.
4
Select the loan product
Choose the loan product that applies to this application. Products are configured by your credit union and determine the eligible amount range, term limits, and applicable rate tables.
5
Fill in Applicant Information
Confirm or complete the applicant’s personal details: name, date of birth, contact information, and address. The member record is the source of truth, so you confirm rather than re-enter, and encrypted identifiers such as TRN, driver’s licence, and passport are never re-typed in plaintext here.
6
Fill in Employment
Enter the applicant’s employment details: employment type (employed, self-employed, or pensioner), employment status (permanent, contract, or temporary), employer name, position held, length of employment, and gross monthly income. Employment type and employment status are scored as separate risk factors, so capture both. The platform uses this information to calculate risk and residual income.
7
Fill in Statement of Affairs
Capture the applicant’s income and monthly expenses.Income sources. At least one is required; submission is rejected without one. Each income line carries an applicability percentage, so income that counts only partially toward affordability (a bonus counted at 50%, for example) is weighted accordingly.Monthly expenses. List every outgoing under a category. The category dropdown covers Statutory Deductions, Pension, Existing Loan Payment, Other Payment, Property-Related, Utility / Household, Personal / Family, Transportation, and Other Expense. Quick add chips drop the common ones in with one click: Utility / Household, Transportation, Personal / Family, Existing Loan Payment, and Property-Related. Utility bills go under Utility / Household.As you type, the section shows a live Total income, Total expenses, Net monthly (which turns red if it goes negative), and a TDSR percentage with a colour-coded band chip. Click Save statement of affairs. The platform uses these figures for the Total Debt Service Ratio (TDSR) and residual income.
8
Fill in Loan Purpose
Enter the loan amount requested and the requested term in months. The amount and term must fall within the product’s configured limits, which the platform enforces. A mortgage product can run up to 480 months; most products cap lower. Describe the purpose in free text and tag it with a purpose category, which the adjudication queue uses for filtering. Pick the preferred repayment method (standing order, payroll deduction, or direct debit); standing order is the default.
9
Fill in the collateral section (if applicable)
Depending on the loan type you selected, an additional section appears.
- Cash-Secured: Pledge one to five accounts as security. You can mix types, for example shares plus a fixed deposit. Each account has a type (Cash / Shares, Fixed / Time Deposit, or Savings Hypothecation), its account number, and the amount held. The card shows the combined total and the most you can borrow against it. The requested loan cannot exceed 95% of the combined pledged cash; the platform warns you and blocks submit if it does.
- Auto: Enter the vehicle’s make, model, year, VIN, engine number, and estimated valuation, plus optional mileage. Insurance is confirmed during the Securities review, not captured here.
- Mortgage: Enter the property type, address, estimated valuation, valuation date, security type (First Mortgage, Second Mortgage, Strata Title, or Other), and any registered mortgagees. Title and insurance are Securities-review concerns, not application fields.
10
Add guarantors (optional)
If the application requires or benefits from a guarantor, click Add Guarantor and fill in the guarantor’s personal, employment, and income details, along with their relationship to the applicant, which is required. You can add more than one guarantor.Each guarantor has its own Documents block. Use the ID, Income, and Employment buttons to upload that guarantor’s identification, proof of income, and employment letter. You can view a file or remove it later. The documents follow the loan, so the Adjudicator, Securities, and Disbursement reviewers see them downstream. Each upload runs the same checks as any member document: a 10 MB size cap, magic-byte type check, and virus scan.
11
Set creditor-life insurance
The application carries creditor-life cover by default. The Creditor-life insurance section lets you tune it for this loan.
- This loan carries creditor-life cover is the on/off toggle, on by default. Untick it for a loan with no cover.
- Premium basis is Level (full sum, whole term) or Declining balance (reduces as repaid). Level is the default.
- Sum insured defaults to the requested principal. Set a different figure when the cover differs from the loan amount.
- Manual total premium (optional) lets you enter the whole-term premium directly. Leave it blank to use the actuarial table.
12
Review the fees that will apply
The Fees that will apply card lists the standard fees for this loan: each fee with its Amount, its GCT, and its Treatment (deducted from proceeds, paid separately, or added to the loan), then the Total fees + GCT and the Net to member after deductions. It is estimated on the requested amount and is read-only here. The Disbursement officer finalises fees at funding. See Fees, deductions, and GCT.
13
Review the auto-calculated figures
Before submitting, review the figures the platform calculates automatically on the application page.
- Risk Band (R1 to R5): the band mapped from the sum of seven categorical factors (employment type, employment status, length of employment, TDSR, LTV, loan type, and credit history).
- TDSR: share of gross income going to all debt repayments.
- LTV: loan amount as a proportion of collateral value (secured loans only).
- Monthly payment: estimated repayment amount.
- Mandatory shares: the member equity required to hold the loan, shown as its own tile. The greater of JMD $2,000 or 15% of the loan amount.
- Residual income: take-home income remaining after all obligations.
- Total monthly payment: the loan repayment plus compulsory savings plus the creditor life premium.
14
Click Submit
When you are satisfied that all sections are complete and the figures look correct, click Submit. The application status moves from DRAFT to SUBMITTED, and it is automatically placed in the Adjudication queue.
Your loan is assigned a unique Loan ID (for example, MDVL-UNS-00001) when the draft is created, which is the moment you pick the member, loan type, and product. This ID appears in the application header and in all subsequent notifications.
Saving a draft
You do not need to complete all sections in a single session. Each section has its own save action, with labels like Save loan parameters, Save statement of affairs, Save net worth, Save cash details, Save vehicle details, and Save insurance. Save the section you are working on to preserve its contents. The application stays in DRAFT status, and you can return to it from the Loans list at any time. Saving is explicit: your progress is preserved when you save a section, so save before navigating away.Abandoning a draft
If you started an application but decide not to proceed, use the Abandon Draft option from the application’s action menu. The UI confirms with an “Abandon this draft?” dialog before flipping the status. Abandoning runs through the workflow engine and is gated by theloans.edit capability. The status changes to DRAFT_ABANDONED, the record is preserved in the audit trail, and the application is removed from your active drafts.
An abandoned draft cannot be reopened or resubmitted. If you need to proceed with the same member, create a new application.
Auto-calculated fields
The platform calculates these figures and shows them as you capture the application.
When you submit, the platform persists the risk band, the integer score, the policy flags, the engine version, and a snapshot of the inputs on the risk assessment record. The other figures above are estimates shown during capture, not separate stored fields on that record. The Adjudicator reviews them when making a decision.